API-uri de conversii
Raportați obiectivele către Meta, LinkedIn, TikTok și Google Ads de pe serverul nostru, nu din browser — asociate doar prin identificatorul de clic stabilit de rețea.
1. De ce pe server?
Pixelul din browser trebuie să treacă de trei obstacole înaintea raportării: blocatorul de reclame, prevenirea urmăririi și închiderea filei înainte de activare. Apelul pe server trece de toate fiindcă nu rulează în browser.
MousePlayer știe deja când un obiectiv a fost atins — acesta este scopul obiectivelor. API-urile de conversii doar transmit informația rețelei publicitare de pe server.
Nu înlocuiește pixelul. Păstrați-l. Fiecare rețea deduplică cele două căi, iar noi trimitem identificatorii necesari.
2. Ce trimitem și ce nu trimitem niciodată
Singurul lucru care identifică vizitatorul în aceste apeluri este cookie-ul sau identificatorul de clic stabilit chiar de rețea. Nicio altă informație despre persoană nu părăsește serverul.
| Rețea | Identificator folosit | Sursă |
|---|---|---|
| Meta | _fbp, _fbc | Cookie-uri de primă parte setate de pixelul Meta |
li_fat_id | Cookie de primă parte setat de LinkedIn Insight Tag | |
| TikTok | _ttp, ttclid | _ttp este cookie, ttclid provine din URL-ul clicului pe reclamă |
| Google Ads | gclid, wbraid, gbraid | Din URL-ul clicului pe reclamă sau ulterior din cookie-ul _gcl_aw. |
| Microsoft Advertising | msclkid | Din URL-ul clicului pe reclamă sau din cookie-ul _uetmsclkid scris de eticheta UET |
Nu se trimit niciodată: e-mail, telefon, nume sau IP — nici măcar sub formă de hash. Fără identificator de clic nu se trimite nimic. O conversie neatribuită valorează mai puțin decât o numărătoare corectă.
Doar cu consimțământ
Toate apelurile depind de aceeași condiție de consimțământ ca înregistrarea. Sesiunea fără acord nu produce raport de conversie, indiferent de comutatorul proiectului.
3. Google Ads are trei identificatori, nu unul
Merită spus clar, fiindcă surprinde: Google folosește gclid pentru un clic publicitar individual. Când prevenirea urmăririi Apple împiedică atribuirea, Google trimite wbraid sau gbraid, care reprezintă un grup de clicuri.
Cei trei se exclud reciproc — Google respinge conversia cu doi identificatori. Trimitem exact unul, iar gclid are prioritate dacă sunt mai mulți, fiind cel mai precis.
Sunt în URL o singură dată
Identificatorul apare în adresă doar pe prima pagină după clic. Eticheta Google îl păstrează apoi în cookie-ul _gcl_aw. Citim cookie-ul ca rezervă — fără el, conversia de pe a treia pagină nu ar găsi identificatorul.
4. Configurare
Meta, LinkedIn și TikTok
Câte două câmpuri: ID-ul pixelului sau regulii de conversie și tokenul de acces creat în interfața rețelei. Ambele se stochează criptat cu AES-256-GCM și nu se mai afișează după salvare.
Google Ads necesită șase
Google este excepția: spre deosebire de celelalte trei, nu emite un simplu token de acces. Accesul folosește OAuth cu token de reîmprospătare, iar Ads API cere în plus un token de dezvoltator.
| Câmp | Unde îl găsiți |
|---|---|
| ID client | În dreapta sus în Google Ads. Doar cifre, fără cratime. |
| ID acțiune de conversie | Obiective și conversii, apoi acțiunea căreia îi atribuiți conversia. |
| Token de dezvoltator | Contul de manager Google Ads, Centrul API. |
| ID client și secret OAuth | Google Cloud Console, Date de autentificare, client OAuth de tip „aplicație desktop”. |
| Token de reîmprospătare | Îl generați o singură dată pentru domeniul adwords. |
LinkedIn are două căi, iar cea scurtă este potrivită
În Managerul de campanii: Date, Manager de semnale, API direct, Generați token de acces. Aceasta este calea agenților de publicitate care trimit date proprii — fără aplicație de dezvoltator sau evaluare. Tokenul nu expiră și nu va mai fi afișat; copiați-l imediat.
Cealaltă cale, o aplicație cerută prin portalul dezvoltatorilor LinkedIn, este pentru platforme care trimit în numele multor agenți de publicitate. Necesită verificarea paginii firmei și un caz de utilizare aprobat — inutile aici.
Microsoft Advertising este simplu
După Google Ads vă așteptați la OAuth, token de dezvoltator și aprobare. Aici sunt doar două câmpuri: ID-ul etichetei UET deja folosite în browser și tokenul copiat din Microsoft Advertising, la eticheta UET, „Folosiți Conversions API”, „Copiați tokenul”. Fără cerere de aprobare.
Folosiți același ID ca eticheta din browser. Astfel Microsoft recunoaște evenimentul din browser și pe cel de pe server ca o singură conversie.
Tokenul de dezvoltator necesită aprobarea Google („Acces de bază”), care durează câteva zile. Începeți cu acest pas, singurul imposibil într-un minut. Nu vedem parola Google — doar tokenul de reîmprospătare, revocabil oricând.
5. Când se raportează o conversie
Exact o dată pe obiectiv și sesiune. MousePlayer elimină repetările înainte de apel, iar datele includ un ID pentru deduplicare și la rețea. Un vizitator care adaugă cinci articole produce o conversie, nu cinci.
Ce vedeți în contul publicitar
Conversia include numele obiectivului, valoarea și moneda dacă sunt setate și momentul. În mod normal sosește într-un minut.
Dacă nu sosește nimic
- Fără identificator de clic. Vizitatorul nu a venit din reclama rețelei sau a sosit înaintea cookie-ului pixelului. Nu se trimite nimic — este normal.
- Fără consimțământ. Condiția de acord s-a aplicat întâi.
- Rețeaua a acceptat apelul, dar a respins conversia. Google, TikTok și altele răspund HTTP 200 cu eroare în conținut. Citim conținutul, nu doar starea, iar motivul apare în jurnalul livrărilor.
Toate mărcile menționate aici aparțin proprietarilor lor. MousePlayer nu are relații comerciale cu acești furnizori.