API-ji konverzija
Prijavite ciljeve Meta-i, LinkedIn-u, TikTok-u i Google Ads-u sa našeg servera umesto iz pregledača — povezane samo preko identifikatora klika koji je sama mreža postavila.
1. Zašto uopšte slanje sa servera?
Piksel u pregledaču mora da preživi tri stvari pre prijave konverzije: blokator oglasa, podešavanje sprečavanja praćenja i zatvaranje kartice pre pokretanja piksela. Poziv sa servera preživljava sve tri jer se uopšte ne odvija u pregledaču.
MousePlayer već zna kada je neki vaš cilj dostignut — tome ciljevi služe. API-ji konverzija jednostavno prosleđuju tu činjenicu oglasnoj mreži sa našeg servera.
Ovo nije zamena za vaš piksel. Zadržite ga. Svaka mreža međusobno deduplikuje oba izvora, a mi šaljemo potrebne identifikatore.
2. Šta šaljemo — i šta nikada ne šaljemo
Jedino što identifikuje posetioca u ovim pozivima jeste kolačić ili identifikator klika koji je sama mreža postavila. Ništa drugo o osobi ne napušta naš server.
| Mreža | Korišćeni identifikator | Odakle potiče |
|---|---|---|
| Meta | _fbp, _fbc | Kolačići prve strane koje postavlja Meta piksel |
li_fat_id | Kolačić prve strane 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 |
| Microsoft Advertising | msclkid | Iz URL-a klika na oglas ili iz kolačića _uetmsclkid koji upisuje UET oznaka |
Nikada se ne šalju: imejl adresa, broj telefona, ime ili IP adresa — čak ni heširani. Ako posetilac nema identifikator klika, ništa se ne šalje. Neciljana konverzija vredi vam manje od tačnog broja.
Samo uz saglasnost
Svaki od ovih poziva uslovljen je istom saglasnošću kao i samo snimanje. Sesija bez saglasnosti ne proizvodi prijavu konverzije, bez obzira na prekidač u podešavanjima projekta.
3. Google Ads ima tri identifikatora, a ne jedan
Ovo iznenađuje ljude, pa vredi reći jasno. Google koristi gclid za pojedinačni klik na oglas. Kada Apple-ovo sprečavanje praćenja onemogući pripisivanje pojedinačnog klika, Google umesto njega šalje wbraid ili gbraid, koji predstavljaju grupu klikova.
Ta tri se međusobno isključuju — Google odbija konverziju sa dva. Šaljemo tačno jedan, a gclid ima prednost kada ih je prisutno više jer je najprecizniji.
U URL-u su samo jednom
Identifikator se pojavljuje u adresi samo na prvoj stranici posle klika na oglas. Google oznaka ga zatim čuva u kolačiću _gcl_aw. Kolačić čitamo kao rezervni izvor — bez njega konverzija na trećoj stranici posete ne bi pronašla identifikator.
4. Podešavanje
Meta, LinkedIn i TikTok
Po dva polja: ID piksela ili pravila konverzije i pristupni token koji napravite u interfejsu same mreže. Oba se čuvaju šifrovano pomoću AES-256-GCM i nikada se ponovo ne prikazuju nakon čuvanja.
Google Ads zahteva šest
Google je izuzetak i razlog vredi znati pre početka: za razliku od ostala tri, Google ne izdaje jednostavan pristupni token. Pristup ide kroz OAuth sa tokenom za osvežavanje, a Ads API dodatno zahteva token programera.
| Polje | Gde ga pronaći |
|---|---|
| ID klijenta | Gore desno u Google Ads-u. Samo cifre, bez crtica. |
| ID radnje konverzije | Goals and conversions, pa radnja kojoj želite da se ovo pripiše. |
| Token programera | Vaš Google Ads menadžerski nalog, API Center. |
| ID i tajna OAuth klijenta | Google Cloud Console, Credentials, OAuth klijent tipa „desktop app“. |
| Token za osvežavanje | Sami ga generišete jednom za opseg adwords. |
LinkedIn ima dva puta, a vama treba kraći
U Campaign Manager-u: Data, Signals Manager, Direct API, Generate access token. To je put za oglašivače koji šalju sopstvene podatke — bez aplikacije programera i provere. Token ne ističe, a Campaign Manager ga neće prikazati drugi put, pa ga odmah kopirajte.
Drugi put, aplikacija programera zatražena preko LinkedIn Developer Portal-a, postoji za platforme koje šalju u ime više oglašivača. Zahteva potvrdu stranice kompanije i odobren slučaj upotrebe, a ništa od toga vam ovde ne treba.
Microsoft Advertising je jednostavan
Posle Google Ads-a očekujete istu složenost — OAuth, token programera, korak odobrenja. Suprotno je: dva polja. ID UET oznake koji već koristite u pregledaču i token koji kopirate iz Microsoft Advertising-a pod UET tag, „Use Conversions API“, „Copy Token“. Nema zahteva za odobrenje.
Koristite isti ID oznake kao u pregledaču. Tako Microsoft prepoznaje serverski događaj i događaj pregledača kao jednu konverziju umesto dve.
Token programera zahteva Google-ovo odobrenje („Basic access“), što traje nekoliko dana. To je jedini korak koji ne možete da završite za minut, pa počnite njime. Nikada ne vidimo vašu Google lozinku — samo token za osvežavanje, koji možete da opozovete u svakom trenutku.
5. Kada se konverzija prijavljuje
Tačno jednom po cilju i sesiji. MousePlayer uklanja duplikate pre slanja poziva, a podaci dodatno sadrže ID, tako da mreža može da ih ukloni i na svojoj strani. Posetilac koji doda pet artikala u korpu proizvodi jednu konverziju, a ne pet.
Šta ćete videti na oglasnom nalogu
Konverzija sadrži naziv cilja, njegovu vrednost i valutu ako je postavljena, kao i vreme događaja. Pri normalnom radu stiže u roku od minuta.
Ako ništa ne stiže
- Nema identifikatora klika. Posetilac nije došao preko oglasa te mreže ili je stigao pre nego što je piksel postavio kolačić. Ništa se ne šalje — to je očekivano, nije greška.
- Nema saglasnosti. Uslov saglasnosti ima prednost.
- Mreža je prihvatila poziv, ali odbila konverziju. Google, TikTok i drugi odgovaraju sa HTTP 200 i greškom unutar tela odgovora. Čitamo telo, a ne samo status, i razlog se pojavljuje u evidenciji isporuke.
Svi ovde navedeni žigovi pripadaju svojim vlasnicima. MousePlayer nema poslovni odnos sa ovim pružaocima usluga.