Интеграция Conversions API (CAPI) с Meta

Передавайте в набор данных Meta с сервера на сервер каждую подтверждённую конверсию, которую приносят ваши партнёры, — чтобы показ рекламы Meta оптимизировался по реальным покупкам, даже когда браузерный пиксель заблокирован.

Обзор

Пиксель Meta работает в браузере покупателя, где блокировщики рекламы, настройки конфиденциальности iOS и выбор согласия останавливают многие события. Conversions API отправляет те же события с сервера. AffClix делает это за вас: когда конверсия подтверждена, в ваш набор данных (пиксель) уходит серверное событие с сопоставленным названием, суммой продажи и теми сигналами идентификации, которые вы разрешили.

Настройка занимает несколько минут: подключите Facebook, выберите набор данных из списка и сопоставьте цели AffClix со стандартными событиями Meta. Если на сайте работает и пиксель, Meta оставит одно событие на конверсию, потому что AffClix передаёт ID конверсии как ID события.

Зачем нужна эта интеграция

  • Возврат потерянных конверсий — покупки, которых пиксель не увидел из-за блокировщиков, iOS или отклонённых cookie, всё равно попадают в Meta.
  • Лучшая оптимизация — Advantage+ и кампании на конверсии обучаются на продажах, которые закрывают ваши партнёры.
  • Только подтверждённые конверсии — ожидающие, отклонённые и урезанные конверсии не передаются, и Meta оптимизирует по той выручке, которая у вас остаётся.
  • Реальная ценность — каждое событие содержит сумму продажи и валюту, поэтому оптимизация по ценности и ROAS точны.
  • Без дублей с пикселем — ID конверсии AffClix передаётся как ID события, и Meta засчитывает покупку один раз, даже если о ней сообщили и пиксель, и сервер.
  • Вы решаете, чем делиться — выберите, какие сигналы идентификации покидают AffClix; местоположение и внешние ID хешируются SHA-256 перед отправкой.
  • Полная история — каждая попытка вместе с ответом Meta записывается в отчёт CAPI Delivery.

Что потребуется

  • Тариф AffClix, в который входит Conversions API, — пункт меню Integrations → Conversions API.
  • Набор данных (пиксель) Meta в Events Manager. Используйте тот, что уже получает браузерные события сайта, чтобы серверные и браузерные события объединялись.
  • Аккаунт Facebook с доступом к этому набору данных — как пользователь Business Manager, которому он принадлежит, или через назначение партнёру.
  • Конверсии, поступающие в AffClix через постбэк, пиксель или e-commerce-интеграцию, и имеющие статус подтверждённых.
  • По желанию: тестовый код события из Events Manager → ваш набор данных → Тестовые события, чтобы проверить настройку до реального трафика.

Шаг 1. Подготовьте набор данных в Events Manager

Всё, что нужно AffClix, уже есть в Events Manager; достаточно знать, какой набор данных использовать.

01

Откройте Events Manager

В Meta Business Suite откройте Events Manager → Data sources и выберите набор данных (пиксель), который использует сайт.

02

Запомните ID набора данных

Это число под его названием. Обычно вы выберете его из списка в AffClix, но полезно знать, какой из них нужный.

03

Скопируйте тестовый код (по желанию)

Откройте вкладку Test events набора данных и скопируйте код, например TEST12345. AffClix использует его только для кнопки Send test event — реальные конверсии его никогда не содержат.

04

Проверьте доступ

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

Нет доступа к Business Manager?

Можно подключиться, вставив маркер доступа Conversions API: Events Manager → ваш набор данных → Settings → Conversions API → Generate access token. См. шаг 2.

Шаг 2. Подключите Facebook в AffClix

01

Откройте Conversions API

Перейдите в Integrations → Conversions API и нажмите Add destination.

02

Выберите Meta CAPI

Выберите плитку Meta CAPI и назовите назначение, например Meta – Основной набор данных. Оставьте Campaign ID пустым, чтобы передавать конверсии всех кампаний, или укажите ID одной кампании.

Выбор платформы в форме нового назначения с плиткой Meta CAPI.
Выберите Meta CAPI — форма строится под неё.
03

Подключите Facebook

Нажмите Connect Facebook и войдите в аккаунт Facebook, который управляет набором данных. Подтвердите разрешения, которые запрашивает Meta, — AffClix нужно рекламное разрешение для отправки событий. AffClix никогда не видит ваш пароль.

Карточка учётных данных Meta с кнопкой Connect Facebook, списком «Get these from Meta first» и полем маркера доступа.
Подключите Facebook или вставьте и проверьте маркер доступа.
04

Выберите набор данных

Вернувшись в AffClix, вы увидите Facebook connected. Выберите набор данных в поле Pixel / Dataset ID. Если его нет в списке, введите ID в это же поле.

05

Или вставьте маркер доступа

Если кнопки Connect Facebook нет или вы предпочитаете собственный маркер системного пользователя, вставьте его в Access token, нажмите Verify token & load pixels и выберите набор данных. Индикатор показывает Paste access token → Verify token → Choose dataset.

Вход через Facebook действует около 60 дней

Meta выдаёт подключённый доступ примерно на 60 дней без автоматического продления. До его окончания откройте назначение и нажмите Reconnect Facebook — набор данных и сопоставление сохранятся. AffClix также предупредит, если Meta начнёт отклонять события.

Шаг 3. Сопоставьте цели с событиями Meta

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

01

Сопоставьте каждую цель

В блоке Event Mapping & Matching выберите цель в поле Your goal и укажите событие Meta в поле Platform event — например, продажа → Purchase, лид → Lead, регистрация → CompleteRegistration.

Карточка Event Mapping & Matching с целями, сопоставленными событиям Meta, и параметрами ключей сопоставления.
Сопоставьте цели со стандартными событиями Meta и выберите, какими сигналами делиться.
02

Решите насчёт общего правила

Строка с целью * охватывает все несопоставленные цели. Удалите её, если передавать нужно только перечисленные цели.

03

Выберите ключи сопоставления

В разделе Match keys to send ничего не отмечайте, чтобы передавать все доступные сигналы, или отметьте только то, что допускает ваша политика согласия. Больше сигналов — выше качество сопоставления событий (EMQ) в Events Manager.

Цель без строки не передаётся

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

Ключи сопоставления вкратце

Click IDs передаёт идентификатор клика на основе fbclid; fbc / fbp — браузерные cookie Meta; IP + UA — IP-адрес и браузер посетителя; Geo — город, регион, индекс и страну (в виде хеша); External ID — ваш ID клиента (в виде хеша). AffClix не хранит адреса электронной почты и номера телефонов, поэтому они никогда не передаются.

Шаг 4. Сохраните и проверьте

01

Сохраните

Убедитесь, что переключатель Active включён, и нажмите Create destination.

02

Отправьте тестовое событие

Укажите в назначении Test event code, сохраните и нажмите Send test event в списке Conversions API. AffClix отправит тестовое событие Purchase, которое в течение минуты появится в Events Manager → ваш набор данных → Test events. Для этой кнопки нужен тестовый код события.

03

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

После следующей подтверждённой конверсии найдите строку Delivered в Reports → Delivery Logs → CAPI Delivery и убедитесь в Events Manager → Overview, что серверные события поступают через Conversions API.

Пример из практики

Бренд одежды продвигает магазин через авторов в Instagram и запускает кампании Advantage+ для покупок на том же наборе данных. Многие покупатели пользуются iPhone.

  1. Покупатель переходит из Instagram по ссылке AffClix одного из авторов. AffClix записывает клик вместе с идентификатором клика Meta.
  2. Покупатель берёт куртку за 89 €, но настройки конфиденциальности Safari не дают пикселю сообщить о покупке.
  3. Постбэк бренда записывает продажу в AffClix, и продажу подтверждают.
  4. AffClix отправляет в набор данных событие Purchase с ценностью 89, валютой EUR, идентификатором клика и хешированным местоположением — а ID конверсии передаётся как ID события.

Итог: Meta засчитывает покупку, которую пропустил пиксель, относит её к нужной кампании и оптимизирует показ по реальным продажам. Если пиксель всё же сработал с тем же ID события, Meta оставляет одну покупку.

Управление и мониторинг интеграции

  • Пауза без удаления — используйте переключатель в строке назначения или отключите Active.
  • Продление входа — переподключайте Facebook до истечения примерно 60-дневного срока; назначение сохранит набор данных и сопоставление.
  • Оповещения об учётных данных — AffClix проверяет каждое назначение раз в час. Если Meta начинает отклонять события из-за истёкшего или отозванного маркера, в строке появляется Reconnect credentials, а владельцу рабочего пространства приходит письмо.
  • Качество сопоставления событий — Events Manager оценивает каждое серверное событие. Разрешите больше ключей сопоставления, чтобы повысить оценку.
  • Статус CAPI у каждой конверсии — в отчёте по конверсиям появляется столбец CAPI со значениями Delivered, Failed или Partial.

Журналы CAPI Delivery

Каждая попытка записывается в Reports → Delivery Logs → CAPI Delivery. Фильтруйте по дате, платформе, назначению и статусу.

Отчёт CAPI Delivery со списком попыток отправки: платформа, событие, статус и код ответа.
Reports → Delivery Logs → CAPI Delivery фиксирует каждую попытку.
СтолбецЧто показывает
Platform / EventНазначение и отправленное событие Meta, например Purchase.
StatusDelivered или Failed с указанием причины.
Response codeHTTP-статус, который вернула Meta.
Attempts / RetryableСколько было попыток и была ли ошибка временной, чтобы повторить отправку.
ErrorСообщение об ошибке от Meta с ID трассировки для обращений в поддержку.

Устранение неполадок

СимптомВероятная причинаЧто делать
Список наборов данных пустАккаунт Facebook не видит набор данных, или бизнес открывает его только через назначение активов.Введите ID набора данных в поле или попросите владельца назначить его вам.
«This login did not grant ads_management»На экране согласия Facebook было отклонено рекламное разрешение.Нажмите Reconnect Facebook и подтвердите все разрешения, которые запрашивает Meta.
Send test event не срабатываетВ назначении не задан тестовый код события.Скопируйте код в Events Manager → Test events, сохраните его в назначении и повторите.
В строке отображается Reconnect credentialsВход через Facebook истёк (около 60 дней) или маркер был отозван.Откройте назначение и нажмите Reconnect Facebook или вставьте новый маркер.
Meta засчитывает покупки дваждыПиксель на сайте сообщает о покупке с другим ID события.Передавайте с сайта ID конверсии AffClix как ID события пикселя или используйте только серверное событие.
Конверсии есть в AffClix, но не в MetaОни ещё не подтверждены, или для их цели нет строки в карте событий и нет строки *.Подтвердите конверсии или добавьте сопоставление для цели.

Итоги

После подключения Meta каждая подтверждённая конверсия от ваших партнёров поступает в набор данных с сервера — с правильным названием события, реальной ценностью и разрешёнными сигналами идентификации, — и Meta ведёт отчётность и оптимизирует показ по реальным продажам. Продлевайте вход через Facebook раз в пару месяцев и следите за отчётом CAPI Delivery.

Примечание

В Meta передаются только подтверждённые конверсии. Ожидающие, отклонённые и урезанные конверсии не передаются никогда; конверсия, подтверждённая позже, передаётся в момент подтверждения.

См. также: Обзор Conversions API · Conversions API для Google Ads · Meta Ads и WebSDK

Rate this article
★★★★★
Thanks for rating!

Was this article helpful?