Tutorial tehnic · CAPI pe Shopify

CAPI implementation pas cu pas de la zero la EMQ 8+

Setup-ul complet de Conversions API pe Shopify, fara developer. Recuperezi 25-35% din evenimentele pierdute prin adblock + iOS 14 ATT.

Tutorial pas cu pas Shopify nativ EMQ 8+ Deduplicare Server-side events
25-35%events recuperate
vs Pixel only
~25 minimplementare
completa
8.5+Event Match
Quality target

Context

Ce Este CAPI si De Ce e Obligatoriu in 2026

Pixel-ul Meta clasic functioneaza pe browser. Trimite evenimentele (PageView, AddToCart, Purchase) direct de pe site-ul tau in browserul utilizatorului catre Meta.

Problema: 30-40% din evenimente nu ajung. Cauze:

🚫

Ad blockers (uBlock, Brave, Ghostery)

Pixelul Meta e prima oprire pe lista lor. Estimativ 25% din vizitatorii desktop folosesc ad blocker activ.

🍎

iOS 14+ ATT (App Tracking Transparency)

Utilizatorii Apple care opt-out (tipic 60-70%) nu trimit tracking date catre Meta din browser. Browser Safari le blocheaza by default.

🔥

Browser fingerprinting reduction

Chrome, Firefox elimina progresiv third-party cookies si limiteaza fingerprinting. Pixelul standard depinde de cookies pentru identificare.

CAPI (Conversions API) rezolva toate astea trimitand evenimentele de pe serverul tau direct catre Meta, ocolind toate restrictiile de browser. Browser-ul utilizatorului nu mai e in pipeline.

Rezultatul concret pe conturile pe care le-am setat: EMQ (Event Match Quality) creste de la 5.5/10 la 8.5+/10. Evenimentele Purchase raportate cresc cu 25-35%. ROAS-ul in Ads Manager devine mult mai aproape de ROAS-ul real din Shopify.
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 — GDPR: Activarea "Maximum data sharing" cere consent explicit de la utilizatori in UE. Trebuie sa ai banner de consent (folosesti Shopify Customer Privacy API sau app cookie consent ca Avada). Fara consent, Shopify nu trimite Customer Information catre Meta — CAPI functioneaza dar EMQ-ul ramane sub 5.

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 masoara cat de bine reuseste Meta sa potriveasca evenimentele tale cu utilizatorii din baza lor de date. EMQ sub 6/10 = algoritmul Meta lucreaza cu date vagi. Tinta in 2026: EMQ 8+ pe Purchase.

5 Tactici Pentru EMQ Maxim

📧

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 score 8+/10 pe matched parameters
  • ✅ 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 sub 6 dupa toate setarile

Cauza tipica: capturezi prea putine emails inainte de checkout. Soluție: popup newsletter cu discount, login social, exit-intent capture. Cu cat capturezi mai multi emails warm, cu atat EMQ creste pe toate eventele.

⚠️

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

CAPI nu da rezultate imediat in ROAS-ul tau Ads Manager. Algoritmul are nevoie de 5-7 zile sa absorba datele aditionale si sa-si recalibreze.

Dupa 7 zile, compara:

Inainte de CAPI

  • EMQ Purchase: ~5/10
  • Events Server: 0
  • Total Purchase events / luna: X
  • ROAS in Meta vs Shopify diferenta: 30-50%

Dupa 7 zile cu CAPI corect

  • EMQ Purchase: 8+/10
  • Events Server: aproape egal cu Browser
  • Total Purchase events / luna: X + 25-35%
  • ROAS in Meta vs Shopify diferenta: sub 15%
Concluzie
CAPI nu e optional in 2026. Fara el, pierzi 25-35% din date pe care le-ai platit cu bugetul de ads. Algoritmul Meta lucreaza cu informatie incompleta, ROAS-ul tau e sistemic sub-raportat, scalarea devine impossibila. 25 minute setup, beneficii permanente.
// Urmatorul pas

Nu ai timp sa setezi CAPI
pe magazinul tau?

Setam CAPI complet pe magazinul tau Shopify in 24-48h: integrare Shopify-Meta, Maximum data sharing, verificare deduplicare, EMQ 8+ garantat. Fix price: 500 EUR. Audit pre-setup gratuit.

Fără angajamentRăspuns în 24hFără pitch de vânzareMeta Business Partner