Kiegészítő feed a Merchant Centerben: mire jó, és hogyan állítsd be?

A kiegészítő feed (angolul supplemental feed) egy második termékadatfájl vagy -táblázat a Google Merchant Centerben, a Google termékadat-kezelő felületén. A már meglévő termékeid adatait pótolja vagy írja felül a termékazonosító alapján, így hiányzó mezőket tölthetsz ki, címeket javíthatsz vagy kampánycímkéket adhatsz a termékekhez anélkül, hogy a webshophoz vagy az eredeti feedhez nyúlnál. Új terméket nem hoz létre. A Merchant Center ma kiegészítő adatforrásnak hívja, és az Adatforrások menüben állítható be, miután bekapcsoltad a „Speciális adatforrás-kezelés” bővítményt.

Elsődleges és kiegészítő adatforrás: mi a különbség?

Az elsődleges adatforrásból kerülnek be a termékeid a Merchant Centerbe. Ebben adod meg a célországot és a nyelvet, és a Google súgója szerint ez az egyetlen adatforrástípus, amely terméket vehet fel vagy törölhet. Webshopoknál ez általában a platform, egy bővítmény vagy a feedkezelő által előállított feed.

A kiegészítő adatforrás másodlagos: a meglévő termékekhez ad újabb adatot, vagy frissíti a már megadottakat, legyen szó kötelező vagy opcionális attribútumról. Önálló adatforrásként nem használható.

A régi Merchant Centerben még feedekről és feedszabályokról volt szó, ma a felület adatforrást és attribútumszabályt mond. A szakmában mindkét elnevezés él, ebben a cikkben a feedet és az adatforrást azonos értelemben használjuk.

A Merchant Center többi adatforrás-típusa

A Merchant API dokumentációja hétféle adatforrást sorol fel. A két termékforrás mellett a többi más célt szolgál:

A helyi készlet, a promóciók és az értékelések külön bővítményhez vagy programhoz kötődnek, és nem minden országban érhetők el. Ha a magyar piacon használnád valamelyiket, előbb nézd meg az adott súgóoldalt. A kiegészítő termékforrást a súgó nem köti országhoz, magyar fiókban is használható.

Mit tud a kiegészítő feed, és mit nem?

A kiegészítő feed csak olyan terméken változtat, amely már szerepel az elsődleges forrásban. Ha a fájlban olyan azonosító van, amely az elsődlegesben nincs, abból nem lesz új termék. Törölni sem tud: ha egy terméket bizonyos felületeken nem akarsz megjeleníteni, arra az excluded_destination attribútum való, ezt viszont a kiegészítő feedben is megadhatod.

Az illesztés kulcsa: termékazonosító (id) + adatforráscímke (feed label, pl. HU) + nyelv. Mindhárom pontosan egyezzen az elsődleges forráséval.

A Merchant API leírása szerint egy kiegészítő forrás egy vagy több elsődleges forráshoz is kapcsolható, például ha az online és a bolti termékeid külön elsődleges forrásban vannak.

Hogy végül melyik érték érvényesül, azt az elsődleges forrás alapértelmezett szabálya dönti el. A Google ezt minden attribútumhoz magától hozzárendeli, és az értéket a kiegészítő vagy az elsődleges forrásból veszi. A Merchant API útmutatója szerint a szabályban a források sorrendje számít: az attribútum az első olyan forrásból jön, amely megadja, a többi csak a hiányt pótolja.

Ha nem azonosító, hanem például márka szerint illesztenél (hogy egy márka minden terméke ugyanazt a címkét kapja), arra az egyéni illesztés való. Ilyenkor a szabályt neked kell beállítanod.

Tipikus felhasználások: új mezők, címek, címkék, GTIN

A kiegészítő feed akkor hasznos, ha egy adatot a webshop vagy a feedkezelő nem tud a feedbe tenni, a fejlesztés pedig lassú vagy drága. A leggyakoribb esetek:

• Hiányzó attribútumok. Anyag, szín, méret, súly, korcsoport: ha a termékoldalon megvan, de a feedből hiányzik, egy-egy oszloppal pótolható. Hogy melyik mező mennyit számít, arról a termékattribútumokról szóló cikkünkben írunk.
• Címjavítás. A title oszloppal felülírhatod az eredeti címet, például ha hiányzik belőle a márka vagy a méret. Ha az új címet AI írta, a Google előírása szerint a structured_title attribútumban kell beküldeni, trained_algorithmic_media jelöléssel.
• Egyéni címkék. A custom_label_0–custom_label_4 mezőkkel (értékenként legfeljebb 100 karakter) szezon, árrés vagy kiárusítás szerint bonthatod a kampányokat. A vásárló ezeket nem látja.
• GTIN. Ha a GTIN (a vonalkódhoz tartozó nemzetközi termékazonosító) megvan a beszállító listájában, de a webshopban nincs, a gtin oszlop pótolja.
• Termékkiemelések és -részletek. A product_highlight és a product_detail mezőhöz sok webshopmotorban nincs külön beviteli mező, kiegészítő feedben viszont könnyen beküldhetők. Hogy mi kerüljön beléjük, azt külön cikkben mutatjuk be.
• Beszélgetési attribútumok. A Google a hat beszélgetési (conversational) mezőt, például a question_and_answer-t kifejezetten kiegészítő adatforrásban javasolja beküldeni, és szerinte ezek a meglévő termékek jóváhagyását nem befolyásolják. Részletesen ebben a cikkben írunk róluk.
• Gyakoribb ár- és készletfrissítés. Az egykori online készletadatforrás megszűnt, ugyanezt ma egy id, price és availability oszlopos kiegészítő forrás végzi a „Legutóbbi kiválasztása” szabállyal, amely a források közül a legfrissebb árat, illetve elérhetőséget veszi.

A feedlove is így működik: a bolt saját termékoldalaiból készít kiegészítő feedet, ezt a Merchant Center naponta letölti, az eredeti feed pedig változatlan marad.

Hogyan állítsd be a kiegészítő feedet lépésről lépésre?

A lépések a jelenlegi Merchant Center-felületen, a magyar súgó elnevezéseivel (a felület feliratai ettől kissé eltérhetnek):

1. Kapcsold be a bővítményt. Beállítások → Bővítmények → „Felfedezés” lap, majd a „Speciális adatforrás-kezelés” kártyán Aktiválás. Enélkül a „Kiegészítő források” lap meg sem jelenik.
2. Hozd létre a forrást. Beállítások → Adatforrások → Kiegészítő források lap → Kiegészítő termékadatok hozzáadása.
3. Válaszd ki a típust: Fájl, Google Táblázatok-sablon vagy API használata.
4. Fájl webcímről. Ha a fájlt egy URL-en tartod, a Merchant Center ütemezett letöltéssel hozza le. Az URL http://, https://, ftp:// vagy sftp:// előtaggal kezdődjön. Jelszóval védett fájlnál a hitelesítési adatoknál (angol felületen: Add authentication information) add meg a felhasználónevet és a jelszót. A letöltés naponta, hetente vagy havonta futhat, a megadott órában.
5. Add meg az adatokat: Fájlnév (ha kéri), Termékazonosító (az illesztés alapja, alapesetben az id), Adatforráscímke és Nyelv. Az utóbbi kettő legyen pontosan ugyanaz, mint az elsődleges forrásé.
6. Kapcsold össze. Válaszd ki az elsődleges adatforrást, amelyet kiegészítesz, majd kattints az Adatforrás létrehozása gombra.
7. Nézd meg a szabályt. Külön szabályt nem kell írnod. A régi felületen a súgó úgy fogalmazott, hogy a Merchant Center az összekapcsoláskor automatikusan létrehoz egy szabályt; ma ez az alapértelmezett szabály része. Az elsődleges forrás Attribútumszabályok lapján nézheted meg és módosíthatod, melyik attribútum honnan kapja az értékét.

Beállítás Google-táblázattal

Kevés terméknél, vagy ha a kollégák kézzel szerkesztenék, a Google Táblázatok-sablon a kényelmesebb. A Merchant Center a táblázatot alapértelmezetten 24 óránként szinkronizálja. Egy különbségre figyelj: a táblázatban nem idézőjellel, hanem fordított perjellel jelölöd, ha egy vessző vagy kettőspont az érték része, például 2\,5 cm.

Milyen formátumú legyen a fájl?

A kiegészítő feed ugyanolyan termékfájl, mint az elsődleges, csak kevesebb oszloppal. Az alapszabályok a Google termékfájl- és idézőjel-útmutatója szerint:

• Tabulátorral tagolt szövegfájl (.tsv vagy .txt) vagy XML, legfeljebb 4 GB, UTF-8 kódolással. CSV-t ne használj, mert a Google-nél a vessző az értékek elválasztására szolgál.
• Az első sor a fejléc: cellánként egy attribútumnév, a specifikáció szerinti formában (id, gtin, custom_label_0).
• Termékenként egy sor. Az id oszlop kötelező, mellette legalább egy adatoszlop kell.
• Csak azokat az oszlopokat tedd bele, amelyeket tényleg pótolni vagy módosítani akarsz.
• Ismétlődő attribútumnál (például product_highlight) vessző választja el az értékeket, csoportattribútumnál (például product_detail) kettőspont az alattribútumokat: szakasz:név:érték.
• Ha egy érték vesszőt vagy kettőspontot tartalmaz, az adott (al)értéket tedd idézőjelbe, ne az egész mezőt. Az értéken belüli idézőjelet duplázd ("").

Magyar szövegnél a tizedesvessző miatt ez gyakran előjön. Rossz: Méretek:Vastagság:2,5 cm, mert a Google a vesszőnél két külön értéknek veszi. Jó: Méretek:Vastagság:"2,5 cm". Egy rövid kiegészítő feed így néz ki (a fájlban az oszlopokat tabulátor választja el):

Mikor töltse le a Merchant Center a fájlt?

Ütemezd naponta, és úgy, hogy a letöltés az elsődleges feed frissülése és a kiegészítő fájl elkészülte után fusson. A Google súgója is arra figyelmeztet, hogy ha az ütemezett letöltés a fájl módosítása előtt fut, a változások késve jelennek meg.

A sorrend akkor számít igazán, ha a kiegészítő fájl az elsődleges feed alapján készül: az új termékek csak így kapják meg még aznap a kiegészítő adataikat. Egy lehetséges ütemezés: az elsődleges feed letöltése hajnali 4-kor, a kiegészítő fájl elkészülte 5-kor, a letöltése 6-kor, ugyanabban az időzónában. Kézzel is indíthatsz frissítést az Adatforrások listáján.

Gyakori hibák: miért nem jelenik meg az új érték?

• Nem egyezik az azonosító. Ha az elsődleges feedben HU-VD-3828 szerepel, a kiegészítőben pedig VD-3828, a sor nem kapcsolódik. Másik tipikus hiba, hogy a variáns helyett a főtermék azonosítója kerül a fájlba.
• Eltér az adatforráscímke vagy a nyelv. Ha az elsődleges forrás HU címkével és magyar nyelvvel fut, a kiegészítő forrásnál is ezt kell megadni.
• Üres cellák. A Google nem írja le egyértelműen, mi történik, ha egy cella üres: megmarad-e az elsődleges érték, vagy törlődik. A Merchant API csak annyit mond, hogy ha az attribútum a kiegészítő forrásban nincs megadva, az elsődleges forrás értéke érvényes; azt nem, hogy az üres cella ennek számít-e. Ne építs erre: ha egy oszlopot beleteszel a fájlba, és egy termékhez nincs új értéked, írd be az eredeti értéket, vagy előbb próbáld ki egy tesztterméken.
• Kézi szerkesztés. A Merchant Center termékszerkesztőjében tett módosítás a súgó szerint felülírja a fájlból érkező értéket. Ha egy mező nem változik, nézd meg, nem írta-e át valaki kézzel.
• Nem tölthető le a fájl. A webhely robots.txt fájlja (a robotoknak szóló hozzáférési szabályok) ne tiltsa a Googlebotot és az AdsBot-Google-t a fájl könyvtárában, az URL pedig közvetlenül a fájlra mutasson. Ha egy átirányítás után HTML-oldal jön (például egy bejelentkezési oldal), a feldolgozás meghiúsul.
• Törlés a szabály kivétele nélkül. Kiegészítő forrást a Merchant API leírása szerint csak akkor lehet törölni, ha már egyetlen elsődleges forrás szabályában sem szerepel. Előbb vedd ki az alapértelmezett és az esetleges egyéni szabályokból, csak utána töröld.

A többi gyakori Merchant Center-hibáról külön cikkben írunk.

Hogyan ellenőrizd, hogy működik?

Az első letöltés után három helyen érdemes ellenőrizni:

1. Az adatforrásnál. Az Adatforrások között nyisd meg a kiegészítő forrást, és nézd meg a legutóbbi feldolgozást: sikerült-e a letöltés, és jelez-e hibát a Google a fájlban.
2. Az attribútumszabályoknál. Az elsődleges forrás Attribútumszabályok lapján nyisd meg egy attribútum szabályát. Az előnézetben termékazonosítóra kereshetsz, és látod, milyen érték kerül a termékbe.
3. A terméknél. A Termékek listájában kattints a termék címére: az adatlapon a végleges értéket látod, és azt is, ha a Google problémát jelez.

Ha egy szabályt módosítasz, a súgó szerint az adatforrást újra fel kell dolgozni, és a változás csak ezután látszik. Ha pedig arra vagy kíváncsi, mennyire teljes és AI-kész a feeded a kiegészítés előtt és után, az ingyenes feed-ellenőrzővel megnézheted.