Jak nastavit měření konverzí z reklam v ChatGPT ve FAPI

Jak nastavit měření konverzí z reklam v ChatGPT ve FAPI

Spustili jste reklamu v ChatGPT a potřebujete zjistit, jestli vám přivádí objednávky?

Propojíme váš web, prodejní formulář FAPI a reklamní účet v OpenAI. Projdeme nasazení pixelu, měření na děkovací stránce i odesílání objednávek přímo z FAPI.

Co budete měřit

Tento postup měří vytvořené objednávky, bez ohledu na to, zda byly zaplacené.

FAPI odesílá událost order_created, kterou v OpenAI Ads najdete jako Order Created. Totéž platí pro zde uvedený konverzní kód na děkovací stránce i pro nativní serverové propojení FAPI.

Když tedy zákazník objedná kurz a zvolí bankovní převod, objednávka už může být odeslaná do měření, přestože peníze ještě nepřišly. Počet těchto konverzí ani jejich hodnota nejsou automaticky počet platících zákazníků nebo přijaté tržby.

Nastavíme dvě cesty, kterými se informace dostane do OpenAI:

• OpenAI Pixel a konverzní kód odešlou událost z prohlížeče návštěvníka na děkovací stránce.
• Conversions API, zkráceně CAPI, odešle událost přímo ze serveru FAPI při vytvoření objednávky.

OpenAI umožňuje používat Pixel, CAPI nebo obě cesty současně. Tady popisujeme kombinaci. Její smysl je, aby měření nezáviselo pouze na načtení děkovací stránky. Podrobnosti vysvětluje dokumentace měření konverzí OpenAI.

Co si připravit

Potřebujete přístup do OpenAI Ads Manageru, do administrace FAPI a k úpravám vlastních kódů na webu. Prohlédněte si také nastavení děkovací stránky prodejního formuláře: bude záležet na tom, jestli používáte vlastní stránku, nebo stránku FAPI.

Měření na webu musí navazovat na nastavení souhlasů návštěvníka. Pokud vlastní kódy a cookies lištu spravuje někdo jiný, předejte mu tento návod.

1. Vytvořte datový zdroj v OpenAI Ads

1. V Ads Manageru otevřete Tools → Conversions.
2. Klikněte na Create → Data source.
3. Pojmenujte zdroj tak, abyste ho poznali, například „Můj web – FAPI objednávky“.
4. Zkopírujte si jeho Pixel ID a instalační kód pixelu.

Pokud už pro tentýž web správný zdroj používáte, pracujte s ním dál. Není potřeba zakládat nový jen kvůli propojení FAPI.

Pixel ID si uschovejte. Stejnou hodnotu použijete na webu, na děkovací stránce i v propojení FAPI. Kopírujte položku označenou Pixel ID, nikoli jiný identifikátor účtu či zdroje.

Názvy položek vycházejí z rozhraní ukázaného ve videu; OpenAI je může průběžně upravovat.

2. Nasaďte OpenAI Pixel na web

Zkopírovaný instalační kód vložte do globálních vlastních kódů svého webu, do části pro hlavičku stránky, obvykle označené HEAD. Ve videu to ukazujeme v MioWebu v sekci Vlastní kódy. U jiného editoru hledejte odpovídající nastavení.

Pixel má být dostupný na vstupní stránce reklamy a dalších stránkách objednávkové cesty. Samotné vložení na děkovací stránku nestačí k zachycení původního příchodu z reklamy. Základní pixel také sám nerozpozná vytvořenou objednávku ve FAPI — tu mu předá až konverzní kód.

Spouštění měření napojte na potřebný souhlas návštěvníka. OpenAI Pixel má vlastní řízení souhlasu; nelze předpokládat, že bez dalšího nastavení počká na vaši cookies lištu. Technik najde přesný postup v části Control measurement consent v dokumentaci OpenAI Pixelu.

Pokud instalační kód obsahuje debug: true  , znamená to výpis diagnostických informací do konzole prohlížeče. Není to testovací režim, který by bránil započítání událostí. Po kontrole můžete diagnostiku vypnout.

3. Přidejte konverzní kód na děkovací stránku

Použijte následující kód z veřejné nápovědy Konverzní kódy FAPI, z části „Ukázka zaslání dat do OpenAI (ChatGPT) pixelu“:

<script>
document.addEventListener('FapiSdkLoaded', function () {
    FAPI_CONVERSION.runConversion(function (fapiOrderData) {
        FAPI_CONVERSION.simpleChatgptAdsTransaction(fapiOrderData);
    });
});
</script>

Kód počká na načtení FAPI SDK, načte údaje o konkrétní objednávce a předá je OpenAI Pixelu. Hodnotu objednávky ani její identifikátor do něj ručně nedoplňujete.

Vyberte si jednu z následujících variant podle děkovací stránky svého formuláře.

Varianta A: Používáte vlastní děkovací stránku

1. Ve FAPI otevřete prodejní formulář a jeho 5. krok – Děkovací stránka.
2. U vlastní děkovací stránky zapněte volbu Vkládat unikátní identifikátor objednávky do URL děkovací stránky. Díky němu kód pozná, kterou objednávku má načíst.
3. Ověřte, že adresa vaší děkovací stránky začíná https://  .
4. Na této stránce zajistěte inicializaci OpenAI Pixelu se stejným Pixel ID jako na webu. Pokud ho už načítají globální kódy webu, nepřidávejte druhou instalaci.
5. Vložte konverzní kód uvedený výše. Pod něj vložte FAPI SDK:

<script src="https://form.fapi.cz/js/sdk/fapi.js"></script>

Pořadí je důležité: inicializace pixelu → konverzní kód → načtení FAPI SDK. Konverzní kód musí začít naslouchat události FapiSdkLoaded   dřív, než ji SDK vyvolá.

Pokud už FAPI SDK na stránce načítá jiný kód nebo plugin, nevkládejte ho podruhé. Nechte s technikem sladit pořadí načítání a spuštění po souhlasu: pouhé pozdější vložení uvedeného callbacku nezachytí událost, která už proběhla. To platí i tehdy, když jeho spuštění odloží cookies lišta.

Varianta B: Používáte děkovací stránku FAPI

1. V prodejním formuláři otevřete 5. krok – Děkovací stránka.
2. Do pole Konverzní kódy / Konverzní kód (HTML) vložte nejprve instalační a inicializační kód OpenAI Pixelu.
3. Pod něj vložte výše uvedený konverzní kód FAPI.
4. Nastavení uložte.

FAPI SDK sem znovu nevkládejte. Děkovací stránka FAPI už ho obsahuje. I zde musí být spouštění měření sladěné s potřebnými souhlasy; nastavení cookies lišty na vlastní doméně samo o sobě neprokazuje stejné nastavení na stránce FAPI.

4. Vytvořte konverzi Order Created

Vraťte se do Tools → Conversions v OpenAI Ads a vytvořte konverzní událost:

1. Vyberte datový zdroj z prvního kroku.
2. Jako základní událost, Base event, zvolte Order Created.
3. Konverzi pojmenujte například „FAPI – vytvořená objednávka“ a uložte ji.

Název slouží pro vaši orientaci. Rozhodující je vybraný zdroj a skutečný typ události order_created  . Samotné přejmenování jiné události na „Objednávka“ ji nezmění.

Pokud vám OpenAI nabídne další obecný kód pro odeslání Order Created, nepřidávejte ho vedle konverzního kódu FAPI. Odeslání objednávky už řešíme v předchozím kroku.

Tuto konverzi pak zvolte v nastavení kampaně. Postup najdete v článku Jak nastavit reklamu v ChatGPT nebo ve videonávodu k vytvoření kampaně.

5. Propojte FAPI přes CAPI

Před zapnutím CAPI ověřte s technikem, jak se serverové odesílání řídí potřebným souhlasem návštěvníka. Samotná cookies lišta a zablokování pixelu v prohlížeči nezaručují blokaci událostí odesílaných z FAPI. Pokud vaše nastavení potřebný souhlas neumí respektovat, CAPI pro tuto cestu zatím nezapínejte. Požadavky na informování návštěvníků a potřebné souhlasy uvádí také OpenAI v dokumentaci měření.

Získejte správný klíč

V části Conversions v OpenAI Ads otevřete Conversion keys a vytvořte nový klíč, například s názvem „FAPI“. Zkopírujte ho při vytvoření a bezpečně uložte.

Potřebujete Conversions API key, nikoli obecný API klíč pro jiné služby OpenAI. Pokud propojení nejde uložit, zkontrolujte také, zda jste tyto klíče nezaměnili. Získání klíče v části konverzí popisuje také dokumentace Conversions API.

Klíč patří pouze do propojení ve FAPI. Nevkládejte ho do HTML stránky ani do veřejného JavaScriptu.

Uložte propojení ve FAPI

1. Otevřete Nastavení → Propojení.
2. U ChatGPT Ads zvolte Připojit.
3. Do pole Pixel ID vložte stejnou hodnotu jako na webu a děkovací stránce.
4. Do pole CAPI klíč vložte právě vytvořený Conversion key.
5. Uložte propojení a zkontrolujte potvrzení úspěšného připojení.

Uložení ověří přihlašovací údaje. Ještě tím ale nemáte ověřenou celou cestu zákazníka ani přiřazení objednávky k reklamě.

Proč se jedna objednávka nemá počítat dvakrát

FAPI používá pro obě cesty společný identifikátor události odvozený od variabilního symbolu objednávky. OpenAI tak může spojit kopii z pixelu a kopii ze serveru. Pro správné odstranění duplicit musí souhlasit také Pixel ID a typ události.

Proto ponechte předávání identifikátoru na FAPI a nepřidávejte další vlastní odesílání téže objednávky s novým ID. Stejně důležitá je kontrola při opakovaném načtení děkovací stránky.

6. Ověřte celou objednávkovou cestu

Projděte formulář stejně jako zákazník. Nestačí si jen otevřít prázdnou děkovací stránku bez údajů o objednávce.

1. Vytvořte kontrolní objednávku a poznamenejte si její variabilní symbol a čas vytvoření. Počítejte s tím, že může odejít jako skutečná měřicí událost.
2. Zkontrolujte návrat na děkovací stránku. U vlastní stránky musí zůstat v URL identifikátor objednávky. Ověřte také, že přesměrování po cestě neztrácí reklamní parametry.
3. Ověřte odeslání i přijetí události. S technikem zkontrolujte chyby prohlížeče a požadavky pixelu; v OpenAI ověřte dostupné údaje o příjmu pro správný datový zdroj. Samotný výpis v konzoli neprokazuje doručení. Pokud váš účet potřebný detail nezobrazuje, požádejte o kontrolu podporu a předejte čas a identifikátor objednávky.
4. Prověřte obě cesty a souhlasy. U kombinace Pixelu a CAPI zkontrolujte shodu typu události a identifikátoru. Vyzkoušejte i odmítnutí a odvolání souhlasu podle nastavení svého webu.
5. Znovu načtěte děkovací stránku. Jedna objednávka nemá vzniknout jako další samostatná konverze s novým ID.
6. Samostatně zkontrolujte přiřazení ke kampani. Přijatá událost ještě nemusí být konverzí připsanou reklamě. K tomu musí odpovídat konverze kampaně a existovat způsobilá reklamní návštěva v příslušném období.

OpenAI uvádí, že připsané konverze se mohou v přehledu objevit se zpožděním 24–48 hodin. Nula bezprostředně po objednávce proto sama o sobě není důkaz rozbitého měření. Podrobnosti najdete v nápovědě Measure Results.

Nejčastější problémy

Potřebujete měřit až zaplacené objednávky? Jde o jiné zadání. Pouhá změna browserové funkce na variantu OnlyPaid   nepřepne serverové propojení CAPI na úhrady a sama nezajistí zachycení pozdější platby převodem. Domluvte si proto konkrétní postup podle toho, jak přijímáte platby a co chcete vyhodnocovat.

Pomůžeme vám s nastavením

Nechcete řešit, kam který kód patří a proč se objednávka nepřiřadila reklamě? Domluvte si konzultaci k nastavení. Projdeme s vámi web, prodejní formulář a měření.

Pokud FAPI ještě nepoužíváte, zaregistrujte se do FAPI a připravte si prodejní formulář pro svoji nabídku.