> For the complete documentation index, see [llms.txt](https://napoveda.rocketoo.cz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://napoveda.rocketoo.cz/rocketoo/rozsireni/open-ai-ads.md).
# Open AI Ads
Modul OpenAI Ads vám umožňuje:
* Připravit e-shop na reklamu v ChatGPT
* Automaticky generovat produktový feed pro OpenAI Ads Manager
* Měřit návštěvy, košík, checkout i dokončené objednávky
* Doplnit měření ze serveru přes Conversions API
* Uchovat údaj o reklamním prokliku, aby šla objednávka správně přiřadit ke kampani
### Co je OpenAI Ads?
OpenAI Ads je reklamní systém pro ChatGPT. Zákazníkům se mohou v konverzaci zobrazit vaše produkty. Aby reklama fungovala, potřebuje OpenAI aktuální katalog zboží, dostupné produktové stránky a měření, zda z reklamy vznikl nákup.
### Kde najdu modul?
{% hint style="info" %}
Modul je nutné nejprve nainstalovat ve **Správci rozšíření**.
{% endhint %}
{% stepper %}
{% step %}
V hlavním menu klikněte na **Nastavení**.
{% endstep %}
{% step %}
Vyberte položku **OpenAI** v části **Rozšíření**.
{% endstep %}
{% endstepper %}
Produktový feed se zakládá zvlášť:
* **Nastavení → XML feedy**
* poskytovatel **OpenAI Ads (ChatGPT) – produktový feed**
## Zapnutí modulu
Modul je po instalaci vypnutý. Nejdřív ho musíte zapnout v rozšířeních a teprve potom vyplnit údaje.
{% stepper %}
{% step %}
## Zapnutí v Rozšířeních
1. V menu klikněte na **Rozšíření**
2. V kategorii **Marketing** najděte **OpenAI Ads**
3. Modul nainstalujte / zapněte
{% endstep %}
{% step %}
## Povolení v nastavení
1. Jděte do **Nastavení → OpenAI Ads**
2. Zapněte přepínač **Povolit OpenAI Ads**
3. Klikněte **Uložit**
{% endstep %}
{% endstepper %}
{% hint style="warning" %}
Bez tohoto přepínače se nespustí měření ani ukládání údaje z reklamního prokliku.
{% endhint %}
## Základní nastavení
### Co budete potřebovat?
Před začátkem si připravte:
* Účet v **OpenAI Ads Manageru**
* **Pixel ID** ze záložky Conversions
* Volitelně **Conversions API klíč** (pro přesnější měření objednávek)
* URL produktového feedu (vznikne po založení feedu v Rocketoo)
### Doporučené pořadí
{% stepper %}
{% step %}
Zapněte modul a přepínač **Povolit OpenAI Ads**.
{% endstep %}
{% step %}
Vytvořte produktový feed a vložte jeho adresu do Ads Manageru.
{% endstep %}
{% step %}
Zadejte **Pixel ID**.
{% endstep %}
{% step %}
Až budete chtít spolehlivější měření, zapněte **Conversions API**.
{% endstep %}
{% step %}
Ověřte, že robot OpenAI vidí produktové stránky.
{% endstep %}
{% endstepper %}
Nemusíte zapínat vše najednou. Feed a pixel stačí k prvnímu spuštění.
## Produktový feed
### Co je produktový feed?
Feed je automaticky připravený soubor se seznamem produktů. OpenAI podle něj ví, co můžete inzerovat: název, popis, cenu, obrázek, dostupnost, značku a další údaje.
Feed je ve formátu CSV (stejný základ jako Google produktová data) a navíc obsahuje sloupec, jestli produkt smí jít do reklamy.
### Jak feed vytvořit?
{% stepper %}
{% step %}
Jděte do **Nastavení → XML feedy**.
{% endstep %}
{% step %}
Klikněte na **Nový Feed**.
{% endstep %}
{% step %}
Vyplňte:
* **Poskytovatel** – vyberte **OpenAI Ads (ChatGPT) – produktový feed**
* **Název** – např. „OpenAI Ads“
* **URL** – můžete nechat výchozí (`openaiads.csv`)
{% endstep %}
{% step %}
Uložte feed.
{% endstep %}
{% step %}
Nechte feed **Aktivní**.
{% endstep %}
{% endstepper %}
Adresu feedu potom najdete:
* v detailu feedu (tlačítko **Otevřít feed URL**)
* v **Nastavení → OpenAI** v sekci **Produktový feed**
Tuto adresu vložte do OpenAI Ads Manageru do části **Feeds**.
### Co feed obsahuje?
U každého produktu (varianty) se obvykle přenáší:
* Název a popis
* Odkaz na produkt a hlavní obrázek
* Další obrázky
* Cena a případná slevová cena
* Dostupnost (skladem / není skladem)
* Značka, EAN a výrobní číslo
* Kategorie
* Zda smí jít do reklamy (**Povolit v ChatGPT Ads**)
* Až 5 štítků pro filtrování kampaní (custom label)
{% hint style="warning" %}
**Důležité:** Produkt bez názvu nebo bez obrázku se do feedu nezařadí.
{% endhint %}
Do feedu se také nedostanou produkty, u kterých je v kartě produktu zapnuté skrytí z XML feedů.
### Nastavení feedu
V úpravě feedu v sekci **Nastavení** můžete zvolit:
* **Popis produktu** – krátký, nebo dlouhý popis
* **Plnit custom\_label\_0–4 z příznaků produktu** – prvních pět příznaků se použije jako štítky kampaní (na produktu je lze přepsat)
* **Zakázat export z kategorií** – vybrané kategorie se do feedu neexportují
**Příklad použití zákazu kategorií:**
* Testovací produkty
* Interní zboží
* Rozpracovaný sortiment, který ještě nechcete inzerovat
### Aktualizace feedu
Feed se generuje pravidelně podle intervalu v XML feedech.
* Položky v Ads Manageru **expirují po 14 dnech**
* Feed proto musí zůstat aktivní a pravidelně se obnovovat
* Pokud potřebujete okamžitou aktualizaci, v detailu feedu klikněte na **Generovat**
### Kontrola feedu
{% stepper %}
{% step %}
V XML feedech otevřete feed OpenAI Ads.
{% endstep %}
{% step %}
Klikněte na **Zobrazit** nebo **Otevřít feed URL**.
{% endstep %}
{% step %}
Zkontrolujte obsah:
* Jsou ve feedu správné produkty
* Mají obrázek a název
* Ceny a dostupnost sedí
* Produkty, které nechcete inzerovat, mají vypnuté **Povolit v ChatGPT Ads**
{% endstep %}
{% endstepper %}
## Measurement Pixel
Measurement Pixel měří, co zákazník na e-shopu dělá po kliknutí na reklamu nebo při běžné návštěvě.
### Co budete potřebovat?
**Pixel ID** ze záložky Conversions v OpenAI Ads Manageru.
### Jak pixel zapnout?
{% stepper %}
{% step %}
Jděte do **Nastavení → OpenAI**.
{% endstep %}
{% step %}
Zapněte **Povolit OpenAI Ads**.
{% endstep %}
{% step %}
Do pole **Pixel ID** vložte kód z Ads Manageru.
{% endstep %}
{% step %}
Klikněte **Uložit**.
{% endstep %}
{% endstepper %}
Pixel se na e-shopu spustí jen tehdy, když je vyplněné Pixel ID.
### Co se měří?
V sekci **Measurement Pixel** můžete zapnout nebo vypnout:
* **Měřit zobrazení stránky** – návštěva stránky
* **Měřit zobrazení produktu** – zákazník otevřel detail produktu
* **Měřit přidání do košíku** – produkt přidal do košíku
* **Měřit začátek checkoutu** – vstoupil do objednávky
Dokončená objednávka se měří automaticky, jakmile je pixel zapnutý.
### Další volby pixelu
* **Posílat ceny s DPH** – hodnota nákupu včetně DPH (výchozí zapnuto)
* **Rozšířené párování** – e-mail, telefon a jméno se před odesláním zahashují, aby šel nákup lépe spárovat s uživatelem ChatGPT. Čitelně se tyto údaje neposílají.
* **Debug režim pixelu** – zapínejte jen při testování. Pomáhá ověřit, že se měření spouští. V ostrém provozu ho nechte vypnutý.
### Co se stane po zapnutí?
Po uložení Pixel ID modul:
* Načte měřicí kód na e-shopu
* Sleduje zvolené kroky nákupní cesty
* Po dokončení objednávky odešle hodnotu nákupu
* Respektuje souhlas zákazníka s marketingovými cookies
Data uvidíte v OpenAI Ads Manageru v části Conversions.
## Conversions API
Conversions API posílá konverze ze serveru e-shopu. Doplňuje pixel tam, kde prohlížeč měření nedoručí (blokace, odchod ze stránky, omezené cookies).
OpenAI doporučuje používat **pixel i Conversions API zároveň**. Obě cesty pak měří stejnou objednávku jako jednu událost.
### Jak Conversions API zapnout?
{% stepper %}
{% step %}
V Ads Manageru zkopírujte **Conversions API klíč**.
{% endstep %}
{% step %}
V Rocketoo jděte do **Nastavení → OpenAI**.
{% endstep %}
{% step %}
Zapněte **Povolit Conversions API**.
{% endstep %}
{% step %}
Vložte klíč do pole **Conversions API klíč**.
{% endstep %}
{% step %}
Klikněte **Uložit**.
{% endstep %}
{% endstepper %}
{% hint style="warning" %}
Klíč patří jen do tohoto nastavení. Nevkládejte ho do šablony webu ani do prohlížeče.
{% endhint %}
### Co se odesílá?
Ve výchozím stavu se ze serveru posílá **dokončená objednávka**.
Volitelně můžete zapnout:
* **Odesílat košík a checkout i přes Conversions API**
Tuto volbu zapněte, pokud chcete serverově měřit i přidání do košíku a začátek objednávky. Pro většinu e-shopů stačí měřit objednávku.
### Kdy použít Conversions API?
{% columns %}
{% column width="50%" %}
✅ **Doporučeno zapnout**
* Spouštíte ostré kampaně a potřebujete přesné počty nákupů
* Část zákazníků má blokované sledovací skripty
* Chcete mít jistotu, že se objednávka započítá i bez dokončení děkovací stránky
{% endcolumn %}
{% column width="50%" %}
❌ **Můžete nechat vypnuté**
* Teprve připravujete katalog a kampaně ještě neběží
* Zatím testujete jen feed a zobrazení produktů
{% endcolumn %}
{% endcolumns %}
## Nastavení produktů
U každého produktu můžete určit, jestli smí jít do reklamy v ChatGPT a jak ho v kampaních označíte.
### Kde nastavení najdu?
{% stepper %}
{% step %}
Jděte do **Produkty**.
{% endstep %}
{% step %}
Otevřete produkt.
{% endstep %}
{% step %}
Přepněte na záložku **Pokročilé**.
{% endstep %}
{% step %}
Najdete sekci **OpenAI Ads**.
{% endstep %}
{% endstepper %}
Stejná pole jsou i u variant.
### Povolit v ChatGPT Ads
* Zapnuto (výchozí) – produkt je ve feedu označený jako vhodný do reklamy
* Vypnuto – produkt ve feedu zůstane, ale OpenAI ho nemá inzerovat
Použijte vypnutí například u:
* Produktů s nízkou marží
* Dočasně nedostupného zboží, které nechcete inzerovat
* Položek nevhodných pro reklamu v ChatGPT
### Custom labely (štítky)
Můžete vyplnit až 5 štítků (**Custom label 0–4**). Slouží k filtrování produktů v kampaních, například:
* `bestseller`
* `sleva`
* `novinka`
* `premium`
Pokud je u feedu zapnuté plnění štítků z příznaků, použijí se první příznaky produktu. Hodnota zadaná přímo u produktu má přednost.
## Reklamní prokliky a crawlery
Aby reklama v ChatGPT správně fungovala, musí e-shop splnit dvě praktické věci: robot OpenAI musí vidět produktové stránky a e-shop nesmí zahodit údaj z reklamního odkazu.
### Robot OAI-AdsBot
OpenAI si produkty ověřuje robotem **OAI-AdsBot**. Produktové stránky mu musí zůstat dostupné.
Standardní `robots.txt` v Rocketoo tohoto robota povoluje.
{% hint style="warning" %}
**Pozor při vlastní ochraně webu:**
* Vlastní soubor `robots.txt` může robota omylem zakázat – doplňte do něj povolení pro `OAI-AdsBot`
* Cloudflare, CAPTCHA nebo jiná ochrana nesmí robotovi stránku zablokovat
* Pokud robot stránku neotevře, produkt v reklamě nemusí projít kontrolou
{% endhint %}
### Parametr oppref
Po kliknutí na reklamu v ChatGPT přijde zákazník na e-shop s parametrem **oppref** v adrese.
Modul tento údaj:
* rozpozná z odkazu
* uloží ho na 90 dní
* předá ho do měření konverzí
Díky tomu jde nákup přiřadit ke konkrétnímu kliknutí, i když zákazník nakoupí až později.
{% hint style="warning" %}
E-shop **nesmí parametr oppref zahodit** při přesměrování (např. z HTTP na HTTPS, z www na bez www, nebo při změně jazykové verze). Pokud se z odkazu ztratí, atribuce kampaně nebude přesná.
{% endhint %}
## GDPR a cookies
Měřicí kód se načítá jen se **souhlasem s marketingovými cookies**.
* Bez souhlasu se pixel nespustí
* Conversions API u objednávky pracuje se stejnými pravidly měření
* Rozšířené párování posílá jen zahashované údaje, ne čitelný e-mail nebo telefon
Zákazník tak má stejnou kontrolu jako u jiných reklamních pixelů (Google, Facebook, Sklik).
## Často kladené otázky
### Obecné otázky
Musím používat feed i měření?
Pro spuštění reklam potřebujete hlavně feed. Měření (pixel a Conversions API) doporučujeme zapnout, abyste viděli, které kampaně přinášejí objednávky.
Je modul po instalaci hned aktivní?
Ne. Nejdřív ho zapněte v Rozšířeních a poté v nastavení přepněte **Povolit OpenAI Ads**.
Stačí vyplnit jen Pixel ID?
Pro základní měření v prohlížeči ano. Pro přesnější počty objednávek zapněte i Conversions API.
### Feed
Kde najdu adresu feedu?
V **Nastavení → OpenAI Ads** v sekci Produktový feed, nebo v **Nastavení → XML feedy** u konkrétního feedu.
Proč ve feedu chybí některé produkty?
Nejčastěji nemají obrázek nebo název, jsou skryté z XML feedů, nebo spadají do zakázané kategorie.
Když vypnu „Povolit v ChatGPT Ads“, produkt z feedu zmizí?
Ne. Ve feedu zůstane, ale je označený jako nevhodný do reklamy.
Jak často se má feed aktualizovat?
Pravidelně. Položky v Ads Manageru expirují po 14 dnech, proto nenechávejte feed vypnutý.
Můžu feed omezit jen na část sortimentu?
Ano, přes zakázané kategorie, skrytí produktu z feedů, nebo vypnutí povolení v ChatGPT Ads.
### Měření
Proč v Ads Manageru nevidím žádné události?
Zkontrolujte, že je modul povolený, Pixel ID je správné a při testu jste souhlasili s marketingovými cookies. Data se nemusí objevit okamžitě.
Musím zapnout Conversions API?
Není povinné, ale doporučené. Pixel a API společně měří lépe než samotný pixel.
Počítá se objednávka dvakrát, když běží pixel i API?
Neměla by. Obě cesty používají stejné označení události, aby se nákup započítal jednou.
Můžu měřit jen objednávky, ne košík?
Ano. Vypněte měření košíku a checkoutu u pixelu. Conversions API ve výchozím stavu posílá jen dokončenou objednávku.
Co znamená rozšířené párování?
Pomáhá spojit nákup s uživatelem v ChatGPT pomocí zahashovaného e-mailu, telefonu a jména. Čitelné osobní údaje se neodesílají.
### Crawlery a prokliky
Proč produkt v reklamě neprošel kontrolou?
Často robot neotevře stránku produktu. Zkontrolujte vlastní `robots.txt`, Cloudflare, CAPTCHA a další ochranu webu.
Musím něco nastavovat kvůli parametru oppref?
Ve většině e-shopů ne. Dohlédněte jen na to, aby přesměrování nesmazalo parametry z adresy.
## Praktické příklady
### Příklad 1: První spuštění
**Situace:** Chcete začít inzerovat v ChatGPT a zatím nemáte nic nastavené.
**Postup:**
{% stepper %}
{% step %}
Zapněte modul v **Rozšířeních**.
{% endstep %}
{% step %}
V **Nastavení → OpenAI Ads** zapněte **Povolit OpenAI Ads**.
{% endstep %}
{% step %}
V **XML feedech** vytvořte feed OpenAI Ads.
{% endstep %}
{% step %}
Adresu feedu vložte do Ads Manageru.
{% endstep %}
{% step %}
Doplňte Pixel ID.
{% endstep %}
{% step %}
Až budete spouštět kampaně, zapněte Conversions API.
{% endstep %}
{% endstepper %}
**Výsledek:** OpenAI má katalog i měření nákupů.
### Příklad 2: Část sortimentu nechcete inzerovat
**Situace:** Do ChatGPT chcete poslat jen hlavní katalogy, ne příslušenství a testovací zboží.
**Postup:**
{% stepper %}
{% step %}
Ve feedu zakažte export vybraných kategorií.
{% endstep %}
{% step %}
U jednotlivých produktů na záložce **Pokročilé** vypněte **Povolit v ChatGPT Ads**.
{% endstep %}
{% step %}
Feed znovu vygenerujte a zkontrolujte.
{% endstep %}
{% endstepper %}
**Výsledek:** Kampaně pracují jen s produkty, které chcete prodávat reklamou.
### Příklad 3: Objednávky z reklamy se nepočítají
**Situace:** Reklama běží, ale v Ads Manageru téměř nejsou konverze.
**Postup:**
{% stepper %}
{% step %}
Ověřte Pixel ID a zapnutý přepínač **Povolit OpenAI Ads**.
{% endstep %}
{% step %}
Proveďte testovací objednávku se souhlasem s marketingovými cookies.
{% endstep %}
{% step %}
Zapněte Conversions API a vložte klíč.
{% endstep %}
{% step %}
Zkontrolujte, že odkaz z reklamy neztrácí parametr oppref.
{% endstep %}
{% step %}
Debug režim použijte jen krátce při ověření a zase ho vypněte.
{% endstep %}
{% endstepper %}
**Výsledek:** Objednávky se začnou párovat s kampaněmi.