Facebook Conversions API

Facebook Conversions API включается в карточке источника: по конверсиям со статусом лида или продажи с кликов этого источника трекер отправляет событие в Facebook с вашего сервера. Понадобятся Pixel ID и Access Token. Менять карточку источника могут владелец и администратор.

Включение в источнике

1. Откройте Источники.
2. Выберите источник, с которого идёт трафик из Facebook.
3. Отметьте флажок Facebook Conversions API. Под ним появятся поля Pixel ID и Access Token.
4. Заполните оба поля. Если пиксель у каждой кампании свой, оставьте их пустыми.
5. Нажмите Сохранить.

Вместо сохранённого токена в поле стоит ***. Пустое поле и *** оставляют прежний токен. Чтобы убрать токен, нажмите Удалить рядом с полем, затем Сохранить. До сохранения удаление отменяет кнопка Не удалять.

В кампании на вкладке S2S-постбеки блок Постбеки источника показывает «Facebook CAPI: включён» или «Facebook CAPI: выключен».

Откуда берутся Pixel ID и Access Token

Трекер ищет каждое значение по порядку и берёт первое заполненное.

В параметрах кампании подходит строка, у которой Параметр или Название — pixel или token.

Pixel ID состоит только из цифр. Значение в фигурных скобках, например {pixel}, считается незаполненным.

Свой пиксель у каждой кампании

Поля источника действуют на все его кампании. Для разных пикселей:

1. Оставьте поля Pixel ID и Access Token в источнике пустыми.
2. Откройте в кампании вкладку Источник и параметры.
3. В строках pixel и token впишите в колонку Значение Pixel ID и Access Token. Если строк нет, добавьте их кнопкой + Параметр.
4. Нажмите Сохранить параметры.

В шаблоне источника «Facebook Ads» параметр pixel привязан к sub_id_11, а token — к sub_id_12. В кампанию они приходят со значениями {pixel} и {token} — замените их. Параметр token в ссылку для трафика не попадает, трекер подставляет его сам — см. Ссылка кампании, домен и параметры.

Какие конверсии уходят в Facebook

Берётся итоговый статус — см. Как определяется статус. Сеть прислала ftd, тип конверсии свёл его к продаже — уйдёт Purchase. По остальным статусам, включая rejected и hold, события нет.

• Передавайте в постбеке параметр status. Конверсия без статуса записывается как лид, но событие по ней не создаётся.
• Смена статуса по той же транзакции, например с лида на продажу, отправляет новое событие.
• Точный повтор постбека с тем же txid и исправление одной выплаты новое событие не создают. Лид после продажи по той же транзакции пропускается.
• Без txid каждый постбек создаёт событие заново — см. Постбек без txid.
• При импорте конверсий события уходят, только если отмечен флажок Отправлять исходящие S2S и CAPI.

Для Purchase трекер передаёт сумму выплаты в USD — см. Валюты и курсы. У Lead суммы нет. Название события и валюта не настраиваются.

Какие данные передаются

Если сеть не прислала email, телефон или имя, трекер берёт данные формы лендинга, закреплённые за кликом, — см. Приём лидов из форм.

Email, телефон, имя, фамилия, город, регион и страна уходят в Facebook в хешированном виде. IP, User-Agent, click-id, fbp и subid передаются как есть.

Идентификатор события и браузерный пиксель

У каждого события есть event_id:

{subid}:lead
{subid}:sale
{subid}:lead:{txid}
{subid}:sale:{txid}

Две последние строки — когда сеть передаёт в постбеке txid или tid.

По названию события и event_id Facebook объединяет событие трекера с таким же событием браузерного пикселя. Если пиксель стоит на странице «спасибо», передавайте в нём то же название события и тот же eventID. Для лида без идентификатора транзакции это {subid}:lead.

Проверка

1. Отправьте постбек со статусом lead по клику этого источника или дождитесь настоящей конверсии.
2. Откройте Логи → Доставка событий.
3. Выберите в списке типов CAPI.
4. Нажмите Найти.

У отправленного события состояние Выполнено. Остальные состояния — на странице Журнал доставки событий.

Если событие не ушло

В журнале доставки нет строки CAPI

Проверьте:

• у источника клика отмечен флажок Facebook Conversions API;
• у кампании на момент клика был выбран этот источник;
• итоговый статус — lead или sale, и параметр status в постбеке не пустой;
• это не точный повтор и не исправление выплаты.

CAPI: pixel/token не найдены (ни в источнике, ни в клике, ни в параметрах кампании)

Строка с subid клика появляется в Логи → S2S postbacks: трекер не нашёл Pixel ID или Access Token. Заполните поля в источнике или параметры pixel и token в кампании. По уже принятым конверсиям событие не уйдёт: оно создаётся при приёме постбека.

Состояние «Нужна проверка», результат capi_error

Facebook не принял событие или не ответил. После сетевой ошибки и ответов 5xx и 429 трекер повторяет отправку сам — см. Автоматические повторы. Остальные ошибки, например неверный токен или пиксель, не повторяются. Тот же результат даёт Pixel ID, в котором есть не только цифры.

Исправьте Pixel ID или Access Token в источнике — следующие конверсии уйдут с новыми значениями. Значения, сохранённые в клике, правка параметров кампании не меняет. Кнопка Повторить отправляет событие с прежними пикселем и токеном.

Состояние «Ожидает», результат license_hold

Лицензия не активна: конверсии принимаются, а события ждут продления и уходят после него автоматически — см. Истечение лицензии.