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

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

Pushwoosh легко интегрируется с Shopify, ведущей платформой для электронной коммерции, которая позволяет компаниям создавать, управлять и масштабировать интернет-магазины. В этом руководстве мы расскажем, как установить и настроить приложение Pushwoosh в вашем магазине Shopify, настроить идентификацию пользователей и использовать уведомления и инструменты автоматизации для взаимодействия с клиентами по таким каналам, как push-уведомления, email, SMS и WhatsApp.

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

• Назначение: 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 для автоматизации отправки сообщений по разным каналам
• Витрина магазина: Используется для сбора подписок на web push-уведомления через встроенные скрипты

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

Shopify	Pushwoosh
Customer	UserID

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

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

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

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

2. Автоматизация на основе событий через Shopify Flow Pushwoosh предоставляет действия для Flow, которые позволяют автоматизировать отправку сообщений (push, email, SMS, WhatsApp) на основе событий Shopify, таких как:

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

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

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

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

Web push-уведомления через встраивание в витрину

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

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

Данные о клиентах и событиях 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 Control Panel → Settings → API Access.

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

Подпишитесь на тарифный план

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

Примечание

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

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

Для доставки уведомлений идентифицированным пользователям по разным каналам (push, email, SMS, WhatsApp) 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. Создайте новый поток в Shopify Flow
2. Добавьте действие → Выберите Pushwoosh notifications

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

Например:

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

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

• Отправить push-уведомление для реактивации через 30 дней неактивности

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

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

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

Примечание

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

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

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