Настройка Shopify

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

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

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

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

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

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

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

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

Синхронизируемые сущности

• Клиенты: используются для присвоения и идентификации User ID 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 через встроенные скрипты
• Фид товаров: фид витрины вашего магазина (products.json) автоматически подключается к Каталогу товаров Pushwoosh при подключении приложения и автоматически отключается при его удалении.
• Заказы и корзины: события сервер-сервер из вебхуков Shopify orders/paid, checkouts/create и checkouts/update. См. События и кампании Shopify.
• Поведение просмотра на витрине: просмотры товаров и действия по добавлению в корзину, собираемые тем же встроенным кодом темы, который используется для подписки на web push.
• Шаги оформления заказа: введённые контактные данные и отправленные платёжные данные, собираемые через Shopify Web Pixel.

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

Shopify	Pushwoosh
Customer	User ID
Вебхук orders/paid	Событие PW_OrderCreated — общее с другими интеграциями электронной коммерции (например, Magento)
Вебхук checkouts/create	Событие PW_AbandonedCart — то же общее событие, также используется источником Cart блока Products
Вебхук checkouts/update	Событие PW_AbandonedCartUpdate — срабатывает, пока покупатель продолжает редактировать то же оформление заказа, перезаписывая сохранённую корзину из PW_AbandonedCart
Просмотр страницы товара	Событие PW_ProductViewed
Добавление в корзину (без перезагрузки страницы)	Событие PW_AddToCart
Web Pixel checkout_contact_info_submitted	Событие PW_CheckoutContactInfo
Web Pixel payment_info_submitted	Событие PW_PaymentInfoSubmitted

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

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

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

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

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

   • Оформлен новый заказ
   • К клиенту применён тег
   • Брошена корзина

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

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

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

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

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

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

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

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

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

Войдите в Shopify

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

Примечание

Это руководство предполагает, что у вас уже есть аккаунт Pushwoosh. Если нет, создайте его

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

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

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

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

1. Нажмите Connect.

2. Введите Application Code и API Key, которые можно найти в Pushwoosh Control Panel → Settings → API Access. API Key здесь — это ваш токен доступа к Device API.

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

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

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

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

Оформите подписку на тариф

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 и укажите следующие значения:

Поле	Значение
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

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

Расширение 1. Send notification by customer

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

Вручную отправить персонализированное сообщение или тестовое уведомление конкретному пользователю.

Шаги

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

Совет

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

Расширение 2. Notification by segment

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

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

Шаги

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

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

3. Выберите Notification by Segment
4. Выберите нужный канал связи и пресет сообщения. Нажмите Send.

Совет

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

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

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

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

Шаги

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

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

Например:

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

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

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

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

Необязательно, если нужен только web push. Обязательно, если вам нужны события просмотра товара и добавления в корзину в Событиях и кампаниях Shopify.

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

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

Примечание

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

Соответствие требованиям по защите данных

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

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

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

После настройки — распространённые способы отправки сообщений из Shopify:

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

О путях и сегментах по событиям заказа, корзины, оформления заказа и витрины см. События и кампании Shopify.