Гайд - Meta CAPI

Meta CAPI: серверні конверсії, яким не страшний iOS

Браузерний піксель не бачить найціннішого в Telegram-воронці: старт бота, вступ у канал і депозит відбуваються там, де пікселя фізично немає. Додайте приватність iOS і втрату cookie на лендінгу - і Meta оптимізується за уламком реальних конверсій: гірші аудиторії і вищий CPA на той самий бюджет. Серверний CAPI закриває цю діру: Leadgram надсилає кожну конверсію напряму зі свого бекенда в Meta, з click ID для сильного матчингу.

Створіть CAPI-акаунт на сторінці Facebook

  1. Відкрийте Facebook у розділі «Рекламні майданчики» та натисніть Додати акаунт.
  2. Назва акаунта - внутрішня мітка, за якою ви його впізнаєте.
  3. Pixel ID - числовий ID вашого пікселя Meta з Events Manager.
  4. Токен доступу - генерується в Events Manager → ваш піксель → Settings → Conversions API (токен системного користувача). Зберігається зашифрованим; в інтерфейсі видно лише останні 4 символи.
  5. Test event code (опційно, але радимо) - з Events Manager → Test Events. Відкриває безпечну тестову конверсію в один клік.
Форма CAPI-акаунта з полями Pixel ID і токена доступуФорма CAPI-акаунта з полями Pixel ID і токена доступу

Зіставте кампанію з акаунтом

На сторінці Кампанії впишіть той самий Pixel ID у поле «ID пікселя Meta» кампанії. Збіг має бути точним - під час відправлення Leadgram зіставляє ID пікселя кампанії з вашими CAPI-акаунтами. Форма перевіряє це наживо, поки ви друкуєте: ви побачите або повідомлення «Знайдено CAPI-акаунт "…" - події CAPI будуть надіслані», або попередження, що події залишаться лише браузерними. Банер після збереження повторює вердикт, тож одрук не пройде мовчки.

Що Leadgram надсилає в Meta

  • Назва події - за мапінгом внутрішнього типу: registration → CompleteRegistration, deposit/ftd/purchase → Purchase, bot_start/lead → Lead, channel_join → Subscribe, first_dm → Contact, land → PageView, click → ViewContent. Незмаплені типи (наприклад, custom_*) не надсилаються.
  • fbc click ID - fbclid, спійманий на вашому трекінг-посиланні, перезбирається в параметр Meta fbc, найсильніший сигнал матчингу після хешованих PII.
  • event_id - детермінований ID на кожну конверсію, тож ретраї ніколи не плодять дублі покупок в Ads Manager.
  • event_time - реальний момент події, узятий з того, коли Leadgram її зафіксував. Meta приймає події з міткою часу лише за останні 7 днів: якщо доставка старша за це вікно, мітку часу підрізають до найпізнішого моменту, який Meta ще прийме, замість того щоб завалити помилкою весь пакет.

Перевірте до того, як витрачати бюджет

  1. У рядку акаунта натисніть Надіслати тест-подію.
  2. Вставте або підтвердьте Test Events код.
  3. Відкрийте Events Manager → Test Events - Purchase з'явиться за секунди.

Тест синтетичний: він не чіпає оптимізацію реклами, атрибуцію чи ваші списання. Якщо Meta відхилила подію, у діалозі покаже точну (з замаскованим токеном) причину Meta - зазвичай це неправильний pixel ID, токен доступу або код тестової події.

Стежте за доставками

Доставка конверсій показує відправлені, збійні та мертві доставки CAPI за вікна 24 год / 7 дн, з повторним відправленням в один клік для всього, що застрягло. Зазирайте туди, коли цифри в Ads Manager видаються заниженими.

Картка останньої помилки прив'язана до платформи, а не до пікселя. Два пікселі Meta отримують кожен свій CAPI-акаунт, але Доставка конверсій показує обидва під однією об'єднаною карткою Meta - протухлий токен на одному акаунті може ховатися за здоровим результатом іншого. Щоб перевірити конкретний піксель, використовуйте кнопку «Надіслати тест-подію» саме того акаунта.

Збійна доставка не мертва з першого промаху. Leadgram повторює її з експоненційною затримкою - до 5 спроб (5с, 10с, 20с, 40с) - перш ніж позначити її мертвою і залишити на сторінці, щоб ви відправили її вручну.

Якщо та сама кампанія веде ще й Google CAPI, картка цієї платформи розкладає, чому події навіть не намагалися відправити: немає click ID, клік прострочений, або тип події, якого Google не мапить. У Meta такої розбивки поки немає - незмаплений тип події в Meta просто не створює жодного рядка в леджері, тож там нема чого відкрити й подивитися.

Типові граблі

  • Pixel ID у кампанії відрізняється від акаунта на одну цифру - події мовчки залишаються браузерними. Живий індикатор і банер після збереження - ваша страховка, читайте їх.
  • Протухлий або неправильно вказаний токен доступу - доставки падають з OAuth-помилкою в Доставці конверсій. Перегенеруйте токен в Events Manager, тоді натисніть Редагувати на акаунті: залиште поле токена порожнім, щоб зберегти поточний, або вставте нове значення, щоб його замінити.
  • У кліках немає fbclid - зробіть трекінг-посилання кампанії прямою ціллю оголошення; Meta додає fbclid автоматично. Якщо у вас ланцюжок трекерів, прокидайте параметр наскрізь.
  • Кнопка тесту відмовляється спрацьовувати - ви не вказали Test Events код. Це навмисно: подія без коду зарахувалася б як справжня конверсія.
  • Беклог, старший за 7 днів, Leadgram не відхиляє повністю - він підрізає мітку часу замість помилки. Але підрізана конверсія все одно несе менше атрибуційної цінності, ніж свіжа, тож не сприймайте це як привід дати доставкам накопичуватися.