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 functioneaza 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 si restrictii de browser

Consimtamantul si limitarile browserului pot reduce semnalele disponibile. Impactul real se masoara pe implementarea si audienta magazinului.

🔥

Browser fingerprinting reduction

Chrome, Firefox elimina progresiv third-party cookies si 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 si server, deduplicarea, parametrii disponibili, diagnosticele si reconcilierea cu Shopify. EMQ depinde de datele furnizate legitim si de consent, nu poate fi garantat.
Pregatire

Prerequisite, Ce Trebuie Pregatit Inainte

Inainte sa incepi, ai nevoie de:

🛍️

Acces admin la Shopify store

Owner sau staff cu Apps permission. Daca esti developer pentru un client, ai nevoie sa fi adaugat ca Collaborator pe contul lor Shopify.

📘

Acces admin la Meta Business Manager

Si 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. Iti generaza Pixel ID (numar de 15+ cifre).

⏱

~25 minute timp continuu

Setup-ul nu se face in 2 pasi. Daca te intrerupi, risti sa pierzi context si sa configurezi gresit. Bloca-ti calendarul.

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" si confirma permissions
  4. Vei fi redirectat catre Meta Business pentru autentificare
  5. Selecteaza Business Manager-ul si 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 si 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", selecteaza 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 si cerintele aplicabile. Comportamentul exact al datelor se testeaza pe magazin.

Verificare ca CAPI e activ

Du-te la Events Manager → Pixel → Overview. Vei vedea 2 coloane: "Browser" si "Server". Daca dupa 24-48h ambele au numere apropiate, CAPI functioneaza. 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 gresit, faceti pagube.

Shopify integrare oficiala face deduplicare automata folosind event_id unic per eveniment. Verifica:

  1. Events Manager → Pixel → Overview
  2. Selecteaza ultimele 7 zile
  3. Click pe orice eveniment (ex: Purchase)
  4. Vezi raportul "Browser vs Server"

Ce trebuie sa vezi:

Deduplicare functioneaza corect

  • Browser: 100 events
  • Server: 100 events
  • Deduplicated: 100 events (NOT 200)
  • "Match between browser and server: 95%+"

Deduplicare NU functioneaza

  • 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 si 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 si la checkout. Captureaza emails inainte de checkout (newsletter popup) pentru cresterea match.

📱

Phone number hashed la checkout

Shopify il are pentru orice comanda. Asigurati-va ca campul phone e obligatoriu la checkout (Shopify Settings → Checkout → Form options → Phone number → Required).

🍪

fbp si 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 (cand 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. Vei vedea un cod (de ex: TEST12345). Copy-l.
  3. Du-te pe site-ul tau Shopify in browser nou cu URL: https://magazinul-tau.com/?fbclid=TEST12345
  4. Navigheaza prin produse, adauga in cart, fa checkout test (folosesc Shopify test mode sau gateway de test)
  5. Inapoi 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 si 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 si banner-ul colecteaza consent corect.

⚠️

EMQ ramane redus dupa configurare

Verifica parametrii eligibili, consentul si implementarea. Nu forta colectarea de date doar pentru scor; cere numai informatiile necesare si 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

Shopify test mode (Bogus Gateway) NU genereaza Purchase events real. Trebuie sa folosesti un cart cu sub 5 RON si plata reala (1 RON test) pentru a vedea Purchase fire-uit.

Verificare

Verificare Dupa 7 Zile, Ce Sa Compari

Nu atribui imediat o schimbare de ROAS implementarii CAPI. Asteapta o fereastra relevanta si compara datele pe aceeasi perioada in Meta si Shopify.

Dupa 7 zile, compara:

Inainte de CAPI

  • Documenteaza EMQ si parametrii
  • Documenteaza evenimentele din browser
  • Noteaza totalul Purchase din magazin
  • Salveaza diferenta Meta versus Shopify

Dupa implementare

  • Verifica EMQ in acelasi context
  • Confirma evenimentele server-side
  • Confirma deduplicarea
  • Reconciliaza din nou cu Shopify
Concluzie
CAPI poate completa masurarea, dar nu rezolva singur atribuirea. Implementarea cere consent, parametri corecti, deduplicare si verificare continua. Timpul si impactul variaza dupa magazin.

Surse și documentație

Documentație oficială pentru implementările descrise. Exemplele de buget, cost și performanță din ghid sunt orientative; rezultatele se validează în contextul fiecărui proiect.

Revizia acestei secțiuni: .

Întrebări frecvente

De ce CAPI nu e optional in 2026?

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

ALLSOFT AGENCY ÎN PUBLICAȚII

Apariții în presă & media

Selecție de apariții advertoriale și platforma media proprie.

  • Financiarul
  • Libertatea
  • Money.ro
  • wall-street.ro
  • spotmedia.ro
  • BZI.ro
  • ALLSoft Media