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

Spouštíte reklamy v ChatGPT a chcete zjistit, zda vám skutečně přivádějí objednávky? V tomto návodu propojíte OpenAI Ads se svým webem a s FAPI. OpenAI potom získá informaci, že člověk, který přišel z reklamy, vytvořil objednávku.

Díky správně nastavenému měření můžete vyhodnocovat úspěšnost kampaní, porovnávat reklamy a lépe rozhodovat, do kterých kampaní se vyplatí investovat.

Jak měření funguje

Nastavíte dvě cesty, kterými se informace o objednávce dostane do OpenAI:

• OpenAI Pixel funguje v prohlížeči zákazníka. Rozpozná jeho příchod z reklamy a sleduje jeho cestu po webu.
• Conversions API neboli CAPI odešle informaci o objednávce přímo ze serveru FAPI do OpenAI.

Pro co nejspolehlivější přiřazení objednávek k reklamám doporučujeme používat OpenAI Pixel a CAPI společně. Pixel zachytí příchod návštěvníka z reklamy v prohlížeči. CAPI následně odešle informaci o vytvořené objednávce přímo ze serveru FAPI a doplňuje tak měření o druhou cestu.

Pokud se stejná objednávka odešle Pixelem i přes CAPI, OpenAI ji může podle společného identifikátoru spojit a nezapočítat dvakrát. Tomuto spojení se říká deduplikace. Podrobnosti najdete v dokumentaci měření konverzí OpenAI.

FAPI odesílá událost order_created. V OpenAI Ads ji vyberete pod názvem Order Created.

Co budete potřebovat

Připravte si:

• účet a přístup do OpenAI Ads Manageru,
• přístup do administrace FAPI,
• vytvořený prodejní formulář ve FAPI,
• oprávnění upravit vlastní kódy webu,
• informaci, zda používáte vlastní děkovací stránku, nebo děkovací stránku FAPI.

1. Vytvořte datový zdroj v OpenAI Ads

1. Přihlaste se do OpenAI Ads Manageru.
2. V levém menu otevřete Tools → Conversions.
3. Klikněte na Create a vyberte Data source.
4. Zadejte srozumitelný název, například Můj web – FAPI objednávky   .
5. Klikněte na Create.

V nabídce Tools otevřete Conversions a přes tlačítko Create založte nový Data source.

Po vytvoření si zkopírujte:

• Pixel ID, tedy identifikátor datového zdroje,
• celý instalační kód OpenAI Pixelu.

Pixel ID budete později vkládat také do FAPI. Pokud už pro stejný web vhodný datový zdroj máte, nemusíte vytvářet další.

2. Vložte OpenAI Pixel na celý web

Zkopírovaný instalační kód vložte do globálních vlastních kódů svého webu. Kód musí být v hlavičce stránky, obvykle označené jako HEAD nebo <head>   .

Pixel musí být dostupný:

• na stránce, na kterou přichází návštěvník z reklamy,
• na dalších stránkách objednávkové cesty,
• na vlastní děkovací stránce, pokud ji používáte.

Nestačí jej vložit pouze na děkovací stránku. Pixel musí zachytit už příchod zákazníka z reklamy.

Příklad vložení v MioWebu

V administraci MioWebu otevřete Vlastní kódy, přidejte nový kód a jako umístění zvolte hlavičku webu.

Instalační kód Pixelu vložte mezi kódy pro celý web a nastavte jeho umístění do hlavičky.

V jiném editoru webu hledejte obdobnou sekci, například Vlastní kódy, Custom code, Tracking code nebo HEAD code.

3. Nastavte odeslání objednávky do OpenAI

Samotný Pixel sleduje návštěvu webu, ale je potřeba mu také předat informaci, že ve FAPI vznikla objednávka. Další postup se liší podle toho, zda používáte vlastní děkovací stránku, nebo děkovací stránku FAPI.

U vlastní děkovací stránky vložíte následující konverzní kód ručně. U děkovací stránky FAPI kód ručně nevkládáte – stačí vyplnit pole ChatGPT Ads Pixel ID podle varianty B.

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

Kód automaticky načte údaje o konkrétní objednávce a předá je OpenAI. Identifikátor ani hodnotu objednávky do něj ručně nedoplňujte.

Aktuální kód najdete také v nápovědě Konverzní kódy FAPI, v části Ukázka zaslání dat do OpenAI (ChatGPT) pixelu.

Na ukázce je konverzní kód uložený mezi vlastními kódy webu. Rozhodující je, aby se spustil na děkovací stránce po vytvoření objednávky.

Další postup závisí na typu děkovací stránky.

Při použití vlastní děkovací stránky FAPI externí stránku nevytváří ani do ní nepřenáší obsah pole ChatGPT Ads Pixel ID nebo Konverzní kód (HTML). Pixel, konverzní kód FAPI a FAPI SDK proto musíte vložit přímo na vlastní web podle následujícího postupu.

1. Ve FAPI otevřete prodejní formulář a přejděte do 5. kroku – Děkovací stránka.
2. U vlastní děkovací stránky aktivujte volbu Vkládat unikátní identifikátor objednávky do URL děkovací stránky.
3. Zkontrolujte, že adresa děkovací stránky začíná https://   .
4. Ověřte, že se na ní načítá OpenAI Pixel se stejným Pixel ID. Pokud se Pixel načítá globálně na celém webu, nevkládejte jej podruhé.
5. Na stránku vložte výše uvedený konverzní kód FAPI.
6. Pod konverzní kód vložte FAPI SDK:

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

Na vlastní děkovací stránku ve svém webovém editoru vložte kódy v tomto pořadí:

1. instalační kód OpenAI Pixelu,
2. konverzní kód FAPI,
3. FAPI SDK.

Pokud už FAPI SDK načítá jiný kód nebo doplněk, nevkládejte jej znovu.

Ve FAPI zadejte adresu vlastní děkovací stránky začínající https://   a aktivujte předávání unikátního identifikátoru objednávky. Samotné měřicí kódy vložte přímo do vlastní děkovací stránky ve svém webovém editoru, nikoli do pole Trackovací kód (HTML) zobrazeného ve FAPI.

Pokud zákazníka po dokončení objednávky necháváte na děkovací stránce FAPI, nemusíte na ni ručně vkládat instalační ani konverzní kód OpenAI.

1. Ve FAPI otevřete příslušný prodejní formulář.
2. Přejděte do 5. kroku – Děkovací stránka.
3. Ponechte vypnutou možnost Použít vlastní děkovací stránku.
4. Do pole ChatGPT Ads Pixel ID vložte Pixel ID datového zdroje z OpenAI Ads.
5. Nastavení formuláře uložte.

FAPI na své děkovací stránce automaticky:

• načte OpenAI Pixel,
• inicializuje jej zadaným Pixel ID,
• po vytvoření objednávky odešle událost order_created ,
• použije variabilní symbol objednávky jako event_id , aby OpenAI mohlo spojit událost odeslanou z prohlížeče s událostí odeslanou přes CAPI a nezapočítalo objednávku dvakrát.

FAPI SDK rovněž nevkládejte. Děkovací stránka FAPI jej již obsahuje.

Pixel musí být také na vašem webu

Pole ChatGPT Ads Pixel ID zajistí načtení Pixelu až na děkovací stránce FAPI. Nenahrazuje Pixel na stránce, na kterou návštěvník přijde z reklamy, ani na objednávkové cestě.

Instalační kód OpenAI Pixelu proto ponechte globálně v hlavičce vlastního webu. Díky tomu Pixel zachytí příchod návštěvníka z reklamy a uchová informace potřebné pro pozdější přiřazení objednávky.

4. Vytvořte konverzi Order Created

1. V OpenAI Ads otevřete Tools → Conversions.
2. Přejděte na záložku Conversion Events.
3. Klikněte na Create → Conversion Event.
4. Vyberte datový zdroj vytvořený v prvním kroku.
5. V poli Base event vyberte Order Created.
6. Konverzi pojmenujte například FAPI – vytvořená objednávka    a uložte ji.

Vytvořte Conversion Event nad správným datovým zdrojem a jako Base event použijte Order Created.

Název konverze slouží pouze pro vaši orientaci. Rozhodující je vybraný typ události Order Created.

Pokud vám OpenAI po vytvoření nabídne další obecný kód pro odeslání této události, na web jej nepřidávejte. Odeslání už zajišťuje konverzní kód FAPI z předchozího kroku. Přidáním druhého kódu by mohla jedna objednávka odejít vícekrát.

Vytvořenou konverzi následně vyberte jako cíl příslušné reklamní kampaně.

5. Propojte FAPI s OpenAI pomocí CAPI

CAPI vytvoří druhou cestu odesílání: informaci o nové objednávce předá přímo server FAPI.

Vytvořte Conversion key

1. V OpenAI Ads otevřete Tools → Conversions.
2. Vpravo nahoře otevřete Conversion keys.
3. Klikněte na Create new key.
4. Klíč pojmenujte například FAPI   .
5. Po vytvoření jej ihned zkopírujte.

CAPI klíč vytvořte v části Conversion keys, nikoli v obecném nastavení API klíčů OpenAI.

Uložte propojení ve FAPI

1. Ve FAPI otevřete Nastavení → Propojení aplikací.
2. Najděte ChatGPT Ads a klikněte na Připojit.
3. Do pole Pixel ID vložte identifikátor datového zdroje z OpenAI Ads.
4. Do pole CAPI klíč vložte právě vytvořený Conversion key.
5. Klikněte na Uložit.

V Nastavení → Propojení najděte ChatGPT Ads a otevřete nastavení přes tlačítko Připojit.

Při uložení FAPI provede test propojení. Testovací událost nemá ovlivnit běžné výsledky měření. Správné uložení poznáte podle potvrzení, že propojení s ChatGPT bylo nastaveno, a podle stavu Připojeno v seznamu propojení.

Pro Pixel, konverzi Order Created a propojení CAPI používejte stejný datový zdroj a stejné Pixel ID.

6. Otestujte celou objednávkovou cestu

Nestačí otevřít samotnou děkovací stránku. Projděte celý proces jako zákazník:

1. Otevřete stránku, na kterou vede reklama.
2. Přijměte odpovídající cookies podle testovaného scénáře.
3. Projděte prodejním formulářem a vytvořte testovací objednávku.
4. Poznamenejte si čas a variabilní symbol objednávky.
5. Zkontrolujte přesměrování na správnou děkovací stránku.
6. U vlastní děkovací stránky ověřte, že URL obsahuje unikátní identifikátor objednávky.
7. V OpenAI Ads zkontrolujte přijetí události u správného datového zdroje.
8. Obnovte děkovací stránku a ověřte, že se stejná objednávka nevytvořila jako další konverze s novým identifikátorem.

Závěrečná kontrola

Před spuštěním kampaně ověřte, že:

• OpenAI Pixel je nasazený na celém webu a spouští se podle uděleného souhlasu,
• Pixel používá správné Pixel ID,
• u vlastní děkovací stránky je vložený konverzní kód FAPI a FAPI SDK a dostává unikátní identifikátor objednávky,
• u děkovací stránky FAPI je vyplněné pole ChatGPT Ads Pixel ID,
• v OpenAI Ads existuje konverze typu Order Created,
• FAPI je propojeno klíčem z části Conversion keys,
• ve všech částech používáte stejný datový zdroj a stejné Pixel ID,
• prošli jste celou testovací objednávku.

FAPI hlásí chybu při uložení propojení

Zkontrolujte, zda jste vložili správné Pixel ID a klíč z části Conversion keys. Běžný OpenAI API klíč není správný.

Pixel se načte, ale objednávka se neodešle

Pokud používáte vlastní děkovací stránku, zkontrolujte konverzní kód FAPI, FAPI SDK, pořadí načítání kódů a unikátní identifikátor objednávky v URL.

Pokud používáte děkovací stránku FAPI, zkontrolujte, zda je v prodejním formuláři vyplněné správné ChatGPT Ads Pixel ID a zda jste Pixel ani konverzní kód nevložili podruhé do pole Trackovací kód (HTML).

Událost je přijatá, ale kampaň ukazuje nulu

Ověřte, že kampaň používá správný datový zdroj a konverzi Order Created. Zkontrolujte také, zda návštěvník skutečně přišel z reklamy, a vyčkejte na zpracování výsledků.

Konverzí je více než objednávek

Zkontrolujte, zda není Pixel nebo konverzní kód vložen vícekrát a zda jste vedle kódu FAPI nepřidali také obecný kód Order Created vygenerovaný OpenAI.

Konverze se zaznamenala před zaplacením

To je u tohoto postupu správné. Událost Order Created měří vznik objednávky. Počet zaplacených objednávek a skutečné tržby kontrolujte ve FAPI.