Conversions API (CAPI) je rozhranie Mety, cez ktoré posielate udalosti ako nákup, pridanie do košíka alebo registráciu priamo zo servera, nie len z prehliadača cez Meta pixel. Server-side udalosti nezávisia od toho, či prehliadač script načíta. Meta tak dostane úplnejšie a spoľahlivejšie dáta na meranie aj optimalizáciu kampaní.
V skratke:
- CAPI posiela udalosti zo servera a odporúča sa používať spolu s pixelom.
- Tú istú udalosť z pixelu a zo servera Meta spáruje cez rovnaké event_id a event_name, okno deduplikácie je 48 hodín.
- CAPI Gateway je spôsob nasadenia bez kódu, beží v cloude inzerenta (AWS, GCP).
- Kvalitu párovania s používateľmi ukazuje Event Match Quality na škále 0 až 10.
Ako Conversions API funguje
Conversions API funguje tak, že server e-shopu po udalosti, napríklad po zaplatení objednávky, pošle do Mety správu s názvom udalosti, časom, hodnotou a údajmi o zákazníkovi. Meta tieto údaje spáruje so svojimi používateľmi a pripíše udalosť k reklame, ktorú človek videl alebo na ktorú klikol.
Pixel robí to isté z prehliadača. Problém je, že prehliadač nie je spoľahlivé miesto: blokovače reklám, obmedzenia prehliadačov, pomalé načítanie stránky alebo zatvorenie okna pred odoslaním udalosti spôsobia, že časť udalostí sa nikdy neodošle. Server tieto problémy nemá.
Odporúčané nastavenie je redundantné: rovnaké udalosti posielate z pixelu aj zo servera. Meta ich spáruje a započíta len raz. Výsledkom je viac zachytených udalostí a viac údajov na párovanie s používateľmi.
Ktoré údaje CAPI posiela
Každá udalosť obsahuje názov (napríklad Purchase), čas, zdroj (webová stránka), URL a údaje o zákazníkovi. Osobné údaje ako e-mail, telefón, meno a adresa sa pred odoslaním hashujú algoritmom SHA256. Technické údaje ako IP adresa, user agent prehliadača a identifikátory fbp a fbc sa posielajú bez hashovania. Pri nákupe pridávate hodnotu, menu a ID produktov, ktoré potrebujú aj dynamické produktové reklamy.
Deduplikácia: ako sa páruje pixel a server
Deduplikácia funguje tak, že pixel aj server pošlú pri tej istej udalosti rovnaký event_id a rovnaký event_name. Meta ich v okne 48 hodín rozpozná ako 1 udalosť a započíta ju len raz.
Ak event_id chýba alebo sa líši, Meta nevie, že ide o tú istú objednávku, a započíta ju 2-krát. V Ads Manager potom vidíte viac nákupov, ako naozaj prebehlo, a systém optimalizuje na nafúknuté čísla. Pri nákupe sa ako event_id často používa číslo objednávky, ktoré poznajú prehliadač aj server.
Vzorec: deduplikácia nastane, ak event_id (pixel) = event_id (server) a zároveň event_name (pixel) = event_name (server) a udalosti prídu do 48 hodín od seba.
Ilustratívny príklad
Napríklad e-shop má za týždeň 100 objednávok. Pixel zachytí 80 z nich, pretože časť zákazníkov používa blokovač alebo zatvorí stránku pred načítaním. Server pošle všetkých 100. Pri správnej deduplikácii Meta vidí 100 objednávok, nie 180. Bez event_id by v reportoch mohlo byť až 180 nákupov a kampane by vyzerali výrazne lepšie, ako v skutočnosti sú.
Preto po každom nasadení CAPI porovnajte počet nákupov v Events Manager s počtom objednávok v e-shope. Číslo nemusí sedieť presne, pretože Meta vidí len časť zákazníkov a súhlasy obmedzujú rozsah dát. Výrazne vyšší počet ako v e-shope je však takmer vždy znak duplicít.
Spôsoby implementácie
CAPI môžete nasadiť 4 spôsobmi a vhodný závisí od platformy e-shopu a od toho, koľko kontroly nad dátami chcete:
| Spôsob | Ako funguje | Pre koho |
|---|---|---|
| Partnerská integrácia | Platforma alebo plugin e-shopu posiela udalosti za vás | E-shopy na bežných platformách, rýchly štart |
| CAPI Gateway | Nasadenie bez kódu, beží v cloude inzerenta (AWS, GCP) | Firmy, ktoré nechcú programovať, ale chcú vlastnú infraštruktúru |
| Server-side GTM | Udalosti idú cez serverový kontajner Google Tag Manager na vlastnej doméne | Firmy, ktoré merajú viac platforiem cez 1 server |
| Priama integrácia | Vývojár volá API z backendu e-shopu | Vlastné riešenia, plná kontrola nad dátami |
Ak už riešite meranie Google cez server, pozrite si heslo server-side tagging. 1 server kontajner dokáže obslúžiť Metu aj Google.
Ako nastaviť a skontrolovať CAPI krok za krokom
Nastavenie a kontrola idú ruka v ruke. Postup:
- Rozhodnite, ktoré udalosti chcete merať. Pre e-shop minimálne PageView, ViewContent, AddToCart, InitiateCheckout a Purchase.
- Vyberte spôsob implementácie a nasaďte serverové udalosti.
- Pri každej udalosti posielajte rovnaké event_id z pixelu aj zo servera.
- Doplňte údaje o zákazníkovi, ktoré legálne máte k dispozícii, a osobné údaje hashujte.
- V Events Manager použite nástroj Test Events a overte, že udalosti prichádzajú z oboch zdrojov.
- Skontrolujte prehľad deduplikácie. Udalosti z pixelu a servera sa majú párovať, nie sčítať.
- Porovnajte počet nákupov v Events Manager s počtom objednávok v e-shope za rovnaké obdobie.
- Sledujte Event Match Quality a dopĺňajte chýbajúce parametre.
Kedy CAPI dáva zmysel a kedy nie
CAPI dáva zmysel pre každý e-shop, ktorý investuje do Meta Ads viac ako symbolické sumy. Systém optimalizuje podľa udalostí, ktoré dostane, a každá chýbajúca objednávka znamená menej signálov pre hľadanie zákazníkov.
Pri lead generation má CAPI ešte 1 výhodu: môžete posielať aj udalosti, ktoré sa stanú mimo webu, napríklad kvalifikovaný lead alebo podpísanú zmluvu z CRM. Systém sa potom učí hľadať ľudí, ktorí sa stanú zákazníkmi, nie len tých, ktorí vyplnia formulár.
Menší zmysel má pri veľmi malých rozpočtoch alebo pri webe, ktorý zatiaľ nemá ani funkčný pixel. Tam je prvý krok dať do poriadku základné meranie. CAPI nenahrádza súhlas so spracovaním údajov. Udalosti posielajte len v rozsahu, ktorý dovoľuje súhlas používateľa, a nastavenie zlaďte s Consent Mode a cookie lištou.
Časté chyby
- Chýbajúce alebo rozdielne event_id, takže nákupy sa započítajú 2-krát.
- Iný názov udalosti v pixeli a na serveri, napríklad Purchase a purchase.
- Serverová udalosť bez údajov o zákazníkovi, ktorú Meta nevie s nikým spárovať.
- Nehashované osobné údaje alebo naopak hashované fbp a fbc.
- Posielanie udalostí v rozpore so súhlasom používateľa.
- Nastavenie bez porovnania s reálnymi objednávkami v e-shope.
Z praxe Lighthouse
- Pri každom novom účte najprv kontrolujeme meranie: pixel, CAPI, deduplikáciu a zhodu počtu nákupov s e-shopom. Až potom optimalizujeme kampane.
- Pri WooCommerce weboch nasadzujeme CAPI spolu so správou webu, aby udalosti a feed používali rovnaké ID produktov.
- Výkon však nehodnotíme len podľa čísel z Mety. Pozeráme na celkové tržby a objednávky e-shopu v GA4 a na MER, pretože Meta je hlavný ťahač dopytu a časť jej výsledku sa prejaví v direct a organic.
Conversions API a podobné pojmy
| Pojem | Odkiaľ sa posielajú dáta | Na čo slúži |
|---|---|---|
| Meta pixel | Prehliadač | Základné meranie udalostí na webe |
| Conversions API | Server | Spoľahlivejšie meranie, doplnenie pixelu, offline udalosti |
| CAPI Gateway | Cloud inzerenta (AWS, GCP) | Nasadenie CAPI bez kódu |
| Event Match Quality | Hodnotenie v Events Manager | Ako dobre sa udalosti párujú s používateľmi |
| Rozšírené konverzie Google | Google tag alebo server | Podobný princíp hashovaných údajov pre Google Ads |
Ako zlepšiť párovanie s používateľmi, opisuje heslo Event Match Quality. Praktický návod na kombináciu pixelu a serveru nájdete v článku Meta pixel a Conversion API.
Odpovede na otázky, ktoré k pojmu Conversions API dostávame najčastejšie. Ak riešite niečo konkrétne vo vašom účte, napíšte nám.
Často kladené otázky
01Nahrádza CAPI pixel?
Nie, odporúča sa používať oboje. Pixel zachytí udalosti v prehliadači, server tie, ktoré pixel nezachytí. Deduplikácia cez event_id a event_name zabezpečí, že sa nič nezapočíta 2-krát.
02Čo sa stane, ak serverová udalosť príde neskoro?
Meta páruje udalosti s rovnakým event_id a event_name v okne 48 hodín. Ak serverová udalosť príde neskôr, deduplikácia nemusí prebehnúť. Posielajte preto udalosti čo najskôr po ich vzniku.
03Potrebujem na CAPI programátora?
Nie nutne. Mnohé platformy e-shopov majú partnerskú integráciu a CAPI Gateway sa nasadzuje bez kódu. Programátora potrebujete pri vlastnom riešení alebo pri posielaní offline udalostí z CRM.
04Je CAPI v súlade s GDPR?
CAPI je technický kanál, súlad závisí od toho, aké údaje a na základe akého súhlasu posielate. Udalosti a osobné údaje posielajte len v rozsahu súhlasu používateľa a osobné údaje hashujte. Nastavenie konzultujte aj s osobou zodpovednou za ochranu údajov.
05Ako zistím, či CAPI funguje správne?
V Events Manager skontrolujte, že udalosti prichádzajú zo servera aj z prehliadača a že sa deduplikujú. Potom porovnajte počet nákupov v Meta s počtom objednávok v e-shope za rovnaké dni. Veľký rozdiel nahor znamená duplicity, veľký rozdiel nadol chýbajúce udalosti.
06Môžem cez CAPI posielať aj offline nákupy?
Áno. Server môže poslať aj udalosti, ktoré sa stali mimo webu, napríklad nákup na predajni alebo uzavretý obchod z CRM. Potrebujete k nim údaje o zákazníkovi, podľa ktorých ich Meta spáruje. Pri lead generation tak systém dostane informáciu, ktoré leady sa stali zákazníkmi.
Ak chcete mať istotu, že Meta dostáva úplné a správne dáta, pozrite si, ako riešime analytiku a meranie, alebo si dohodnite konzultáciu.
Zdroje: Meta for Developers: deduplikácia udalostí pixelu a servera, Meta for Developers: Dataset Quality API. Fakty overené 14. 11. 2026.