# Интеграция с Shopify
## Обзор интеграции
Pushwoosh легко интегрируется с Shopify, ведущей платформой для электронной коммерции, которая позволяет компаниям создавать, управлять и масштабировать интернет-магазины. В этом руководстве мы расскажем, как установить и настроить приложение Pushwoosh в вашем магазине Shopify, настроить идентификацию пользователей и использовать уведомления и инструменты автоматизации для взаимодействия с клиентами по таким каналам, как push-уведомления, email, SMS и WhatsApp.
### Тип интеграции
- **Назначение**: Shopify отправляет данные о клиентах в Pushwoosh, где они используются для таргетинга и отправки сообщений.
### Предварительные требования
* [Аккаунт Pushwoosh](https://www.pushwoosh.com/)
* Доступ к вашей панели администратора Shopify
* [Токен доступа Device API](/ru/developer/api-reference/api-access-token/#device-api-token) и **код приложения** Pushwoosh
* Магазин Shopify с доступными данными о клиентах и заказах
### Синхронизируемые сущности
* **Клиенты**: Используются для присвоения и идентификации UserID в Pushwoosh через метаполя Shopify
* **Сегменты клиентов**: Используются для таргетинга и отправки сообщений на основе групп
* **События и триггеры** (например, размещенные заказы, примененные теги): Используются в Shopify Flow для автоматизации отправки сообщений по разным каналам
* **Витрина магазина**: Используется для сбора подписок на web push-уведомления через встроенные скрипты
### Глоссарий (сопоставление названий сущностей, если они различаются)
| **Shopify** | **Pushwoosh** |
| -------------------------- | --------------------------------------------------------- |
| Customer | UserID |
## Как работает интеграция
Pushwoosh выступает в качестве места назначения для сообщений из Shopify. После интеграции Shopify отправляет данные о клиентах и их поведении в Pushwoosh, где они используются для уведомлений в реальном времени, сегментации клиентов и персонализированных сообщений по разным каналам.
### Ключевые компоненты интеграции
1. **Идентификация клиентов через метаполя**
Каждому клиенту Shopify присваивается уникальный `UserID`, который хранится в метаполе (`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**: Для сообщений в рамках кампаний
### Web push-уведомления через встраивание в витрину
Включив встраивание Pushwoosh в вашу тему Shopify, вы можете предлагать посетителям сайта подписаться на push-уведомления в браузере — мобильное приложение не требуется.
#### Обзор потока данных
```
Данные о клиентах и событиях Shopify
↓
Pushwoosh API (через приложение)
↓
UserID → Сегментация → Триггерные или ручные уведомления
```
Эта интеграция позволяет вам доставлять своевременные, релевантные сообщения, которые улучшают удержание пользователей, повышают конверсию и улучшают клиентский опыт — автоматически или по запросу.
## Часть 1. Установка
### Войдите в Shopify
1. Перейдите в [панель администратора Shopify](https://admin.shopify.com/)
2. Выберите свой магазин на панели управления
### Установите приложение Pushwoosh
1. Посетите [страницу приложения Pushwoosh в App Store](https://apps.shopify.com/pushwoosh-notifications)
2. Нажмите **Install**
3. Подтвердите установку в диалоговом окне Shopify
### Подключите ваше приложение Pushwoosh
После установки вы будете перенаправлены в приложение Pushwoosh внутри Shopify.
1. Нажмите **Connect**.
2. Введите **код приложения** и [токен доступа Device API](/ru/developer/api-reference/api-access-token/#device-api-token), которые можно найти в **Pushwoosh Control Panel → Settings → API Access**.
После подключения появится сообщение об успехе: "Pushwoosh app connected."
### Подпишитесь на тарифный план
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** и используйте следующие значения:
| Поле | Значение |
| ----------------------- | ------------------------ |
| Пространство имен и ключ | custom.pushwoosh_userid |
| Пространство имен | custom |
| Тип | Однострочный текст |
| Проверка | Нет |
| Доступ к учетной записи клиента | Чтение и запись |
| Доступ к Storefront API | Включен |
## Часть 3. Использование расширений Pushwoosh
Pushwoosh включает расширения Shopify для таргетинга на сегменты, автоматизации (Flow) и уведомлений для конкретных клиентов.
### Расширение 1. Отправка уведомления по клиенту
#### Сценарий использования
Отправка персонализированных сообщений вручную или тестирование уведомлений для конкретного пользователя.
#### Шаги
1. Откройте **Customers → Выберите клиента**
2. Нажмите **More actions → Notification by customer**
3. Выберите платформу для отправки сообщений (например, Email) и [пресет контента](/ru/product/content/push-presets/).
4. Нажмите **Send**
### Расширение 2. Уведомление по сегменту
#### Сценарий использования
Таргетинг на группы клиентов — брошенные корзины, новые покупатели, клиенты с высокими расходами.
#### Шаги
1. Перейдите в **Customers → Segments**
2. Выберите сегмент → Нажмите **Use Segment**
3. Выберите **Notification by Segment**
4. Выберите желаемый канал связи и пресет сообщения. Нажмите **Send**.
### Расширение 3. Pushwoosh в Shopify Flow
#### Сценарий использования
Автоматизация отправки сообщений в клиентских путях с использованием триггеров, таких как заказы, теги или поведение.
#### Шаги
1. Создайте новый поток в **Shopify Flow**
2. Добавьте действие → Выберите **Pushwoosh notifications**
3. Настройте сообщение и динамические поля
Например:
* Отправить сообщение после размещения заказа
* Напомнить пользователю о брошенной корзине
* Отправить push-уведомление для реактивации через 30 дней неактивности
## Часть 4. Включение web push-уведомлений (необязательно, но рекомендуется)
Чтобы поддерживать web push-уведомления в браузере на вашей витрине, выполните следующие действия:
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 |