Conversion API (CAPI): ghid pentru magazine online

Dacă rulezi Facebook și Instagram Ads și te bazezi doar pe pixel, pierzi date, iar odată cu ele pierzi performanță. Conversion API (CAPI) trimite evenimentele de pe serverul tău direct către Meta și este configurarea standard în 2026. Mai jos vezi ce este, cum funcționează, cum îl implementezi și ce greșeli să eviți.

De ce pixelul singur nu mai e suficient

Pixelul rulează în browserul utilizatorului. Exact acolo se întâmplă cele mai multe pierderi de date, din patru motive.

Cookie-urile third-party dispar. Safari și Firefox le blochează de ani de zile, iar Chrome a restrâns progresiv utilizarea lor. Meta nu mai poate recunoaște ușor același utilizator între site-uri.
iOS și App Tracking Transparency. După ce utilizatorii de iPhone pot refuza urmărirea, o parte din conversiile lor nu mai ajung la Meta. Pentru un magazin cu trafic mobil mare, diferența se vede imediat în raportare.
Adblock și browsere cu protecții. Extensiile și browserele axate pe confidențialitate blochează scriptul pixelului înainte să trimită ceva.
Erori de browser. Pagina de confirmare a comenzii se închide prea repede, conexiunea cade, un script intră în conflict cu altul. Evenimentul de cumpărare, cel mai important, nu pleacă.

Rezultatul: evenimente pierdute, atribuire incompletă și audiențe de remarketing mai mici. Algoritmul Meta primește mai puține semnale, deci optimizează mai slab și cheltuiești bugetul mai puțin eficient.

Un exemplu simplu: magazinul tău înregistrează 400 de comenzi pe lună în backend, dar Ads Manager raportează 290. Cele 110 comenzi lipsă nu sunt inexistente, doar nu au ajuns la Meta. Campaniile par mai puțin profitabile decât sunt, iar tu poți lua decizii greșite, de exemplu să oprești o campanie bună.

Ce este Conversion API

Conversion API trimite evenimentele (vizualizare produs, adăugare în coș, inițiere checkout, cumpărare) de pe serverul tău către Meta, în paralel cu pixelul. Serverul nu depinde de browserul vizitatorului, deci adblockul și restricțiile din browser nu îl afectează. Practic, este varianta server-side tracking pentru Meta.

Nu este un înlocuitor al pixelului. Meta recomandă explicit configurarea redundantă: pixelul prinde semnalele din browser, iar CAPI le completează cu cele care s-ar fi pierdut.

Cum funcționează trimiterea server-side

Când un client finalizează o comandă, backendul magazinului știe sigur că plata a trecut. Acel moment declanșează o cerere către API-ul Meta, care conține:

numele evenimentului (de exemplu Purchase);
valoarea comenzii, moneda și produsele;
parametri de potrivire a utilizatorului (email, telefon, IP, user agent, identificatori Meta);
un event_id unic, folosit la deduplicare.

Meta primește datele, le potrivește cu un cont de Facebook sau Instagram și le folosește la atribuire și optimizare. Pentru o explicație mai largă a principiului, citește ghidul de server-side tracking.

Deduplicarea cu pixelul: rolul lui event_id

Dacă pixelul și CAPI trimit același eveniment, Meta trebuie să știe că e vorba de o singură comandă. Fără asta, în raport apar vânzări duble, ROAS-ul pare umflat, iar algoritmul învață din date false.

Deduplicarea se face prin două câmpuri: event_name și event_id. Același event_id trebuie trimis și din pixel, și din server pentru același eveniment. Un event_id bun este, de exemplu, numărul comenzii pentru Purchase. Pentru evenimentele fără identificator natural (vizualizare produs) generezi un ID la încărcarea paginii și îl pasezi ambelor părți.

Meta deduplică evenimentele primite în aceeași fereastră scurtă de timp. De aceea ambele canale trebuie să folosească aceleași nume de evenimente, scrise identic, și aceleași ID-uri.

Verificare rapidă: în Events Manager, secțiunea de evenimente arată dacă un eveniment vine prin Browser, prin Server sau prin ambele, și ce rată de deduplicare ai. Dacă vezi evenimente Server fără acoperire Browser sau invers, există o problemă de configurare.

Calitatea potrivirii (Event Match Quality) și ce date trimiți

Meta evaluează cât de bine poate lega un eveniment de o persoană reală printr-un scor numit Event Match Quality, de la 0 la 10. Cu cât trimiți mai mulți parametri relevanți, cu atât potrivirea e mai bună și atribuirea mai precisă.

Parametrii utili pentru un magazin online:

email și telefon (hash-uite SHA-256 înainte de trimitere);
prenume, nume, oraș, cod poștal, țară;
ID-ul extern al clientului din sistemul tău;
cookie-urile _fbp și _fbc, plus parametrul fbclid din URL;
adresa IP și user agent-ul vizitatorului.

Exemplu: un magazin care trimite doar IP-ul și user agent-ul rămâne cu un scor modest. Același magazin, după ce adaugă emailul și telefonul din formularul de checkout, urcă de regulă semnificativ. La cumpărare ai aceste date, deci ar trebui să le trimiți mereu. Pentru evenimentele de navigare, unde utilizatorul nu și-a lăsat încă datele, scorul va fi natural mai mic.

Documentația tehnică completă este pe developers.facebook.com.

Opțiuni de implementare

Alegi metoda în funcție de platformă, buget și nivelul de control dorit.

Integrare nativă sau partener

Shopify, WooCommerce, PrestaShop și alte platforme oferă conectori Meta care activează CAPI fără cod. Sunt rapizi de pus în funcțiune, dar oferă control limitat asupra parametrilor și a regulilor de consimțământ. Pentru un magazin mic sau la început de drum, sunt o alegere rezonabilă.

Server-side prin Google Tag Manager

Un container GTM server-side, găzduit pe domeniul tău, primește evenimentele din site și le retrimite către Meta. Ai control bun asupra datelor, poți îmbogăți evenimentele cu informații din backend și poți folosi același setup și pentru Google Ads sau GA4. Costul include hostingul serverului și timpul de configurare. Detaliile sunt în ghidul de server-side tracking și în capitolul nostru despre analytics și tracking pentru eCommerce.

Integrare directă prin API

Backendul tău apelează direct endpointul Meta. Este cea mai flexibilă variantă și cea mai fiabilă pentru evenimentele de cumpărare, fiindcă pornește chiar din sistemul de comenzi. Cere dezvoltare și mentenanță, deci are sens pentru magazine cu volum mare sau cu platformă custom.

În practică, multe magazine combină metodele: pixel în browser, evenimente de comportament prin GTM server-side și cumpărarea trimisă direct din backend.

Beneficii concrete pentru un magazin online

Acuratețe mai mare. Recuperezi o parte din conversiile pierdute, iar raportarea se apropie de realitatea din backend.
Optimizare mai bună. Algoritmul primește semnale mai complete și poate găsi mai eficient oameni care seamănă cu cumpărătorii tăi.
ROAS mai real. Vezi ce campanii aduc vânzări și nu mai tai bugete din cauza datelor lipsă.
Audiențe mai solide. Remarketingul și audiențele lookalike se construiesc pe liste mai complete.
Catalog mai util. Evenimentele corecte cu ID-uri de produs potrivite cu feedul alimentează campaniile dinamice. Vezi ghidul despre catalog Meta și DPA.

Atenție la așteptări: CAPI nu aduce vânzări în plus prin el însuși. Îmbunătățește calitatea datelor, iar efectul asupra rezultatelor vine prin optimizare mai bună în timp.

CAPI nu înseamnă să ocolești regulile de confidențialitate. Un eveniment trimis server-side rămâne prelucrare de date personale și are nevoie de temei legal, în practică consimțământul pentru marketing.

Trimite evenimentele către Meta doar dacă utilizatorul a acceptat categoria de marketing din bannerul de cookies.
Transmite starea consimțământului din browser către server, ca să respecți aceeași decizie în ambele canale.
Integrează corect Consent Mode; detaliile sunt în ghidul Consent Mode v2.
Hash-uiește emailul și telefonul înainte de trimitere și nu trimite date care nu sunt necesare.
Menționează în politica de confidențialitate că folosești procesare server-side și Meta ca destinatar.

În România, ANSPDCP aplică GDPR, iar un magazin cu clienți din UE trebuie să poată dovedi consimțământul. Pentru situații concrete, consultă un specialist în protecția datelor.

Greșeli frecvente

Lipsa deduplicării. Evenimente duble, ROAS umflat, optimizare distorsionată.
Nume de evenimente diferite între pixel și server (Purchase vs purchase), așa că Meta nu le potrivește.
Trimiterea datelor nehash-uite sau hash-uite greșit (spații, majuscule), ceea ce strică potrivirea.
Ignorarea consimțământului. Serverul trimite totul, indiferent de alegerea utilizatorului.
Valori sau monede greșite la Purchase, cu venituri raportate incorect.
Lipsa testării. Nu folosești Test Events din Events Manager înainte de lansare și descoperi problema după săptămâni.
Parametri de potrivire săraci, deși ai emailul și telefonul clientului.

Cum verifici că funcționează

După implementare, parcurge o listă scurtă:

în Events Manager, evenimentele apar atât prin Browser, cât și prin Server;
folosește Test Events pentru a face o comandă de test și a verifica event_id;
rata de deduplicare este ridicată, fără evenimente duble;
scorul Event Match Quality pentru Purchase este cel puțin bun;
numărul de comenzi din Ads Manager se apropie de cel din backend, ținând cont de fereastra de atribuire.

Repetă verificarea după orice modificare de temă, checkout sau banner de cookies.

Întrebări frecvente

Ce este Conversion API și diferă de pixel?

Pixelul trimite evenimentele din browser, iar CAPI le trimite de pe server. Se folosesc împreună: pixelul acoperă semnalele din browser, iar CAPI recuperează ce se pierde din cauza blocărilor și a restricțiilor de confidențialitate.

Pot folosi doar CAPI, fără pixel?

Se poate, dar nu e recomandat. Pixelul oferă context din browser (cookie-uri, comportament pe pagină), iar redundanța dintre cele două canale dă cele mai bune rezultate, atâta timp cât deduplicarea e corectă.

Cum evit numărarea dublă a conversiilor?

Trimite același event_name și același event_id din pixel și din server. Meta le recunoaște ca pe un singur eveniment. Verifică apoi rata de deduplicare în Events Manager.

Este legal dacă respecți consimțământul utilizatorului și transmiți doar datele necesare, hash-uite. CAPI e un canal tehnic, nu o excepție de la reguli: dacă nu ai consimțământ pentru marketing, nu trimiți evenimentul.

Cât durează implementarea?

O integrare nativă se face în câteva ore. Un setup cu GTM server-side durează de obicei câteva zile cu testare cu tot, iar o integrare directă depinde de platforma magazinului.

Concluzie

În 2026, Conversion API nu mai e opțional pentru un magazin online serios care rulează Meta Ads. Este fundația unei optimizări și atribuiri corecte, cu condiția să fie făcut cu deduplicare, date de potrivire bune și consimțământ respectat. Dacă vrei să-l implementăm corect, vezi serviciul de Facebook & Instagram Ads sau cere un audit gratuit.