Objednávka v e-shopu proběhla, ale Meta ji nevidí. Jindy ji vidí dvakrát. Tým pak ladí kampaně podle čísel, kterým nevěří, a první nápad zní: nasadíme CAPI, tím se všechno spraví.
Conversions API může měření zpřesnit, protože část marketingových událostí posílá ze serveru, CRM nebo platformy přímo do systémů Meta. Nevrátí ale data, která firma vůbec nevytváří, a nevyřeší špatně pojmenované konverze. Nejprve potřebujete měřicí plán. Až potom přenos.
CAPI není náhrada za Pixel ani souhlas
Meta popisuje Conversions API jako přímější spojení mezi firemními marketingovými daty a svými systémy pro měření a optimalizaci reklam. U webových událostí doporučuje zvážit CAPI společně s Meta Pixelem. Prohlížečová a serverová cesta se mohou doplňovat.
To neznamená, že server smí poslat všechno, co prohlížeč neposlal. Meta výslovně uvádí, že CAPI není určena k obcházení pravidel ochrany soukromí, evropských pravidel ani platformních omezení. Souhlas a zákonnost zpracování řešte podle konkrétních dat, regionu a právního posouzení. Hashovaný e-mail je pořád údaj odvozený od člověka, ne kouřová clona.
Nejdřív rozhodněte, které události mají obchodní význam
U e-shopu obvykle dává smysl sledovat postup od zobrazení produktu přes košík a zahájení objednávky po nákup. U poptávkového webu může být důležitější odeslaný formulář nebo kvalifikovaný lead. Neposílal bych každé kliknutí jako konverzi jen proto, že to jde.
U každé události si napište:
- co přesně se musí stát v reálném světě,
- zda jde o hlavní obchodní výsledek, nebo jen diagnostický signál,
- který systém je zdrojem pravdy,
- jaký jedinečný identifikátor použijete,
- které parametry potřebuje reklama a reporting,
- za jakých podmínek smíte data odeslat.
U nákupu je zdrojem pravdy často potvrzená objednávka v e-shopu nebo backendu, ne samotné otevření děkovací stránky. U leadu může být prvním signálem formulář, ale kvalitu kontaktu potvrdí až CRM.
Deduplikace rozhoduje, zda dvojí měření pomůže
Když stejnou událost odešlete z Pixelu i serveru, Meta je musí poznat jako jednu událost. K tomu se používá shodný název události a shodný event_id na obou cestách.
U nákupu může být vhodným základem stabilní ID objednávky. U události, která vlastní obchodní ID nemá, vytvořte jedinečný identifikátor při vzniku akce a předejte jej prohlížečové i serverové vrstvě. Náhodný identifikátor vytvořený zvlášť na každé straně nepomůže — hodnoty se neshodují.
Deduplikace není detail pro programátora. Když selže, kampaně mohou dostat dvojnásobný signál a reporting začne lhát.
Čtyři cesty k implementaci mají různou cenu
Partner nebo funkce e-shopové platformy
Pro běžný e-shop je to často první volba. Integraci průběžně udržuje platforma a firma nemusí vlastnit API kód. Ověřte však, jaké události posílá, zda zvládá deduplikaci, práci se souhlasem a zda vám dovolí zkontrolovat parametry.
Řízená služba nebo gateway
Část infrastruktury a aktualizací přebírá dodavatel. Platíte za provoz a závislost, ale snižujete vlastní technickou údržbu. Dává smysl, pokud služba podporuje váš stack a máte jasný přístup k diagnostice.
Server-side Google Tag Manager
Serverový kontejner může sjednotit více marketingových přenosů a dát firmě větší kontrolu. Současně přidává hosting, šablony, oprávnění a další místo, které je nutné testovat. Nevolil bych jej jen kvůli hezkému diagramu architektury.
Vlastní přímé napojení
Má největší flexibilitu a také největší odpovědnost. Potřebujete bezpečnou správu tokenů, validaci vstupu, logování bez úniku citlivých dat, obnovu při chybách, řízení verze API a člověka, který integraci udrží.
Původní článek nabízel krátký PHP skript a veřejně dosažitelný endpoint. Takové řešení už jako univerzální návod nedoporučuji. Obsahovalo starou verzi API a příliš mnoho bezpečnostních i provozních předpokladů. Kód, který dnes funguje po zkopírování, může zítra tiše zahazovat události. U přímé integrace vycházejte z aktuální dokumentace Meta a udělejte normální vývoj, ne copy-paste marketing.
Kvalita události je víc než počet parametrů
Serverová událost typicky potřebuje název, čas, zdroj akce a URL nebo jiný kontext podle zdroje. K obchodní události přidejte odpovídající hodnotu, měnu, položky a stabilní ID. Identifikátory uživatele posílejte jen tehdy, když je máte oprávněně, správně normalizované a v požadovaném formátu.
Více identifikátorů může zlepšit přiřazení, ale neplatí „čím víc, tím líp“ bez hranic. Neposílejte prázdné, vymyšlené nebo zastaralé hodnoty. A už vůbec nevytvářejte fingerprint, abyste obešli volbu uživatele.
Test musí projít celou cestou
- Spusťte testovací režim v Meta Events Manageru.
- Proveďte reálný scénář od vstupu na web po objednávku nebo lead.
- Ověřte prohlížečovou i serverovou událost, jejich parametry a shodné ID.
- Zkontrolujte, že Meta dvojici deduplikuje a nezobrazuje diagnostickou chybu.
- Porovnejte hodnotu, měnu a ID s backendem či CRM.
- Otestujte udělení i odmítnutí souhlasu podle vašeho řešení.
- Po nasazení sledujte diagnostiku a propady v čase, ne jen jeden zelený test.
Test Events potvrzuje, že technická zpráva dorazila. Nepotvrzuje, že jste zvolili správnou konverzi nebo že je integrace právně v pořádku.
CAPI a GA4 jsou dvě různé vrstvy
CAPI posílá události do Meta pro její měření a reklamní optimalizaci. GA4 analyzuje web a aplikaci napříč zdroji. Čísla se mohou lišit kvůli atribuci, souhlasu, identitě a zpracování. Nesnažím se je donutit k absolutní shodě; nejdřív ověřím, že každý systém dostává technicky správná data a používáme jej ke správnému rozhodnutí.
Pokud potřebujete společný přehled nákladů a webových výsledků, přečtěte si také propojení Meta Ads s GA4. Samotnou implementaci značek řeší průvodce Google Tag Managerem a význam událostí průvodce GA4.
Kdy bych CAPI zatím nenasazoval
Pokud firma nemá definované konverze, neví, která objednávka je platná, nebo neumí udržet současný Pixel, přidání serverové cesty zvýší chaos. Nejdřív opravte zdrojová data a měřicí plán. CAPI dává smysl, když víte, jaký signál chcete doručit, proč jej Meta potřebuje a kdo bude integraci vlastnit.
Chcete-li zvolit nejmenší rozumné řešení pro váš e-shop nebo leadový web, pošlete mi přes kontakt platformu, současné měření a událost, která je pro vás obchodně nejdůležitější.