Jak napojit feed z Mergada do OpenAI Ads Manageru#

Aby se vaše produkty mohly zobrazovat v reklamách v ChatGPT, potřebuje OpenAI Ads Manager váš produktový feed. Mergado ho připraví ve formátu ChatGPT Shopping a postará se o jeho pravidelné doručení. Účty Mergada a Ads Manageru se přitom nijak nepropojují, Mergado jen posílá aktuální feed na místo, které mu určíte.

V tomto článku najdete, jaký způsob napojení zvolit, jak krok za krokem nastavit doporučené napojení přes SFTP, a to při vytváření nového projektu i u projektu, který už máte, a co dělat, když produkty v Ads Manageru nesedí.

Jaký způsob napojení zvolit#

Ads Manager nabízí při vytvoření feedu tři možnosti:

SFTP se nemusíte bát. Zní technicky, ale nastavuje se jen jednou. Přístupové údaje vám vygeneruje Ads Manager a Mergado pak feed posílá samo.

Než začnete#

• Zkontrolujte kvalitu feedu v nástroji Mergado Audit. Ads Manager k chybám v datech téměř nedává zpětnou vazbu, takže je lepší je opravit předem. Nejčastěji chybí popis (description) nebo značka (brand).
• Připravte si dvě okna vedle sebe: Ads Manager a Mergado. Přístupové údaje budete kopírovat z jednoho do druhého.

Krok 1: Vytvořte feed v Ads Manageru#

1. V Ads Manageru přejděte do Tools → Feeds.
2. Klikněte na Create Feed.
3. Vyplňte Display name, například název e-shopu a země.
4. U volby How will you send products? zvolte SFTP connection.
5. Klikněte na Create.

Krok 2: Vygenerujte přístupové údaje k SFTP#

Po vytvoření feedu se otevře panel Connect your feed via SFTP.

1. V části Choose authentication zvolte přihlášení heslem a vygenerujte heslo.
2. Heslo hned zkopírujte a uložte. Po zavření okna ho už znovu neuvidíte. Pokud ho ztratíte, musíte vygenerovat nové a změnit ho i v Mergado Keychain (viz FAQ).
3. V části Add connection details najdete údaje, které budete potřebovat v Mergadu:
   • Host: adresa serveru, například sftp.commerce.openai.com nebo sftp-prod3.commerce.openai.com
   • Username: dlouhý řetězec začínající oaiproductfeedprod
   • Upload path: /
   • Port: 443

⚠️ Adresa serveru (Host) se liší feed od feedu. Vždy ji zkopírujte přesně z Ads Manageru. Uživatelské jméno a heslo k jinému serveru nebudou fungovat.

Panel nechte otevřený, budete z něj kopírovat do Mergada.

Krok 3: Vyplňte napojení v Mergadu#

Napojení můžete v Mergadu nastavit dvěma způsoby podle toho, jestli projekt teprve zakládáte, nebo už ho máte:

• Zakládáte nový projekt? Napojení vyplníte rovnou v průvodci vytvořením projektu (varianta A). Nemusíte pak nic nastavovat dodatečně.
• Projekt už máte, třeba jen s adresou výstupního feedu a bez SFTP? Napojení doplníte v nastavení projektu (varianta B).

Varianta A: při vytváření nového projektu#

Tento postup ukazuje video:

1. Začněte zakládat nový projekt podle návodu Jak v Mergadu vytvořit nový projekt?
2. V kroku s výběrem výstupního formátu zvolte zemi a jako výstupní formát ChatGPT Shopping (například ChatGPT Shopping [CZ] TSV).
3. Pod výběrem formátu zapněte přepínač Nahrát výstupní feed na OpenAI SFTP. Připojení k OpenAI je předvyplněné, stačí doplnit přihlašovací údaje.
4. Vyplňte Uživatelské jméno (Username z Ads Manageru), nechte zvolené přihlášení Heslem a vložte Heslo vygenerované v Ads Manageru.
5. Klikněte na Zobrazit pokročilé nastavení a zkontrolujte Adresu serveru (URL). Předvyplněná je sftp.commerce.openai.com. Pokud Ads Manager u vašeho feedu uvádí jiný Host, přepište ji. Port 443 a vzdálený adresář / nechte beze změny.
6. Pokračujte v průvodci až do konce.

Na poslední obrazovce průvodce uvidíte zelenou zprávu, že se soubor exportuje na externí službu SFTP i s adresou serveru. Připojení se na pozadí uloží do Mergado Keychain a Mergado na něj nahraje feed hned po prvním exportu. Pokračujte krokem 4.

Varianta B: u existujícího projektu#

Tento postup ukazuje i video:

1. V Mergadu otevřete projekt s výstupem ChatGPT Shopping a přejděte do Nastavení.
2. Najděte sekci SFTP/FTP/FTPS server a klikněte na Nové připojení.
3. Vyplňte formulář:
   • Typ připojení: SFTP
   • Uživatelské jméno: Username z Ads Manageru
   • Způsob přihlášení: Heslo
   • Heslo: heslo vygenerované v Ads Manageru
   • Adresa serveru (URL): Host z Ads Manageru
   • Port: 443 (výchozí hodnotu 22 přepište)
   • Vzdálený adresář: /
   • Název souboru: libovolný, například chatgpt-shopping-cz
   • Název připojení: volitelný, pomůže vám rozlišit připojení, pokud jich máte víc
4. Klikněte na Uložit.

V přehledu připojení se pak objeví nové připojení se stavem Připojeno. Připojení se uloží i do Mergado Keychain, takže ho můžete použít i u dalších projektů.

💡 V nastavení projektu můžete připojení jen vytvořit, zobrazit nebo odpojit. Upravit existující připojení, třeba změnit heslo nebo adresu serveru, jde jen v Mergado Keychain.

Krok 4: Zkontrolujte nahrání#

1. U existujícího projektu (varianta B) klikněte v Nastavení projektu na Přegenerovat změněné. Mergado vytvoří export a hned ho nahraje na SFTP. U nového projektu (varianta A) proběhne první export i nahrání samo po dokončení průvodce. Další nahrání už probíhají automaticky po každém přegenerování projektu.
2. Zkontrolujte nahrání v Mergadu:
   • na Přehledu projektu v řádku Poslední nahrání na externí úložiště,
   • v Historii projektu po vyfiltrování události Externí úložiště. U neúspěšného nahrání tu uvidíte i důvod.
3. Zkontrolujte výsledek v Ads Manageru. V panelu SFTP feedu je část Upload and verify, která nahraný soubor sama rozpozná a ukáže výsledek zpracování. Pokud se nic neděje, klikněte na Refresh. Celkový počet produktů pak najdete v Tools → Feeds ve sloupci Products a podrobnosti jednotlivých nahrání na záložce Upload History.

Zpracování na straně OpenAI může chvíli trvat, počet produktů se proto nemusí aktualizovat hned po nahrání.

Počty na obou místech se mohou lišit. Upload History ukazuje, kolik produktů obsahoval nahraný soubor, a to včetně produktů, které nejsou skladem. Sloupec Products na záložce Feed Connection ukazuje jen produkty, které OpenAI zpracovalo a může je použít v reklamách. Podrobný rozpad uvidíte po najetí myší na ikonu vedle čísla.

Co dělat, když něco nefunguje#

V Ads Manageru vidím mnohem víc produktů, než má můj feed#

OpenAI načítá všechny soubory, které v SFTP složce feedu leží, a produkty z nich sčítá. Pokud jste napojení nastavovali vícekrát nebo jste změnili název souboru, zůstal na serveru starý soubor a jeho produkty se pořád počítají.

Řešení:

• Smažte starý soubor. Připojte se k SFTP stejnými údaji jako v Mergadu, například přes FileZilla nebo Cyberduck, a smažte všechny soubory kromě toho, jehož název odpovídá Názvu souboru v nastavení projektu. Soubor status.json patří OpenAI, ten nechte.
• Nebo začněte s čistým feedem. V Ads Manageru vytvořte nový feed s novými přístupovými údaji, jeho složka bude prázdná. V Mergadu pak staré připojení odpojte a vyplňte nové. Kampaně napojené na starý feed bude potřeba napojit na nový.

V Ads Manageru vidím méně produktů, než má můj feed#

OpenAI do reklam nezpracuje produkty, které nejsou skladem, tedy produkty s hodnotou out_of_stock v elementu availability. Na záložce Upload History je přitom uvidíte mezi nahranými, ve sloupci Products na záložce Feed Connection už ale chybí. Menší část rozdílu obvykle tvoří produkty, které OpenAI neschválilo. Jejich počet uvidíte po najetí myší na ikonu u počtu produktů v řádku Not approved.

Řešení:

• Skryjte produkty, které nejsou skladem. Vytvořte výběr produktů, které nejsou skladem, podle elementu s dostupností ve vašem feedu, a použijte ho v pravidle Skrytí produktu. Feed pak obsahuje jen produkty, které se v reklamách můžou zobrazit, a počty v Mergadu a v Ads Manageru se shodují. Jakmile se produkt znovu naskladní, objeví se ve feedu sám.
• Zkontrolujte neschválené produkty v Mergado Audit. Ads Manager důvod neschválení většinou neuvádí, nejčastěji jde o chybějící povinné údaje, například značku.

Nahrání na SFTP nefunguje#

Důvod chyby uvidíte v Historii projektu u události Externí úložiště. Nejčastější příčiny:

• Změnili jste heslo. Když v Ads Manageru vygenerujete nové heslo, to staré přestane platit. Nové heslo změňte u existujícího SFTP připojení v Mergado Keychain. V nastavení projektu připojení upravit nejde.
• Nesedí adresa serveru. Každý feed může mít jiný Host. Porovnejte Adresu serveru (URL) u připojení v Mergado Keychain s hodnotou Host v Ads Manageru a případně ji tam opravte.
• Špatný port. OpenAI používá port 443, ne výchozí 22.

Feed má 0 produktů nebo ho Ads Manager odmítl bez udání důvodu#

Ads Manager často neuvede, co mu na datech vadí. Zkontrolujte feed v Mergado Audit, který u každé chyby ukáže i postup opravy. Chyby pak opravte pravidly v Mergadu, ne ručně produkt po produktu.

Napojení přes Hosted URL nejde uložit nebo se feed nenačte#

U napojení přes URL evidujeme případy, kdy ho Ads Manager nepřijme, i když stejný feed projde přes SFTP. Pokud vám URL nefunguje, přejděte na SFTP podle tohoto návodu.

Feed nebo obrázky se nestahují kvůli firewallu#

Pokud váš e-shop chrání Cloudflare nebo jiný firewall, může blokovat stahování vstupního feedu i obrázků. Postupujte podle návodu Jak nastavit Cloudflare, aby neblokoval stahování feedu a obrázků.

FAQ#

Musím feed napojovat přes SFTP?#

Ne, SFTP není povinné. Feed můžete do Ads Manageru vložit i jako Hosted URL. SFTP ale doporučujeme, protože je spolehlivější a Mergado na něj nahraje feed po každém přegenerování.

Můžu SFTP doplnit k projektu, který už mám?#

Ano. Postupujte podle varianty B v kroku 3. Projekt nemusíte zakládat znovu.

Jak často se feed v Ads Manageru aktualizuje?#

Mergado nahraje aktuální feed na SFTP po každém přegenerování projektu. Kdy ho OpenAI zpracuje, určuje už Ads Manager.

Můžu do jednoho feedu v Ads Manageru posílat víc projektů z Mergada?#

Nedoporučujeme to. OpenAI načte všechny soubory ve složce a produkty sečte, takže by se vám v jednom feedu míchaly. Pro každý projekt vytvořte v Ads Manageru samostatný feed.

Zobrazí se produkty z feedu i v běžných odpovědích ChatGPT?#

Ne. Feed nahraný do Ads Manageru slouží jen pro placené reklamy. Organické zobrazování produktů v ChatGPT je samostatný program OpenAI.

Ztratil jsem heslo k SFTP. Co teď?#

Heslo se v Ads Manageru zobrazí jen jednou. Postupujte takto:

1. V Ads Manageru vygenerujte v nastavení SFTP připojení feedu nové heslo. Staré tím přestane platit.
2. V Mergadu otevřete Mergado Keychain, najděte existující SFTP připojení k OpenAI a upravte u něj heslo.
3. Uložte. Mergado se při dalším přegenerování projektu přihlásí už s novým heslem.

Heslo měňte v Keychain, ne v nastavení projektu. Tam připojení upravit nejde, můžete ho jen odpojit nebo vytvořit nové.