Konverziós API-k
A célok teljesülését a böngésző helyett szerverünkről jelentheti a Meta, a LinkedIn, a TikTok és a Google Ads felé — kizárólag a hálózat saját kattintásazonosítója alapján egyeztetve.
1. Miért egyáltalán szerveroldalon?
A böngészős pixelnek három akadályt kell leküzdenie a konverzió jelentéséig: a reklámblokkolót, a követésvédelmi beállítást és azt, hogy a látogató bezárja a lapot a pixel lefutása előtt. A szerveroldali hívás mindhármat túléli, mert egyáltalán nem a böngészőben történik.
A MousePlayer már tudja, mikor teljesült valamelyik célja — erre valók a célok. A konverziós API-k ezt a tényt egyszerűen szerverünkről továbbítják a hirdetési hálózatnak.
Ez nem helyettesíti a pixelt. Tartsa meg. Minden hálózat kiszűri a két forrás közötti duplikációkat, mi pedig elküldjük az ehhez szükséges azonosítókat.
2. Mit küldünk — és mit soha
E hívásokban a látogatót kizárólag a hálózat saját maga által beállított sütije vagy kattintásazonosítója azonosítja. Semmi más személyes adat nem hagyja el a szerverünket.
| Hálózat | Használt azonosító | Honnan származik |
|---|---|---|
| Meta | _fbp, _fbc | A Meta-pixel által beállított, első féltől származó sütik |
li_fat_id | A LinkedIn Insight Tag által beállított, első féltől származó süti | |
| TikTok | _ttp, ttclid | _ttp egy süti, a ttclid a hirdetésre kattintás URL-jéből származik |
| Google Ads | gclid, wbraid, gbraid | A hirdetésre kattintás URL-jéből vagy később a _gcl_aw sütiből |
| Microsoft Advertising | msclkid | A hirdetésre kattintás URL-jéből vagy a UET-címke által írt _uetmsclkid sütiből |
Soha nem küldünk: e-mail-címet, telefonszámot, nevet vagy IP-címet — még kivonatolva sem. Ha a látogatónak nincs kattintásazonosítója, semmit nem küldünk. A célhoz nem rendelhető konverzió kevesebbet ér Önnek, mint a pontos számlálás.
Csak hozzájárulással
Minden ilyen hívásra ugyanaz a hozzájárulási ellenőrzés vonatkozik, mint magára a felvételre. Hozzájárulás nélküli munkamenetből nem készül konverziós jelentés, függetlenül a projektbeállítás kapcsolójától.
3. A Google Ads három azonosítót használ, nem egyet
Ez sokakat meglep, ezért érdemes világosan kimondani. Egyetlen hirdetéskattintáshoz a Google ezt használja: gclid. Ha az Apple követésvédelme miatt egyetlen kattintás nem rendelhető forráshoz, a Google helyette wbraid vagy gbraid értéket küld, amelyek kattintások csoportját jelölik.
A három kölcsönösen kizárja egymást — a Google elutasítja a két azonosítót tartalmazó konverziót. Pontosan egyet küldünk, és ha több is jelen van, a gclid élvez elsőbbséget, mert ez a legpontosabb.
Csak egyszer vannak az URL-ben
Az azonosító a hirdetéskattintás utáni első oldal címében jelenik meg. A Google-címke ezután a _gcl_aw sütibe menti. Tartalékként a sütit olvassuk — nélküle a látogatás harmadik oldalán létrejövő konverzióhoz egyáltalán nem lenne azonosító.
4. Beállítás
Meta, LinkedIn és TikTok
Mindegyikhez két mező kell: a pixel vagy konverziós szabály azonosítója és a hálózat saját felületén létrehozott hozzáférési token. Mindkettőt AES-256-GCM titkosítással tároljuk, és mentés után többé nem mutatjuk meg.
A Google Adshez hat kell
A Google kivétel; az okát még kezdés előtt érdemes ismerni: a másik hárommal ellentétben nem ad egyszerű hozzáférési tokent. A hozzáférés OAuth-on, frissítési tokennel működik, az Ads API pedig ezenfelül kér egy fejlesztői tokent.
| Mező | Hol található |
|---|---|
| Ügyfélazonosító | A Google Ads jobb felső sarkában. Csak számjegyek, kötőjelek nélkül. |
| Konverziós művelet azonosítója | Célok és konverziók, majd a művelet, amelyhez ezt el szeretné könyvelni. |
| Fejlesztői token | Google Ads-kezelői fiókja API-központjában. |
| OAuth-kliensazonosító és titkos kulcs | Google Cloud Console, Hitelesítési adatok, „asztali alkalmazás” típusú OAuth-kliens. |
| Frissítési token | Ezt egyszer maga generálja ehhez a hatókörhöz: adwords. |
A LinkedInhez két út vezet; a rövidre van szüksége
A Campaign Managerben: Adatok, Jelzéskezelő, Közvetlen API, Hozzáférési token generálása. Ez a saját adataikat küldő hirdetők útja — nincs fejlesztői alkalmazás vagy felülvizsgálat. A token nem jár le, és a Campaign Manager másodszor már nem mutatja meg, ezért azonnal másolja ki.
A másik út, a LinkedIn Developer Portalon igényelt fejlesztői alkalmazás, a sok hirdető nevében küldő platformoknak készült. Ellenőrzött vállalati oldal és jóváhagyott felhasználási eset kell hozzá; itt egyikre sincs szüksége.
A Microsoft Advertising az egyszerű eset
A Google Ads után ugyanazt a terhet várná: OAuth-ot, fejlesztői tokent, jóváhagyást. Épp ellenkezőleg: két mező kell. A böngészőben már használt UET-címke azonosítója és a Microsoft Advertising UET-címkéjénél a „Conversions API használata”, „Token másolása” alatt kimásolt token. Semmit nem kell igényelni.
Használja a böngészős címkével azonos címkeazonosítót. A Microsoft ebből ismeri fel, hogy a szerveroldali és a böngészős esemény egyetlen konverzió, nem kettő.
A fejlesztői tokenhez a Google jóváhagyása szükséges („Alapszintű hozzáférés”), ez néhány napot igényel. Ezt az egy lépést nem tudja egy perc alatt elintézni, ezért ezzel kezdjen. Google-jelszavát soha nem látjuk — csak a frissítési tokent, amelyet bármikor visszavonhat.
5. Mikor jelentünk konverziót
Célonként és munkamenetenként pontosan egyszer. A MousePlayer még a hívás elküldése előtt kiszűri az ismétlést, az adatcsomag pedig azonosítót is tartalmaz, hogy a hálózat a saját oldalán ismét kiszűrhesse. Az öt terméket kosárba helyező látogató egy konverziót eredményez, nem ötöt.
Mit lát majd a hirdetési fiókban
A konverzió tartalmazza célja nevét, a megadott értéket és pénznemet, valamint a teljesülés időpontját. Normál működés mellett egy percen belül megérkezik.
Ha semmi nem érkezik
- Nincs kattintásazonosító. A látogató nem az adott hálózat hirdetésén át érkezett, vagy a pixel sütijének beállítása előtt jött. Semmit nem küldünk — ez a várt működés, nem hiba.
- Nincs hozzájárulás. Az ellenőrzés megelőzte a küldést.
- A hálózat fogadta a hívást, de elutasította a konverziót. A Google, a TikTok és több más szolgáltató HTTP 200-zal, a válasz törzsében pedig hibával válaszol. A törzset olvassuk, nem csupán az állapotkódot; az ok megjelenik a kézbesítési naplóban.
Az itt említett védjegyek a tulajdonosaikhoz tartoznak. A MousePlayer nem áll üzleti kapcsolatban ezekkel a szolgáltatókkal.