Konverzní API
Oznamujte splněné cíle sítím Meta, LinkedIn, TikTok a Google Ads z našeho serveru místo z prohlížeče. Přiřazení probíhá pouze pomocí identifikátoru kliknutí, který nastavila sama síť.
1. Proč vůbec přes server?
Pixel v prohlížeči musí před odesláním konverze překonat tři překážky: blokování reklam, nastavení ochrany před sledováním a zavření karty návštěvníkem dříve, než se pixel spustí. Serverové volání překoná všechny tři, protože vůbec neprobíhá v prohlížeči.
MousePlayer už ví, kdy byl některý z vašich cílů splněn - právě k tomu cíle slouží. Konverzní API tuto skutečnost jednoduše předají reklamní síti z našeho serveru.
Nejde o náhradu vašeho pixelu. Ponechte ho. Každá síť oba zdroje vzájemně deduplikuje a my posíláme identifikátory, které k tomu potřebuje.
2. Co odesíláme a co nikdy neodesíláme
Jediné, co v těchto voláních identifikuje návštěvníka, je cookie nebo identifikátor kliknutí nastavený samotnou sítí. Nic dalšího o dané osobě náš server neopouští.
| Síť | Použitý identifikátor | Odkud pochází |
|---|---|---|
| Meta | _fbp, _fbc | Vlastní cookies nastavené pixelem Meta |
li_fat_id | Vlastní cookie nastavená značkou LinkedIn Insight Tag | |
| TikTok | _ttp, ttclid | _ttp je cookie, ttclid pochází z adresy URL po kliknutí na reklamu |
| Google Ads | gclid, wbraid, gbraid | Z adresy URL po kliknutí na reklamu nebo později z cookie _gcl_aw . |
| Microsoft Advertising | msclkid | Z adresy URL po kliknutí na reklamu nebo z cookie _uetmsclkid zapsané značkou UET |
Nikdy neodesíláme: e-mailovou adresu, telefonní číslo, jméno ani IP adresu, a to ani v podobě hashe. Pokud návštěvník nemá identifikátor kliknutí, neodešle se vůbec nic. Nepřiřazená konverze má pro vás menší hodnotu než přesné počítání.
Pouze se souhlasem
Každé z těchto volání podléhá stejné kontrole souhlasu jako samotný záznam. Relace bez souhlasu nevytvoří hlášení konverze bez ohledu na přepínač v nastavení projektu.
3. Google Ads má tři identifikátory, ne jeden
To bývá překvapivé, proto je dobré to říct přímo. Google používá gclid pro jednotlivé kliknutí na reklamu. Když ochrana Apple před sledováním znemožní přiřadit jednotlivé kliknutí, Google místo toho pošle wbraid nebo gbraid pro skupinu kliknutí.
Tyto tři možnosti se vzájemně vylučují - Google odmítne konverzi obsahující dvě. Odesíláme přesně jednu a gclid má při výskytu více identifikátorů přednost, protože je nejpřesnější.
V adrese URL jsou jen jednou
Identifikátor se v adrese objeví pouze na první stránce po kliknutí na reklamu. Značka Google ho pak uloží do cookie _gcl_aw . Cookie čteme jako záložní možnost - bez ní by konverze na třetí stránce návštěvy žádný identifikátor nenašla.
4. Nastavení
Meta, LinkedIn a TikTok
Pro každou síť dvě pole: ID pixelu nebo konverzního pravidla a přístupový token vytvořený přímo v rozhraní sítě. Oba údaje se ukládají zašifrované pomocí AES-256-GCM a po uložení se už nezobrazí.
Google Ads potřebuje šest údajů
Google je výjimka a důvod je dobré znát předem: na rozdíl od ostatních tří nevydává jednoduchý přístupový token. Přístup využívá OAuth s obnovovacím tokenem a Ads API navíc vyžaduje token vývojáře.
| Pole | Kde ho najdete |
|---|---|
| ID zákazníka | Vpravo nahoře v Google Ads. Pouze číslice, bez pomlček. |
| ID konverzní akce | Goals and conversions, potom akce, ke které chcete konverzi přiřadit. |
| Token vývojáře | V účtu správce Google Ads, v části API Center. |
| ID a tajný klíč klienta OAuth | Google Cloud Console, Credentials, klient OAuth typu „desktop app“. |
| Obnovovací token | Jednou si ho vygenerujete pro rozsah adwords. |
LinkedIn má dvě cesty a vy potřebujete tu kratší
V Campaign Manager: Data, Signals Manager, Direct API, Generate access token. To je cesta pro inzerenty odesílající vlastní data - bez vývojářské aplikace a bez kontroly. Token nevyprší a Campaign Manager ho podruhé neukáže, proto ho ihned zkopírujte.
Druhá cesta, vývojářská aplikace vyžádaná přes LinkedIn Developer Portal, slouží platformám, které odesílají data za mnoho inzerentů. Vyžaduje ověření firemní stránky a schválený případ použití; nic z toho zde nepotřebujete.
Microsoft Advertising je jednoduchý
Po Google Ads byste čekali stejnou náročnost - OAuth, token vývojáře a schvalování. Je to naopak: dvě pole. ID značky UET, kterou už používáte v prohlížeči, a token zkopírovaný z Microsoft Advertising u značky UET přes „Use Conversions API“, „Copy Token“. O nic nežádáte.
Použijte stejné ID značky jako v prohlížeči. Díky tomu Microsoft rozpozná událost ze serveru a z prohlížeče jako jednu konverzi místo dvou.
Token vývojáře vyžaduje schválení od Googlu („Basic access“), které trvá několik dní. To je jediný krok, který nelze dokončit za minutu, proto jím začněte. Vaše heslo ke Googlu nikdy nevidíme - pouze obnovovací token, který můžete kdykoli odvolat.
5. Kdy se konverze hlásí
Přesně jednou na cíl a relaci. MousePlayer potlačí duplicity ještě před odesláním volání a data navíc obsahují ID, podle kterého může síť provést druhou kontrolu na své straně. Návštěvník, který přidá do košíku pět položek, vytvoří jednu konverzi, ne pět.
Co uvidíte v reklamním účtu
Konverze obsahuje název cíle, jeho hodnotu a měnu, pokud je nastavena, a čas splnění. Za běžného provozu dorazí do minuty.
Když nic nedorazí
- Chybí identifikátor kliknutí. Návštěvník nepřišel přes reklamu dané sítě nebo dorazil dříve, než pixel nastavil cookie. Nic se neodešle - to je očekávaný stav, ne chyba.
- Chybí souhlas. Kontrola souhlasu má přednost.
- Síť přijala volání, ale odmítla konverzi. Google, TikTok a několik dalších sítí odpovídají HTTP 200 s chybou v těle odpovědi. Čteme obsah, nejen stavový kód, a důvod se objeví v protokolu doručení.
Všechny uvedené ochranné známky patří příslušným vlastníkům. MousePlayer s těmito poskytovateli nemá obchodní vztah.