Піксель Meta і Conversions API: підключення і налаштування

Ця сторінка — про те, як передавати події з ваших воронок у рекламний кабінет Meta: підключити піксель і Conversions API (CAPI), поставити трекінг на лендинг, надсилати конверсії з бота і перевірити, що все дійшло.

Sviteya працює з обома каналами: браузерний піксель на сторінках (міні-лендинги, сторінки «дякую», вебінарна кімната) і серверний CAPI з воронки. Усередині Telegram браузера немає взагалі, тому конверсії з бота йдуть сервером.

Піксель і CAPI недоступні на тарифі Free — потрібен платний тариф.

Два значення з Meta Events Manager:

• Pixel ID — номер вашого пікселя (число);
• токен Conversions API — ключ, яким сервер підтверджує право надсилати події у ваш піксель.

Обидва поля обов’язкові. Сам лише Pixel ID не працює: всередині Telegram браузера немає, піксель туди вставити нікуди, тому подія з бота (заявка, бронювання, оплата) іде виключно сервером через CAPI, і без токена вона не надішлеться.

Крок 1. Відкрийте Meta Events Manager і оберіть свій піксель (набір даних). Якщо пікселя ще немає — створіть його там же.

Крок 2. Pixel ID — число в назві або в налаштуваннях пікселя. Скопіюйте його.

Крок 3. Перейдіть на вкладку Налаштування (Settings), знайдіть розділ Conversions API і натисніть Generate access token. Скопіюйте токен — це довгий рядок.

Крок 4. У Sviteya відкрийте «Інтеграції», блок «Трекінг реклами (Meta)», вкажіть назву підключення (наприклад, «Школа»), вставте Pixel ID і токен, за потреби вкажіть код Test Events (необов’язково) і натисніть «Підключити Meta». Sviteya перевірить, що токен має доступ до пікселя; якщо ні, покаже помилку.

Якщо підключити той самий Pixel ID ще раз, оновиться токен наявного підключення (зручно після того, як Meta відкликала старий токен).

Підключень може бути скільки завгодно — під різні проєкти чи різні рекламні кабінети. У списку видно назву і Pixel ID числом, щоб було з чим звіритися в Events Manager.

Піксель обирається там, де подія народжується:

• дія «подія в Meta CAPI» у ноді воронки — вибір пікселя з’являється, коли підключень більше одного;
• вебінар — вкладка «Інтеграції» → блок «Піксель / CAPI»;
• міні-лендинг, сторінка «дякую», «успішна реєстрація» — блок «Піксель цього лендинга».

Якщо піксель один, обирати нічого не треба — все йде в нього. Якщо їх кілька, а вибір не зроблено, подія не надсилається (краще нічого, ніж у чужий кабінет), а при публікації воронки з’явиться попередження.

Коли трафік іде на зовнішню сторінку, а з неї — кнопкою в Telegram, потрібно два кроки.

Крок 1. Посилання для кнопки. У воронці відкрийте (або створіть) тригер «Реф-посилання» і скопіюйте «Посилання зі змінними» — воно має вигляд …/api/c/<бот>/<тригер>. Поставте його на кнопку «Перейти в Telegram» на лендингу. Це саме те посилання, через яке Sviteya ловить мітки: на звичайне посилання t.me/… мітки реклами не передаються.

Крок 2. Сніпет трекінгу. Додайте на сторінку один рядок — у кінець <body> або через Tag Manager:

<script src="https://app.sviteya.ai/api/pixel.js" async></script>

Цей рядок також показано в розділі «Інтеграції» біля налаштування Meta. У WordPress його додають плагіном для вставки коду (наприклад, WPCode) або в полі «Custom code» теми; у Webflow — Page Settings → Custom Code → Footer Code.

Тепер, коли людина з реклами натискає кнопку, мітки — utm_source, utm_medium, utm_campaign, utm_content, utm_term, fbclid, fbp, fbc — записуються в поля контакта з тими самими назвами, і воронка стартує як звичайно. Далі кожна CAPI-подія з бота піде в Meta вже «зшитою» з кліком по рекламі. Також зберігаються IP-адреса і браузер кліку.

Тут коду вставляти не треба взагалі: на наших сторінках (міні-лендинги, вебінарна кімната, сторінка оплати) мітки й піксель підставляються самі.

• Міні-лендинг, сторінка «дякую», «успішна реєстрація»: у налаштуваннях сторінки, блок «Піксель цього лендинга», оберіть піксель і позначте, що надсилати: PageView при відкритті, Lead при відправці форми або кліку кнопки, Purchase при відкритті (для сторінки після оплати). Браузерний код Meta сервіс додає на сторінку сам, а серверна подія йде через CAPI паралельно.
• Вебінар: вкладка «Інтеграції» → «Піксель / CAPI» — оберіть піксель і події: «Реєстрація = Lead», «Зайшов у кімнату», «Досидів до офера», «Клік кнопки», «Покупка = Purchase». Код пікселя в кімнату вже вбудований.

Щоб Meta бачила не кліки, а результати, поставте у воронці блок «Дії» з дією «подія в Meta CAPI» на кроці, де результат стається. З воронки події самі не надсилаються — лише цією дією.

• після бронювання — вихід «заброньовано» → подія Schedule;
• після оплати — воронка з тригером «Оплата товару» → подія Purchase; у полі «сума» вкажіть суму (можна змінною з вибору змінних) і оберіть валюту (USD, EUR, UAH, PLN або GBP);
• після заявки чи анкети → Lead;
• також доступні Contact, CompleteRegistration, Subscribe або власна назва події («своя назва…», латиницею).

Саме на такі події Meta потім оптимізує покази: алгоритм шукає людей, схожих на тих, хто купив, а не на тих, хто просто клікнув.

З кожною подією з воронки сервіс передає Meta: fbclid/fbc/fbp з кліку по рекламі (якщо вони збережені в полях контакта), IP-адресу і браузер кліку, а також email, телефон, ім’я й прізвище контакта (усе це хешується перед відправкою) і внутрішній ідентифікатор контакта.

Email і телефон беруться з полів контакта, назва яких містить «email» / «пошта» / «мейл» та «phone» / «телефон». Якщо ваші поля названі інакше, ці дані не підтягнуться. Що більше даних — то точніша атрибуція і вища «якість зіставлення» в Events Manager.

На веб-сторінках (лендинг, «дякую», вебінарна кімната) подію надсилає браузерний піксель, і паралельно та сама подія йде сервером через CAPI. Обидві несуть однаковий event_id, тому Meta рахує їх як одну — це стандартна дедуплікація.

Саме тому піксель обирається один на сторінку: якби браузер слав в один піксель, а сервер в інший, Meta бачила б дві різні покупки.

Крок 1. Пройдіть шлях як клієнт: відкрийте лендинг з тестовими мітками (наприклад, додайте до адреси ?utm_source=test&utm_campaign=demo), натисніть кнопку, запустіть бота і дійдіть до кроку з CAPI-дією.

Крок 2. У Sviteya відкрийте контакт: у полях мають з’явитися utm_source і utm_campaign, а в журналі подій — записи «клік з реклами» і «подію надіслано в Meta». Якщо відправка не вдалась, буде запис «помилка відправки в Meta».

Крок 3. В Events Manager відкрийте свій піксель: подія з’явиться протягом кількох хвилин на вкладці Overview. Для миттєвої перевірки є вкладка Test events: скопіюйте звідти код і вкажіть його в полі Test Events при підключенні Meta в Sviteya — тестові події видно в реальному часі. Після перевірки перепідключіть піксель без цього коду, інакше всі події й далі йтимуть як тестові.

Чи можна підключити тільки Pixel ID, без токена?

Ні. Без токена сервер не має права надсилати події у ваш піксель, а з Telegram події йдуть лише сервером. Обидва поля обов’язкові.

У мене кілька рекламних кабінетів. Що робити?

Створіть окреме підключення на кожен піксель і обирайте потрібний у налаштуваннях воронки, вебінару чи лендинга.

Подія не з’явилася в Events Manager.

Перевірте по черзі: чи вибраний піксель (коли їх кілька), чи дійшов контакт до ноди з CAPI-дією (журнал подій контакта), чи дійсний токен (Meta інколи відкликає токени — згенеруйте новий і підключіть піксель ще раз із тим самим Pixel ID).

Навіщо сніпет на лендингу, якщо є браузерний піксель Meta?

Сніпет Sviteya не замінює піксель — він ловить мітки кліку (fbclid, utm) і передає їх у бот разом з людиною. Без нього серверні події буде ні з чим зшити, і атрибуція до кампанії загубиться.