Sari la conținut
Ajutor
România
Marketing și urmărire

Cum configurez Conversion API (CAPI) pe server și urmăresc comenzile abandonate?

Configurează Conversion API pe server pentru Facebook, TikTok și Snapchat: tokenuri de acces, tipuri de evenimente, mod test, acoperire pe piețe și comutatorul pentru comenzi abandonate.

Ce face Conversion API

Un Conversion API (CAPI) trimite evenimente de conversie direct de pe serverul Storeep către platforma de reclame, ocolind browserul cumpărătorului. Deoarece rulează server-la-server, nu este afectat de ad blockere, setări de confidențialitate din browser sau limitele de tracking iOS și transmite detalii despre client (hash-uite) pentru a îmbunătăți calitatea potrivirii pentru Smart Bidding și audiențe similare. Pentru pixeli pe partea de client, vezi articolul asociat Browser pixels.

Poți folosi simultan un pixel de browser și un CAPI pentru aceeași platformă. Storeep marchează ambele cu un ID de eveniment comun, construit din tipul evenimentului și numărul comenzii, astfel încât platforma le deduplicatează într-o singură conversie, nu le numără de două ori.

Ce platforme oferă CAPI

  • Facebook / Meta Conversion API.
  • TikTok Events API.
  • Snapchat Conversions API.

X și Google Ads nu au Conversion API pe server în Storeep; funcționează doar pe partea de browser.

Ce se trimite

La fiecare comandă eligibilă, Storeep trimite valoarea și moneda comenzii, produsele din comandă și semnalele cumpărătorului: email hash-uit, telefon hash-uit, un ID client hash-uit (external_id), adresa IP, user agentul și, pentru Facebook și Snapchat, țara pieței hash-uită. De asemenea, transmite orice ID de click din cookie-urile cumpărătorului (Facebook _fbc și _fbp, TikTok ttclid, Snapchat ScCid) pentru ca platforma să poată atribui conversia clickului original.

Tipuri de evenimente de conversie

  • Facebook: doar Lead sau Purchase. Facebook CAPI nu trimite evenimente de tip add-to-cart sau checkout.
  • TikTok: Lead, Purchase, Place an order sau Complete payment.
  • Snapchat: Purchase sau Reserve.

Moneda și comenzile cu valoare zero

Fiecare eveniment folosește moneda propriei comenzi dacă platforma o suportă; altfel, valoarea este convertită în USD. Facebook CAPI ignoră orice comandă cu total 0, deoarece Meta respinge conversiile fără valoare, ceea ce o face consistentă cu pixelul de browser Facebook.

Gating pentru comenzi abandonate

Aceasta este o funcționalitate cheie de înțeles. O comandă nouă declanșează întotdeauna trimiterea prin CAPI. O comandă abandonată este diferită: se trimite doar dacă activezi comutatorul Abandoned orders pentru acea intrare CAPI și doar în momentul când statusul comenzii se schimbă din abandonat în orice alt status.

  • Cu Abandoned orders dezactivat, comenzile abandonate recuperate nu sunt niciodată trimise către platformă.
  • Cu el activat, evenimentul se declanșează când comanda iese din statusul abandonat, fie că schimbi manual statusul, fie că aplicația Automator îl schimbă automat.
  • Dacă Automator nu este instalat, trebuie să muți manual comanda în alt status pentru ca evenimentul să fie trimis.
  • Comutatorul este per intrare, deci poți activa urmărirea comenzilor abandonate pentru un Pixel ID și să o lași dezactivată pentru altul.

Instalarea unui CAPI și câmpurile sale

  1. Deschide Apps din meniul din stânga.
  2. Găsește aplicația Conversion API dorită și apasă Install, apoi confirmă.
  3. Deschide din nou aplicația și apasă Add new pixel pentru a crea o intrare.

Fiecare intrare are aceste câmpuri:

  • Activate: când este activ, evenimentele de conversie sunt trimise server-la-server. Activat implicit.
  • Abandoned orders: comutatorul de gating descris mai sus. Dezactivat implicit.
  • Ad account name: o etichetă doar pentru referința ta.
  • Pixel ID: Pixel ID-ul tău Meta, TikTok sau Snapchat.
  • Markets: piețele magazinului acoperite de această intrare. Selectează una sau mai multe.
  • Conversion event type: opțiunile platformei menționate mai sus.
  • Access token: tokenul de acces pentru Conversions API generat în events manager-ul platformei. Obligatoriu.
  • Activate test mode: când este activ, evenimentele sunt trimise ca evenimente de test.
  • Test code: codul de test pentru evenimente de la platformă, de exemplu TEST_1234. Obligatoriu când modul de test este activ.

Modul de test

Cu modul de test activ, evenimentele apar în secțiunea de test a platformei, ca să poți confirma integrarea fără a afecta datele reale. Evenimentele de test nu influențează licitarea sau optimizarea reclamelor, deci dezactivează modul de test înainte de a lansa campanii live.

Cum delimitează piețele un CAPI

O intrare CAPI se declanșează doar pentru comenzile plasate în piețele selectate pe acea intrare. O comandă dintr-o piață nealeasă nu declanșează acea intrare, astfel poți folosi un Pixel ID și token de acces diferit pentru fiecare țară din același magazin.

Lucruri de verificat

  • Folosește același Pixel ID pe pixelul de browser și pe CAPI, ca platforma să deduplicateze cele două livrări într-o singură conversie.
  • Dacă evenimentele nu mai apar în events manager-ul platformei, tokenul de acces poate fi expirat. Generează unul nou și actualizează intrarea.
  • Fiecare intrare este independentă. Poți adăuga mai multe intrări per platformă, fiecare cu propriul Pixel ID, token de acces, piețe, tip de eveniment și setare pentru comenzi abandonate.
  • Nu uita să dezactivezi modul de test înainte de a trece live, altfel conversiile reale nu vor fi contorizate.