API за реализации

1. Защо изобщо от страната на сървъра?

Пикселът в браузъра трябва да преодолее три неща, преди да отчете реализация: блокиране на реклами, настройка против проследяване и затваряне на раздела от посетителя, преди пикселът да се задейства. Сървърното извикване преодолява и трите, защото изобщо не се случва в браузъра.

MousePlayer вече знае кога е постигната някоя от целите ви — за това служат целите. API за реализации просто предават този факт на рекламната мрежа от сървъра ни.

2. Какво изпращаме — и какво никога не изпращаме

Единственото, което идентифицира посетителя в тези извиквания, е бисквитката или идентификаторът на кликване, зададен от самата мрежа. Нищо друго за човека не напуска сървъра ни.

Мрежа	Използван идентификатор	Откъде идва
Meta	_fbp, _fbc	Бисквитки от първа страна, зададени от пиксела на Meta
LinkedIn	li_fat_id	Бисквитка от първа страна, зададена от LinkedIn Insight Tag
TikTok	_ttp, ttclid	_ttp е бисквитка, ttclid идва от URL адреса на рекламното кликване
Google Ads	gclid, wbraid, gbraid	От URL адреса на рекламното кликване или впоследствие от бисквитката _gcl_aw
Microsoft Advertising	msclkid	От URL адреса на рекламното кликване или от бисквитката _uetmsclkid, която UET маркерът записва

Само със съгласие

Всяко от тези извиквания е зад същата проверка за съгласие като самия запис. Сесия без съгласие не води до отчет за реализация, независимо от превключвателя в настройките на проекта.

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

Това изненадва хората, затова го казваме ясно. Google използва gclid за отделно рекламно кликване. Когато защитата от проследяване на Apple прави отделното кликване неотнесимо, Google изпраща wbraid или gbraid вместо него, които представляват група кликвания.

Трите са взаимно изключващи се — Google отхвърля реализация с два. Изпращаме точно един и gclid има предимство, когато присъства повече от един, защото е най-точният.

В URL адреса са само веднъж

Идентификаторът се появява в адреса само на първата страница след рекламното кликване. След това маркерът на Google го съхранява в бисквитката _gcl_aw. Прочитаме бисквитката като резервен вариант — без нея реализация на третата страница от посещението не би намерила никакъв идентификатор.

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: Данни, Мениджър на сигнали, Директен API, Генериране на токен за достъп. Това е пътят за рекламодатели, които изпращат собствените си данни — без приложение за разработчици и без преглед. Токенът не изтича, а Campaign Manager няма да го покаже втори път, затова го копирайте веднага.

Другият път — приложение за разработчици, заявено през Developer Portal на LinkedIn — е за платформи, които изпращат от името на много рекламодатели. Изисква потвърждение на фирмената страница и одобрен случай на употреба, а тук нищо от това не ви трябва.

Microsoft Advertising е лесният вариант

След Google Ads очаквате същата сложност — OAuth, токен за разработчици, стъпка за одобрение. Точно обратното: две полета. Идентификаторът на UET маркера, който вече използвате в браузъра, и токен, който копирате от Microsoft Advertising под UET маркера, „Използване на Conversions API“, „Копиране на токена“. Няма какво да заявявате.

Използвайте същия идентификатор на маркера като в браузъра. Така Microsoft разпознава сървърното събитие и събитието от браузъра като една реализация, а не две.

5. Кога се отчита реализация

Точно веднъж на цел и сесия. MousePlayer премахва повторенията, преди извикването да бъде изпратено, а полезните данни допълнително съдържат идентификатор, за да може мрежата повторно да ги отстрани от своя страна. Посетител, който добави пет артикула в кошницата, произвежда една реализация, а не пет.

Какво ще видите в рекламния си акаунт

Реализацията съдържа името на целта, стойността и валутата ѝ, ако сте ги задали, и времето на настъпване. При нормална работа пристига в рамките на минута.

Ако нищо не пристига

• Няма идентификатор на кликване. Посетителят не е дошъл през реклама от тази мрежа или е пристигнал, преди пикселът да е задал бисквитката си. Нищо не се изпраща — това е очаквано, не е грешка.
• Няма съгласие. Проверката за съгласие е първа.
• Мрежата е приела извикването, но е отхвърлила реализацията. Google, TikTok и няколко други отговарят с HTTP 200 и грешка в тялото на отговора. Прочитаме тялото, а не само състоянието, и причината се появява в дневника за доставяне.