Ako napojiť feed z Mergada do OpenAI Ads Manageru#

Aby sa vaše produkty mohli zobrazovať v reklamách v ChatGPT, potrebuje OpenAI Ads Manager váš produktový feed. Mergado ho pripraví vo formáte ChatGPT Shopping a postará sa o jeho pravidelné doručenie. Účty Mergada a Ads Manageru sa pritom nijako neprepájajú, Mergado iba posiela aktuálny feed na miesto, ktoré mu určíte.

V tomto článku nájdete, aký spôsob napojenia zvoliť, ako krok za krokom nastaviť odporúčané napojenie cez SFTP, a to pri vytváraní nového projektu aj pri projekte, ktorý už máte, a čo robiť, keď produkty v Ads Manageri nesedia.

Aký spôsob napojenia zvoliť#

Ads Manager ponúka pri vytvorení feedu tri možnosti:

SFTP sa nemusíte báť. Znie technicky, ale nastavuje sa iba raz. Prístupové údaje vám vygeneruje Ads Manager a Mergado potom feed posiela samo.

Skôr ako začnete#

• Skontrolujte kvalitu feedu v nástroji Mergado Audit. Ads Manager k chybám v dátach takmer nedáva spätnú väzbu, takže je lepšie ich opraviť vopred. Najčastejšie chýba popis (description) alebo značka (brand).
• Pripravte si dve okná vedľa seba: Ads Manager a Mergado. Prístupové údaje budete kopírovať z jedného do druhého.

Krok 1: Vytvorte feed v Ads Manageri#

1. V Ads Manageri prejdite do Tools → Feeds.
2. Kliknite na Create Feed.
3. Vyplňte Display name, napríklad názov e-shopu a krajiny.
4. Pri voľbe How will you send products? zvoľte SFTP connection.
5. Kliknite na Create.

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

Po vytvorení feedu sa otvorí panel Connect your feed via SFTP.

1. V časti Choose authentication zvoľte prihlásenie heslom a vygenerujte heslo.
2. Heslo hneď skopírujte a uložte. Po zatvorení okna ho už znova neuvidíte. Ak ho stratíte, musíte vygenerovať nové a zmeniť ho aj v Mergado Keychain (pozri FAQ).
3. V časti Add connection details nájdete údaje, ktoré budete potrebovať v Mergade:
   • Host: adresa servera, napríklad sftp.commerce.openai.com alebo sftp-prod3.commerce.openai.com
   • Username: dlhý reťazec začínajúci oaiproductfeedprod
   • Upload path: /
   • Port: 443

⚠️ Adresa servera (Host) sa líši feed od feedu. Vždy ju skopírujte presne z Ads Manageru. Používateľské meno a heslo k inému serveru nebudú fungovať.

Panel nechajte otvorený, budete z neho kopírovať do Mergada.

Krok 3: Vyplňte napojenie v Mergade#

Napojenie môžete v Mergade nastaviť dvoma spôsobmi podľa toho, či projekt ešte len zakladáte, alebo ho už máte:

• Zakladáte nový projekt? Napojenie vyplníte rovno v sprievodcovi vytvorením projektu (variant A). Nemusíte potom nič nastavovať dodatočne.
• Projekt už máte, napríklad iba s adresou výstupného feedu a bez SFTP? Napojenie doplníte v nastavení projektu (variant B).

Variant A: pri vytváraní nového projektu#

Tento postup ukazuje video:

1. Začnite zakladať nový projekt podľa návodu Ako v Mergade vytvoriť nový projekt?
2. V kroku s výberom výstupného formátu zvoľte krajinu a ako výstupný formát ChatGPT Shopping (napríklad ChatGPT Shopping [CZ] TSV).
3. Pod výberom formátu zapnite prepínač Nahrať výstupný feed na OpenAI SFTP. Pripojenie k OpenAI je predvyplnené, stačí doplniť prihlasovacie údaje.
4. Vyplňte Používateľské meno (Username z Ads Manageru), nechajte zvolené prihlásenie Heslom a vložte Heslo vygenerované v Ads Manageri.
5. Kliknite na Zobraziť pokročilé nastavenia a skontrolujte Adresu servera (URL). Predvyplnená je sftp.commerce.openai.com. Ak Ads Manager pri vašom feede uvádza iný Host, prepíšte ju. Port 443 a vzdialený adresár / nechajte bez zmeny.
6. Pokračujte v sprievodcovi až do konca.

Na poslednej obrazovke sprievodcu uvidíte zelenú správu, že sa súbor exportuje na externú službu SFTP aj s adresou servera. Pripojenie sa na pozadí uloží do Mergado Keychain a Mergado naň nahrá feed hneď po prvom exporte. Pokračujte krokom 4.

Variant B: pri existujúcom projekte#

Tento postup ukazuje aj video:

1. V Mergade otvorte projekt s výstupom ChatGPT Shopping a prejdite do Nastavenia.
2. Nájdite sekciu SFTP/FTP/FTPS server a kliknite na Nové pripojenie.
3. Vyplňte formulár:
   • Typ pripojenia: SFTP
   • Používateľské meno: Username z Ads Manageru
   • Spôsob prihlásenia: Heslo
   • Heslo: heslo vygenerované v Ads Manageri
   • Adresa servera (URL): Host z Ads Manageru
   • Port: 443 (predvolenú hodnotu 22 prepíšte)
   • Vzdialený adresár: /
   • Názov súboru: ľubovoľný, napríklad chatgpt-shopping-cz
   • Názov pripojenia: voliteľný, pomôže vám rozlíšiť pripojenia, ak ich máte viac
4. Kliknite na Uložiť.

V prehľade pripojení sa potom objaví nové pripojenie so stavom Pripojené. Pripojenie sa uloží aj do Mergado Keychain, takže ho môžete použiť aj pri ďalších projektoch.

💡 V nastavení projektu môžete pripojenie iba vytvoriť, zobraziť alebo odpojiť. Upraviť existujúce pripojenie, napríklad zmeniť heslo alebo adresu servera, ide iba v Mergado Keychain.

Krok 4: Skontrolujte nahranie#

1. Pri existujúcom projekte (variant B) kliknite v Nastaveniach projektu na Pregenerovať zmenené. Mergado vytvorí export a hneď ho nahrá na SFTP. Pri novom projekte (variant A) prebehne prvý export aj nahranie samo po dokončení sprievodcu. Ďalšie nahrania už prebiehajú automaticky po každom pregenerovaní projektu.
2. Skontrolujte nahranie v Mergade:
   • na Prehľade projektu v riadku Posledné nahranie na externé úložisko,
   • v Histórii projektu po vyfiltrovaní udalosti Externé úložisko. Pri neúspešnom nahraní tu uvidíte aj dôvod.
3. Skontrolujte výsledok v Ads Manageri. V paneli SFTP feedu je časť Upload and verify, ktorá nahraný súbor sama rozpozná a ukáže výsledok spracovania. Ak sa nič nedeje, kliknite na Refresh. Celkový počet produktov potom nájdete v Tools → Feeds v stĺpci Products a podrobnosti jednotlivých nahraní na záložke Upload History.

Spracovanie na strane OpenAI môže chvíľu trvať, počet produktov sa preto nemusí aktualizovať hneď po nahraní.

Počty na oboch miestach sa môžu líšiť. Upload History ukazuje, koľko produktov obsahoval nahraný súbor, a to vrátane produktov, ktoré nie sú skladom. Stĺpec Products na záložke Feed Connection ukazuje len produkty, ktoré OpenAI spracovalo a môže ich použiť v reklamách. Podrobný rozpad uvidíte po prejdení myšou na ikonu vedľa čísla.

Čo robiť, keď niečo nefunguje#

V Ads Manageri vidím oveľa viac produktov, ako má môj feed#

OpenAI načítava všetky súbory, ktoré v SFTP priečinku feedu ležia, a produkty z nich sčítava. Ak ste napojenie nastavovali viackrát alebo ste zmenili názov súboru, zostal na serveri starý súbor a jeho produkty sa stále počítajú.

Riešenie:

• Zmažte starý súbor. Pripojte sa k SFTP rovnakými údajmi ako v Mergade, napríklad cez FileZilla alebo Cyberduck, a zmažte všetky súbory okrem toho, ktorého názov zodpovedá Názvu súboru v nastavení projektu. Súbor status.json patrí OpenAI, ten nechajte.
• Alebo začnite s čistým feedom. V Ads Manageri vytvorte nový feed s novými prístupovými údajmi, jeho priečinok bude prázdny. V Mergade potom staré pripojenie odpojte a vyplňte nové. Kampane napojené na starý feed bude potrebné napojiť na nový.

V Ads Manageri vidím menej produktov, ako má môj feed#

OpenAI do reklám nespracuje produkty, ktoré nie sú skladom, teda produkty s hodnotou out_of_stock v elemente availability. Na záložke Upload History ich pritom uvidíte medzi nahranými, v stĺpci Products na záložke Feed Connection však chýbajú. Menšiu časť rozdielu zvyčajne tvoria produkty, ktoré OpenAI neschválilo. Ich počet uvidíte po prejdení myšou na ikonu pri počte produktov v riadku Not approved.

Riešenie:

• Skryte produkty, ktoré nie sú skladom. Vytvorte výber produktov, ktoré nie sú skladom, podľa elementu s dostupnosťou vo vašom feede, a použite ho v pravidle Skrytie produktu. Feed potom obsahuje len produkty, ktoré sa v reklamách môžu zobraziť, a počty v Mergade a v Ads Manageri sa zhodujú. Hneď ako sa produkt znovu naskladní, objaví sa vo feede sám.
• Skontrolujte neschválené produkty v Mergado Audit. Ads Manager dôvod neschválenia väčšinou neuvádza, najčastejšie ide o chýbajúce povinné údaje, napríklad značku.

Nahranie na SFTP nefunguje#

Dôvod chyby uvidíte v Histórii projektu pri udalosti Externé úložisko. Najčastejšie príčiny:

• Zmenili ste heslo. Keď v Ads Manageri vygenerujete nové heslo, to staré prestane platiť. Nové heslo zmeňte pri existujúcom SFTP pripojení v Mergado Keychain. V nastavení projektu pripojenie upraviť nejde.
• Nesedí adresa servera. Každý feed môže mať iný Host. Porovnajte Adresu servera (URL) pri pripojení v Mergado Keychain s hodnotou Host v Ads Manageri a prípadne ju tam opravte.
• Nesprávny port. OpenAI používa port 443, nie predvolený 22.

Feed má 0 produktov alebo ho Ads Manager odmietol bez udania dôvodu#

Ads Manager často neuvedie, čo mu na dátach prekáža. Skontrolujte feed v Mergado Audit, ktorý pri každej chybe ukáže aj postup opravy. Chyby potom opravte pravidlami v Mergade, nie ručne produkt po produkte.

Napojenie cez Hosted URL nejde uložiť alebo sa feed nenačíta#

Pri napojení cez URL evidujeme prípady, keď ho Ads Manager neprijme, hoci rovnaký feed prejde cez SFTP. Ak vám URL nefunguje, prejdite na SFTP podľa tohto návodu.

Feed alebo obrázky sa nesťahujú kvôli firewallu#

Ak váš e-shop chráni Cloudflare alebo iný firewall, môže blokovať sťahovanie vstupného feedu aj obrázkov. Postupujte podľa návodu Ako nastaviť Cloudflare, aby neblokoval sťahovanie feedu a obrázkov.

FAQ#

Musím feed napájať cez SFTP?#

Nie, SFTP nie je povinné. Feed môžete do Ads Manageru vložiť aj ako Hosted URL. SFTP však odporúčame, pretože je spoľahlivejšie a Mergado naň nahrá feed po každom pregenerovaní.

Môžem SFTP doplniť k projektu, ktorý už mám?#

Áno. Postupujte podľa variantu B v kroku 3. Projekt nemusíte zakladať znova.

Ako často sa feed v Ads Manageri aktualizuje?#

Mergado nahrá aktuálny feed na SFTP po každom pregenerovaní projektu. Kedy ho OpenAI spracuje, určuje už Ads Manager.

Môžem do jedného feedu v Ads Manageri posielať viac projektov z Mergada?#

Neodporúčame to. OpenAI načíta všetky súbory v priečinku a produkty sčíta, takže by sa vám v jednom feede miešali. Pre každý projekt vytvorte v Ads Manageri samostatný feed.

Zobrazia sa produkty z feedu aj v bežných odpovediach ChatGPT?#

Nie. Feed nahraný do Ads Manageru slúži iba na platené reklamy. Organické zobrazovanie produktov v ChatGPT je samostatný program OpenAI.

Stratil som heslo k SFTP. Čo teraz?#

Heslo sa v Ads Manageri zobrazí iba raz. Postupujte takto:

1. V Ads Manageri vygenerujte v nastavení SFTP pripojenia feedu nové heslo. Staré tým prestane platiť.
2. V Mergade otvorte Mergado Keychain, nájdite existujúce SFTP pripojenie k OpenAI a upravte pri ňom heslo.
3. Uložte. Mergado sa pri ďalšom pregenerovaní projektu prihlási už s novým heslom.

Heslo meňte v Keychain, nie v nastavení projektu. Tam pripojenie upraviť nejde, môžete ho iba odpojiť alebo vytvoriť nové.