Przejdź do głównej zawartości

Wymagania dotyczące feedu produktowego

Dowiedz się jakie standardy feedu przyjmujemy oraz jakie są wymagania dotyczące pliku.

Napisane przez Klaudia Lewandowska

Z tego artykułu dowiesz się, jakie standardy feedu przyjmuje edrone, jakie są wymagania dotyczące pliku i jakie dane produktów analizuje kontrola feedu.

📌 Wskazówka: jeśli Twój sklep jest połączony z edrone przez integrację jednym kliknięciem, nie potrzebujesz feedu produktowego. Produkty synchronizują się już przez integrację.


​

Obsługiwane standardy feedu

  • Google Merchant Center (GMC)

  • IAI

  • CENEO

Poniżej znajdziesz przykładowe feedy produktowe w tych standardach. Rekomendujemy standard GMC – na niektórych platformach występuje pod nazwą Google Shopping.


​

<rss version="2.0">
<title>My feed</title>
<link rel="self" href="www.my-shop.com"/>
<updated>2019-08-01T09:30:01Z</updated>
<author>
<name>myShop</name>
</author>
<id>/googleshopping.xml</id>
<channel>
<item>
<g:id>ABC2151</g:id>
<title>This is my product name</title>
<description>Very nice product</description>
<g:google_product_category>Another category</g:google_product_category>
<g:product_type>We > take > category from > here</g:product_type>
<g:brand>This is producer brand</g:brand>
<g:mpn>07920</g:mpn>
<g:gtin>7898920068216</g:gtin>
<link>https://www.my-shop.com/product-url-30ml/p?idsku=215196140</link>
<g:image_link>https://my-shop.com./image/ids/496848_2.jpg</g:image_link>
<g:price>49,90 USD</g:price>
<g:sale_price>39,90 USD</g:sale_price>
<g:sale_price_effective_date>2016-02-24T13:00-0800/2016-02-29T15:30-0800</g:sale_price_effective_date>
<g:availability_date>2016-11-25T13:00-0800</g:availability_date>
<g:expiration_date>2016-02-24</g:expiration_date>
<g:availability>in stock</g:availability>
<g:condition>new</g:condition>
<g:complementary_product_ids>DEF3151~GHI4151~JKL5151</g:complementary_product_ids>
</item>
...
<offers version="1">
<group name="other">
<o id="ISC6020000613" url="https://www.my-shop.com/product-url-30ml/p?idsku=215196140" price="39,02 PLN" weight="0.0300" stock="1" avail="1">
<cat>We/take/category from/here</cat>
<name>This is my product name</name>
<desc>What a lovely product</desc>
<imgs>
<main url="https://my-shop.com./image/ids/496848_2.jpg"/>
<i url="https://my-shop.com./another-image/ids/496848_2.jpg"/>
</imgs>
<attrs>
<a name="Producent">This is producer brand</a>
<a name="Kod_producenta">ISC6020000613</a>
<a name="Pojemnosc">30 ml</a>
<a name="namePl">Some other attribute</a>
<a name="sale_price">29,02 PLN</a>
<a name="sale_price_effective_date">2016-02-24T13:00-0800/2016-02-29T15:30-0800</a>
<a name="availability_date">2016-11-25T13:00-0800</a>
<a name="expiration_date">2016-02-24</a>
<a name="complementary_product_ids">ABC7020000613~DEF8020000613~GHI9020000613</a>
</attrs>
</o>
...
<offer file_format="IOF" version="3.0" generated_by="IdoSell Shop" generated="2019-08-01 11:01:19" expires="2019-08-02 11:01:19" extensions="yes">
<products language="pol" currency="PLN">
<product type="regular" id="7002" vat="23.0" producer_code_standard="GTIN12" code_on_card="FUND-001 / 375833-010" site="6" currency="PLN">
<producer id="24" name="Brand of product"/>
<category id="1236067664" name="We > take > category from > here"/>
<unit id="0" name="szt."/>
<card url="https://www.my-shop.com/product-url-30ml/p?idsku=215196140"/>
<description>
<name type="name" xml:lang="pol">This is product name</name>
<short_desc xml:lang="pol">What a lovely product</short_desc>
<long_desc xml:lang="pol">What a lovely product. What a lovely product. What a lovely product. </long_desc>
</description>
<iaiext:delivery_time unit="day" value="1"></iaiext:delivery_time>
<iaiext:visibility></iaiext:visibility>
<price gross="64.99" net="52.84"/>
<srp gross="0" net="0"/>
<strikethrough_retail_price gross="119.99" net="97.55"/>
<strikethrough_wholesale_price gross="119.99" net="97.55"/>
<iaiext:price_retail>
<iaiext:site id="6" size_id="0" gross="64.99" net="52.84"/>
</iaiext:price_retail>
<iaiext:price_wholesale>
<iaiext:site id="6" size_id="0" gross="64.99" net="52.84"/>
</iaiext:price_wholesale>
<iaiext:price_minimal>
<iaiext:site id="6" size_id="0" gross="0.01" net="0.01"/>
</iaiext:price_minimal>
<promotion name=""/>
<iaiext:hotspots></iaiext:hotspots>
<sizes></sizes>
<images>
<large>
<image url="https://my-shop.com./image/ids/496848_2.jpg" changed="2013-01-02 00:00:00" hash="2dbbdb78f4f5f42bb65d4ffa96f53501" width="800" height="800"/>
</large>
</images>
</product>
...

Wymagania dotyczące pliku

  • Feed produktowy musi być plikiem XML podanym jako link (URL), np. https://yourshop.com/gmc-feed.xml

  • Link musi prowadzić bezpośrednio do pliku XML – nie do strony ustawień, strony sklepu ani panelu Google Merchant Center.

  • Po otwarciu linku w przeglądarce powinien wyświetlić się kod XML z listą produktów. Plik nie może wymagać logowania ani hasła.

  • Kodowanie pliku musi być w formacie UTF-8.

  • Nie blokuj dostępu do pliku z określonych lokalizacji (np. wybranych krajów).

  • Obsługiwane linki udostępniania z Google Drive i Dropbox mogą zostać zamienione na linki do bezpośredniego pobrania.

  • Jeśli zabezpieczenia sklepu lub hostingu blokują dostęp do pliku, „Kontrola feedu” pokaże problem i podpowie, co zrobić. Gdy odblokowanie adresów IP faktycznie pomoże, lista pojawi się w sekcji „Adresy IP edrone do odblokowania”.

⚠️ Ważne: linki do grafik i produktów nie mogą zawierać spacji. Jeśli pojawią się puste znaki, system może nie odczytać poprawnie wartości atrybutu.
Przykład błędnego linku:
​<g:link> https://www.my-shop.com/product-url-30ml/p?idsku=215196140 </g:link>


​


Obowiązkowe parametry w pliku (przykład na bazie feedu GMC)

Obowiązkowe niezależnie od funkcjonalności, z których chcesz korzystać w edrone (w standardach Ceneo i IAI parametry mogą mieć inne nazwy):

  • id – ID produktu. W feedzie GMC ID może być też pobrane z parametrów item_group_id, gtin lub mpn. Musi zgadzać się z ID, które Twój sklep wysyła do edrone (zobacz sekcję „ID produktu” poniżej).

  • link – link do produktu

  • image_link – link do zdjęcia produktu

  • title – nazwa produktu

  • price – cena


​


Opcjonalne parametry w pliku

Poniższe atrybuty są opcjonalne, ale mogą być ważne, jeśli planujesz korzystać z wybranych funkcji edrone:

  • product_type/product_category – kategoria produktu (w feedzie GMC może być pobrana z dowolnego parametru, który zawiera kategorię);

  • sale_price – używany w elementach dynamicznych i ramkach rekomendacji;

  • quantity – stan magazynowy, potrzebny do automatyzacji opartych na stanie magazynowym, np. flow „Ostrzegaj o niskim stanie magazynowym”;

  • complementary_product_ids – opcjonalny przy korzystaniu z ramek rekomendacji;

  • expiration_date – określa dostępność produktu w danym okresie.

Kategoria jest opcjonalna, ale zalecamy jej dodanie. Korzystają z niej m.in.:

  • dynamiczne elementy Wybrane produkty i Bestsellery;

  • kategorie w Custom Flows;

  • pełne drzewo kategorii we flow Cross-selling;

  • ramki rekomendacji Marketing Machine (MM);

  • filtry w różnych funkcjonalnościach.


​


ID produktu: musi zgadzać się ze sklepem

ID każdego produktu w feedzie musi być takie samo jak ID, które Twój sklep wysyła do edrone (np. gdy ktoś ogląda produkt, dodaje go do koszyka lub składa zamówienie). Jeśli ID się różnią, aktualizacje nie trafiają do właściwego produktu albo pojawiają się duplikaty.

Gdy ID się nie zgadzają, edrone szuka reguły dopasowania – np. innego pola ID, SKU albo części identyfikatora przed lub po separatorze – i sprawdza ją na prawdziwych danych Twojego sklepu, zanim będzie można ją zastosować. Reguła zmienia tylko sposób importu do edrone; oryginalny plik pozostaje bez zmian.

W obsługiwanych feedach XML dopasowanie może korzystać także z dodatkowych pól ID – np. idProduto z VTEX, gdy standardowe pole id zawiera SKU. Dzięki temu możesz użyć istniejącego eksportu bez zmiany nazw pól. Nie każda struktura XML jest obsługiwana.

⚠️ Ważne: w kroku „Dopasowanie do sklepu” co najmniej 80% produktów ostatnio aktywnych w sklepie musi zostać odnalezionych w feedzie. Jeśli żadna reguła nie osiąga tego poziomu, zmień ID w feedzie na ID produktu ze sklepu lub skontaktuj się z naszym supportem.

Nowe sklepy mogą dodać feed, zanim pojawi się aktywność klientów: porównanie ID nastąpi, gdy spłyną dane o zakupach, koszykach lub wyświetleniach produktów.


​


Co kontrola feedu sprawdza w danych produktów

Aby zobaczyć wynik, kliknij menu konta (lewy dolny róg), przejdź do „Twój sklep” i otwórz zakładkę „Feed produktowy”. W sekcji „Kontrola feedu” edrone sprawdza feed w 5 krokach. Więcej znajdziesz w artykule Kontrola feedu produktowego.

W kroku 4, „Dane produktów”, widzisz, ile produktów ma dany problem, przykładowe produkty i praktyczny skutek. Kontrola wskazuje:

  • Brak lub zduplikowane ID – przy zduplikowanym ID importowany jest tylko jeden z produktów.

  • Brak nazwy lub linku albo nieprawidłowy link.

  • Brak zdjęcia – produkt nie pojawi się w newsletterach, automatyzacjach i rekomendacjach.

  • Brak lub nieprawidłowa cena – produktu nie można użyć w wiadomościach i filtrach opartych na cenie.

  • Brak dostępności – produkt jest traktowany jako dostępny i może pojawić się w e-mailach i rekomendacjach, nawet gdy go zabraknie.

  • Brak kategorii – kategoria jest opcjonalna, ale korzystają z niej filtry kategorii.

  • Brak stanu magazynowego – produkty pozostają dostępne, ale automatyzacje oparte na stanie magazynowym (np. ostrzeżenie o niskim stanie) nie działają.

  • Nieprawidłowe wartości w polach produktu.

📌 Wskazówka: ten krok sprawdza adresy zdjęć w pliku. Nie sprawdza, czy zdjęcia da się pobrać, ani czy ceny zgadzają się ze sklepem.


​


Potrzebujesz dodatkowej pomocy?

Jeśli masz jakiekolwiek dodatkowe pytania dotyczące feedu produktowego, skontaktuj się z nami na hello@edrone.me


Czy to odpowiedziało na twoje pytanie?