Ce este CAPI și când completează măsurarea din browser
Pixel-ul Meta clasic funcționează pe browser. Trimite evenimentele (PageView, AddToCart, Purchase) direct de pe site-ul tau in browserul utilizatorului catre Meta.
Problema: o parte din evenimentele din browser poate lipsi sau poate ajunge incomplet. Impactul diferă în funcție de audiență, dispozitiv, browser, implementare și consimțământ. Cauzele includ:
Ad blockers și protecții ale browserului
Unele extensii și browsere pot limita încărcarea sau transmiterea evenimentelor din pixel.
iOS, ATT și restrictii de browser
Consimtamantul și limitarile browserului pot reduce semnalele disponibile. Impactul real se masoara pe implementarea și audienta magazinului.
Browser fingerprinting reduction
Chrome, Firefox elimina progresiv third-party cookies și limiteaza fingerprinting. Pixelul standard depinde de cookies pentru identificare.
CAPI (Conversions API) poate completa sursa din browser prin evenimente trimise de server către Meta. Nu ocolește consimțământul, nu justifică trimiterea unor date nepermise și nu garantează recuperarea tuturor semnalelor.
Prerequisite, Ce Trebuie Pregatit Înainte
Înainte sa incepi, ai nevoie de:
Acces admin la Shopify store
Owner sau staff cu Apps permission. Daca esti developer pentru un client, ai nevoie să fii adăugat ca Collaborator pe contul lor Shopify.
Acces admin la Meta Business Manager
Și la Ad Account-ul conectat la magazin. Daca nu ai inca Business Manager, primul pas e business.facebook.com.
Meta Pixel deja creat in Events Manager
Daca nu ai inca Pixel, creeaza-l in Events Manager → Connect Data Source → Web. Îți generează Pixel ID (număr de 15+ cifre).
~25 minute timp continuu
Setup-ul nu se face in 2 pasi. Daca te intrerupi, risti sa pierzi context și sa configurezi greșit. Rezervă-ți timpul necesar.
Pas 1: Conectare Shopify ↔ Meta Business
Shopify ofera in 2024 o aplicatie nativa oficiala pentru Meta Pixel & CAPI: Facebook & Instagram channel. Asta e calea corecta in 2026 (vs metode third-party din 2022).
Pasii:
- Du-te la Shopify Admin → Sales channels → Add app
- Cauta "Facebook & Instagram" (oficial, dezvoltat de Meta Platforms, Inc.)
- Click "Add app" și confirma permissions
- Vei fi redirectat catre Meta Business pentru autentificare
- Selectează Business Manager-ul și Ad Account-ul corect
- Conecteaza Pixel-ul existent (selecteaza-l din lista)
- Connect, gata, integrarea de baza e activa
Pas 2: Activarea Conversions API in Shopify
Integrarea Shopify ↔ Meta din Pas 1 a configurat doar Pixel-ul de browser. Acum activam CAPI-ul (server-side):
- Du-te la Shopify Admin → Sales channels → Facebook & Instagram
- Click "Settings" sus dreapta
- In sectiunea "Data sharing", selectează modul: Maximum
- Standard: doar Pixel browser (insuficient in 2026)
- Enhanced: Pixel browser + data partener limited
- Maximum: Pixel + Conversions API + Customer Information sharing
- Confirmati permisiunile
- Save
Verificare ca CAPI e activ
Du-te la Events Manager → Pixel → Overview. Vei vedea 2 coloane: "Browser" și "Server". Daca dupa 24-48h ambele au numere apropiate, CAPI funcționează. Daca "Server" e 0 sau foarte mic, ceva nu merge, vezi sectiunea Troubleshooting.
Pas 3: Verificare Deduplicare
Cea mai grava problema cu CAPI prost configurat: fiecare event e raportat de doua ori (o data din Pixel browser, o data din CAPI server). ROAS-ul tau arata x2 fata de realitate. Tu decizi pe baza datelor false, scalezi greșit, faceti pagube.
Shopify integrare oficiala face deduplicare automata folosind event_id unic per eveniment. Verifica:
- Events Manager → Pixel → Overview
- Selectează ultimele 7 zile
- Click pe orice eveniment (ex: Purchase)
- Vezi raportul "Browser vs Server"
Ce trebuie sa vezi:
Deduplicare funcționează corect
- Browser: 100 events
- Server: 100 events
- Deduplicated: 100 events (NOT 200)
- "Match between browser and server: 95%+"
Deduplicare NU funcționează
- Browser: 100 events
- Server: 100 events
- Deduplicated: 200 events (raportare dubla)
- ROAS in Ads Manager e x2 fata de Shopify
Pas 4: Cresterea Event Match Quality (EMQ)
EMQ arata calitatea parametrilor de potrivire disponibili. Un scor trebuie interpretat impreuna cu tipul evenimentului, consentul și datele pe care utilizatorul le ofera.
5 verificari pentru parametri mai buni
Trimite email hashed cu fiecare event
Cel mai puternic match parameter. Shopify Maximum data sharing face asta automat pentru clienti logged-in și la checkout. Captureaza emails înainte de checkout (newsletter popup) pentru cresterea match.
Phone number hashed la checkout
Shopify il are pentru orice comanda. Nu face numărul de telefon obligatoriu doar pentru a crește EMQ. Solicită-l când este necesar cumpărării sau livrării și trimite doar datele permise de setările de confidențialitate și consimțământ.
fbp și fbc parameters
Cookie-urile native Meta pentru cross-session tracking. Shopify integrare oficiala le seteaza automat. Verifica in Chrome DevTools → Application → Cookies.
external_id consistent
ID-ul Shopify customer (când exista) trimis ca external_id pentru fiecare event al lui. Help Meta sa construiasca profilul cumparatorului peste timp.
Adresa fizica + tara la checkout
City, state, country, zip. Toate hashate. Shopify le trimite automat din checkout. Asigurati-va ca nu ai validare excesiva care arunca date prost formatate.
Pas 5: Test Events Manager, Verificare Finala
Acum testam end-to-end:
- Events Manager → Pixel-ul tau → tab "Test Events"
- Pentru evenimentele trimise de server, copiază codul din Test Events.
- Într-o integrare CAPI custom, include codul în parametrul
test_event_codeal cererii serverului, lângă listadata. Nu îl pune înfbclid: acesta identifică un click pe reclamă. Dacă integrarea Shopify gestionată nu expune parametrul, folosește diagnosticul și procedura de test documentate de furnizor. - Navigheaza prin produse, adauga in cart, fa checkout test (folosesc Shopify test mode sau gateway de test)
- Înapoi in Events Manager, vezi evenimentele care vin live
Ce trebuie sa vezi pentru fiecare event (ex: Purchase):
- ✅ Both Browser and Server, event vine din ambele surse
- ✅ Deduplicated, apare bifat ca dedup-uit
- ✅ EMQ și parametrii analizati in contextul datelor disponibile
- ✅ Match parameters trimise:
em, ph, fbp, fbc, external_id, ct, st, country, zp
Troubleshooting, Cazuri Edge Pe Care le Vedem
"Server" coloana e 0 dupa 48h
Cauza tipica: GDPR consent banner blocheaza Customer Information sharing. Verifica Shopify Settings → Customer Privacy → asigura-te ca tracking permissions sunt active și banner-ul colecteaza consent corect.
EMQ rămâne redus dupa configurare
Verifica parametrii eligibili, consentul și implementarea. Nu forta colectarea de date doar pentru scor; cere numai informațiile necesare și legitime.
Deduplicare arata "no match"
Cauza tipica: Shopify trimite event_id diferit pentru Browser vs Server. Solutie: dezactiveaza temporar app-uri terte care injecteaza Pixel-uri manual (Facebook Pixel Helper extension, elimina app-uri non-Shopify oficiale care manipuleaza Pixel events).
Test Events nu arata Purchase events
Comportamentul comenzilor de test depinde de integrare și de configurare. Verifică documentația conectorului și diagnosticul serverului. Nu face automat o plată reală pentru a forța evenimentul; folosește mediul de test și aprobarea explicită pentru eventuale tranzacții reale.
Verificare Dupa 7 Zile, Ce Sa Compari
Nu atribui imediat o schimbare de ROAS implementarii CAPI. Asteapta o fereastra relevanta și compara datele pe aceeași perioada in Meta și Shopify.
Dupa 7 zile, compara:
Înainte de CAPI
- Documenteaza EMQ și parametrii
- Documenteaza evenimentele din browser
- Noteaza totalul Purchase din magazin
- Salveaza diferenta Meta versus Shopify
Dupa implementare
- Verifica EMQ in același context
- Confirma evenimentele server-side
- Confirma deduplicarea
- Reconciliaza din nou cu Shopify
Facebook Ads
TikTok Ads
Shopify