Stav informací: 30. 8. 2026
Primární zdroje: OpenAI Help Center – Conversion Measurement a OpenAI Help Center – Measure Results.
Aktualizace článku: Text vychází z aktuální dokumentace OpenAI dostupné k 30. srpnu 2026. Názvy obrazovek, dostupnost funkcí a formát API se mohou měnit; před nasazením ověřte aktuální dokumentaci a nastavení svého účtu.
OpenAI Pixel a Conversions API řeší stejný úkol dvěma různými cestami: předat OpenAI informaci, že na webu nebo v aplikaci nastala měřitelná akce. Pixel pracuje v prohlížeči návštěvníka. Conversions API posílá událost ze serveru. Nejde o dvě konkurenční „verze stejného kódu“, které se mají vždy vybírat podle toho, co používá jiná platforma. Volba závisí na tom, kde vaše aplikace spolehlivě ví o dokončení akce a jaké signály dokážete předat v souladu s pravidly a souhlasy.
OpenAI výslovně uvádí, že konverze lze měřit pomocí OpenAI Pixelu, Conversions API nebo kombinace obou. Pro odolnější měření doporučuje kombinaci a při odeslání stejné konverze oběma cestami požaduje stejné ID události, aby bylo možné události deduplikovat. Tento článek vysvětluje, co každá cesta umí, kdy dává smysl, jak se vyhnout dvojímu započítání a jak nastavit kontrolu kvality bez neověřených slibů.
Rychlá odpověď
Pixel zvolte jako hlavní zdroj, když potřebujete rychle měřit akce v prohlížeči a máte kontrolu nad stránkami, na kterých se událost spouští. Conversions API zvolte jako hlavní zdroj, když je rozhodující serverová objednávka, lead nebo registrace a backend zná výsledek spolehlivěji než prohlížeč. Obě cesty použijte společně, pokud chcete využít browserový i serverový signál; stejnou obchodní akci odešlete oběma cestami se stejným event ID.
Žádná z těchto voleb sama o sobě nezaručuje vykázání každé konverze. OpenAI ji může reportovat tehdy, když přijme událost z datového zdroje připojeného k účtu, událost odpovídá konverzní události nastavené v kampani, nastane v příslušném atribučním okně a systém ji dokáže spojit s oprávněným kliknutím pomocí dostupných měřicích signálů. O tom, zda se konkrétní událost započítá, tedy rozhoduje i konfigurace kampaně, časování a dostupnost signálů.

1. Co OpenAI považuje za konverzi
Fakt OpenAI: pro měření vytvoříte v Ads Manageru datový zdroj a posíláte konverzní události přes Pixel, Conversions API nebo obě metody. OpenAI tyto události vyhodnocuje proti konverzním událostem nastaveným pro kampaň a proti příslušnému atribučnímu oknu.
V praxi je proto potřeba oddělit tři věci:
- technické přijetí: zda OpenAI událost z připojeného zdroje přijme,
- shoda události: zda standardní nebo vlastní event přesně odpovídá konfiguraci kampaně,
- atribuce: zda lze akci spojit s oprávněným kliknutím v okně a pomocí dostupných signálů.
Událost může být správně odeslaná a přesto se neobjevit jako konverze kampaně. Typickou příčinou je nesoulad typu nebo názvu eventu. OpenAI upozorňuje také na to, že historické události se po opravě konfigurace automaticky nedoplní. Testujte proto na nové způsobilé návštěvě a před spuštěním zkontrolujte přesné nastavení konverzní události.
2. Jak funguje OpenAI Pixel
Fakt OpenAI: JavaScript Pixel se instaluje na stránky, na kterých chcete měřit aktivitu, a událost se odesílá v okamžiku, kdy nastane zamýšlená akce. OpenAI doporučuje při ověřování použít debug režim a zkontrolovat inicializaci se správným ID Pixelu.
Browserový model je přirozený pro akce, které se odehrají v rozhraní webu: odeslání formuláře, dokončení registrace nebo potvrzení objednávky po návratu z platební brány. Pixel vidí prohlížeč, stránku a její stav. Může tedy zachytit i událost, u níž server ještě nemá vlastní potvrzení, například zobrazení děkovací stránky. U nákupu ale musí tým rozhodnout, zda za konverzi považuje zobrazení stránky, nebo až potvrzenou objednávku z backendu.
Co Pixelu pomáhá
- jednoduchá instalace přímo do webu nebo přes správce tagů,
- měření akcí, které se spouštějí v browseru bez další serverové integrace,
- automatické zachycení dostupného parametru
oppref, - automatické pokročilé párování, pokud Pixel rozpozná podporované údaje a použití je povolené.
Kde má Pixel hranice
Browserový signál závisí na načtení stránky, souhlasu, nastavení prohlížeče, úložišti a případném blokování skriptů. OpenAI v dokumentaci popisuje tyto podmínky jako jeden z důvodů, proč se její report může lišit od analytiky nebo jiných reklamních platforem. Pixel proto není automaticky přesnější jen proto, že je na stránce. Je přesný v rozsahu signálu, který se skutečně načte a odešle.
Pokud používáte Google Tag Manager nebo jiný správce tagů, OpenAI doporučuje ověřit, že se snippet načte na správných stránkách a že správce neblokuje ani nepřeskupí inicializaci a volání událostí. Když tag manager Pixel nespouští spolehlivě, dokumentace uvádí jako alternativu přímý snippet nebo serverové měření tam, kde je vhodné.
3. Jak funguje Conversions API
Fakt OpenAI: Conversions API je určeno pro serverové události. OpenAI v návodu k měření doporučuje serverové události používat například pro nákupy, jejichž stav zná backend. Při odesílání je důležité zachovat dostupné hodnoty OpenAI click reference, například oppref, aby měl systém signál pro přiřazení události.
Serverový event má smysl tam, kde se finální výsledek nachází až po několika krocích: platební brána potvrdí platbu webhookem, objednávkový systém změní stav na uhrazeno nebo CRM schválí lead. Backend v takové chvíli může odeslat událost z jednoho autoritativního místa místo čekání na to, zda návštěvník zůstane na děkovací stránce.
Co CAPI zlepšuje
- server může odeslat potvrzenou obchodní akci i po odchodu návštěvníka ze stránky,
- backend může použít stejný identifikátor objednávky nebo interní event ID jako browserová vrstva,
- serverová integrace se hodí pro headless weby, vlastní checkout a systémy, kde je objednávka vytvořena mimo hlavní web,
- když je
opprefdostupný, lze ho připojit k serverové události.
Co CAPI neřeší samo
Serverový event automaticky neobnoví informaci, kterou web nikdy nezachytil. Pokud se oppref ztratí při redirectu nebo navigaci, backend ho nemá z čeho doplnit. OpenAI proto doporučuje click reference zachovat přes redirecty a navigaci a poslat ji serverově, když je k dispozici. CAPI také nenahrazuje shodu eventu s nastavením kampaně ani právní povinnost sdílet data pouze v povoleném rozsahu.
Technické přihlašovací údaje k serverové integraci držte na serveru a nevkládejte je do JavaScriptu stránky. Jde o obecné bezpečnostní pravidlo redakce, nikoli o tvrzení, že OpenAI dokumentace stanovuje konkrétní architekturu vašeho backendu.
4. Pixel versus CAPI podle typu provozu
Následující tabulka je praktický rozhodovací rámec. Popisuje vhodnost podle architektury, ne garanci výkonu nebo dostupnosti konkrétní funkce v účtu.
SituaceVýchozí volbaPročKontrola Klasický e-shop s potvrzením objednávky v prohlížečiPixel, případně Pixel + CAPIPixel se snadno nasadí; CAPI doplní potvrzený stav objednávky.Zda event vzniká jednou a zda obě cesty používají stejné ID. Headless storefront nebo vlastní checkoutPixel + CAPIBrowser zachytí návštěvu, backend zná finální stav nákupu.Přenosoppref přes vlastní navigaci a webhooky.
Lead formulář bez serverového workflowPixelAkce končí odesláním formuláře v browseru.Souhlas, validace formuláře a přesný okamžik eventu.
Lead schvalovaný v CRMCAPI, případně oba zdrojeServer může poslat kvalifikovaný stav, který vznikne až později.Stabilní event ID a pravidlo, která fáze je konverzí kampaně.
Mobilní aplikace nebo partner pro měření mobiluPodle aktuální integraceDokumentace rozlišuje browserové, serverové a partnerské scénáře.Konkrétní podporu ověřte v dokumentaci a v účtu.
Redakční doporučení: začněte od autoritativního zdroje pravdy. Pokud je to prodejní databáze, měl by mít tým způsob, jak serverovou objednávku spojit s browserovým signálem. Pokud takové propojení nemáte, neposílejte stejnou akci dvěma nezávislými integracemi jen proto, abyste měli více dat. Dvě nepropojené cesty zvyšují riziko dvojího započítání.
5. Kdy použít jen Pixel
Samotný Pixel je rozumný začátek u menšího webu, kde:
- je celý konverzní krok v jedné browserové cestě,
- umíte spolehlivě poznat, kdy akce skutečně nastala,
- máte přístup ke všem relevantním stránkám a souhlasu uživatele,
- nepotřebujete čekat na potvrzení z externího systému.
Typickým příkladem je registrační formulář, jehož úspěšné odeslání server potvrdí přímo v téže stránce a nevzniká pozdější obchodní stav. I zde ověřte, zda se event nespustí při každém obnovení děkovací stránky. Pixel neodpovídá za obchodní logiku formuláře; pouze odesílá to, co mu implementace přikáže.
6. Kdy použít jen Conversions API
Samotné CAPI dává smysl, když backend spolehlivě vlastní okamžik konverze a browserová cesta není stabilní nebo k ní nemáte přístup. Může jít o potvrzení platby z webhooku, objednávku vytvořenou v externím checkoutu nebo kvalifikovaný lead vznikající až po kontrole v CRM.
Před volbou ověřte, zda server dostává měřicí signály, které OpenAI může použít pro spojení s kliknutím. Nejčastěji to znamená zachovat oppref a předat ho, když je dostupný. Pokud server zná pouze interní číslo objednávky bez vazby na návštěvu, interní číslo samo o sobě není OpenAI click reference.
7. Kdy zapojit Pixel i CAPI
OpenAI doporučuje kombinaci obou metod pro odolnější měření. Browser může zachytit cestu a parametry při návštěvě, zatímco server pošle potvrzený obchodní stav. Kombinace je však kvalitní jen tehdy, když obě vrstvy rozumí stejné události.
Pro každou obchodní akci si proto definujte jedno:
- co je začátek a konec eventu,
- jaký standardní nebo vlastní název se posílá,
- jaké event ID reprezentuje konkrétní akci,
- kdo je zdroj pravdy při změně stavu objednávky,
- jak se zachová
opprefmezi landing page, checkoutem a backendem.
Důležitá hranice: stejná objednávka odeslaná Pixelem a CAPI musí mít stejné event ID. Když browser pošle ID order-8421 a server pošle pro tutéž objednávku náhodně vytvořené jiné ID, OpenAI nemá sjednocený identifikátor, podle kterého by duplikát bezpečně rozpoznalo.

8. Deduplikace na neutrálním příkladu
Uvažujme zákazníka, který klikne na reklamu, dokončí platbu a děkovací stránka odešle event order_created přes Pixel. Platební webhook následně odešle stejný event přes CAPI. Oba payloady reprezentují jednu objednávku a nesou stejné event ID. To je správný kombinovaný scénář.
Chybný scénář vypadá jinak: Pixel odešle event při načtení děkovací stránky, CAPI odešle nový event při každém opakovaném webhooku a každá cesta generuje vlastní ID. Reporting pak může obsahovat více událostí, než odpovídá počtu objednávek. Oprava nespočívá v ručním odečtení výsledku v tabulce. Je potřeba změnit zdroj pravdy, idempotenci webhooku a event ID před dalším testem.
OpenAI dokumentace popisuje stejné event ID jako mechanismus pro deduplikaci. Konkrétní databázové schéma, délku ID a idempotenci webhooku si musí nastavit váš tým podle platformy; nevydávejte interní návrh za pravidlo OpenAI.
9. Oppref je spojovací signál, ne náhrada analytiky
Fakt OpenAI: OpenAI click reference nazývaná oppref se připojí na konec landing-page URL. Pixel ji zachytí a uloží do first-party cookie, aby mohla být spojena s pozdějšími konverzními událostmi. Pokud je hodnota dostupná, inzerent ji může připojit k volání Conversions API.
Pro implementaci to znamená projít všechny přechody, které mohou parametr ztratit:
- landing page musí přijmout dotazovací parametr,
- redirect na lokalizaci, consent vrstvu nebo checkout ho nesmí bez pravidla zahodit,
- server musí mít místo, kde se dostupná hodnota uloží k relaci nebo objednávce,
- CAPI musí hodnotu použít u eventu, který k návštěvě patří.
Další článek série se bude věnovat UTM parametrům, oppref a deduplikaci podrobněji. Zde je důležité jen rozlišení: UTM parametry slouží především vaší analytice, zatímco oppref je OpenAI click reference popsaná v dokumentaci pro měření a atribuci.
10. Pokročilé párování a soukromí
Fakt OpenAI: pokročilé párování může pomoci, když je přímá click informace neúplná. U automatického pokročilého párování Pixel rozpozná podporované údaje ve formulářích, normalizuje je a v browseru zabezpečeně hash-uje pomocí SHA-256. OpenAI uvádí, že prostřednictvím tohoto mechanismu neposílá raw customer information.
To není licence k posílání všech dostupných osobních údajů. OpenAI požaduje, aby konverzní data byla sdílena pouze v souladu s platnými zákony a podmínkami, po jasném informování uživatelů a po získání všech potřebných souhlasů, pokud je právo vyžaduje. Technický hash sám o sobě neřeší právní titul ani text informování. Tyto otázky posuďte s odpovědnou osobou pro ochranu údajů.
Prakticky si ve specifikaci u každé odesílané hodnoty uveďte zdroj, účel, právní režim a dobu uchování. Je to redakční kontrola pro tým, nikoli další tvrzení o nastavení OpenAI.
11. Jak sladit event s kampaní
OpenAI v dokumentaci k reportingu upozorňuje, že event může být přijatý, ale v Ads Manageru se zobrazí nula, pokud neodpovídá konverzní události nastavené v kampani. U standardní události se musí shodovat typ. U vlastní události se musí shodovat typ Custom i přesný název. Pouhé shodné zobrazované jméno nestačí.
Před spuštěním si vytvořte malý kontrakt:
{
"campaign_conversion_event": "order_created",
"browser_event_name": "order_created",
"server_event_name": "order_created",
"event_id_rule": "stable-order-id",
"click_reference": "preserve-oppref-when-available"
}
Hodnoty jsou pouze ilustrační. Použijte event, který je skutečně podporovaný a nastavený ve vašem účtu. Kontrakt udržujte společně s implementací Pixelu, serverového konektoru a kampaně; rozdíl mezi dokumentací a produkcí jinak často vznikne při změně názvu v jednom systému.
12. Testovací plán před ostrým provozem
Praktický checklist redakce:
- Spusťte testovací klik na reklamu a ověřte, zda se
opprefobjeví na landing page. - Projděte redirecty, consent banner, lokalizaci a checkout a zaznamenejte, kde se hodnota ukládá.
- V debug režimu ověřte inicializaci Pixelu se správným ID a přesný okamžik eventu.
- Na serveru zaznamenejte přijetí stejné objednávky, event ID a dostupný
oppref. - Porovnejte payload browseru a serveru: musí reprezentovat stejnou událost a sdílet ID.
- Ověřte, že event odpovídá typu a názvu nastavenému u kampaně.
- Proveďte obnovení děkovací stránky a opakovaný webhook; ověřte, že nevznikne druhá obchodní akce.
- Do kontrolního protokolu uložte čas, časové pásmo, event name, event ID, výsledek a případnou chybu.
Testovací log může obsahovat technické identifikátory, ale nesdílejte do něj více osobních údajů, než je pro diagnostiku nutné. Po úspěšném testu odstraňte testovací objednávky z běžných interních reportů nebo je označte tak, aby se nemíchaly s produkčním výkonem.
13. Co porovnávat v Ads Manageru a vlastní analytice
OpenAI uvádí, že Ads Manager, analytický nástroj a jiné platformy mohou vykazovat odlišné počty konverzí. Důvodem jsou jiné atribuční metody a okna, časová razítka, časová pásma, hranice dnů, browserové a consent podmínky, úložiště, deduplikace, konfigurace eventů a případně modelované měření.
Porovnávejte stejné období a stejné časové pásmo. Nezaměňujte kliknutí reklamy za analytickou relaci; OpenAI upozorňuje, že relace závisí také na načtení stránky, redirectech, souhlasu, blokování prohlížeče a UTM zpracování. Ads Manager navíc nemusí připsané konverze zobrazit okamžitě. Dokumentace doporučuje počítat s 24–48 hodinami, než se attributed conversions promítnou do reportu.
U účtů, kde je dostupné view-through měření, je tato metrika reportována odděleně od hlavního součtu Conversions a nemění billing, bidding ani conversion optimization. Pro diagnostiku Pixelu a CAPI ji proto nepřidávejte k click-through konverzím.
14. Nejčastější chyby volby zdroje
„CAPI je vždy přesnější“
Server zná obchodní stav, ale bez click reference nebo jiného dostupného signálu nemusí být možné akci správně spojit s reklamou. Kvalita závisí na úplnosti, správném eventu, atribuci a souhlasech.
„Pixel stačí, i když nákup potvrzuje webhook“
Pokud se děkovací stránka načte vícekrát nebo uživatel opustí checkout před návratem, browserový event nemusí odpovídat potvrzené objednávce. Zvažte, zda je pro váš cíl autoritativní browser, nebo backend.
„Pošleme oběma cestami dvě různá ID“
To maří deduplikaci stejné konverze. Pro jednu akci používejte stejné event ID podle pravidla, které je stabilní při opakovaném webhooku i při obnovení stránky.
„Když Ads Manager ukáže nulu, event nefunguje“
Nejprve ověřte shodu eventu s kampaní a čas zpracování. OpenAI uvádí, že přijatý, ale nesprávně nakonfigurovaný event se v kampani zobrazit nemusí a historická data se po opravě zpětně nedoplní.
„UTM a oppref jsou totéž“
UTM je parametr pro vaši analytiku a řízení kampaní. oppref je OpenAI click reference popsaná v měřicí dokumentaci. Mohou cestovat stejnou URL, ale mají jiný účel a jiné místo ověření.
15. Doporučené rozhodnutí pro první kampaň
Pokud máte běžný e-shop, začněte Pixel zprovozněním na relevantních stránkách a současně si připravte serverový bod pro potvrzení objednávky. Otestujte jednu standardní konverzi, zachování oppref a stejné event ID. Teprve potom zapojte CAPI do produkce.
Pokud máte headless nebo vlastní checkout, navrhněte Pixel a CAPI společně od začátku. V datovém modelu objednávky držte event ID a dostupnou click reference. Pokud je pro vás rozhodující kvalifikace leadu v CRM, definujte, zda chcete měřit první odeslání formuláře, nebo pozdější schválení; podle toho zvolte zdroj a název eventu.
V každém scénáři dokumentujte, co je fakt OpenAI a co je vaše implementační rozhodnutí. OpenAI potvrzuje podporu Pixelu, CAPI, kombinace, oppref, event ID pro deduplikaci a požadavek na shodu s kampaní. Neříká, že jedna metoda bude pro každý web výkonnější, že odstraní všechny rozdíly v analytice nebo že nahradí souhlasový proces.
Praktický checklist
- ☐ Vybrali jsme autoritativní okamžik konverze.
- ☐ Víme, zda hlavní signál přichází z browseru, serveru, nebo z obou.
- ☐ Pixel má správné ID a spouští se jen na relevantních stránkách.
- ☐ CAPI dostává potvrzený event ze serveru a chrání přihlašovací údaje.
- ☐
opprefpřežije redirecty a je předán serverově, pokud je dostupný. - ☐ Stejná konverze přes Pixel a CAPI používá stejné event ID.
- ☐ Event name a typ přesně odpovídají nastavení kampaně.
- ☐ Máme test obnovy stránky, opakovaného webhooku a ztráty souhlasu.
- ☐ Při porovnání s analytikou používáme stejné období, časové pásmo a atribuční kontext.
- ☐ Počítáme s tím, že report konverzí může mít zpoždění 24–48 hodin.
Závěr
Pixel a Conversions API nejsou otázka „který nástroj je lepší“, ale otázka, kde vzniká důvěryhodný signál o konkrétní akci. Pixel je browserová cesta, CAPI serverová cesta a kombinace může být odolnější, pokud obě vrstvy popisují tutéž konverzi jedním event ID. Zachovejte oppref, slaďte event s kampaní, respektujte souhlasy a rozdíly v reportingu vyhodnocujte až po zohlednění atribučního okna a zpoždění.
Další díl série naváže na tento základ a popíše UTM parametry, oppref v URL a praktickou deduplikaci konverzí. I tam budeme oddělovat dokumentované chování OpenAI od provozních rozhodnutí konkrétního webu.