Интеграция с Shopify
Обзор интеграции
Anchor link toPushwoosh легко интегрируется с Shopify, ведущей платформой для электронной коммерции, которая позволяет компаниям создавать, управлять и масштабировать интернет-магазины. Это руководство проведет вас через установку и настройку приложения Pushwoosh в вашем магазине Shopify, настройку идентификации пользователей, а также использование уведомлений и инструментов автоматизации для взаимодействия с клиентами по таким каналам, как push-уведомления, email, SMS и WhatsApp.
Тип интеграции
Anchor link to- Назначение: Shopify отправляет данные клиентов в Pushwoosh, где они используются для таргетинга и обмена сообщениями.
Предварительные требования
Anchor link to- Аккаунт Pushwoosh
- Доступ к вашей панели администратора Shopify
- Токен доступа к Device API и код приложения Pushwoosh
- Магазин Shopify с доступными данными о клиентах и заказах
- Одобрение области доступа
read_ordersдля событий заказов/корзин, а такжеwrite_pixelsиread_customer_eventsдля отслеживания шагов оформления заказа
Синхронизируемые сущности
Anchor link to- Клиенты: Используются для назначения и идентификации User ID Pushwoosh через метаполя Shopify
- Сегменты клиентов: Используются для группового таргетинга и обмена сообщениями
- События и триггеры (например, размещенные заказы, примененные теги): Используются в Shopify Flow для автоматизации обмена сообщениями по разным каналам
- Витрина магазина: Используется для сбора подписок на веб-push через встроенные скрипты
- Фид продуктов: Фид витрины вашего магазина (
products.json) автоматически подключается к каталогу продуктов Pushwoosh при подключении приложения и автоматически отключается при его удалении. - Заказы и корзины: Серверные события от вебхуков Shopify
orders/paid,checkouts/createиcheckouts/update. См. Отслеживание заказов, корзин и шагов оформления заказа. - Поведение при просмотре витрины: Просмотры продуктов и действия по добавлению в корзину, собираемые тем же встраиваемым элементом темы, который используется для подписок на веб-push.
- Шаги оформления заказа: Введенная контактная информация и отправленная платежная информация, собираемые через Shopify Web Pixel.
Глоссарий (сопоставление названий сущностей, если они отличаются)
Anchor link to| Shopify | Pushwoosh |
|---|---|
| Customer | User ID |
orders/paid webhook | Событие PW_OrderCreated — общее для других интеграций с e-commerce (например, Magento) |
checkouts/create webhook | Событие PW_AbandonedCart — то же общее событие, также используется источником “Корзина” блока “Продукты” |
checkouts/update webhook | Событие PW_AbandonedCartUpdate — срабатывает, когда покупатель продолжает редактировать ту же корзину, перезаписывая сохраненную корзину из PW_AbandonedCart |
| Product page view | Событие PW_ProductViewed |
| Add to cart (no page reload) | Событие PW_AddToCart |
Web Pixel checkout_contact_info_submitted | Событие PW_CheckoutContactInfo |
Web Pixel payment_info_submitted | Событие PW_PaymentInfoSubmitted |
Как работает интеграция
Anchor link toPushwoosh выступает в качестве назначения для сообщений из Shopify. После интеграции Shopify отправляет данные о клиентах и их поведении в Pushwoosh, где они используются для уведомлений в реальном времени, сегментации клиентов и персонализированных сообщений по разным каналам.
Ключевые компоненты интеграции
Anchor link to-
Идентификация клиентов через метаполя Каждому клиенту Shopify присваивается уникальный User ID, который хранится в метаполе (
custom.pushwoosh_userid). Этот ID позволяет Pushwoosh распознавать и отправлять сообщения пользователям последовательно на разных платформах. -
Автоматизация на основе событий через Shopify Flow Pushwoosh предоставляет действия для Flow, которые позволяют автоматизировать обмен сообщениями (push, email, SMS, WhatsApp) на основе событий Shopify, таких как:
- Размещение нового заказа
- Применение тега к клиенту
- Брошенная корзина
-
Таргетинг на основе сегментов Сегменты клиентов из Shopify можно использовать для отправки уведомлений определенным группам по разным каналам, например, рекламных акций для новых покупателей или кампаний по реактивации для неактивных пользователей.
-
Ручная и real-time отправка сообщений Из представления клиента или сегмента в Shopify вы можете вручную запускать уведомления с помощью расширений Pushwoosh:
- Notification by Customer: Для личных сообщений или тестирования
- Notification by Segment: Для сообщений в рамках кампаний
Веб-push уведомления через встраиваемый элемент витрины
Anchor link toВключив встраиваемый элемент Pushwoosh в вашей теме Shopify, вы можете предлагать посетителям сайта подписаться на push-уведомления в браузере — мобильное приложение не требуется.
Обзор потока данных
Anchor link toДанные о клиентах и событиях Shopify ↓API Pushwoosh (через приложение) ↓User ID → Сегментация → Триггерные или ручные уведомленияЭта интеграция позволяет вам доставлять своевременные, релевантные сообщения, которые улучшают удержание пользователей, повышают конверсию и улучшают клиентский опыт — автоматически или по запросу.
Часть 1. Установка
Anchor link toВойдите в Shopify
Anchor link to- Перейдите в панель администратора Shopify
- Выберите свой магазин на панели управления
Установите приложение Pushwoosh
Anchor link to- Посетите страницу приложения Pushwoosh в App Store
- Нажмите Install

- Подтвердите установку в диалоговом окне Shopify

Подключите ваше приложение Pushwoosh
Anchor link toПосле установки вы будете перенаправлены в приложение Pushwoosh внутри Shopify.
- Нажмите Connect.

- Введите код приложения и API-ключ, которые можно найти в панели управления Pushwoosh → Settings → API Access. API-ключ здесь — это ваш токен доступа к Device API.

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

Когда Shopify запросит разрешения (на заказы, пиксели, события клиентов), одобрите их. Эти области доступа необходимы для отслеживания в Части 5. Если вы подключили приложение ранее, см. Уже подключены? Вам будет предложено повторно одобрить доступ.
Подпишитесь на тарифный план
Anchor link to- Нажмите Upgrade Subscription
- Будет показан единый тарифный план на основе использования.
- Подтвердите оплату.

Часть 2. Настройка: User ID клиента через метаполя
Anchor link toДля доставки уведомлений идентифицированным пользователям по разным каналам (push, email, SMS, WhatsApp) Pushwoosh использует уникальный User ID для каждого клиента. Shopify хранит это значение в метаполях клиента Shopify.
- Перейдите в Settings → Metafields and metaobjects → Customers

- Нажмите 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 |

Установите Customer accounts access и Storefront API access, как указано в таблице выше.

Часть 3. Использование расширений Pushwoosh
Anchor link toPushwoosh включает расширения Shopify для таргетинга на сегменты, автоматизации (Flow) и уведомлений для конкретных клиентов.
Расширение 1. Отправить уведомление по клиенту
Anchor link toСценарий использования
Anchor link toОтправка персонализированных сообщений вручную или тестирование уведомлений для конкретного пользователя.
Шаги
Anchor link to- Откройте Customers → Выберите клиента
- Нажмите More actions → Notification by customer

- Выберите платформу для обмена сообщениями (например, Email) и пресет контента.

- Нажмите Send
Расширение 2. Уведомление по сегменту
Anchor link toСценарий использования
Anchor link toТаргетинг на группы клиентов — брошенные корзины, новые покупатели, клиенты с высокими тратами.
Шаги
Anchor link to-
Перейдите в Customers → Segments
-
Выберите сегмент → Нажмите Use Segment

- Выберите Notification by Segment

- Выберите желаемый канал связи и пресет сообщения. Нажмите Send.

Расширение 3. Pushwoosh в Shopify Flow
Anchor link toСценарий использования
Anchor link toАвтоматизация обмена сообщениями в клиентских путях с использованием триггеров, таких как заказы, теги или поведение.
Шаги
Anchor link to- Создайте новый Flow в Shopify Flow
- Добавьте действие → Выберите Pushwoosh send notification

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

Например:
-
Отправить сообщение после размещения заказа
-
Напомнить пользователю о брошенной корзине
-
Отправить push-уведомление для реактивации через 30 дней неактивности
Часть 4. Включение веб-push (и событий просмотра витрины)
Anchor link toНеобязательно только для веб-push. Обязательно, если вам нужны события просмотра продукта и добавления в корзину в Части 5.
Включите встраиваемый элемент темы для веб-push в браузере на вашей витрине:
- Перейдите в Online Store → Themes → Customize

- Откройте App Embeds в левом меню
- Включите Push Init Embed

Часть 5. Отслеживание заказов, корзин и шагов оформления заказа
Anchor link toПосле того как вы подключите приложение и одобрите запрошенные Shopify разрешения на отслеживание заказов, корзин и оформления заказа (read_orders, write_pixels, read_customer_events), события заказов, оформления заказа и шагов оформления заказа начнут поступать без отдельного экрана отслеживания в Pushwoosh. См. Предварительные требования и Часть 1 для шага одобрения. Для просмотра витрины (просмотры продуктов и добавление в корзину) также необходимо включить Push Init Embed.
Отслеживание охватывает три независимые группы событий. Каждая требует разного доступа, поэтому отключение одной не приостанавливает другие:
- Оплаченный заказ и оформление заказа: поступают из Shopify, даже если встраиваемый элемент темы выключен
- Просмотр витрины (просмотры продуктов и добавление в корзину): требуют включения встраиваемого элемента темы
- Шаги оформления заказа: требуют разрешений Shopify на отслеживание оформления заказа из Части 1 (
write_pixelsиread_customer_events), которые одобряются отдельно от разрешения на отслеживание заказов (read_orders) выше
Прежде чем подключать приложение, проверьте, как Pushwoosh обрабатывает типы атрибутов денег и дат для PW_OrderCreated и PW_AbandonedCart. Неправильный тип, отправленный до того, как вы его заметите, нельзя исправить задним числом.
События оплаченного заказа и оформления заказа
Anchor link toИспользуйте их для сообщений после покупки (PW_OrderCreated), путей или сегментов для брошенных корзин (PW_AbandonedCart / PW_AbandonedCartUpdate) и сопоставления конверсий покупок. Они поступают из Shopify, даже если покупатель блокирует отслеживание в браузере:
| Название события в Pushwoosh | Когда срабатывает |
|---|---|
PW_OrderCreated | Заказ оплачен |
PW_AbandonedCart | Покупатель начинает оформление заказа |
PW_AbandonedCartUpdate | Покупатель добавляет, удаляет или изменяет товары во время существующего оформления заказа |
Они соответствуют уведомлениям о заказах и оформлении заказа, которые Shopify автоматически отправляет в Pushwoosh (вебхуки orders/paid, checkouts/create и checkouts/update, перечисленные в разделе Синхронизируемые сущности).
Собственное условие Flow от Shopify, вебхук checkouts/create и источник “Корзина” блока “Продукты” — это три разные вещи, которые все называются брошенной корзиной. Выберите то, что соответствует тому, что вы создаете, используя таблицу ниже.
| Что вы хотите создать | Что использовать |
|---|---|
| Напоминание из Shopify Flow (собственное условие Shopify Cart abandonment) | Shopify Flow + действие Pushwoosh send notification. Не имена событий PW_AbandonedCart. |
| Напоминание или сегмент в Pushwoosh при начале оформления заказа или изменении корзины | Customer Journey или сегмент по PW_AbandonedCart / PW_AbandonedCartUpdate |
| Показать товары из корзины покупателя в email | Блок “Продукты”, источник “Корзина” (использует тег PW_AbandonedCartID во время отправки). Отдельно от того, какой триггер запустил путь. |
Как ведут себя эти события. checkouts/create означает только, что оформление заказа было начато. Shopify еще не решил, что оно брошено, и заказ также не был подтвержден.
Пока покупатель редактирует оформление заказа, PW_AbandonedCartUpdate срабатывает снова для того же оформления и перезаписывает корзину, сохраненную из PW_AbandonedCart. Напоминания в email, использующие источник “Корзина”, подхватывают последние товары во время отправки. Вам не нужен второй триггер пути только для обновления корзины.
PW_AbandonedCart и PW_AbandonedCartUpdate устанавливают тег PW_AbandonedCartID на покупателя, который считывается источником “Корзина” во время отправки. PW_OrderCreated немедленно его очищает, поэтому покупатель, который уже оформил заказ, пропускает блок, вместо того чтобы получать напоминание о корзине, которой у него больше нет. См. Что происходит, когда вы отправляете PW_OrderCreated для точного поведения очистки.
Атрибуты событий заказа и оформления заказа
Anchor link toPW_OrderCreated и PW_AbandonedCart включают:
| Атрибут | Описание |
|---|---|
orderId | Идентификатор заказа или оформления заказа |
email | Email покупателя |
totalPrice | Общая сумма заказа или корзины |
shippingAmount | Стоимость доставки |
taxAmount | Сумма налога |
discountAmount | Сумма скидки |
currency | Код валюты |
items | Позиции в корзине |
customerId | Только для зарегистрированных клиентов, отсутствует при гостевом оформлении заказа |
orderUrl | Страница статуса заказа для PW_OrderCreated или URL для восстановления брошенной корзины для PW_AbandonedCart и PW_AbandonedCartUpdate. Используйте его для создания ссылки или кнопки “Завершить покупку”. |
createdDate | Когда был создан заказ или оформление заказа |
abandonedDate | Только для PW_AbandonedCart и PW_AbandonedCartUpdate. Когда корзина была последний раз изменена, а не когда она была впервые создана |
Гостевые оформления заказов все еще могут отправлять события заказов и корзин, но без ID зарегистрированного клиента в событии.
PW_AbandonedCartUpdate несет те же атрибуты. Если в вашем аккаунте также подключена интеграция с Magento, его заказы и брошенные корзины отправляются на те же имена событий, поэтому сегмент или путь, построенный на PW_OrderCreated / PW_AbandonedCart, будет отлавливать оба магазина, и типы атрибутов выше применяются к обоим. У Magento нет эквивалента PW_AbandonedCartUpdate, потому что он не отслеживает изменения в процессе оформления заказа.
items, в частности, поступает из Shopify только с несколькими заполненными полями.
События просмотра витрины
Anchor link toИспользуйте их для сегментов или путей по брошенным просмотрам, а также для стратегий рекомендаций в email, которым нужны просмотры продуктов (например, На основе того, что они просматривали). См. Как настроить рекомендации продуктов в email.
Оба события собираются одним и тем же встраиваемым элементом темы. Ничего больше в тему добавлять не нужно, как только Push Init Embed будет включен:
PW_ProductViewed: покупатель открывает страницу продукта.PW_AddToCart: покупатель добавляет товар в корзину без перезагрузки страницы, как это делают большинство тем Shopify.
Атрибуты событий просмотра витрины
Anchor link toОба события включают:
| Атрибут | Описание |
|---|---|
items | Просмотренные или добавленные продукты, каждый с productId, name, sku, quantity, price |
totalPrice | Общая цена items |
productUrl | Страница, на которой находился покупатель |
currency | Только когда витрина предоставляет эту информацию |
Сообщение, которое показывает totalPrice, нуждается в запасном варианте на случай отсутствия currency, так как само по себе число не говорит, в какой оно валюте.
Ни одно из событий не несет email или customerId в качестве атрибута. Покупатель идентифицируется так же, как и остальная часть встраиваемого элемента темы, через сессию SDK, связанную с User ID метаполя (см. Часть 2), а не через полезную нагрузку события.
items в PW_ProductViewed и PW_AddToCart несут те же поля, которые Shopify отправляет до обогащения: productId, name, sku, quantity, price. Pushwoosh не заполняет остальные поля каталога для этих двух событий, как это делает для items в PW_AbandonedCart (см. Товары в корзине обогащаются из вашего каталога продуктов выше).
Стратегия рекомендаций, которой нужны полные данные о продукте, например На основе того, что они просматривали, ищет их в вашем каталоге продуктов по productId при рендеринге сообщения. См. Как настроить рекомендации продуктов в email для того, что нужно каждой стратегии.
События шагов оформления заказа
Anchor link toИспользуйте их, чтобы увидеть, где люди уходят до покупки, и чтобы отправлять сообщения людям, которые начали оформление заказа, но не дошли до оплаченного заказа.
PW_CheckoutContactInfo: покупатель ввел свою контактную информацию.PW_PaymentInfoSubmitted: покупатель отправил свои платежные данные.
Завершенная продажа — это PW_OrderCreated из раздела выше, а не эти два события.
PW_AbandonedCart только говорит вам, что оформление заказа началось. Эти два события отмечают две более поздние точки в том же оформлении заказа, в таком порядке: сначала контактная информация, затем платежные данные. Покупатель, который дошел до PW_PaymentInfoSubmitted и так и не получил последующего PW_OrderCreated, продвинулся дальше, чем тот, кто только вызвал PW_AbandonedCart, поэтому сообщение, построенное на этом этапе, может конкретно обращаться к застрявшему платежу, а не к общему напоминанию о корзине.
Атрибуты событий шагов оформления заказа
Anchor link toОба события включают:
| Атрибут | Описание |
|---|---|
items | Позиции в оформлении заказа, каждая с productId, name, sku, quantity, price |
orderId | Токен оформления заказа или ID заказа Shopify, как только у оформления заказа он появится |
totalPrice | Общая сумма оформления заказа |
email | Только когда у оформления заказа он есть. Оформление заказа по телефону (без ввода email) отправляет событие без него. |
currency | Только когда у оформления заказа он есть |
Проверьте, что это работает
Anchor link toВыполните соответствующее действие в магазине, затем убедитесь, что имя события появилось в Pushwoosh. Само событие обрабатывается в реальном времени, но два места, где вы бы его проверили, реагируют по-разному на имя, которое Pushwoosh раньше не видел:
- В выпадающем списке Event при создании сегмента по событиям новое имя появляется сразу.
- В выпадающем списке Event при добавлении триггера Customer Journey новое имя может появиться с задержкой до 10 минут (этот список кэшируется). Если вы его еще не видите, подождите, а не думайте, что интеграция сломана.
| Тестовое действие | Событие |
|---|---|
| Оплатить тестовый заказ | PW_OrderCreated |
| Начать оформление заказа | PW_AbandonedCart |
| Изменить товары в этом оформлении заказа | PW_AbandonedCartUpdate |
| Открыть страницу продукта (Push Init Embed включен) | PW_ProductViewed |
| Добавить товар в корзину | PW_AddToCart |
| Ввести контактную информацию при оформлении заказа | PW_CheckoutContactInfo |
| Отправить платежную информацию при оформлении заказа | PW_PaymentInfoSubmitted |
Используйте события
Anchor link toПосле того как вы узнаете, какое событие вам нужно, используйте его в двух местах:
- В качестве триггера или условия сегмента: выберите его в выпадающем списке Event при создании сегмента по событиям или добавлении триггера Customer Journey.
- В тексте сообщения: на шаге сообщения включите Personalize message with event attributes и выберите атрибут (например, общую сумму заказа из
PW_OrderCreated). Вы также можете вставить атрибут с помощью плейсхолдера Liquid. См. Динамический контент и шаблоны Liquid в путях.
Для оплаченных заказов вы также можете сопоставить PW_OrderCreated как событие конверсии, чтобы покупки в Shopify питали RFM-сегментацию, атрибуцию путей и статистику блока “Продукты”.
Примеры кампаний
Anchor link toКаждая из них срабатывает в разный момент пути покупателя, поэтому они охватывают разные аудитории: насколько далеко кто-то зашел, прежде чем уйти, или дошел ли он вообще до оформления заказа, решает, какая из них применима.
- Напоминание о брошенной корзине. Охватывает каждого покупателя, который начал оформление заказа, независимо от того, как далеко он зашел: самая широкая аудитория здесь. Создайте это как Customer Journey: триггер на
PW_AbandonedCart, подождитеPW_OrderCreated, затем отправьте email с блоком источника “Корзина” тем, кто не оплатил. См. Как настроить кампанию по брошенным корзинам для полной настройки. - Сообщение для застрявших оформлений заказа. Охватывает только покупателей, которые дошли до ввода контактной информации, но так и не оплатили, более узкий срез аудитории выше. Сегментируйте по
PW_CheckoutContactInfo, затем исключите всех, у кого также естьPW_PaymentInfoSubmittedилиPW_OrderCreated. - Восстановление для застрявшего платежа. Охватывает покупателей, которые дошли до оплаты, но так и не завершили заказ, дальше, чем предыдущее сообщение, и взаимоисключающее с ним. Сегментируйте по
PW_PaymentInfoSubmitted, затем исключите всех, у кого также естьPW_OrderCreated. - Email с рекомендациями по просмотрам. Охватывает покупателей, которые смотрели товары, но так и не начали оформление заказа, другая аудитория по сравнению с напоминаниями выше. Используйте
PW_ProductViewedсо стратегией блока “Продукты” На основе того, что они просматривали. См. Как настроить рекомендации продуктов в email.
Часть 6. Соответствие данных
Anchor link toShopify требует, чтобы каждое публичное приложение отвечало на его обязательные вебхуки GDPR/CCPA. Pushwoosh обрабатывает их следующим образом:
customers/redact: Когда покупатель просит магазин удалить его данные, Pushwoosh удаляет соответствующие записи Pushwoosh по тем идентификаторам, которые отправляет Shopify — email, телефон и ID клиента Shopify.customers/data_request: Когда покупатель запрашивает копию своих данных, Pushwoosh отправляет уведомление во внутренний канал поддержки, и человек обрабатывает запрос вручную. Shopify требует, чтобы приложения отвечали на них в течение 30 дней.shop/redact: Shopify отправляет это через 48 часов после того, как магазин удаляет приложение, с просьбой удалить данные магазина. Pushwoosh повторно запускает то же удаление, которое вызывает само удаление, очищая любую оставшуюся сессию и удаляя запись об интеграции магазина (включая ключ API устройства, код приложения и ID для биллинга). Это существует как страховка на случай, если удаление не полностью очистило все с первого раза.
Краткий обзор сценариев использования
Anchor link toДалее используйте имена событий выше в путях, сегментах или сопоставлении конверсий. Примеры:
| Сценарий | Используемый инструмент |
|---|---|
| Персонализированное сообщение | Notification by Customer |
| Напоминание о брошенной корзине | Shopify Flow + действие Pushwoosh, или Journey/сегмент по PW_AbandonedCart / PW_AbandonedCartUpdate (см. Часть 5) |
| Акция на основе сегмента | Notification by Segment |
| Приветственное сообщение после регистрации | Flow + отслеживание метаполей |
| Подписка на push-уведомления | Theme Embed + Push Init Toggle |
| Атрибуция дохода и RFM-сегментация | События заказов/оформления заказа, сопоставленные с событиями конверсии |
| Анализ отказов при оформлении заказа | События PW_CheckoutContactInfo / PW_PaymentInfoSubmitted |
| Сегменты по брошенным просмотрам или корзинам | События просмотра продуктов / добавления в корзину на витрине |