API-ji za konverzije

1. Zakaj sploh strežniško?

Piksel v brskalniku mora pred poročanjem o konverziji preživeti tri stvari: blokator oglasov, nastavitev preprečevanja sledenja in obiskovalca, ki zapre zavihek, preden se piksel sproži. Strežniški klic preživi vse tri, ker se sploh ne zgodi v brskalniku.

MousePlayer že ve, kdaj je bil dosežen vaš cilj – temu so cilji namenjeni. API-ji za konverzije to dejstvo preprosto posredujejo oglaševalskemu omrežju z našega strežnika.

2. Kaj pošiljamo in česa nikoli ne pošljemo

Edino, kar v teh klicih identificira obiskovalca, je piškotek ali identifikator klika, ki ga je nastavilo samo omrežje. Nič drugega o osebi ne zapusti našega strežnika.

Omrežje	Uporabljeni identifikator	Od kod izvira
Meta	_fbp, _fbc	Lastni piškotki, ki jih nastavi piksel Meta
LinkedIn	li_fat_id	Lastni piškotek, ki ga nastavi LinkedIn Insight Tag
TikTok	_ttp, ttclid	_ttp je piškotek, ttclid izvira iz URL-ja klika na oglas
Google Ads	gclid, wbraid, gbraid	Iz URL-ja klika na oglas ali pozneje iz piškotka _gcl_aw.
Microsoft Advertising	msclkid	Iz URL-ja klika na oglas ali iz piškotka _uetmsclkid, ki ga zapiše oznaka UET

Samo s privolitvijo

Vsak od teh klicev je za istim preverjanjem privolitve kot samo snemanje. Seja brez privolitve ne ustvari poročila o konverziji, ne glede na stikalo v nastavitvah projekta.

3. Google Ads ima tri identifikatorje, ne enega

To ljudi preseneti, zato povejmo jasno. Google uporablja gclid za posamezen klik na oglas. Če Applovo preprečevanje sledenja onemogoči pripis posameznega klika, Google namesto tega pošlje wbraid ali gbraid, ki predstavljata skupino klikov.

Vsi trije se medsebojno izključujejo – Google zavrne konverzijo, ki vsebuje dva. Pošljemo natanko enega in gclid ima prednost, če jih je prisotnih več, ker je najnatančnejši.

V URL-ju so samo enkrat

Identifikator se pojavi v naslovu samo na prvi strani po kliku na oglas. Oznaka Google ga nato shrani v piškotek _gcl_aw. Piškotek preberemo kot rezervno možnost – brez njega konverzija na tretji strani obiska ne bi našla nobenega identifikatorja.

4. Nastavitev

Meta, LinkedIn in TikTok

Po dve polji: ID piksla ali pravila konverzije in dostopni žeton, ki ga ustvarite v vmesniku omrežja. Oboje se shrani šifrirano z AES-256-GCM in po shranjevanju ni več prikazano.

Google Ads jih potrebuje šest

Google je izjema in razlog je dobro poznati pred začetkom: v nasprotju z drugimi tremi ne izdaja preprostega dostopnega žetona. Dostop poteka prek OAuth z osvežitvenim žetonom, Ads API pa dodatno zahteva razvijalski žeton.

Polje	Kje ga najdete
ID stranke	Zgoraj desno v Google Ads. Samo številke, brez vezajev.
ID dejanja konverzije	Cilji in konverzije, nato dejanje, ki mu želite to pripisati.
Razvijalski žeton	Vaš skrbniški račun Google Ads, Središče API.
ID in skrivnost odjemalca OAuth	Konzola Google Cloud, Poverilnice, Odjemalec OAuth vrste „namizna aplikacija“.
Osvežitveni žeton	Enkrat ga ustvarite sami za obseg adwords.

LinkedIn ima dve poti in potrebujete krajšo

V upravljalniku kampanj: Podatki, Upravljalnik signalov, Neposredni API, Ustvari dostopni žeton. To je pot za oglaševalce, ki pošiljajo lastne podatke – brez razvijalske aplikacije in pregleda. Žeton ne poteče, upravljalnik kampanj pa ga ne pokaže drugič, zato ga takoj kopirajte.

Druga pot, razvijalska aplikacija prek portala LinkedIn Developer, je namenjena platformam, ki pošiljajo v imenu več oglaševalcev. Zahteva potrditev strani podjetja in odobren primer uporabe; tukaj ne potrebujete ničesar od tega.

Microsoft Advertising je preprost

Po Google Ads pričakujete enako zahtevnost – OAuth, razvijalski žeton, odobritev. Tu je ravno nasprotno: dve polji. ID oznake UET, ki ga že uporabljate v brskalniku, in žeton, ki ga kopirate iz Microsoft Advertising pod oznako UET, „Uporabi Conversions API“, „Kopiraj žeton“. Nobene vloge ni treba oddati.

Uporabite isti ID oznake kot pri oznaki v brskalniku. Tako Microsoft prepozna strežniški in brskalniški dogodek kot eno konverzijo namesto dveh.

5. Kdaj se o konverziji poroča

Natanko enkrat na cilj in sejo. MousePlayer prepreči podvojitev pred pošiljanjem klica, podatki pa vsebujejo tudi ID, da lahko omrežje to preveri še na svoji strani. Obiskovalec, ki v košarico doda pet izdelkov, ustvari eno konverzijo, ne petih.

Kaj vidite v oglaševalskem računu

Konverzija vsebuje ime cilja, njegovo vrednost in valuto, če ste jo nastavili, ter čas dogodka. Ob običajnem delovanju prispe v minuti.

Če nič ne prispe

• Ni identifikatorja klika. Obiskovalec ni prišel prek oglasa tega omrežja ali je prispel, preden je piksel nastavil piškotek. Nič se ne pošlje – to je pričakovano, ne napaka.
• Ni privolitve. Preverjanje privolitve je imelo prednost.
• Omrežje je sprejelo klic, vendar zavrnilo konverzijo. Google, TikTok in nekateri drugi vrnejo HTTP 200 ter napako v telesu odgovora. Beremo telo, ne le stanja, razlog pa se prikaže v dnevniku dostave.