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

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

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

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

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

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

• Аккаунт Pushwoosh
• Доступ к вашей панели администратора Shopify
• Токен доступа Device API и Код приложения Pushwoosh
• Магазин Shopify с доступными данными о клиентах и заказах
• Одобрение запрашиваемых приложением областей доступа read_orders, write_pixels и read_customer_events, необходимых для событий заказов/корзин, отслеживания этапов оформления заказа и поведенческих событий на витрине

Уже подключены? Вам будет предложено повторно одобрить доступ

Если вы подключили приложение Pushwoosh до того, как появилась функция отслеживания заказов, корзин и оформления покупок, Shopify попросит вас одобрить новые области доступа при следующем открытии приложения — это ожидаемый способ, которым 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 для автоматизации обмена сообщениями по разным каналам
• Витрина: Используется для сбора подписок на веб-пуши через встроенные скрипты
• Фид товаров: Фид витрины вашего магазина (products.json) автоматически подключается к Каталогу товаров Pushwoosh при подключении приложения и автоматически отключается при его удалении.
• Заказы и корзины: События сервер-сервер от веб-хуков Shopify orders/paid и checkouts/create. См. Отслеживание заказов, корзин и этапов оформления покупки.
• Поведение при просмотре витрины: Просмотры товаров и действия по добавлению в корзину, собираемые тем же встраиваемым элементом темы, который используется для подписок на веб-пуши.
• Этапы оформления покупки: Введенная контактная информация и отправленная платежная информация, собираемые через Shopify Web Pixel.

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

Shopify	Pushwoosh
Customer	UserID
orders/paid webhook	Событие PW_OrderCreated — общее с другими интеграциями для электронной коммерции (например, Magento)
checkouts/create webhook	Событие PW_AbandonedCart — то же самое общее событие, также используемое источником “Корзина” блока “Товары”
Product page view	Событие PW_ProductViewed

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

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

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

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

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

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

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

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

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

Веб-пуши через встраиваемый элемент витрины

Включив встраиваемый элемент 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.”

Автоматическое подключение каталога товаров

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

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

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

Примечание

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

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

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

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

Например:

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

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

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

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

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

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

Примечание

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

Часть 5. Отслеживание заказов, корзин и этапов оформления покупки

После того как вы одобрите области доступа read_orders, write_pixels и read_customer_events (см. Предварительные требования), Pushwoosh начнет получать три вида коммерческих событий из вашего магазина. Они поступают из разных источников и прекращаются независимо друг от друга — не рассматривайте их как один фид.

Серверные события заказов и корзин

Shopify отправляет события оплаченного заказа (веб-хук orders/paid, событие PW_OrderCreated) и создания оформления заказа (веб-хук checkouts/create, событие PW_AbandonedCart) в Pushwoosh напрямую, с сервера на сервер. Оба события являются общими с другими интеграциями для электронной коммерции — Magento использует те же два названия событий. Как и другие события от входящих веб-хуков (Stripe работает так же), они появляются в выпадающем списке Событие при создании сегмента или настройке триггера Customer Journey, и вы можете сопоставить любое из них как источник для событий конверсии, чтобы перенести доходы из Shopify в RFM-сегментацию, атрибуцию Journey и статистику по блокам “Товары”, которую вы отправляете в email.

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

Брошенная корзина здесь означает три разные вещи

• Триггер Брошенная корзина в Shopify Flow (см. Автоматизация на основе событий через Shopify Flow) является нативным условием Shopify, не связанным с событиями Pushwoosh.
• Веб-хук checkouts/create выше означает только, что было начато оформление заказа — Shopify еще не решил, что он “брошен”, и заказ также не был подтвержден.
• Источник “Корзина” блока “Товары” считывает корзину получателя через тег PW_AbandonedCartID, независимо от этих событий.

Выбирайте то, что соответствует тому, что вы на самом деле создаете, а не название, которое звучит наиболее близко.

События просмотра витрины

Просмотры товаров (событие PW_ProductViewed) и действия по добавлению в корзину собираются тем же встраиваемым элементом темы, который вы уже установили для подписок на веб-пуши — вам не нужно ничего нового добавлять в вашу тему, но встраиваемый элемент должен быть ВКЛЮЧЕН (см. Включение веб-пушей), чтобы эти события поступали. Если вы пропустили этот переключатель, вы не получите ни подписок на веб-пуши, ни событий с витрины.

Для событий витрины требуется включенный встраиваемый элемент темы

События просмотра товаров и добавления в корзину поступают из браузера покупателя. Если покупатель блокирует скрипт встраиваемого элемента, или вы оставляете встраиваемый элемент темы выключенным, вы перестаете получать эти два события — но события оплаченного заказа и создания оформления заказа продолжают поступать независимо, так как они приходят с сервера Shopify. Не думайте, что отключенный встраиваемый элемент темы также приостанавливает отслеживание заказов.

PW_ProductViewed не имеет дедупликации

PW_ProductViewed срабатывает при каждой загрузке страницы товара — включая повторные посещения в одной сессии, перезагрузки страницы и трафик от ботов или поисковых роботов. Дедупликация или ограничение частоты отсутствуют. Поскольку стратегии, такие как На основе просмотренного, строятся на этом событии, шумный трафик также влияет на эти рекомендации.

События этапов оформления покупки

Shopify Web Pixel сообщает о двух этапах оформления заказа по мере того, как покупатель заполняет форму:

• PW_CheckoutContactInfo: покупатель ввел свою контактную информацию.
• PW_PaymentInfoSubmitted: покупатель отправил свои платежные данные.

Завершенная покупка не является частью этого пикселя

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

Часть 6. Соответствие требованиям по обработке данных

Shopify требует, чтобы каждое публичное приложение отвечало на его обязательные веб-хуки GDPR/CCPA. Pushwoosh обрабатывает их следующим образом:

• customers/redact: Когда покупатель просит магазин удалить его данные, Pushwoosh удаляет соответствующие записи Pushwoosh по тем идентификаторам, которые отправляет Shopify — email, телефон и ID клиента Shopify.
• customers/data_request: Когда покупатель запрашивает копию своих данных, Pushwoosh отправляет уведомление во внутренний канал поддержки, и человек обрабатывает запрос вручную. Shopify требует, чтобы приложения отвечали на такие запросы в течение 30 дней.
• shop/redact: Shopify отправляет это через 48 часов после того, как магазин удаляет приложение, с просьбой удалить данные магазина. Pushwoosh намеренно не имеет отдельного обработчика для этого — удаление уже удаляет всю запись об интеграции магазина (включая ключ API устройства, код приложения и идентификаторы биллинга), поэтому к моменту поступления этого веб-хука ему уже нечего удалять.

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

Сценарий	Используемый инструмент
Персонализированное сообщение	Уведомление по клиенту
Напоминание о брошенной корзине	Shopify Flow + действие Pushwoosh
Акция на основе сегмента	Уведомление по сегменту
Приветственное сообщение после регистрации	Flow + отслеживание метаполей
Подписка на пуши	Встраиваемый элемент темы + переключатель Push Init
Атрибуция дохода и RFM-сегментация	События заказов/оформления покупок, сопоставленные с событиями конверсии
Анализ прерываний при оформлении заказа	События PW_CheckoutContactInfo / PW_PaymentInfoSubmitted
Сегменты по брошенным просмотрам или корзинам	События просмотра товаров / добавления в корзину на витрине