Что делает Conversion API
Conversion API (CAPI) отправляет события конверсии с сервера Storeep прямо на рекламную платформу, минуя браузер покупателя. Поскольку он работает «сервер-серверу», на него не влияют блокировщики рекламы, настройки приватности браузера или ограничения отслеживания iOS, и он несёт хешированные данные клиента, чтобы улучшить качество сопоставления для Smart Bidding и похожих аудиторий. О клиентских пикселях см. сопутствующую статью Браузерные пиксели.
Вы можете одновременно запускать браузерный пиксель и CAPI для одной и той же платформы. Storeep помечает оба общим ID события, построенным из типа события и номера заказа, поэтому платформа дедуплицирует их в одну конверсию, а не считает две.
Какие платформы предлагают CAPI
- Facebook / Meta Conversion API.
- TikTok Events API.
- Snapchat Conversions API.
X и Google Ads не имеют серверного Conversion API в Storeep; они работают только на стороне браузера.
Что отправляется
По каждому подходящему заказу Storeep отправляет стоимость заказа и валюту, позиции товаров и сигналы покупателя: хешированный email, хешированный телефон, хешированный ID клиента (external_id), IP-адрес, user agent и, для Facebook и Snapchat, хешированную страну рынка. Он также пересылает любые ID кликов по рекламе, найденные в куки покупателя (Facebook _fbc и _fbp, TikTok ttclid, Snapchat ScCid), чтобы платформа могла атрибутировать конверсию исходному клику.
Типы событий конверсии
- Facebook: только Lead или Purchase. Facebook CAPI не отправляет события добавления в корзину или оформления.
- TikTok: Lead, Purchase, Place an order или Complete payment.
- Snapchat: Purchase или Reserve.
Валюта и заказы с нулевой стоимостью
Каждое событие использует собственную валюту заказа, когда платформа её поддерживает; иначе стоимость конвертируется в USD. Facebook CAPI пропускает любой заказ, чей итог равен 0, потому что Meta отклоняет конверсии без стоимости, что сохраняет согласованность с браузерным пикселем Facebook.
Ограничение брошенных заказов
Это ключевое поведение, которое нужно понять. Совершенно новый заказ всегда запускает отправку CAPI. Брошенный заказ отличается: он отправляется только тогда, когда вы включаете переключатель Брошенные заказы для этой записи CAPI, и только в момент, когда статус заказа меняется с брошенного на любой другой.
- При выключенном Брошенные заказы восстановленные брошенные заказы никогда не пересылаются на платформу.
- При включённом событие срабатывает, когда заказ выходит из статуса брошенного, независимо от того, меняете ли вы статус вручную или приложение Automator меняет его автоматически.
- Если Automator не установлен, вы должны сами перевести заказ в другой статус, чтобы событие сработало.
- Переключатель действует на каждую запись, поэтому вы можете включить отслеживание брошенных заказов для одного Pixel ID и оставить его выключенным для другого.
Установка CAPI и его поля
- Откройте Приложения в левом меню.
- Найдите нужное приложение Conversion API и нажмите Установить, затем подтвердите.
- Откройте приложение снова и нажмите Добавить новый пиксель, чтобы создать запись.
У каждой записи есть эти поля:
- Активировать: когда включено, события конверсии отправляются «сервер-серверу». Включено по умолчанию.
- Брошенные заказы: переключатель ограничения, описанный выше. Выключен по умолчанию.
- Название рекламного аккаунта: метка только для вашего собственного ориентира.
- Pixel ID: ваш Pixel ID Meta, TikTok или Snapchat.
- Рынки: рынки магазина, которые покрывает эта запись. Выберите один или несколько.
- Тип события конверсии: варианты платформы, перечисленные выше.
- Токен доступа: токен доступа Conversions API, который вы генерируете в менеджере событий платформы. Обязателен.
- Активировать тестовый режим: когда включено, события отправляются как тестовые.
- Тестовый код: код тестового события с платформы, например TEST_1234. Обязателен, когда тестовый режим включён.
Тестовый режим
При включённом тестовом режиме события появляются в представлении тестовых событий платформы, чтобы вы могли подтвердить интеграцию, не затрагивая живые данные. Тестовые события не питают ставки рекламы или оптимизацию, поэтому отключите тестовый режим перед запуском живых кампаний.
Как рынки ограничивают CAPI
Запись CAPI срабатывает только для заказов, размещённых на рынках, которые вы на ней выбрали. Заказ на рынке, который вы не выбрали, не запускает эту запись, поэтому вы можете запускать разный Pixel ID и токен доступа для каждой страны из одного магазина.
Что проверить
- Используйте один и тот же Pixel ID на вашем браузерном пикселе и вашем CAPI, чтобы платформа дедуплицировала две доставки в одну конверсию.
- Если события перестают появляться в менеджере событий платформы, ваш токен доступа мог истечь. Сгенерируйте его заново и обновите запись.
- Каждая запись независима. Вы можете добавить несколько записей на платформу, каждую со своим Pixel ID, токеном доступа, рынками, типом события и настройкой брошенных заказов.
- Не забудьте отключить тестовый режим перед запуском, иначе ваши реальные конверсии не будут учтены.