Meta Commerce

Meta Commerce

Meta Pixel, Conversions API и синхронизация каталога для Medusa с настройкой в Medusa Admin.

Плагин подключает магазин на Medusa к Meta. Он отправляет покупки и события витрины в Conversions API с сервера, работает вместе с Meta Pixel в браузере и связывает товарный фид магазина с каталогом в Meta Commerce Manager. Настройки находятся в Medusa Admin в разделе Настройки → Интеграции → Meta Commerce и работают через Модуль интеграций.

Возможности

• Покупки через Conversions API – при оформлении заказа плагин отправляет в Meta событие Purchase с сервера. Идентификатор события строится из идентификатора заказа, поэтому Meta может исключить повторный учёт покупки.
• События витрины – витрина отправляет стандартные события (PageView, ViewContent, Search, AddToCart, InitiateCheckout, AddPaymentInfo, Purchase, Lead) на /store/meta-commerce/events, и плагин передаёт их в Conversions API вместе с IP-адресом и user agent покупателя из запроса. Другие названия событий отклоняются, а адрес страницы сверяется с адресами витрины магазина.
• Хеширование данных покупателя – перед отправкой с сервера плагин нормализует данные покупателя и хеширует их SHA-256 по требованиям Meta. Уже захешированное значение передаётся как есть.
• Каталог товаров – каталог Meta подключается по идентификатору, и в нём можно зарегистрировать адрес товарного фида. Фид из Product Feeds поддерживает каталог в актуальном состоянии, а идентификатор товара совпадает в фиде, Pixel и Conversions API. Это SKU или идентификатор варианта, если у варианта нет SKU.
• Журнал доставки – каждое событие сохраняется со статусом доставки: delivered, retryable или failed.
• Диагностика в Admin – страница Meta Commerce показывает сводку, события, каталог и зарегистрированные в нём фиды. На ней можно проверить токен доступа на Pixel, каталог и бизнес-аккаунт и отправить тестовое событие с кодом из Meta Events Manager.

Настройки в Admin

На странице настроек четыре раздела:

• Credentials – токен доступа системного пользователя Meta, который хранится в зашифрованном виде, идентификатор Pixel (набора данных) и идентификатор бизнес-аккаунта.
• Catalog – идентификатор каталога и фид Product Feeds для синхронизации.
• Tracking – переключатели событий Pixel в браузере и Conversions API, код тестовых событий.
• Regional / Compliance – валюта и страна событий по умолчанию, коды страны и штата для Data Processing Options в Meta.

Для событий Pixel в браузере на витрину нужно установить пакет @wanderwares/storefront-meta.

Требования

• Medusa 2.21 или новее
• Модуль интеграций 0.2 или новее

Плагин находится в бете.

Установка

Зарегистрируйте плагин в medusa-config и добавьте его провайдер, @wanderwares/medusa-meta-commerce/providers/integration-meta-commerce, в провайдеры Модуля интеграций, как показано в документации Модуля интеграций. Журнал событий плагин хранит в собственной таблице, поэтому выполните миграции:

npx medusa db:migrate