Meta pixel a Conversions API (CAPI): co to je a jak je nastavit

Co je Meta pixel a co Conversions API

Meta pixel je kód, který vložíte na web. Zaznamenává akce návštěvníků, třeba zobrazení produktu, vložení do košíku nebo nákup, a posílá je do Mety. Conversions API (CAPI) posílá tytéž události přímo z vašeho serveru, e-shopové platformy nebo CRM, bez prohlížeče. Oba nástroje plní stejný účel: Meta díky nim ví, co reklama přinesla.

Podle nápovědy Mety pixel slouží ke třem věcem. Pomáhá ukázat reklamy správným lidem, umožňuje automatickým nabídkám cílit na ty, kdo pravděpodobně nakoupí, a měří výsledky reklam. Z událostí lze navíc vytvářet vlastní publika pro remarketing. Stručnou definici najdete i ve slovníku pod heslem Meta pixel.

Facebook pixel, Meta pixel, dataset

Facebook pixel je starší název Meta pixelu, starší návody ho používají dodnes. Ve Správci událostí dnes uvidíte i slovo dataset. Dataset spojuje události z webu, aplikace, prodejny a chatů pod jedno ID. Když vznikl z vašeho pixelu, má stejné ID jako původní pixel.

Tabulku posuňte do strany.

Conversions API není náhrada pixelu, ale jeho druhá polovina. Server navíc zná třeba stav poptávky v CRM.

Proč používat pixel i Conversions API zároveň

Meta tomu říká redundantní nastavení: stejné události posíláte z prohlížeče i ze serveru. Pixel občas událost nedoručí. Stránka se nenačte celá, vypadne připojení nebo kód zablokuje blokátor reklam. Data z Conversions API tyhle potíže podle Mety ovlivňují méně.

Víc zachycených událostí znamená, že systém doručování má z čeho se učit. Meta proto doporučuje usilovat o pokrytí 75 %: přes Conversions API má přijít zhruba tři čtvrtiny toho, co pošle pixel. Ve Správci událostí to ukazuje karta Pokrytí událostí.

Samotné Conversions API bez pixelu nedoporučujeme. Pixel ukládá na vaší doméně cookie _fbp s ID prohlížeče a Meta doporučuje posílat tuto hodnotu i se serverovými událostmi. Pomáhá jim najít správného člověka.

Deduplikace událostí: jak zabránit dvojitému nákupu

Když stejný nákup přijde z pixelu i ze serveru, Meta ho bez vodítka započítá dvakrát. Konverzní poměr a ROAS pak vypadají lépe, než jsou, a kampaň se učí na nafouknutých číslech. Deduplikace zajistí, že se jedna akce započítá jednou.

Co musí sedět

• Název události: Purchase z pixelu a event_name: Purchase ze serveru.
• ID události: v pixelu parametr eventID, v Conversions API event_id. Musí být identické.

Meta doporučuje právě tuto dvojici. U nákupu je nejjednodušší použít jako ID číslo objednávky. U událostí bez vlastního čísla stačí náhodný řetězec, jen ho musí prohlížeč i server poslat stejný.

fbq('track', 'Purchase',
  { value: 1290.00, currency: 'CZK' },
  { eventID: 'OBJ-2026-10458' });

{ "event_name": "Purchase",
  "event_id": "OBJ-2026-10458",
  "event_time": 1791273600,
  "action_source": "website",
  "custom_data": {
    "value": 1290.00,
    "currency": "CZK" } }

Příklad s vymyšleným číslem objednávky. Celá serverová událost potřebuje ještě údaje o zákazníkovi (user_data) a adresu stránky.

Jak Meta páruje

Podle dokumentace pro vývojáře Meta hledá shodu mezi událostmi, které přišly v rozmezí 48 hodin, a ponechá tu první. Když dorazí v rozmezí pěti minut, dá přednost události z prohlížeče. Náhradní párování přes fbp nebo external_id existuje, ale funguje hlavně tehdy, když událost z prohlížeče dorazí dřív než ze serveru.

Kvalita párování událostí: Event Match Quality

Kvalita párování událostí (anglicky Event Match Quality, EMQ) je skóre od 0 do 10, které ukazuje, jak dobře Meta dokáže serverovou událost přiřadit ke konkrétnímu Meta účtu. Počítá se z údajů o zákazníkovi, které s událostí posíláte, a z podílu skutečně spárovaných událostí.

Skóre najdete ve Správci událostí u webových událostí z Conversions API. Podle nápovědy Mety vychází z posledních 48 hodin. Čím víc událostí Meta spáruje, tím víc konverzí přiřadí reklamám a tím lépe kampaň cílí.

Tabulku posuňte do strany.

• Údaje o zákazníkovi hashujte (SHA-256): e-mail, telefon, jméno, město, PSČ, zemi. IP adresu, user agent, fbp a fbc naopak nehashujte.
• Telefon vždy s předvolbou (420…), i když máte jen české zákazníky.
• Zvažte rozšířené párování pro pixel. Automatické se zapíná přepínačem ve Správci událostí a hledá údaje ve formulářích. V regulovaných oborech (např. zdraví, finance) nemusí být dostupné. Ruční nastaví vývojář v kódu.

Ve starší verzi článku jsme psali, že Meta chce skóre aspoň 6 z 10. V nápovědě Mety ale takovou hranici nenajdete. Řiďte se doporučeními, která Správce událostí ukáže u konkrétní události.

Jak nastavit Meta pixel a Conversions API: pět cest

Pixel i Conversions API zakládáte ve Správci událostí (Events Manager). Cesta na web záleží na tom, na čem web běží a kdo se o něj stará. Meta možnosti porovnává podle ceny a náročnosti:

Tabulku posuňte do strany.

Jak nastavit Meta pixel ve Správci událostí

Celý postup popisuje nápověda Mety k instalaci pixelu. Dataset s pixelem můžete mít ve firemním portfoliu Mety (hodí se, když reklamy spravuje někdo další), nebo pod samostatným reklamním účtem. Jak portfolio založit, popisuje článek jak založit Business Manager.

E-shop na platformě

Meta mezi partnery pro webové události uvádí například Shopify, WooCommerce, WordPress, PrestaShop, Magento nebo BigCommerce. U nich se Conversions API zapíná přímo v integraci.

Používáte Shoptet nebo jinou platformu, kterou Meta v seznamu nemá? Ověřte v její nápovědě, jestli posílá události i ze serveru a jestli k nim přidává event_id pro deduplikaci.

Meta pixel a CAPI přes Google Tag Manager

Do Google Tag Manageru vložíte základní kód pixelu jako tag Vlastní HTML, spouštěný jednou na stránku na všech stránkách. Události přidáte jako samostatné tagy se spouštěči. Postup má Meta v článku pixel přes Google Tag Manager.

Pro Conversions API potřebujete serverový kontejner GTM. Data z webového tagu GA4 jdou na váš server (Google Cloud, Stape nebo jiný hosting) a odtud do Mety přes CAPI. Propojení se zakládá ve Správci událostí v části Partnerské integrace, volba Google Tag Manager. Deduplikaci zajistí stejné event_id v prohlížeči i na serveru.

Conversions API Gateway

Conversions API Gateway je samoobslužné nastavení bez kódu na vašem účtu u Amazon Web Services nebo Google Cloud. Meta ho doporučuje, když už máte pixel, utrácíte přes 300 USD měsíčně za kampaně na webové konverze a nepracujete s e-shopovým partnerem. Platíte jen cloud, od 30 USD měsíčně, deduplikaci řeší Gateway sama.

Standardní události: které posílat

Meta má 17 standardních událostí a používá je pro reporty, optimalizaci kampaní i publika. Proto je volte místo vlastních názvů, kde to jde. Pro e-shop a web s poptávkami stačí obvykle tyhle (kromě PageView ze základního kódu jsou všechny mezi standardními):

Tabulku posuňte do strany.

• Hodnota s desetinnou tečkou, bez mezer a symbolu měny: 1290.00, ne „1 290 Kč“. Měna třípísmenným kódem CZK. Výchozí kód od Mety má 0.00 USD, takže hodnotu vždy přepište.
• Názvy rozlišují velká a malá písmena. purchase není Purchase a Meta ho nevezme jako standardní nákup.
• ID produktů musí sedět s katalogem. Bez content_ids nebo contents nefungují katalogové reklamy Advantage+ ani dynamický remarketing.

Hodnotu nákupu posílejte všude stejně, buď s DPH a dopravou, nebo bez nich, v pixelu, v Conversions API i v dalších nástrojích.

Souhlas s cookies: pixel až po souhlasu

Pixel je marketingový nástroj. V praxi ho spouštíme až poté, co návštěvník v cookie liště souhlasí s marketingovými cookies; závazný výklad dá právník. Meta v nápovědě opakuje, že právní základ a potřebné souhlasy musí zajistit inzerent.

Když pixel vkládáte kódem, Meta pro to má funkci souhlasu. Před inicializací pixelu zavoláte fbq('consent', 'revoke'), a to na každé stránce. Pixel tím pozastaví odesílání. Až člověk souhlasí, zavoláte fbq('consent', 'grant'). Když souhlas řídíte jinak, třeba přes Google Tag Manager, je tento kód podle Mety volitelný.

fbq('consent', 'revoke');          před init, na každé stránce
fbq('init', 'VASE_ID_PIXELU');
fbq('track', 'PageView');
… po kliknutí na „Souhlasím“ v cookie liště:
fbq('consent', 'grant');

Na serveru postupujeme stejně. Meta píše jen, že Conversions API není určené k obcházení pravidel ochrany soukromí a souhlasy zajišťuje inzerent. V praxi proto ze serveru posíláme jen události lidí, kteří souhlasili, a hlídá to integrace nebo serverový kontejner. Závazný výklad dá právník.

Jak ověřit, že měření funguje

Nastavení je hotové, až když události vidíte ve Správci událostí a sedí jejich počty:

Typické chyby v měření Meta pixelu a CAPI

Většinu chyb odhalí Test událostí a Diagnostika. Tyhle se v auditech měření opakují často.

Proč Meta hlásí jiná čísla než GA4

Rozdíl mezi Ads Managerem a Google Analytics 4 neznamená automaticky chybu. Každý nástroj počítá jinak a Meta vyjmenovává důvody:

• Konverze po zobrazení. Výchozí atribuce nových sestav v Ads Manageru je 7 dní po kliknutí nebo 1 den po zobrazení. Meta si tedy připíše i nákup člověka, který reklamu jen viděl. Některé nástroje s připsáním konverze po zobrazení potíže mají.
• Měření napříč zařízeními. Meta pozná, že člověk viděl reklamu v mobilu a nakoupil na počítači. Měření postavené na cookies v jednom prohlížeči to často nespojí.
• Datum konverze. Ads Manager připisuje konverzi ke dni zobrazení reklamy, ne ke dni nákupu.
• Blokátory. Když pixel kvůli blokátoru nebo chybě načítání nezafunguje, Meta vidí méně než váš e-shop. Conversions API tuhle mezeru zmenšuje.
• Souhlasy. Kdo marketingové cookies odmítl, do Mety se neodešle ani ze serveru. Rozdíl proti e-shopu tak zčásti zůstane.

Proto čísla neporovnávejte jen v součtu. Sledujte trend, porovnávejte se stejným atribučním oknem a návštěvy z Mety označujte UTM parametry, aby je GA4 poznala. Jak se liší atribuční okno a model Mety a GA4 a co ovlivňuje cenu reklamy, popisujeme v článku kolik stojí reklama na Metě.

Na co se nás ptáte