API канверсій
Паведамляйце мэты Meta, LinkedIn, TikTok і Google Ads з нашага сервера замест браўзера — з супастаўленнем толькі па ідэнтыфікатары кліку самой сеткі.
1. Навошта серверны шлях?
Піксель браўзера павінен перажыць тры рэчы перад паведамленнем канверсіі: блакіроўшчык рэкламы, абарону ад адсочвання і закрыццё ўкладкі да спрацоўвання. Серверны выклік перажывае ўсе тры, бо не адбываецца ў браўзеры.
MousePlayer ужо ведае, калі дасягнута мэта — для таго мэты і існуюць. API канверсій проста перадаюць гэты факт сетцы з нашага сервера.
Гэта не замена пікселю. Пакіньце яго. Кожная сетка выдаляе дублікаты двух шляхоў, і мы перадаём патрэбныя ідэнтыфікатары.
2. Што адпраўляем і чаго ніколі
Адзінае, што ідэнтыфікуе наведвальніка ў гэтых выкліках, — cookie або ідэнтыфікатар кліку, зададзены самой сеткай. Больш нічога пра чалавека сервер не пакідае.
| Сетка | Ідэнтыфікатар | Крыніца |
|---|---|---|
| Meta | _fbp, _fbc | Cookies першага боку, зададзеныя пікселем Meta |
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 |
Ніколі не адпраўляюцца: пошта, тэлефон, імя або IP — нават хэшаваныя. Без ідэнтыфікатара кліку не адпраўляецца нічога. Ненакіраваная канверсія менш карысная за дакладны падлік.
Толькі са згодай
Кожны выклік мае той жа бар'ер згоды, што і запіс. Сеанс без згоды не стварае паведамлення канверсіі незалежна ад пераключальніка праекта.
3. Google Ads мае тры ідэнтыфікатары, не адзін
Гэта здзіўляе, таму скажам проста. Google выкарыстоўвае gclid для асобнага рэкламнага кліку. Калі абарона Apple не дазваляе аднесці асобны клік, Google адпраўляе wbraid або gbraid замест яго — яны прадстаўляюць групу клікаў.
Тры значэнні ўзаемавыключальныя: Google адхіляе канверсію з двума. Мы адпраўляем роўна адно, і gclid перамагае пры наяўнасці некалькіх, бо яно найдакладнейшае.
У URL яны толькі адзін раз
Ідэнтыфікатар ёсць у адрасе толькі першай старонкі пасля рэкламнага кліку. Потым тэг Google захоўвае яго ў cookie _gcl_aw . Мы чытаем cookie як запасны варыянт — без гэтага канверсія на трэцяй старонцы не знайшла б ідэнтыфікатара.
4. Наладжванне
Meta, LinkedIn і TikTok
Па два палі: ID пікселя або правіла канверсіі і токен доступу з інтэрфейсу сеткі. Абодва захоўваюцца з шыфраваннем AES-256-GCM і больш не паказваюцца.
Google Ads патрабуе шэсць
Google — выключэнне; варта ведаць прычыну загадзя: у адрозненне ад іншых трох, простага токена доступу няма. Доступ працуе праз OAuth з refresh token, а Ads API дадаткова патрабуе токен распрацоўшчыка.
| Поле | Дзе знайсці |
|---|---|
| ID кліента | Справа ўверсе Google Ads. Толькі лічбы, без злучкоў. |
| ID дзеяння канверсіі | Мэты і канверсіі, затым патрэбнае дзеянне. |
| Токен распрацоўшчыка | API Center у кіраўнічым акаўнце Google Ads. |
| OAuth client ID і secret | Google Cloud Console, Уліковыя даныя, кліент OAuth тыпу «настольная праграма». |
| Refresh token | Адзін раз згенеруйце яго самі для вобласці adwords. |
LinkedIn мае два шляхі, вам патрэбны кароткі
У Campaign Manager: Даныя, Signals Manager, Direct API, Стварыць токен доступу. Гэта шлях рэкламадаўцаў са сваімі данымі — без праграмы распрацоўшчыка і праверкі. Токен не мінае і больш не паказваецца ў Campaign Manager, таму скапіруйце адразу.
Іншы шлях, праграма праз Developer Portal LinkedIn, прызначаны платформам многіх рэкламадаўцаў. Ён патрабуе праверкі старонкі кампаніі і зацверджанага сцэнарыя; нічога з гэтага тут не трэба.
Microsoft Advertising — просты выпадак
Пасля Google Ads чакаеш OAuth, токена распрацоўшчыка і зацвярджэння. Тут наадварот: два палі. ID UET з браўзера і токен, скапіраваны ў Microsoft Advertising пад тэгам UET: «Выкарыстоўваць Conversions API», «Скапіраваць токен». Няма чаго заяўляць.
Выкарыстоўвайце той жа ID тэга, што ў браўзеры. Гэта дазваляе Microsoft лічыць серверную і браўзерную падзеі адной канверсіяй, а не дзвюма.
Токен распрацоўшчыка патрабуе дазволу Google («Basic access»), што займае некалькі дзён. Гэта адзіны крок, які не зрабіць за хвіліну, таму пачніце з яго. Мы не бачым пароль Google, толькі refresh token, які можна адклікаць у любы час.
5. Калі паведамляецца канверсія
Роўна адзін раз на мэту і сеанс. MousePlayer ліквідуе дублікаты перад адпраўкай, а пакет дадаткова мае ID для паўторнай праверкі сеткай. Пяць тавараў у кошыку — адна канверсія, не пяць.
Што вы ўбачыце ў рэкламным акаўнце
Канверсія мае назву мэты, каштоўнасць і валюту, калі зададзены, і час. Звычайна паступае на працягу хвіліны.
Калі нічога не паступае
- Няма ідэнтыфікатара кліку. Наведвальнік не прыйшоў з рэкламы гэтай сеткі або прыйшоў да cookie пікселя. Нічога не адпраўляецца — гэта чакана, не памылка.
- Няма згоды. Бар'ер згоды спрацаваў першым.
- Сетка прыняла выклік, але адхіліла канверсію. Google, TikTok і іншыя вяртаюць HTTP 200 з памылкай у целе. Мы чытаем цела, не толькі статус, і прычына з'яўляецца ў журнале дастаўкі.
Усе згаданыя таварныя знакі належаць адпаведным уладальнікам. MousePlayer не мае дзелавых адносін з гэтымі пастаўшчыкамі.