API конверсій

1. Навіщо взагалі серверний спосіб?

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

MousePlayer уже знає, коли досягнуто однієї з ваших цілей: саме для цього цілі й існують. API конверсій просто передають цей факт рекламній мережі з нашого сервера.

2. Що ми надсилаємо, а чого не надсилаємо ніколи

Єдине, що ідентифікує відвідувача в цих викликах, — це cookie або ідентифікатор кліку, який установила сама мережа. Жодні інші відомості про людину не залишають наш сервер.

Мережа	Використаний ідентифікатор	Звідки він береться
Meta	_fbp, _fbc	Cookie першої сторони, установлені пікселем Meta
LinkedIn	li_fat_id	Cookie першої сторони, установлений LinkedIn Insight Tag
TikTok	_ttp, ttclid	_ttp є cookie, а ttclid надходить з URL рекламного кліку
Google Ads	gclid, wbraid, gbraid	З URL рекламного кліку або з cookie _gcl_aw згодом
Microsoft Advertising	msclkid	З URL рекламного кліку або з cookie _uetmsclkid, який записує тег UET

Лише зі згодою

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

3. Google Ads має три ідентифікатори, а не один

Це дивує людей, тож скажемо прямо. Google використовує gclid для окремого рекламного кліку. Коли запобігання відстеженню Apple робить атрибуцію окремого кліку неможливою, Google натомість надсилає wbraid або gbraid, які позначають групу кліків.

Ці три ідентифікатори взаємовиключні: Google відхиляє конверсію з двома. Ми надсилаємо рівно один, і gclid має перевагу, якщо наявні кілька, адже він найточніший.

В URL вони є лише один раз

Ідентифікатор з’являється в адресі лише на першій сторінці після рекламного кліку. Потім тег Google зберігає його в cookie _gcl_aw. Ми зчитуємо cookie як резервне джерело: без нього для конверсії на третій сторінці візиту не знайшлося б жодного ідентифікатора.

4. Налаштування

Meta, LinkedIn і TikTok

По два поля: ідентифікатор пікселя чи правила конверсії та токен доступу, який ви створюєте в інтерфейсі самої мережі. Обидва значення зберігаються зашифрованими AES-256-GCM і більше не показуються після збереження.

Google Ads потребує шести

Google — виняток, і причину варто знати до початку: на відміну від інших трьох, Google не видає простого токена доступу. Доступ працює через OAuth із токеном оновлення, а Ads API додатково потребує токена розробника.

Поле	Де знайти
Ідентифікатор клієнта	Угорі праворуч у Google Ads. Лише цифри, без дефісів.
Ідентифікатор дії-конверсії	Цілі й конверсії, потім дія, на яку ви хочете зараховувати конверсію.
Токен розробника	Керуючий обліковий запис Google Ads, Центр API.
Ідентифікатор і секрет клієнта OAuth	Google Cloud Console, Облікові дані, клієнт OAuth типу «Настільний застосунок».
Токен оновлення	Ви самі генеруєте його один раз для області доступу adwords.

У LinkedIn два шляхи, і вам потрібен короткий

У Campaign Manager: Дані, Signals Manager, Direct API, Створити токен доступу. Це шлях для рекламодавців, які надсилають власні дані: без застосунку розробника й перевірки. Токен не має строку дії, і Campaign Manager не покаже його вдруге, тому скопіюйте його одразу.

Інший шлях — застосунок розробника, замовлений через LinkedIn Developer Portal, — існує для платформ, що надсилають дані від імені багатьох рекламодавців. Він потребує перевірки сторінки компанії та схваленого сценарію використання; тут вам нічого з цього не потрібно.

Microsoft Advertising — простий випадок

Після Google Ads очікуєш тієї самої складності: OAuth, токен розробника, етап схвалення. Насправді навпаки: два поля. Ідентифікатор тега UET, який ви вже використовуєте в браузері, і токен, який можна скопіювати в Microsoft Advertising у розділі тега UET: «Використовувати Conversions API», «Копіювати токен». Подавати заявки не потрібно.

Використовуйте той самий ідентифікатор тега, що й у браузері. Саме це дає Microsoft змогу розпізнати серверну подію й подію браузера як одну конверсію, а не дві.

5. Коли повідомляється про конверсію

Рівно один раз на ціль і сеанс. MousePlayer усуває повтори до надсилання виклику, а дані додатково містять ідентифікатор, щоб мережа могла повторно усунути дублікати на своєму боці. Відвідувач, який додає п’ять товарів до кошика, створює одну конверсію, а не п’ять.

Що ви побачите у своєму рекламному обліковому записі

Конверсія містить назву цілі, її цінність і валюту, якщо ви їх задали, а також час події. За нормальної роботи вона надходить протягом хвилини.

Якщо нічого не надходить

• Немає ідентифікатора кліку. Відвідувач прийшов не з реклами цієї мережі або раніше, ніж піксель установив cookie. Нічого не надсилається — це очікувана поведінка, а не помилка.
• Немає згоди. Перевірка згоди спрацювала першою.
• Мережа прийняла виклик, але відхилила конверсію. Google, TikTok і деякі інші відповідають HTTP 200 із помилкою всередині тіла відповіді. Ми читаємо тіло, а не лише статус, і причина з’являється в журналі доставки.