Интеграция с 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 по умолчанию из SDK Pushwoosh.
4. В любом случае, userID будет присвоен с обеих сторон, что обеспечит последовательную синхронизацию.

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

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

Shopify	Pushwoosh
Customer	UserID

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

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

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

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

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

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

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

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

   • Уведомление по клиенту: для персональных сообщений или тестирования
   • Уведомление по сегменту: для сообщений в рамках кампаний

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

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

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

Данные о клиентах и событиях Shopify
         ↓
API Pushwoosh (через приложение)
         ↓
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. Подтвердите оплату.

Примечание

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

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

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

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

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

Поле	Значение
Namespace and key	custom.pushwoosh_userid
Namespace	custom
Type	Single line text
Validation	None
Customer Account Access	Read and Write
Storefront API Access	Enabled

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

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

Часть 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. Настройте сообщение и динамические поля

Например:

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

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

• Отправить push для реактивации через 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-уведомления	Встраивание в тему + переключатель Push Init