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

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

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

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

Destination: Эта интеграция передает данные из вашего магазина Magento в Pushwoosh.

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

Прежде чем продолжить, убедитесь в следующем:

Доступ к панели администратора Magento
Действующий аккаунт Pushwoosh
Ваш ключ доступа к API Pushwoosh и код приложения
Composer, установленный на вашем сервере Magento
Соответствие системным требованиям:
- PHP 7.4 / 8.x
- Magento 2.3 / 2.4
- Elasticsearch 7
- RabbitMQ

Глоссарий

Сопоставление названий сущностей, если они различаются:

Magento	Pushwoosh
Customer	User

Список синхронизируемых сущностей:

Клиенты
Заказы
Брошенные корзины

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

Отправляйте push-уведомления на основе событий создания заказа и брошенной корзины.
Сегментируйте клиентов по атрибутам (например, местоположению, дню рождения) и отправляйте таргетированные кампании.
Отправляйте рекламные уведомления в браузеры.

Настройка интеграции

Установка

Выполните следующую команду Composer в корневом каталоге вашего проекта Magento:

composer require pushwoosh/magento2-integration

После установки пакета выполните настройку Magento для установки модуля:

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:clean

Конфигурация после установки

После завершения установки:

Войдите в панель администратора Magento.
Перейдите в Stores > Configuration > Pushwoosh > Configuration.

Общие настройки

В разделе General настройте следующие поля:

Status: Установите значение Enable, чтобы активировать интеграцию.
API URL: Введите эндпоинт API Pushwoosh: https://api.pushwoosh.com/
API Key: Вставьте ваш ключ API Pushwoosh, необходимый для аутентификации запросов. Узнайте больше о ключе доступа API Pushwoosh
App Code: Введите код приложения Pushwoosh, соответствующий вашему мобильному или веб-приложению.

Ниже приведены опции конфигурации, доступные для синхронизации клиентов, заказов и брошенных корзин.

Конфигурация синхронизации заказов

Определите, как данные о заказах синхронизируются между вашим магазином Magento и Pushwoosh.

Заполните следующие поля:


Order Sync Enable	Установите Yes, чтобы включить автоматическую синхронизацию заказов. Если опция включена, процесс будет следовать определённому расписанию cron. Установите No, чтобы отключить автоматическую синхронизацию.
Cron Settings	Доступно только если синхронизация заказов включена. Определите, когда должна запускаться задача cron, используя следующие поля: `Minute`, `Hour`, `Day`, `Month`, `Weekday`. Cron — это планировщик задач, основанный на времени, который используется для автоматического выполнения задач через заданные интервалы.
Order Sync Numbers	Укажите, сколько заказов обрабатывать при каждом запуске синхронизации.
Order Sync in Real Time	Установите Yes для немедленной синхронизации заказов после их размещения.

Здесь вы также можете увидеть статус синхронизации заказов:

Total Orders: Отображает общее количество заказов, оцененных для синхронизации.
Synced Orders: Количество заказов, успешно синхронизированных с Pushwoosh.
Not Synced Orders: Заказы, которые еще не были синхронизированы.
Fail Synced Orders: Заказы, для которых попытки синхронизации завершились неудачно.

Конфигурация синхронизации брошенных корзин

Настройте синхронизацию данных о брошенных корзинах между вашим магазином Magento и Pushwoosh.

Заполните следующие поля:


Abandoned Cart Syncing	Установите Yes, чтобы включить автоматическую синхронизацию данных о брошенных корзинах. Если опция включена, синхронизация будет выполняться в соответствии с заданным расписанием cron.
Cron Schedule Configuration	Определите, когда должна запускаться синхронизация, используя следующие поля: `Minute`, `Hour`, `Day`, `Month`, `Weekday`. Cron — это планировщик задач, основанный на времени, который используется для автоматического выполнения задач через заданные интервалы.
Number of Abandoned Cart	Укажите, сколько брошенных корзин будет обрабатываться при каждом запуске синхронизации.
Minimum Inactivity Time	Установите минимальное время неактивности (в минутах), по истечении которого корзина будет считаться брошенной. Например, значение `60` означает, что корзины, неактивные в течение как минимум 60 минут, будут подлежать синхронизации.

Здесь вы также можете видеть метрики активности синхронизации в реальном времени:

Total Abandoned Carts: Общее количество корзин, идентифицированных как брошенные.
Synced Abandoned Carts: Количество корзин, успешно синхронизированных с Pushwoosh.
Not Synced Abandoned Carts: Количество корзин, которые еще не были синхронизированы.
Fail Synced Abandoned Carts: Количество корзин, синхронизация которых не удалась.

Конфигурация синхронизации клиентов

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

Заполните следующие поля:


Customer Syncing	Установите Yes, чтобы включить синхронизацию всех существующих и новых записей о клиентах. Синхронизация будет следовать заданному расписанию cron и использовать указанные сопоставления атрибутов.
Cron Schedule Configuration	Определите, когда должна запускаться синхронизация, используя следующие поля: `Minute`, `Hour`, `Day`, `Month`, `Weekday`. Cron — это планировщик задач, основанный на времени, который используется для автоматического выполнения задач через заданные интервалы.
Mapping Customer Custom Fields	Сопоставьте атрибуты клиентов Magento с кастомными полями Pushwoosh для точной передачи данных. Примеры: `Date of Birth → Birthday`, `First Name → firstName`
Number of Customers	Установите максимальное количество клиентов для синхронизации за один запуск cron.

Здесь вы также можете увидеть статистику синхронизации:

Total Customer: Общее количество записей о клиентах, определённых для синхронизации.
Synced Customer: Количество клиентов, успешно синхронизированных с Pushwoosh.
Not Synced Customer: Клиенты, ожидающие синхронизации.
Fail Synced Customer: Клиенты, которых не удалось синхронизировать из-за ошибок.

Конфигурация веб-уведомлений

Установите Yes, чтобы включить веб push-уведомления для посетителей вашего магазина. Установите No, чтобы отключить эту функциональность.

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

Сохранение конфигурации

После заполнения всех обязательных полей нажмите кнопку Save Config в правом верхнем углу. Очистите кеш Magento, если будет предложено, чтобы применить изменения.

Опции ручной синхронизации

Синхронизация выбранных клиентов с Pushwoosh

Если вы предпочитаете не синхронизировать всех клиентов автоматически, вы можете вручную синхронизировать отдельных или выбранных клиентов.

В панели администратора Magento перейдите в Customers > All Customers.
Найдите и выберите клиента(ов), которого(ых) вы хотите синхронизировать.
В выпадающем меню Actions над списком клиентов выберите Sync to Pushwoosh.

После завершения синхронизации данные клиента появятся в разделе User Explorer вашего аккаунта Pushwoosh со всей соответствующей информацией, переданной из Magento.

Синхронизация выбранных заказов с Pushwoosh

Если вы предпочитаете не синхронизировать все заказы автоматически, вы можете вручную синхронизировать определённые заказы. Для этого:

В панели администратора Magento перейдите в Sales > Orders.
Выберите один или несколько заказов из списка.
В выпадающем меню Actions выберите Sync to Pushwoosh.

После синхронизации заказ появится в разделе Events профиля пользователя в User Explorer Pushwoosh как событие PW_OrderCreated или PW_OrderUpdated (если статус заказа изменился), включая подробную информацию о заказе.

Синхронизация выбранных брошенных корзин

Чтобы вручную синхронизировать выбранные брошенные корзины:

В панели администратора Magento перейдите в раздел Abandoned Carts.
Выберите корзину, которую вы хотите синхронизировать.
В выпадающем меню Actions выберите Sync to Pushwoosh.

Примечание: Убедитесь, что вы настроили необходимый период неактивности в настройках Abandoned Cart Sync, чтобы определить, когда корзина считается брошенной.

После синхронизации данные о брошенной корзине появятся в разделе Events профиля пользователя в User Explorer Pushwoosh как событие PW_AbandonedCart с подробной информацией.

Кроме того, в профиле пользователя будут установлены два тега:

Abandoned Cart Date → PW_AbandonedCartDate
Abandoned Cart ID → PW_AbandonedCartID

Эти теги можно использовать для отправки напоминаний о брошенной корзине, используя связанный контент в ваших email-шаблонах. Узнать больше

Проверка работы интеграции

Чтобы убедиться, что интеграция работает корректно:

Создайте тестового клиента в Magento.
Вручную синхронизируйте клиента с Pushwoosh.
Откройте User Explorer на вашей панели управления Pushwoosh и найдите этого клиента.

Если клиент появится в User Explorer, это означает, что синхронизация прошла успешно.