Перейти к содержанию

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

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

Anchor link to

Pushwoosh легко интегрируется с 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
CustomerUser 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 to

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

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

Anchor link to
  1. Идентификация клиентов через метаполя Каждому клиенту Shopify присваивается уникальный User ID, который хранится в метаполе (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: Для сообщений в рамках кампаний

Веб-push уведомления через встраиваемый элемент витрины

Anchor link to

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

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

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

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

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

Anchor link to

Войдите в Shopify

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

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

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

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

Anchor link to

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

  1. Нажмите Connect.

Нажмите кнопку Connect

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

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

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

Приложение Pushwoosh подключено

Когда Shopify запросит разрешения (на заказы, пиксели, события клиентов), одобрите их. Эти области доступа необходимы для отслеживания в Части 5. Если вы подключили приложение ранее, см. Уже подключены? Вам будет предложено повторно одобрить доступ.

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

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

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

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

Anchor link to

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

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

Добавить определение

  1. Нажмите Add definition и используйте следующие значения:
ПолеЗначение
Namespace and keycustom.pushwoosh_userid
Namespacecustom
TypeSingle line text
ValidationNone
Customer Account AccessRead and Write
Storefront API AccessEnabled

Добавить определение

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

Добавить определение

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

Anchor link to

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

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

Anchor link to

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

Anchor link to

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

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

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

Anchor link to

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

Anchor link to

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

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

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

Использовать сегмент

  1. Выберите Notification by Segment Уведомление по сегменту
  2. Выберите желаемый канал связи и пресет сообщения. Нажмите Send. Заполните форму сообщения

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

Anchor link to

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

Anchor link to

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

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

Действие потока Pushwoosh

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

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

Например:

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

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

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

Часть 4. Включение веб-push (и событий просмотра витрины)

Anchor link to

Необязательно только для веб-push. Обязательно, если вам нужны события просмотра продукта и добавления в корзину в Части 5.

Включите встраиваемый элемент темы для веб-push в браузере на вашей витрине:

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

Включите 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 to

PW_OrderCreated и PW_AbandonedCart включают:

АтрибутОписание
orderIdИдентификатор заказа или оформления заказа
emailEmail покупателя
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

После того как вы узнаете, какое событие вам нужно, используйте его в двух местах:

Для оплаченных заказов вы также можете сопоставить 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 to

Shopify требует, чтобы каждое публичное приложение отвечало на его обязательные вебхуки 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
Сегменты по брошенным просмотрам или корзинамСобытия просмотра продуктов / добавления в корзину на витрине