Tutorial tehnic · CAPI pe Shopify

CAPI implementation pas cu pas de la setup la validare

Configurarea Conversions API pe Shopify, de la sursele browser și server până la deduplicare, diagnostic și consimțământ.

Tutorial pas cu pas Shopify nativ EMQ contextual Deduplicare Server-side events
2 sursebrowser și server
verificate
1 IDpentru deduplicarea
aceluiași eveniment
ContextEMQ interpretat după
datele permise

Context

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.

Ce verificam dupa implementare: sursa browser și server, deduplicarea, parametrii disponibili, diagnosticele și reconcilierea cu Shopify. EMQ depinde de datele furnizate legitim și de consent, nu poate fi garantat.
Pregatire

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

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:

  1. Du-te la Shopify Admin → Sales channels → Add app
  2. Cauta "Facebook & Instagram" (oficial, dezvoltat de Meta Platforms, Inc.)
  3. Click "Add app" și confirma permissions
  4. Vei fi redirectat catre Meta Business pentru autentificare
  5. Selectează Business Manager-ul și Ad Account-ul corect
  6. Conecteaza Pixel-ul existent (selecteaza-l din lista)
  7. Connect, gata, integrarea de baza e activa
Verificare rapida: Du-te la Events Manager → Pixel-ul tau → tab "Test Events". Deschide un browser incognito pe magazinul tau Shopify și vezi daca evenimentele apar in real-time (PageView, ViewContent etc.). Daca apar, integrarea de baza e OK.
Pas 2

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):

  1. Du-te la Shopify Admin → Sales channels → Facebook & Instagram
  2. Click "Settings" sus dreapta
  3. 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
  4. Confirmati permisiunile
  5. Save
Important, confidentialitate: Configurarea data sharing trebuie aliniata cu mecanismul de consent, politica de confidentialitate și cerintele aplicabile. Comportamentul exact al datelor se testează pe magazin.

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

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:

  1. Events Manager → Pixel → Overview
  2. Selectează ultimele 7 zile
  3. Click pe orice eveniment (ex: Purchase)
  4. 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

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

Pas 5: Test Events Manager, Verificare Finala

Acum testam end-to-end:

  1. Events Manager → Pixel-ul tau → tab "Test Events"
  2. Pentru evenimentele trimise de server, copiază codul din Test Events.
  3. Într-o integrare CAPI custom, include codul în parametrul test_event_code al cererii serverului, lângă lista data. Nu îl pune în fbclid: acesta identifică un click pe reclamă. Dacă integrarea Shopify gestionată nu expune parametrul, folosește diagnosticul și procedura de test documentate de furnizor.
  4. Navigheaza prin produse, adauga in cart, fa checkout test (folosesc Shopify test mode sau gateway de test)
  5. Î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
Daca toate ✅ sunt OK, ai terminat setup-ul. CAPI e activ, deduplicat, EMQ ridicat. Algoritmul Meta poate optimiza corect.
Troubleshoot

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

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
Concluzie
CAPI poate completa măsurarea, dar nu rezolva singur atribuirea. Implementarea cere consent, parametri corecti, deduplicare și verificare continua. Timpul și impactul variaza dupa magazin.

Întrebări frecvente despre acest ghid

Când este util CAPI pentru un magazin Shopify?

CAPI poate completa semnalele din browser, dar nu ocolește consimțământul și nu garantează recuperarea unui procent fix. Calitatea depinde de integrare, deduplicare, datele permise și traseul de checkout.

Cat dureaza setup-ul CAPI pe Shopify?

Timpul depinde de arhitectura magazinului, nivelul de acces, consent și implementările existente. O instalare standard poate fi rapidă, dar validarea deduplicării și a evenimentelor trebuie făcută înainte de a considera setup-ul finalizat.

Ce este Event Match Quality (EMQ) si de ce conteaza?

EMQ este un indicator de diagnostic pentru parametrii de potrivire disponibili. Nu este o notă garantată și nu trebuie îmbunătățit prin colectarea de date fără temei. Trimite doar parametrii permiși, cu hashing, deduplicare și consent corect.

Ce fac daca dupa 48h coloana 'Server' e inca 0?

Verifică mai întâi integrarea, maparea evenimentului, deduplicarea, setările Shopify Customer Privacy și alegerea reală a vizitatorului. Faptul că Server rămâne 0 poate avea mai multe cauze; nu activa transmiterea datelor fără consimțământ doar pentru a crește indicatorul.

// Următorul pas

Nu ai timp sa setezi CAPI
pe magazinul tau?

Configurăm CAPI pe magazinul tău Shopify, verificăm sursele browser și server, deduplicarea, diagnosticul și datele permise de consimțământ. Începem cu un audit tehnic al implementării curente.

Evaluare inițială gratuităRăspuns într-o zi lucrătoareRecomandări scriseParteneriate verificate