Meta Conversions API (CAPI): nastavitev, parametri, dedup

Večina vodnikov o Meta Conversions API se konča pri "namestite ga, popravi iOS". Po 15 letih vodenja trgovine in zdaj, ko gradim pošiljanje za druge trgovine, se mi zdijo uporabna bolj konkretna vprašanja: kateri parametri so obvezni, od kod pride dostopni žeton, kako deduplikacija v resnici odloča, kako star je lahko dogodek in česa vam Conversions API o vaši porabi pri Meti še vedno ne pove.

Ta vodnik nanje odgovarja po Metini lastni dokumentaciji, odprti septembra 2026, in doda, kar vidimo v podatkih Enalitice.

Kratek odgovor. Meta Conversions API (CAPI) je vmesnik strežnik-strežnik, ki dogodke konverzij (Purchase, AddToCart, Lead) pošilja z vašega strežnika, trgovinske platforme ali CRM-ja k Meti, poleg Pixla v brskalniku ali namesto njega. Spletni dogodek potrebuje štiri obvezne parametre: event_name, event_time, user_data in action_source (za spletne dogodke sta obvezna tudi event_source_url in client_user_agent), event_id, da ga Meta lahko deduplicira s Pixlom, in event_time, star največ 7 dni. CAPI hrani Metino ponujanje; ne pove vam, koliko je Meta dejansko prodala. Vodnik pokriva oboje.

Kaj je Meta Conversions API (CAPI)?

Meta Conversions API je strežniški vmesnik, prek katerega dogodke konverzij (nakupe, dodajanja v košarico, povpraševanja, oglede strani) pošiljate s svojega strežnika neposredno v Metin oglaševalski sistem. Meta ga opisuje kot neposredno povezavo med vašimi marketinškimi podatki (s strežnika, spletne platforme, aplikacije ali CRM-ja) in sistemi, ki optimizirajo ciljanje, znižujejo ceno na rezultat in merijo izide (Meta Business Help).

Razlika v enem stavku: Meta Pixel prosi kupčev brskalnik, naj sporoči, kaj se je zgodilo, in če ga ustavi blokator oglasov, zavrnjeno soglasje ali pokvarjen skript, Meta za naročilo nikoli ne izve; CAPI naročilo sporoči z vašega strežnika, zato omejitve brskalnika ne veljajo.

Meta priporoča oboje hkrati, "redundantno nastavitev": Pixel sporoči, kar zmore, CAPI pokrije, kar je Pixel zgrešil, deduplikacija pa poskrbi, da se isti nakup šteje enkrat.

Metina stran o izdelku navaja, da so oglaševalci s CAPI za spletne dogodke v povprečju dosegli 17,8 % nižjo ceno na rezultat kot tisti brez njega (Meta, september 2026; opomba z metodo na strani ni objavljena).

Pri nakupu integracija CAPI zbere podatke o dogodku (vrednost, valuto, ID-je izdelkov, zgoščeno e-pošto in telefon, piškotek klika fbc, piškotek brskalnika fbp, IP naslov, uporabniški agent), jih z dostopnim žetonom pošlje na https://graph.facebook.com/{različica}/{pixel_id}/events, Meta pa dogodek poveže z računom, ga pripiše kliku ali ogledu oglasa in deduplicira z dogodkom Pixla, ki ima isti event_id. Uporabljajte Metina standardna imena dogodkov (ViewContent, AddToCart, InitiateCheckout, AddPaymentInfo, Purchase), občutljiva na velikost črk; Purchase zahteva value in currency.

Kateri štirje parametri so obvezni pri CAPI dogodku?

Vsak dogodek Conversions API mora nositi štiri parametre: event_name, event_time (Unix sekunde, GMT, star največ 7 dni), user_data (vsaj en podatek o stranki) in action_source (website, app, physical_store, system_generated, phone_call, chat, email, other). Za spletne dogodke Meta zahteva še event_source_url in client_user_agent. event_id po specifikaciji ni obvezen, brez njega pa ni deduplikacije (parametri strežniškega dogodka).

Meta sprejme event_time največ 7 dni pred pošiljanjem; če je v paketu en sam starejši dogodek, Meta zavrne celotno zahtevo in ne obdela nobenega dogodka. Zamuda najprej stane učinkovitost, šele nato dostavo: za prodajne kampanje Meta priporoča pošiljanje v 1 uri in dopušča do 7 dni; za atribucijo v Ads Managerju sta priporočeno in največje okno 7 dni; offline dogodki lahko pridejo do 62 dni pozneje (Meta Business Help, september 2026).

Podatki o stranki in zgoščevanje

V objektu user_data se zgodi ujemanje. Metina stran o podatkih o stranki določa pravila: normalizirajte, nato zgostite s SHA-256, razen štirih signalov, ki morajo ostati nezgoščeni.

Nikoli ne zgoščujte fbc, fbp, IP naslova ali uporabniškega agenta. Oblika obeh piškotkov in pravilo, da ju osvežujete, sta v Metinem vodniku za fbp in fbc.

Deduplikacija dogodkov z event_id: 48 ur, prvi dogodek zmaga

Če Pixel in CAPI tečeta skupaj, Meta prejme dve kopiji vsakega dogodka, in brez deduplikacije Events Manager pokaže dvakrat toliko nakupov, cena na nakup pa je videti pol nižja, kot je. Deduplikacija deluje prek event_id: za vsako konverzijo ustvarite en ID (na primer order_67890_purchase) in ga pošljete tako z dogodkom Pixla kot s strežniškim dogodkom.

Metina pravila iz dokumentacije o deduplikaciji in Business Help: Meta deduplicira, kadar se ujemata event_name in event_id, ali, brez event_id, kadar se ujemata event_name in isti fbp ali external_id. Oba dogodka morata priti v 48 urah od prvega, in kadar sta podobna, Meta obdrži tistega, ki ga je prejela prva. Identifikator nakupa, ki ga delite na obeh straneh, je torej event_id; order_id v custom_data je podatek za poročanje, ne ključ za deduplikacijo.

Na strani Pixla:

fbq('track', 'Purchase', {
  value: 89.99,
  currency: 'EUR'
}, {eventID: 'order_67890_purchase'});

Na strani strežnika:

{
  "event_name": "Purchase",
  "event_id": "order_67890_purchase",
  "event_time": 1709913600,
  "action_source": "website",
  "user_data": { "em": ["<sha256>"], "client_user_agent": "..." },
  "custom_data": { "value": 89.99, "currency": "EUR" }
}

Tipične napake: event_id, ki manjka na eni strani, ID-ja, ki se razlikujeta za ločilo, Purchase proti purchase, ali strežniški dogodek, ki pride več kot 48 ur za dogodkom Pixla. Preverite v Events Managerju z orodjem Test Events, ki vsak dogodek označi kot prejet, dedupliciran ali zavržen.

Event Match Quality in ACR: kako Meta ocenjuje vaš tok

Event Match Quality (EMQ) je ocena od 0 do 10, ki jo Meta izračuna za vsak spletni dogodek, poslan prek CAPI, iz podatkov o stranki, ki jih pošljete, in deleža dogodkov, ujetih z Metinimi računi, na podlagi zadnjih 48 ur (About event match quality). Višja ocena pomeni več nakupov, pripisanih pravemu oglasu, in, po Metinih besedah, nižjo ceno na dejanje.

Metina prednostna lestvica za ujemanje: e-pošta in ID klika (fbc) visoko; telefon, država, datum rojstva, external ID, ID brskalnika (fbp) in Facebook login ID srednje; ime, priimek, mesto in poštna številka nizko.

Kakovost ujemanja je sredstvo. Številka, ki odgovori na vprašanje "ali se je CAPI splačal?", je Additional Conversions Reported (ACR): Metina lastna ocena, koliko več konverzij je bilo poročanih s CAPI poleg Pixla kot s samim Pixlom. Meta jo izračuna iz zadnjih 7 dni konverzij, pripisanih naborom oglasov, povezanim z naborom podatkov; prej se je imenovala "additional attributed conversions" (About additional conversions reported). ACR blizu nič pomeni, da vaši strežniški dogodki Pixel le podvajajo.

Enalitica EMQ, ACR, 7-dnevno pokritost dogodkov (delež dogodkov Pixla, ki so prišli tudi prek CAPI s ključem za deduplikacijo) in svežino podatkov bere iz Metinega Dataset Quality API in jih prikaže v zavihku Strežniško sledenje; številke so Metine, razredi v zavihku (8+ odlično, 6 do 8 dobro) pa naše branje teh številk.

Dostopni žeton za Meta CAPI: Events Manager ali sistemski uporabnik

Dostopni žeton Conversions API preverja pristnost klicev vašega strežnika na graph.facebook.com/{različica}/{pixel_id}/events. Metina začetna stran ponuja dva načina.

V Events Managerju izberite nabor podatkov, odprite Settings, v razdelku Conversions API kliknite "Generate access token"; Meta sama ustvari aplikacijo in sistemskega uporabnika. Ali pa v Business settings nabor dodelite sistemskemu uporabniku in žeton ustvarite tam. Hranite ga kot skrivnost na strežniku, nikoli v brskalniku.

Trgovine WooCommerce in Shopify z uradnima aplikacijama žetona sploh ne potrebujejo: aplikacija pošilja strežniške dogodke, ko povežete račun.

Pet načinov za nastavitev Meta CAPI: od klika do API-ja

Metina primerjava možnosti nastavitve navaja možnost z enim klikom, neposredno integracijo in partnerske integracije; strežniški GTM in Gateway sta partnerska in gostovana različica istega vmesnika.

Meta-enabled Conversions API je samo spletna možnost, ki jo je Meta dodala v Events Manager: en klik ustvari strežniško povezavo, ki zrcali dogodke in parametre, kot jih Pixel že pošilja, samodejno deduplicirane; brezplačno, brez razvijalca in brez podatkov, ki jih brskalnik ni imel. Partnerski aplikaciji pokriva naslednji razdelek. Strežniški GTM dogodke iz podatkovnega sloja iz enega vsebnika posreduje Meti, Google Ads in drugim, še vedno odvisen od tega, da jih brskalnik sproži; uradno predlogo in tri alternativne nastavitve sGTM za Meta CAPI primerjamo ločeno. Neposredni API pomeni, da vaše zaledje samo pošilja na Graph API, edina pot za dogodke iz aplikacij, offline in CRM-ja, ki jo Meta ocenjuje na 2 do 4 tedne.

Conversions API Gateway je Metina samopostrežna možnost brez kode: vnaprej pripravljen posrednik, ki ga namestite v lasten račun AWS (EKS ali ECS Express) ali Google Cloud in ki sprejme, kar je sprožil Pixel v brskalniku, ter to posreduje kot strežniške dogodke. Programska oprema je brezplačna, plačate oblačne vire (Metina razvijalska dokumentacija). Ker je njen vhod Pixel, ne more rešiti nakupa, ki ga brskalnik ni sporočil. Stroški, nastavitev in slepa pega brskalnika so v Meta CAPI Gateway: kaj je in kdaj ga uporabiti. Metin novejši Signals Gateway isto zamisel poganja na vaši infrastrukturi z usmerjanjem na več ciljev.

WooCommerce in Shopify: Meta CAPI v uradnih aplikacijah

WooCommerce. Uradni vtičnik Meta for WooCommerce ima Conversions API vgrajen: ko povežete račun, strežniške dogodke pošilja brez dodatne nastavitve in brez lepljenja žetona. Dve omejitvi iz dokumentacije vtičnika: Checkout on Facebook and Instagram ni podprt, vtičniki za predpomnjenje, ki združujejo JavaScript (Breeze, SG Optimizer, Asset CleanUp), pa lahko ustavijo dogodke Pixla. Surov ID klika na naročilu pokriva zapis o zajemu fbclid v metapodatke naročila v WooCommerce, širšo nastavitev pa naš vodnik za sledenje konverzij v WooCommerce.

Shopify. Aplikacija Facebook & Instagram pošilja strežniške dogodke glede na raven deljenja podatkov o strankah (Shopify Help):

Shopifyjeva stran za pomoč daje ravnema Enhanced in Maximum isti strežniški dogodek nakupa; edina navedena razlika je Metina najnovejša oglaševalska tehnologija.

Ali lahko CRM pošlje nakupne dogodke v Conversions API?

Da. Conversions API sprejema dogodke s strežnika, trgovinske platforme, aplikacije ali CRM-ja, Metina primerjava nastavitev pa CRM navaja poleg spleta, aplikacij in offline kot vir dogodkov za neposredne integracije. Metin vodnik za CRM je napisan za lijake povpraševanj (pošljite 15- do 17-mestni Meta lead ID, optimizirajte za stopnjo, doseženo v 28 dneh), a zaključen posel ali nakup, potrjen v ERP-ju, gre po isti poti: action_source na system_generated ali physical_store, zgoščena e-pošta in telefon ter event_time znotraj okna zamude.

Za spletno trgovino je najbolj avtomatizirano orodje tisto, ki potrjeno naročilo že ima: uradni aplikaciji Shopify in WooCommerce, ali, kot dela Enalitica, pošiljanje iz samega zapisa naročila.

Meta CAPI in GDPR: česa strežniško pošiljanje ne spremeni

CAPI je odpornejša cev, ne obvoz okoli soglasja. Pomaga tam, kjer je ovira brskalnik, in ne spremeni ničesar tam, kjer je ovira zakon.

Kje CAPI pomaga. Blokatorji oglasov prestrezajo zahteve brskalnika na sledilne domene; strežniška zahteva je zanje nevidna. Safari vsak piškotek, ki ga zapiše JavaScript, omeji na sedem dni, kar skrajša življenje fbp ali fbc, ki ju nastavi Pixel; strežniški dogodek lahko namesto tega nosi identifikatorje, ki jih je zbrala vaša blagajna.

Kje CAPI ne pomaga. Če je kupec v EU zavrnil marketinško soglasje, njegovih osebnih podatkov Meti ne smete poslati niti s strežnika. Metin data_processing_options (Limited Data Use) obstaja samo za zakone ameriških zveznih držav, trenutno 14, med njimi Kalifornija, Kolorado, Teksas in Florida; za GDPR nima pomena. Za zavrnitelja ni možnosti "pošlji z zastavico": edina skladna izbira je, da dogodka z osebnimi podatki sploh ne pošljete. Enalitica naredi točno to: naročilo, pri katerem je obiskovalec zavrnil marketinško soglasje, označi kot preskočeno in ga Meti nikoli ne pošlje. Pravila po državah so v zapisu kaj lahko sledite po regijah.

Strežniško ne pomeni brez soglasja: naročilo obiskovalca, ki je zavrnil marketinško soglasje, Meti nikoli ni poslano.

Česa Meta CAPI ne meri: atribucija med platformami

CAPI popravi zajem za Meto. Neodvisne številke ne da, iz treh razlogov, ki jih nobena nastavitev ne spremeni. Celotna razlika je v zapisu strežniško sledenje proti atribuciji na podlagi naročil.

Meta vidi samo Meto. Conversions API Meti sporoča vaše konverzije; ne more vam povedati, kako se Metin prispevek primerja z Google Ads, organskim iskanjem, e-pošto ali neposrednimi obiski.

Obe platformi si lastita isto prodajo. Kupec, ki v ponedeljek klikne Metin oglas, v sredo Googlov oglas in v četrtek kupi, je konverzija na obeh nadzornih ploščah. CAPI deduplicira Pixel proti strežniku, nikoli Mete proti Googlu. Izračunan primer je v zapisu kako Meta, Google in Enalitica štejejo konverzije.

Številke so velike. V podatkih Enalitice je med skoraj 12.000 naročili, analiziranimi v zadnjih 90 dneh, 12,6 % nosilo Metin ID klika. Zožite to na trgovine s povezanima Meto in Google Ads, več kot 10.000 naročil in več kot 700.000 € prihodka, in Metine poročane konverzije so tekle pri 4,6-kratniku števila naročil, ki so nosila njen ID klika. Del te vrzeli je resničen: Meta šteje konverzije po ogledu in engaged-view, zajem klika pa zgreši obiskovalce, ki so zavrnili soglasje. Del je zaprt vrt, ki ocenjuje lastno delo.

CAPI izboljša tok, po katerem se Meta sama ocenjuje. Neodvisne številke ne da.

Kako Enalitica pošilja Meta CAPI in Meto meri neodvisno

Enalitica z vsakim potrjenim naročilom iz WooCommerce, Shopify ali Shopamine naredi dvoje: nakup pošlje Meti prek Conversions API in v lastnem poročilu zabeleži, kateri kanal je lastnik naročila.

Kaj Enalitica pošlje Meti. Dogodek Purchase z zgoščeno e-pošto in telefonom (zbrana na blagajni, zato prisotna pri večini naročil), zgoščenim imenom, mestom, poštno številko in državo, stabilnim external_id ter fbc, fbp, IP naslovom in uporabniškim agentom, kadar jih naročilo nosi, z action_source website in event_time, omejenim na 7 dni. Med več kot 6.600 dogodki Purchase, ki jih je Enalitica v zadnjih 90 dneh poslala Meti, jih je približno 17 % nosilo Metin ID klika, 55 % ID brskalnika _fbp in 8 od 10 zgoščeno e-pošto in telefon; delež ID-jev klika se od trgovine do trgovine močno razlikuje (izmerjeno 25. septembra 2026).

Kako je urejena deduplikacija. Enalitica pošlje determinističen event_id (ID naročila in _purchase). Trgovine po pogodbi za lastno platformo isti ID sprožijo iz Pixla, zato Meta oba združi po event_id. Pri WooCommerce in Shopify Pixel uradne aplikacije uporablja svoj ID, zato velja Metina rezervna pot (isti event_name in isti _fbp v 48 urah), zaradi česar Enalitica posreduje _fbp, kadar ga je zajel skript ob nakupu. V Events Managerju preverite, da se Purchase iz brskalnika in strežnika združita v enega, preden zaupate številu.

Kaj Enalitica pošlje Googlu in kaj se zgodi ob vračilu. Google nima lastnega CAPI; ustreznica je nalaganje konverzij z ID-jem klika, zgoščenimi podatki o stranki in izrecnimi signali Consent Mode v2, razloženo v našem vodniku o vprašanju Googlovega conversions API. Ko je naročilo preklicano ali delno vrnjeno, Enalitica Googlovo konverzijo umakne ali popravi prek prilagoditev konverzij znotraj Googlovega 55-dnevnega okna, v dnevnem opravilu. Metini standardni dogodki ne vsebujejo dogodka vračila, zato Metinih knjig za nazaj ni mogoče popraviti; Enalitičina lastna poročila vračila odštejejo za obe platformi in tam živijo popravljene številke (glej vodnik za POAS).

Kaj Enalitica meri neodvisno. Vsako naročilo dobi enega lastnika. Ko kupec klikne Metin oglas, se dva dni pozneje vrne prek Googlovega oglasa in kupi, si Meta prodajo lasti znotraj 7-dnevnega okna po kliku, Google pa zadnji klik; Enalitica naročilo dodeli zadnjemu veljavnemu kliku in Meto pokaže kot asistenco, tako da nič ni šteto dvakrat. Metine lastne nastavitve atribucije ponujajo okni 1 dan ali 7 dni po kliku, 1 dan po ogledu in engaged-view (Meta Business Help); 28 dni je Enalitičino pravilo: fbclid šteje samo, če je bil zajet največ 28 dni pred naročilom (90 za gclid). Naročilo zavrnitelja je še vedno pripisano iz pristajočega URL-ja, ki ga je zabeležila trgovina sama in ki ne posega v piškotke; le Meti ni nikoli poslano. Pogledi z več stiki so v zapisu o večtočkovni atribuciji za e-trgovino.

Omejitve so resnične: preteklih naročil po Metinem 7-dnevnem oknu ni mogoče poslati, naročilo brez kakršnegakoli identifikatorja pa se ne ujame z ničimer. Cilj je številka, na katero lahko stavite proračun, ne večja številka. Uvajanje uvozi vaša nedavna naročila in jih v nekaj minutah obogati z ID-ji klikov in podatki o oglasih; če želite videti, kako se vaše Metine in Googlove številke primerjajo, ko jih merimo iz resničnih naročil, rezervirajte predstavitev.

Dobro hraniti Meto in Meto meriti neodvisno je isto naročilo, prebrano dvakrat.

Kontrolni seznam za Meta CAPI: pet preverjanj v Events Managerju

1. Stolpec vira. Odprite Events Manager; če vsak Purchase piše "Browser", imate samo Pixel.
2. Deduplikacija. Pošljite isti event_id iz Pixla in strežnika; v Test Events potrdite, da se par združi v enega.
3. Parametri. Zgoščena e-pošta in telefon pri vsakem Purchase, fbc in fbp nezgoščena, client_user_agent in event_source_url prisotna.
4. Svežina. Nakupi v 1 uri, v paketu nič starejšega od 7 dni.
5. Ocena. EMQ in ACR preverjena mesečno, ne enkrat.

Pogosta vprašanja

Ali je Conversions API Gateway isto kot Conversions API?

Ne. Conversions API je vmesnik; Gateway je en gostovan način, kako ga napolniti iz Pixla v brskalniku. Neposredna integracija, strežniški GTM, partnerske aplikacije in pošiljatelji iz naročil, kot je Enalitica, polnijo isti vmesnik brez Gatewaya. Celotna primerjava je v zapisu Meta CAPI Gateway.

Ali razširitev Meta Pixel Helper zazna CAPI dogodke?

Ne. Pixel Helper prikaže samo dogodke, ki jih sproži Pixel v brskalniku. Strežniški dogodki so vidni v Events Managerju, v orodju Test Events in v stolpcu vira v pregledu nabora podatkov, kjer pišejo "Server".

Ali lahko Meta CAPI uporabim za offline konverzije (CRM, v trgovini)?

Da. Meta je samostojni Offline Conversions API ukinila maja 2025 (Meta Business Help); konverzije iz trgovine, klicnega centra ali CRM-ja zdaj sprejema prek Conversions API z action_source physical_store, phone_call ali system_generated, naložene v nabor podatkov; offline dogodki so lahko stari do 62 dni. Metina primerjalna stran opozarja, da offline in aplikacijski dogodki prek CAPI zahtevajo neposredno integracijo.

Katera je minimalna različica Graph API za CAPI v letu 2026?

Trenutna različica Graph API je v26.0 (29. julij 2026), različice Graph pa živijo približno dve leti: v22.0 do 20. maja 2027, v25.0 do 29. julija 2028 (dnevnik sprememb). Del Marketing API iste različice se upokoji prej (v24.0 6. oktobra 2026), Meta pa je za 29. julij 2026 napovedala samodejno nadgradnjo različice, zato stara različica ne odpove glasno, ampak se preusmeri. Preverite glavo odgovora facebook-api-version; Enalitica različico pripne v kodi in tedenski zdravstveni pregled pade, ko Meta streže drugo.

Ali je CAPI skladen z GDPR?

CAPI je cev, ne mehanizem soglasja. Implementacija je skladna, ko osebne podatke pošilja samo za obiskovalce, ki so privolili v marketinško sledenje, in za tiste, ki so zavrnili, ne pošlje ničesar z identifikatorji. data_processing_options tu ne pomaga: pokriva samo zakone ameriških zveznih držav. Ne glede na to, ali uporabljate Pixel, CAPI ali oboje, je zahteva pasica za soglasje, ki jo vaša logika pošiljanja v resnici bere.