Интеграция с Shopify

Обзор интеграции

Pushwoosh легко интегрируется с Shopify, ведущей платформой для электронной коммерции, которая позволяет компаниям создавать, управлять и масштабировать интернет-магазины. Это руководство проведет вас через процесс установки и настройки приложения Pushwoosh в вашем магазине Shopify, настройки идентификации пользователей, а также использования уведомлений и инструментов автоматизации для взаимодействия с клиентами на мобильных устройствах и в вебе.

Тип интеграции

• Назначение: Shopify отправляет данные клиентов в Pushwoosh, где они используются для таргетинга и отправки сообщений.

Предварительные требования

• Аккаунт Pushwoosh
• Доступ к панели администратора Shopify
• Токен доступа Device API и код приложения Pushwoosh
• Магазин Shopify с доступными данными о клиентах и заказах

Синхронизируемые сущности

• Клиенты: Используются для назначения и идентификации UserID Pushwoosh через метаполя Shopify.

Примечание

Подходы к синхронизации клиентов в Pushwoosh

Из-за технических ограничений Pushwoosh предлагает несколько методов синхронизации клиентов в зависимости от канала коммуникации, используемого для уведомлений:

• Email, Web, SMS и WhatsApp: Устройства/пользователи автоматически регистрируются в приложении Pushwoosh.
• Мобильные и десктопные приложения: Устройства/пользователей можно синхронизировать вручную через панели администратора Pushwoosh и Shopify.
• Веб-платформы (Chrome, Firefox, Safari): Устройства/пользователи управляются самим расширением темы Shopify.

Как это работает?

Процесс синхронизации работает следующим образом:

1. Система пытается получить текущую сессию пользователя, чтобы получить email или номер телефона (идентификаторы, которые работают без дополнительной настройки).
2. В случае успеха email или номер телефона устанавливается в качестве идентификатора userID как для Pushwoosh, так и для свойства pushwoosh_userid в данных клиента.
3. Если это невозможно, в качестве идентификатора для Pushwoosh и свойства pushwoosh_userid назначается userID по умолчанию из Pushwoosh SDK.
4. В любом случае userID будет назначен с обеих сторон, обеспечивая последовательную синхронизацию.

• Сегменты клиентов: Используются для таргетинга и отправки сообщений на основе групп.
• События и триггеры (например, размещенные заказы, примененные теги): Используются в Shopify Flow для автоматизации отправки пуш-уведомлений.
• Витрина магазина: Используется для сбора подписок на веб-пуши через встроенные скрипты.

Глоссарий (сопоставление названий сущностей, если они различаются)

Shopify	Pushwoosh
Customer	UserID

Как работает интеграция

Pushwoosh выступает в качестве канала для отправки сообщений из Shopify. После интеграции Shopify отправляет данные о клиентах и их поведении в Pushwoosh, где они используются для real-time уведомлений, сегментации клиентов и персонализированных сообщений в вебе и на мобильных устройствах.

Ключевые компоненты интеграции

1. Идентификация клиентов через метаполя Каждому клиенту Shopify присваивается уникальный UserID, который хранится в метаполе (custom.pushwoosh_userid). Этот ID позволяет Pushwoosh распознавать и отправлять сообщения пользователям последовательно на разных платформах.

2. Автоматизация на основе событий через Shopify Flow Pushwoosh предоставляет действия для Flow, которые позволяют автоматизировать пуш-уведомления на основе событий Shopify, таких как:

   • Размещение нового заказа
   • Применение тега к клиенту
   • Брошенная корзина

3. Таргетинг на основе сегментов Сегменты клиентов из Shopify можно использовать для отправки пуш-уведомлений для определенных групп, например, рекламных акций для новых покупателей или кампаний по реактивации для неактивных пользователей.

4. Ручная и real-time отправка сообщений Из представления клиента или сегмента в Shopify вы можете вручную запускать уведомления с помощью расширений Pushwoosh:

   • Notification by Customer: Для личных сообщений или тестирования.
   • Notification by Segment: Для сообщений в рамках кампаний.

Веб-пуши через встраивание в витрину магазина

Включив встраивание Pushwoosh в вашу тему Shopify, вы можете предлагать посетителям сайта подписаться на пуш-уведомления в браузере — мобильное приложение для этого не требуется.

Обзор потока данных

Данные о клиентах и событиях Shopify
         ↓
Pushwoosh API (через приложение)
         ↓
UserID → Сегментация → Триггерные или ручные уведомления

Эта интеграция позволяет вам доставлять своевременные, релевантные сообщения, которые улучшают удержание пользователей, повышают конверсию и улучшают клиентский опыт — автоматически или по запросу.

Часть 1. Установка

Вход в Shopify

1. Перейдите в панель администратора Shopify
2. Выберите свой магазин на панели управления

Примечание

Это руководство предполагает, что у вас уже есть аккаунт Pushwoosh. Если нет, создайте его

Установка приложения Pushwoosh

1. Посетите страницу приложения Pushwoosh в App Store
2. Нажмите Install
3. Подтвердите установку в диалоговом окне Shopify

Подключение вашего приложения Pushwoosh

После установки вы будете перенаправлены в приложение Pushwoosh внутри Shopify.

1. Нажмите Connect.

2. Введите код приложения и токен доступа Device API, которые можно найти в панели управления Pushwoosh → Settings → API Access.

После подключения появится сообщение об успехе: “Pushwoosh app connected.”

Подписка на тарифный план

1. Нажмите Upgrade Subscription
2. Будет показан единый тарифный план на основе использования.
3. Подтвердите оплату.

Примечание

Оплата требуется для использования функций доставки пушей и сегментации.

Часть 2. Настройка: User ID клиента через метаполя

Для доставки мобильных пуш-уведомлений идентифицированным пользователям Pushwoosh использует уникальный User ID для каждого клиента. Shopify хранит это значение в метаполях клиента Shopify.

1. Перейдите в Settings → Metafields and metaobjects → Customers

2. Нажмите Add definition и используйте следующие значения:

Поле	Значение
Пространство имен и ключ	custom.pushwoosh_userid
Пространство имен	custom
Тип	Однострочный текст
Валидация	Нет
Доступ к аккаунту клиента	Чтение и запись
Доступ к Storefront API	Включен

Почему это важно

Это метаполе является постоянным идентификатором пользователя на мобильных/веб-устройствах для уведомлений и сегментации.

Часть 3. Использование расширений Pushwoosh

Pushwoosh включает расширения Shopify для таргетинга на сегменты, автоматизации (Flow) и уведомлений для конкретных клиентов.

Расширение 1. Отправка уведомления по клиенту

Сценарий использования

Отправка персонализированных сообщений вручную или тестирование уведомлений для конкретного пользователя.

Шаги

1. Откройте Customers → Выберите клиента
2. Нажмите More actions → Notification by customer
3. Выберите платформу для отправки сообщений (например, Email) и пресет контента.
4. Нажмите Send

Совет

Используйте это для напоминаний после покупки, личных благодарностей или сообщений для реактивации.

Расширение 2. Уведомление по сегменту

Сценарий использования

Таргетинг на группы клиентов — брошенные корзины, новые покупатели, клиенты с высокими тратами.

Шаги

1. Перейдите в Customers → Segments

2. Выберите сегмент → Нажмите Use Segment

3. Выберите Notification by Segment
4. Выберите желаемый канал коммуникации и пресет сообщения. Нажмите Send.

Совет

Сегменты можно создавать на основе истории покупок, местоположения, активности или тегов.

Расширение 3. Pushwoosh в Shopify Flow

Сценарий использования

Автоматизация отправки сообщений в рамках пути клиента с использованием триггеров, таких как заказы, теги или поведение.

Шаги

1. Создайте новый Flow в Shopify Flow
2. Добавьте действие → Выберите Pushwoosh notifications

3. Настройте сообщение и динамические поля

Например:

• Отправить сообщение после размещения заказа

• Напомнить пользователю о брошенной корзине

• Отправить реактивационный пуш после 30 дней неактивности

Часть 4. Включение веб-пушей (необязательно, но рекомендуется)

Чтобы поддерживать веб-пуши в браузере на вашей витрине, выполните следующие действия:

1. Перейдите в Online Store → Themes → Customize
2. Откройте App Embeds в левом меню
3. Включите Push Init Embed

Примечание

Теперь ваш магазин может предлагать пользователям подписаться на веб-пуши прямо с витрины.

Сводка по сценариям использования

Сценарий	Используемый инструмент
Персонализированное последующее сообщение	Notification by Customer
Напоминание о брошенной корзине	Shopify Flow + действие Pushwoosh
Продвижение на основе сегмента	Notification by Segment
Приветственное сообщение после регистрации	Flow + отслеживание метаполей
Подписка на пуши	Встраивание в тему + переключатель Push Init