Hogyan csatlakoztasd a Mergado feedet az OpenAI Ads Managerhez#

Ahhoz, hogy a termékeid megjelenhessenek a ChatGPT hirdetéseiben, az OpenAI Ads Managernek szüksége van a termékfeededre. A Mergado elkészíti ChatGPT Shopping formátumban, és gondoskodik a rendszeres kézbesítéséről. A Mergado- és az Ads Manager-fiókot ehhez nem kell összekapcsolnod, a Mergado csak elküldi az aktuális feedet arra a helyre, amelyet megadsz neki.

Ebben a cikkben megtudod, melyik csatlakozási módot válaszd, hogyan állítsd be lépésről lépésre az ajánlott SFTP-kapcsolatot új projekt létrehozásakor és meglévő projektnél is, valamint mit tegyél, ha a termékek az Ads Managerben nem stimmelnek.

Melyik csatlakozási módot válaszd#

Az Ads Manager a feed létrehozásakor három lehetőséget kínál:

Az SFTP-től nem kell tartanod. Technikainak hangzik, de csak egyszer kell beállítani. A hozzáférési adatokat az Ads Manager generálja neked, utána a Mergado magától küldi a feedet.

Mielőtt elkezded#

• Ellenőrizd a feed minőségét a Mergado Audit eszközzel. Az Ads Manager szinte semmilyen visszajelzést nem ad az adathibákról, ezért jobb előre kijavítani őket. Leggyakrabban a leírás (description) vagy a márka (brand) hiányzik.
• Nyiss meg egymás mellett két ablakot: az Ads Managert és a Mergadót. A hozzáférési adatokat az egyikből a másikba fogod másolni.

1. lépés: Hozd létre a feedet az Ads Managerben#

1. Az Ads Managerben lépj a Tools → Feeds részre.
2. Kattints a Create Feed gombra.
3. Töltsd ki a Display name mezőt, például a webáruház nevével és az országgal.
4. A How will you send products? kérdésnél válaszd az SFTP connection lehetőséget.
5. Kattints a Create gombra.

2. lépés: Generáld le az SFTP hozzáférési adatokat#

A feed létrehozása után megnyílik a Connect your feed via SFTP panel.

1. A Choose authentication részben válaszd a jelszavas bejelentkezést, és generálj jelszót.
2. A jelszót azonnal másold ki és mentsd el. Az ablak bezárása után már nem látod újra. Ha elveszíted, újat kell generálnod, és a Mergado Keychainben is módosítanod kell (lásd a GYIK-ot).
3. Az Add connection details részben találod azokat az adatokat, amelyekre a Mergadóban szükséged lesz:
   • Host: a szerver címe, például sftp.commerce.openai.com vagy sftp-prod3.commerce.openai.com
   • Username: hosszú karakterlánc, amely oaiproductfeedprod-dal kezdődik
   • Upload path: /
   • Port: 443

⚠️ A szerver címe (Host) feedenként eltérő. Mindig pontosan az Ads Managerből másold ki. A felhasználónév és a jelszó egy másik szerverhez nem fog működni.

A panelt hagyd nyitva, innen fogsz másolni a Mergadóba.

3. lépés: Töltsd ki a kapcsolatot a Mergadóban#

A kapcsolatot a Mergadóban kétféleképpen állíthatod be attól függően, hogy most hozod létre a projektet, vagy már megvan:

• Új projektet hozol létre? A kapcsolatot rögtön a projektlétrehozó varázslóban kitöltheted (A változat). Utólag így semmit nem kell beállítanod.
• Már van projekted, például csak a kimeneti feed címével, SFTP nélkül? A kapcsolatot a projekt beállításaiban adhatod hozzá (B változat).

A változat: új projekt létrehozásakor#

Ezt a folyamatot videó is bemutatja:

1. Kezdd el létrehozni az új projektet az Új projekt létrehozása a Mergadóban útmutató szerint.
2. A kimeneti formátum kiválasztásánál válaszd ki az országot, kimeneti formátumként pedig a ChatGPT Shopping formátumot (például ChatGPT Shopping [CZ] TSV).
3. A formátumválasztó alatt kapcsold be a Kimeneti feed feltöltése az OpenAI SFTP-re kapcsolót. Az OpenAI-kapcsolat előre ki van töltve, csak a bejelentkezési adatokat kell megadnod.
4. Töltsd ki a Felhasználónév mezőt (az Ads Manager Username értéke), hagyd kiválasztva a Jelszó bejelentkezési módot, és illeszd be az Ads Managerben generált Jelszót.
5. Kattints a Speciális beállítások megjelenítése lehetőségre, és ellenőrizd a Szerver címét (URL). Előre ki van töltve a sftp.commerce.openai.com érték. Ha az Ads Manager a feedednél más Hostot ad meg, írd át. A 443-as portot és a / távoli könyvtárat hagyd változatlanul.
6. Haladj végig a varázslón.

A varázsló utolsó képernyőjén egy zöld üzenetet látsz arról, hogy a fájl a külső SFTP szolgáltatásba exportálódik, a szerver címével együtt. A kapcsolat a háttérben a Mergado Keychainbe is mentődik, és a Mergado rögtön az első export után feltölti rá a feedet. Folytasd a 4. lépéssel.

B változat: meglévő projektnél#

Ezt a folyamatot is bemutatja egy videó:

1. A Mergadóban nyisd meg a ChatGPT Shopping kimenetű projektet, és lépj a Beállítások részre.
2. Keresd meg az SFTP/FTP/FTPS szerver szekciót, és kattints az Új kapcsolat gombra.
3. Töltsd ki az űrlapot:
   • Kapcsolat típusa: SFTP
   • Felhasználónév: az Ads Manager Username értéke
   • Bejelentkezési mód: Jelszó
   • Jelszó: az Ads Managerben generált jelszó
   • Szerver címe (URL): az Ads Manager Host értéke
   • Port: 443 (az alapértelmezett 22 értéket írd át)
   • Távoli könyvtár: /
   • Fájlnév: tetszőleges, például chatgpt-shopping-cz
   • Kapcsolat neve: opcionális, segít megkülönböztetni a kapcsolatokat, ha több is van
4. Kattints a Mentés gombra.

A kapcsolatok áttekintésében ezután megjelenik az új kapcsolat Csatlakoztatva állapottal. A kapcsolat a Mergado Keychainbe is mentődik, így más projekteknél is használhatod.

💡 A projekt beállításaiban a kapcsolatot csak létrehozni, megtekinteni vagy leválasztani tudod. Meglévő kapcsolatot módosítani, például a jelszót vagy a szerver címét megváltoztatni, csak a Mergado Keychainben lehet.

4. lépés: Ellenőrizd a feltöltést#

1. Meglévő projektnél (B változat) kattints a projekt Beállításaiban a Módosítottak újragenerálása gombra. A Mergado elkészíti az exportot, és azonnal feltölti az SFTP-re. Új projektnél (A változat) az első export és feltöltés a varázsló befejezése után magától lefut. A további feltöltések a projekt minden újragenerálása után automatikusan megtörténnek.
2. Ellenőrizd a feltöltést a Mergadóban:
   • a projekt Áttekintésében az Utolsó feltöltés külső tárhelyre sorban,
   • a projekt Előzményeiben a Külső tárhely eseményre szűrve. Sikertelen feltöltésnél itt az okát is látod.
3. Ellenőrizd az eredményt az Ads Managerben. Az SFTP feed paneljén található az Upload and verify rész, amely magától felismeri a feltöltött fájlt, és megmutatja a feldolgozás eredményét. Ha semmi nem történik, kattints a Refresh gombra. A termékek teljes számát ezután a Tools → Feeds részben, a Products oszlopban találod, az egyes feltöltések részleteit pedig az Upload History fülön.

A feldolgozás az OpenAI oldalán eltarthat egy ideig, ezért a termékek száma nem feltétlenül frissül közvetlenül a feltöltés után.

A két helyen látható számok eltérhetnek. Az Upload History azt mutatja, hány terméket tartalmazott a feltöltött fájl, a nem raktáron lévő termékeket is beleértve. A Feed Connection fül Products oszlopa csak azokat a termékeket mutatja, amelyeket az OpenAI feldolgozott, és fel tud használni a hirdetésekben. A részletes bontást akkor látod, ha a szám melletti ikon fölé viszed az egeret.

Mit tegyél, ha valami nem működik#

Az Ads Managerben sokkal több terméket látok, mint amennyi a feedemben van#

Az OpenAI a feed SFTP-mappájában lévő összes fájlt beolvassa, és összeadja a bennük lévő termékeket. Ha a kapcsolatot többször állítottad be, vagy megváltoztattad a fájlnevet, a régi fájl a szerveren maradt, és a termékei továbbra is beleszámítanak.

Megoldás:

• Töröld a régi fájlt. Csatlakozz az SFTP-hez ugyanazokkal az adatokkal, mint a Mergadóban, például FileZilla vagy Cyberduck segítségével, és törölj minden fájlt, kivéve azt, amelynek a neve megegyezik a projekt beállításaiban megadott Fájlnévvel. A status.json fájl az OpenAI-é, azt hagyd meg.
• Vagy kezdj tiszta feeddel. Az Ads Managerben hozz létre új feedet új hozzáférési adatokkal, ennek a mappája üres lesz. A Mergadóban ezután válaszd le a régi kapcsolatot, és add meg az újat. A régi feedhez kapcsolt kampányokat át kell kötnöd az újra.

Az Ads Managerben kevesebb terméket látok, mint amennyi a feedemben van#

Az OpenAI a hirdetésekhez nem dolgozza fel a nem raktáron lévő termékeket, vagyis azokat, amelyeknél az availability elem értéke out_of_stock. Az Upload History fülön ezeket is látod a feltöltött termékek között, a Feed Connection fül Products oszlopából viszont hiányoznak. A különbség kisebb részét általában azok a termékek adják, amelyeket az OpenAI nem hagyott jóvá. A számukat a Not approved sorban látod, ha a termékszám melletti ikon fölé viszed az egeret.

Megoldás:

• Rejtsd el a nem raktáron lévő termékeket. Hozz létre egy lekérdezést, amely a feedben lévő elérhetőségi elem alapján kiválasztja a nem raktáron lévő termékeket, és használd a Termékek elrejtése szabályban. A feed így csak olyan termékeket tartalmaz, amelyek megjelenhetnek a hirdetésekben, és a számok a Mergadóban és az Ads Managerben egyezni fognak. Amint egy termék újra raktárra kerül, magától visszakerül a feedbe.
• Ellenőrizd a jóvá nem hagyott termékeket a Mergado Audit segítségével. Az Ads Manager az elutasítás okát többnyire nem adja meg, leggyakrabban hiányzó kötelező adatról, például a márkáról van szó.

Az SFTP-feltöltés nem működik#

A hiba okát a projekt Előzményeiben látod a Külső tárhely eseménynél. A leggyakoribb okok:

• Megváltoztattad a jelszót. Ha az Ads Managerben új jelszót generálsz, a régi érvényét veszti. Az új jelszót a meglévő SFTP-kapcsolatnál a Mergado Keychainben módosítsd. A projekt beállításaiban a kapcsolatot nem lehet szerkeszteni.
• Nem egyezik a szerver címe. Minden feednek más Hostja lehet. Hasonlítsd össze a Mergado Keychainben lévő kapcsolat Szerver címét (URL) az Ads Manager Host értékével, és szükség esetén javítsd ki ott.
• Rossz port. Az OpenAI a 443-as portot használja, nem az alapértelmezett 22-t.

A feedben 0 termék van, vagy az Ads Manager indoklás nélkül elutasította#

Az Ads Manager gyakran nem jelzi, mi a gond az adatokkal. Ellenőrizd a feedet a Mergado Audit eszközzel, amely minden hibánál a javítás módját is megmutatja. A hibákat ezután a Mergadóban szabályokkal javítsd, ne kézzel, termékenként.

A Hosted URL-kapcsolatot nem lehet menteni, vagy a feed nem töltődik be#

Az URL-alapú kapcsolatnál ismerünk olyan eseteket, amikor az Ads Manager nem fogadja el, pedig ugyanaz a feed SFTP-n keresztül átmegy. Ha az URL nálad nem működik, válts SFTP-re ennek az útmutatónak megfelelően.

A feed vagy a képek a tűzfal miatt nem töltődnek le#

Ha a webáruházadat Cloudflare vagy más tűzfal védi, az blokkolhatja a bemeneti feed és a képek letöltését is. Kövesd a Hogyan állítsd be a Cloudflare-t, hogy ne blokkolja a feed és a képek letöltését? útmutatót.

GYIK#

Kötelező SFTP-n keresztül csatlakoztatnom a feedet?#

Nem, az SFTP nem kötelező. A feedet Hosted URL-ként is megadhatod az Ads Managerben. Az SFTP-t mégis ajánljuk, mert megbízhatóbb, és a Mergado minden újragenerálás után feltölti rá a feedet.

Hozzáadhatom az SFTP-t egy már meglévő projekthez?#

Igen. Kövesd a 3. lépés B változatát. A projektet nem kell újra létrehoznod.

Milyen gyakran frissül a feed az Ads Managerben?#

A Mergado a projekt minden újragenerálása után feltölti az aktuális feedet az SFTP-re. Azt, hogy az OpenAI mikor dolgozza fel, már az Ads Manager határozza meg.

Küldhetek több Mergado-projektet egyetlen Ads Manager-feedbe?#

Nem ajánljuk. Az OpenAI a mappában lévő összes fájlt beolvassa, és összeadja a termékeket, így egy feedben keverednének. Minden projekthez hozz létre külön feedet az Ads Managerben.

A feedben lévő termékek a ChatGPT szokásos válaszaiban is megjelennek?#

Nem. Az Ads Managerbe feltöltött feed csak a fizetett hirdetésekhez használható. A termékek organikus megjelenítése a ChatGPT-ben az OpenAI külön programja.

Elvesztettem az SFTP-jelszót. Mit tegyek?#

A jelszó az Ads Managerben csak egyszer jelenik meg. Így járj el:

1. Az Ads Managerben a feed SFTP-kapcsolatának beállításaiban generálj új jelszót. A régi ezzel érvényét veszti.
2. A Mergadóban nyisd meg a Mergado Keychaint, keresd meg a meglévő OpenAI SFTP-kapcsolatot, és módosítsd a jelszavát.
3. Mentsd el. A Mergado a projekt következő újragenerálásakor már az új jelszóval jelentkezik be.

A jelszót a Keychainben módosítsd, ne a projekt beállításaiban. Ott a kapcsolatot nem lehet szerkeszteni, csak leválasztani vagy újat létrehozni.