Konverzné API
Oznamujte dosiahnutie cieľov platformám Meta, LinkedIn, TikTok a Google Ads z nášho servera namiesto prehliadača – s priradením iba cez identifikátor kliknutia nastavený samotnou sieťou.
1. Prečo vôbec na strane servera?
Pixel v prehliadači musí pred nahlásením konverzie prekonať tri veci: blokovač reklám, nastavenie ochrany pred sledovaním a zatvorenie karty návštevníkom pred spustením pixelu. Serverové volanie prekoná všetky tri, pretože vôbec neprebieha v prehliadači.
MousePlayer už vie, kedy bol dosiahnutý niektorý z vašich cieľov – na to ciele slúžia. Konverzné API túto skutočnosť jednoducho odovzdajú reklamnej sieti z nášho servera.
Nie je to náhrada vášho pixelu. Ponechajte ho. Každá sieť odstraňuje duplicity medzi oboma zdrojmi a my posielame identifikátory potrebné na tento účel.
2. Čo posielame – a čo nikdy neposielame
Jediné, čo pri týchto volaniach identifikuje návštevníka, je súbor cookie alebo identifikátor kliknutia nastavený samotnou sieťou. Žiadne ďalšie údaje o osobe náš server neopúšťajú.
| Sieť | Použitý identifikátor | Odkiaľ pochádza |
|---|---|---|
| Meta | _fbp, _fbc | Súbory cookie prvej strany nastavené pixelom Meta |
li_fat_id | Súbor cookie prvej strany nastavený značkou LinkedIn Insight Tag | |
| TikTok | _ttp, ttclid | _ttp je súbor cookie, ttclid pochádza z URL kliknutia na reklamu |
| Google Ads | gclid, wbraid, gbraid | Z URL kliknutia na reklamu alebo následne zo súboru cookie _gcl_aw v prehliadači |
| Microsoft Advertising | msclkid | Z URL kliknutia na reklamu alebo zo súboru cookie _uetmsclkid, ktorý zapisuje značka UET |
Nikdy neposielame: e-mailovú adresu, telefónne číslo, meno ani IP adresu – dokonca ani v hašovanej podobe. Ak návštevník nemá identifikátor kliknutia, neodošle sa vôbec nič. Nepriradená konverzia má pre vás menšiu hodnotu než presný počet.
Iba so súhlasom
Každé z týchto volaní podlieha rovnakej podmienke súhlasu ako samotné zaznamenávanie. Relácia bez súhlasu nevytvorí hlásenie konverzie bez ohľadu na prepínač v nastaveniach projektu.
3. Google Ads má tri identifikátory, nie jeden
Ľudí to prekvapuje, preto to treba povedať jasne. Google používa gclid pre jedno kliknutie na reklamu. Keď ochrana pred sledovaním od Apple znemožní priradenie konkrétneho kliknutia, Google posiela wbraid alebo gbraid namiesto neho; tie označujú skupinu kliknutí.
Tieto tri možnosti sa navzájom vylučujú – Google odmietne konverziu s dvoma identifikátormi. Posielame presne jeden a gclid má pri súčasnej prítomnosti viacerých prednosť, pretože je najpresnejší.
V URL sú iba raz
Identifikátor sa v adrese objaví iba na prvej stránke po kliknutí na reklamu. Značka Google ho potom uloží do súboru cookie _gcl_aw. Súbor cookie čítame ako náhradný zdroj – bez neho by konverzia na tretej stránke návštevy nenašla žiadny identifikátor.
4. Nastavenie
Meta, LinkedIn a TikTok
Každá platforma má dve polia: ID pixelu alebo konverzného pravidla a prístupový token, ktorý vytvoríte vo vlastnom rozhraní siete. Obe hodnoty sa ukladajú šifrované pomocou AES-256-GCM a po uložení sa už nikdy nezobrazia.
Google Ads ich potrebuje šesť
Google je výnimka a dôvod sa oplatí poznať pred začiatkom: na rozdiel od ostatných troch neposkytuje jednoduchý prístupový token. Prístup funguje cez OAuth s obnovovacím tokenom a Ads API navyše vyžaduje vývojársky token.
| Pole | Kde ho nájdete |
|---|---|
| ID zákazníka | Vpravo hore v Google Ads. Iba číslice, bez pomlčiek. |
| ID konverznej akcie | Ciele a konverzie, potom akcia, ku ktorej chcete konverziu priradiť. |
| Vývojársky token | Váš účet správcu Google Ads, Centrum API. |
| ID klienta OAuth a tajný kľúč | Konzola Google Cloud, Poverenia, klient OAuth typu „počítačová aplikácia“. |
| Obnovovací token | Jednorazovo si ho vygenerujete pre rozsah adwords. |
LinkedIn má dve cesty a vy potrebujete tú kratšiu
V Správcovi kampaní: Údaje, Správca signálov, Priame API, Vygenerovať prístupový token. Je to cesta pre inzerentov odosielajúcich vlastné údaje – bez vývojárskej aplikácie a posudzovania. Token nevyprší a Správca kampaní ho druhýkrát nezobrazí, preto ho hneď skopírujte.
Druhá cesta, vývojárska aplikácia vyžiadaná cez vývojársky portál LinkedIn, je určená platformám posielajúcim údaje v mene mnohých inzerentov. Vyžaduje overenie firemnej stránky a schválený prípad použitia; tu nič z toho nepotrebujete.
Microsoft Advertising je jednoduchý prípad
Po Google Ads očakávate rovnakú záťaž – OAuth, vývojársky token, schvaľovanie. Opak je pravdou: dve polia. ID značky UET, ktoré už používate v prehliadači, a token skopírovaný z Microsoft Advertising pod značkou UET, „Použiť Conversions API“, „Kopírovať token“. O nič netreba žiadať.
Použite rovnaké ID značky ako pri značke v prehliadači. Vďaka tomu Microsoft rozpozná serverovú udalosť a udalosť prehliadača ako jednu konverziu namiesto dvoch.
Vývojársky token vyžaduje schválenie od Google („Základný prístup“), ktoré trvá niekoľko dní. Je to jediný krok, ktorý nedokončíte za minútu, preto ním začnite. Vaše heslo Google nikdy nevidíme – iba obnovovací token, ktorý môžete kedykoľvek odvolať.
5. Kedy sa konverzia hlási
Presne raz za cieľ a reláciu. MousePlayer potlačí duplicity pred odoslaním volania a dátový balík navyše obsahuje ID, aby sieť mohla duplicity znovu potlačiť na svojej strane. Návštevník, ktorý pridá do košíka päť položiek, vytvorí jednu konverziu, nie päť.
Čo uvidíte v reklamnom účte
Konverzia nesie názov vášho cieľa, jeho hodnotu a menu, ak ste ich nastavili, a čas udalosti. Pri bežnej prevádzke dorazí do minúty.
Ak nič neprichádza
- Žiadny identifikátor kliknutia. Návštevník neprišiel cez reklamu danej siete alebo prišiel skôr, než pixel nastavil súbor cookie. Nič sa neodosiela – ide o očakávané správanie, nie o chybu.
- Bez súhlasu. Podmienka súhlasu má prednosť.
- Sieť prijala volanie, ale odmietla konverziu. Google, TikTok a viaceré ďalšie platformy odpovedajú HTTP 200 s chybou v tele odpovede. Čítame telo, nie iba stav, a dôvod sa zobrazí v denníku doručení.
Všetky uvedené ochranné známky patria príslušným vlastníkom. MousePlayer nemá s týmito poskytovateľmi obchodný vzťah.