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

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

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

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

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

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

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

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

Глоссарий

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

Magento	Pushwoosh
Клиент	Пользователь

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

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

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

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

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

Установка

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

composer require pushwoosh/magento2-integration

После установки пакета запустите установку Magento, чтобы установить модуль:

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

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

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

Войдите в панель администратора Magento.
Перейдите в Магазины > Конфигурация > Pushwoosh > Конфигурация.

Pushwoosh Configuration in Magento Admin Panel

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

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

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

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

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

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

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


Включить синхронизацию заказов	Установите Да, чтобы включить автоматическую синхронизацию заказов. Если включено, процесс будет следовать определенному расписанию cron. Установите Нет, чтобы отключить автоматическую синхронизацию.
Настройки Cron	Доступно, только если включена синхронизация заказов. Определите, когда должна выполняться задача cron, используя следующие поля: `Минута`, `Час`, `День`, `Месяц`, `День недели`. Cron — это планировщик задач по времени, используемый для автоматического выполнения задач с заданными интервалами.
Количество заказов для синхронизации	Укажите, сколько заказов обрабатывать при каждом запуске синхронизации.
Синхронизация заказов в реальном времени	Установите Да, чтобы синхронизировать заказы сразу после их размещения.

Order sync configuration settings

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

Всего заказов: Отображает общее количество заказов, оцененных для синхронизации.
Синхронизированные заказы: Количество заказов, успешно синхронизированных с Pushwoosh.
Несинхронизированные заказы: Заказы, которые еще не были синхронизированы.
Неудачные синхронизации заказов: Заказы, для которых попытки синхронизации завершились неудачей.

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

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

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


Синхронизация брошенных корзин	Установите Да, чтобы включить автоматическую синхронизацию данных о брошенных корзинах. Если включено, синхронизация выполняется в соответствии с определенным расписанием cron.
Конфигурация расписания Cron	Определите, когда должна выполняться синхронизация, используя следующие поля: `Минута`, `Час`, `День`, `Месяц`, `День недели`. Cron — это планировщик задач по времени, который автоматически выполняет задачи с заданными интервалами.
Количество брошенных корзин	Укажите, сколько брошенных корзин будет обрабатываться при каждом запуске синхронизации.
Минимальное время неактивности	Установите минимальное время неактивности (в минутах), по истечении которого корзина будет считаться брошенной. Например, `60` означает, что корзины, неактивные в течение как минимум 60 минут, будут подлежать синхронизации.

Abandoned cart sync configuration settings

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

Всего брошенных корзин: Общее количество корзин, определенных как брошенные.
Синхронизированные брошенные корзины: Количество корзин, успешно синхронизированных с Pushwoosh.
Несинхронизированные брошенные корзины: Количество корзин, которые еще не были синхронизированы.
Неудачные синхронизации брошенных корзин: Количество корзин, для которых синхронизация завершилась неудачей.

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

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

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


Синхронизация клиентов	Установите Да, чтобы включить синхронизацию всех существующих и новых записей о клиентах. Синхронизация будет следовать определенному расписанию cron и использовать указанные сопоставления атрибутов.
Конфигурация расписания Cron	Определите, когда должна выполняться синхронизация, используя следующие поля: `Минута`, `Час`, `День`, `Месяц`, `День недели`. Cron — это планировщик задач по времени, который автоматически выполняет задачи с заданными интервалами.
Сопоставление пользовательских полей клиента	Сопоставьте атрибуты клиентов Magento с пользовательскими полями Pushwoosh для точной передачи данных. Примеры: `Дата рождения → Birthday`, `Имя → firstName`
Количество клиентов	Установите максимальное количество клиентов для синхронизации за один запуск cron.

Customer sync configuration settings

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

Всего клиентов: Общее количество записей о клиентах, определенных для синхронизации.
Синхронизированные клиенты: Количество клиентов, успешно синхронизированных с Pushwoosh.
Несинхронизированные клиенты: Клиенты, ожидающие синхронизации.
Неудачные синхронизации клиентов: Клиенты, которые не удалось синхронизировать из-за ошибок.

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

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

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

Web notifications configuration in Magento

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

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

Save Config button in Magento Admin Panel

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

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

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

В панели администратора Magento перейдите в Клиенты > Все клиенты.
Найдите и выберите клиента(ов), которого(ых) вы хотите синхронизировать.
В выпадающем меню Действия над списком клиентов выберите Синхронизировать в Pushwoosh.

Sync to Pushwoosh action for customers

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

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

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

В панели администратора Magento перейдите в Продажи > Заказы.
Выберите один или несколько заказов из списка.
В выпадающем меню Действия выберите Синхронизировать в Pushwoosh.

Sync to Pushwoosh action for orders

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

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

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

В панели администратора Magento перейдите в раздел Брошенные корзины.
Выберите корзину, которую хотите синхронизировать.
В выпадающем меню Действия выберите Синхронизировать в Pushwoosh.

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

Sync to Pushwoosh action for abandoned carts

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

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

Abandoned Cart Date → PW_AbandonedCartDate
Abandoned Cart ID → PW_AbandonedCartID

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

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

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

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

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