API-ji za konverzije
Prijavite ciljeve Meti, LinkedInu, TikToku i Google Adsu s našeg poslužitelja umjesto iz preglednika – uz uparivanje samo putem identifikatora klika koji je postavila sama mreža.
1. Zašto uopće poslužiteljska strana?
Piksel u pregledniku mora preživjeti tri stvari prije prijave konverzije: blokator oglasa, postavku sprječavanja praćenja i zatvaranje kartice prije njegova pokretanja. Poziv s poslužitelja preživljava sve tri jer se uopće ne događa u pregledniku.
MousePlayer već zna kada je ostvaren jedan od vaših ciljeva – tome ciljevi služe. API-ji za konverzije samo prosljeđuju tu činjenicu oglasnoj mreži s našeg poslužitelja.
Ovo nije zamjena za vaš piksel. Zadržite ga. Svaka mreža uklanja duplikate između njih, a mi šaljemo potrebne identifikatore.
2. Što šaljemo, a što nikad ne šaljemo
Jedino što u tim pozivima identificira posjetitelja jest kolačić ili identifikator klika koji je postavila sama mreža. Ništa drugo o osobi ne napušta naš poslužitelj.
| Mreža | Korišteni identifikator | Odakle dolazi |
|---|---|---|
| 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 poslije iz kolačića _gcl_aw |
| Microsoft Advertising | msclkid | Iz URL-a klika na oglas ili iz kolačića _uetmsclkid koji zapisuje oznaka UET |
Nikad se ne šalje: adresa e-pošte, telefonski broj, ime ni IP adresa – čak ni u obliku sažetka. Ako posjetitelj nema identifikator klika, ništa se ne šalje. Neciljana konverzija vrijedi vam manje od točnog broja.
Samo uz privolu
Svaki je poziv iza iste provjere privole kao i samo snimanje. Sesija bez privole ne stvara prijavu konverzije, bez obzira na prekidač u postavkama projekta.
3. Google Ads ima tri identifikatora, a ne jedan
To iznenađuje ljude pa vrijedi jasno navesti. Google koristi gclid za pojedini klik na oglas. Kad Appleova zaštita od praćenja onemogući pripisivanje pojedinog klika, Google umjesto toga šalje wbraid ili gbraid, koji predstavljaju skupinu klikova.
Tri identifikatora međusobno se isključuju – Google odbija konverziju koja nosi dva. Šaljemo točno jedan, a gclid ima prednost kad ih je prisutno više jer je najprecizniji.
U URL-u se pojavljuju samo jednom
Identifikator se pojavljuje u adresi samo na prvoj stranici nakon klika na oglas. Google oznaka zatim ga pohranjuje u kolačić _gcl_aw. Kolačić čitamo kao pričuvni izvor – bez njega konverzija na trećoj stranici posjeta ne bi pronašla nijedan identifikator.
4. Postavljanje
Meta, LinkedIn i TikTok
Po dva polja: ID piksela ili pravila konverzije i pristupni token koji izradite u sučelju same mreže. Oba se pohranjuju šifrirana algoritmom AES-256-GCM i nakon spremanja više se ne prikazuju.
Google Ads zahtijeva šest
Google je iznimka, a razlog vrijedi znati prije početka: za razliku od ostala tri pružatelja ne izdaje jednostavan pristupni token. Pristup ide putem OAuth-a s tokenom za osvježavanje, a Ads API dodatno zahtijeva razvojni token.
| Polje | Gdje ga pronaći |
|---|---|
| ID korisnika | Gore desno u Google Adsu. Samo znamenke, bez crtica. |
| ID radnje konverzije | Ciljevi i konverzije, zatim radnja kojoj želite pripisati konverziju. |
| Razvojni token | Vaš upraviteljski račun za Google Ads, Centar za API. |
| ID i tajna OAuth klijenta | Google Cloud konzola, Vjerodajnice, OAuth klijent vrste „aplikacija za stolna računala“. |
| Token za osvježavanje | Sami ga generirate jednom za opseg adwords. |
LinkedIn ima dva puta, a vama treba kraći
U Upravitelju kampanja: Podaci, Upravitelj signala, Izravni API, Generirajte pristupni token. To je put za oglašivače koji šalju vlastite podatke – bez razvojne aplikacije i provjere. Token ne istječe, a Upravitelj kampanja neće ga prikazati drugi put pa ga odmah kopirajte.
Drugi put, razvojna aplikacija zatražena putem LinkedInova razvojnog portala, namijenjen je platformama koje šalju podatke u ime mnogih oglašivača. Zahtijeva provjeru stranice poduzeća i odobren slučaj upotrebe; ovdje vam ništa od toga ne treba.
Microsoft Advertising je jednostavan
Nakon Google Adsa očekujete istu složenost – OAuth, razvojni token, korak odobravanja. Suprotno je: dva polja. ID oznake UET koji već koristite u pregledniku i token koji kopirate iz Microsoft Advertisinga pod oznakom UET, „Koristite Conversions API“, „Kopirajte token“. Ne trebate ništa zatražiti.
Koristite isti ID oznake kao za oznaku u pregledniku. Tako Microsoft prepoznaje događaj s poslužitelja i događaj iz preglednika kao jednu konverziju umjesto dvije.
Razvojni token zahtijeva Googleovo odobrenje („Osnovni pristup“), što traje nekoliko dana. To je jedini korak koji ne možete završiti u minuti pa počnite od njega. Nikad ne vidimo vašu Google lozinku – samo token za osvježavanje, koji možete opozvati bilo kada.
5. Kada se konverzija prijavljuje
Točno jednom po cilju i sesiji. MousePlayer sprječava ponavljanje prije slanja poziva, a korisni teret dodatno nosi ID kako bi i mreža mogla spriječiti ponavljanje. Posjetitelj koji doda pet proizvoda u košaricu stvara jednu konverziju, a ne pet.
Što ćete vidjeti na oglasnom računu
Konverzija sadrži naziv cilja, njegovu vrijednost i valutu ako ste je postavili te vrijeme događaja. U uobičajenom radu stiže unutar minute.
Ako ništa ne stigne
- Nema identifikatora klika. Posjetitelj 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, a ne pogreška.
- Nema privole. Provjera privole imala je prednost.
- Mreža je prihvatila poziv, ali odbila konverziju. Google, TikTok i još neki odgovaraju s HTTP 200 i pogreškom u tijelu odgovora. Čitamo tijelo, ne samo status, a razlog se pojavljuje u dnevniku isporuka.
Svi ovdje navedeni žigovi pripadaju svojim vlasnicima. MousePlayer nema poslovni odnos s tim pružateljima.