API-ji za konverzije

1. Zašto uopće na strani servera?

Piksel preglednika mora preživjeti tri stvari prije prijave konverzije: blokator oglasa, postavku sprečavanja praćenja i zatvaranje kartice prije aktiviranja piksela. Serverski poziv preživljava sve tri jer se uopće ne dešava u pregledniku.

MousePlayer već zna kad je jedan od ciljeva ostvaren — tome ciljevi služe. API-ji za konverzije jednostavno prosljeđuju tu činjenicu oglasnoj mreži s našeg servera.

2. Šta šaljemo, a šta nikad ne šaljemo

Jedino što identificira posjetioca u ovim pozivima je kolačić ili identifikator klika koji je sama mreža postavila. Ništa drugo o osobi ne napušta naš server.

Mreža	Korišteni identifikator	Odakle dolazi
Meta	_fbp, _fbc	Vlastiti kolačići koje postavlja Meta piksel
LinkedIn	li_fat_id	Vlastiti kolačić koji postavlja LinkedIn Insight Tag
TikTok	_ttp, ttclid	_ttp je kolačić, ttclid dolazi iz URL-a klika na oglas
Google Ads	gclid, wbraid, gbraid	Iz URL-a klika na oglas ili kasnije iz kolačića _gcl_aw za taj klik
Microsoft Advertising	msclkid	Iz URL-a klika na oglas ili kolačića _uetmsclkid koji upisuje UET oznaka

Samo uz saglasnost

Svaki ovaj poziv prolazi istu provjeru saglasnosti kao samo snimanje. Sesija bez saglasnosti ne proizvodi prijavu konverzije bez obzira na prekidač u postavkama projekta.

3. Google Ads ima tri identifikatora, ne jedan

Ovo iznenađuje ljude, pa treba jasno reći. Google koristi gclid za pojedinačni klik na oglas. Kad Appleova zaštita od praćenja onemogući atribuciju jednog klika, Google šalje wbraid ili gbraid umjesto njega; predstavljaju grupu klikova.

Tri identifikatora su međusobno isključiva — Google odbija konverziju s dva. Šaljemo tačno jedan, a gclid ima prednost kad ih ima više jer je najprecizniji.

U URL-u su samo jednom

Identifikator se pojavljuje u adresi samo na prvoj stranici nakon klika na oglas. Google oznaka ga zatim čuva u kolačiću _gcl_aw za taj klik. Čitamo kolačić kao rezervu — bez njega konverzija na trećoj stranici posjete ne bi pronašla identifikator.

4. Postavljanje

Meta, LinkedIn i TikTok

Po dva polja: ID piksela ili pravila konverzije i pristupni token koji kreirate u interfejsu mreže. Oba se čuvaju šifrirana uz AES-256-GCM i nikad ne prikazuju nakon čuvanja.

Google Ads treba šest

Google je izuzetak i razlog vrijedi znati prije početka: za razliku od ostala tri, ne izdaje jednostavan pristupni token. Pristup ide putem OAuth-a s tokenom za osvježavanje, a Ads API dodatno zahtijeva token programera.

Polje	Gdje ga pronaći
ID klijenta	Gore desno u Google Adsu. Samo cifre, bez crtica.
ID radnje konverzije	Ciljevi i konverzije, zatim radnja na koju želite knjižiti.
Token programera	Vaš upraviteljski račun Google Adsa, API Center.
ID i tajna OAuth klijenta	Google Cloud Console, Credentials, OAuth client vrste „desktop app“.
Token za osvježavanje	Sami ga generirate jednom za opseg adwords.

LinkedIn ima dva puta, a vama treba kraći

U Campaign Manageru: Data, Signals Manager, Direct API, Generate access token. To je put za oglašivače koji šalju vlastite podatke — bez aplikacije programera i pregleda. Token ne ističe i Campaign Manager ga neće ponovo prikazati, pa ga odmah kopirajte.

Drugi put, aplikacija programera zatražena putem LinkedIn Developer Portala, postoji za platforme koje šalju u ime mnogih oglašivača. Zahtijeva provjeru stranice firme i odobren slučaj upotrebe, a ovdje vam ništa od toga ne treba.

Microsoft Advertising je jednostavan

Nakon Google Adsa očekujete istu složenost — OAuth, token programera, korak odobravanja. Upravo suprotno: dva polja. ID UET oznake koju već koristite u pregledniku i token koji kopirate iz Microsoft Advertisinga pod UET oznakom, „Use Conversions API“, „Copy Token“. Ništa ne morate prijavljivati.

Koristite isti ID oznake kao u pregledniku. To omogućava Microsoftu da serverski događaj i događaj preglednika prepozna kao jednu konverziju umjesto dvije.

5. Kad se konverzija prijavljuje

Tačno jednom po cilju i sesiji. MousePlayer sprečava duplikate prije slanja poziva, a sadržaj dodatno nosi ID da mreža to može ponoviti na svojoj strani. Posjetilac koji doda pet artikala u korpu proizvodi jednu konverziju, ne pet.

Šta ćete vidjeti u oglasnom računu

Konverzija sadrži naziv cilja, vrijednost i valutu ako ih postavite te vrijeme događaja. Pri normalnom radu stiže u roku od minute.

Ako ništa ne stiže

• Nema identifikatora klika. Posjetilac nije došao putem oglasa te mreže ili je stigao prije nego što je piksel postavio kolačić. Ništa se ne šalje — to je očekivano, ne greška.
• Nema saglasnosti. Provjera saglasnosti ima prednost.
• Mreža je prihvatila poziv, ali odbila konverziju. Google, TikTok i još neke mreže odgovaraju HTTP 200 s greškom u tijelu odgovora. Čitamo tijelo, ne samo status, i razlog se pojavljuje u zapisu dostava.