W tym artykule przedstawiamy format i wymagania dotyczące wszystkich atrybutów, których można używać w Manufacturer Center. Niektóre atrybuty są wymagane, a inne – zalecane lub opcjonalne. Jeśli nie dostarczysz wymaganych atrybutów, uniemożliwi to poprawne przetworzenie informacji o produkcie podczas przesyłania pliku danych. Z kolei pominięcie zalecanych lub opcjonalnych atrybutów sprawi, że dane produktów w naszym systemie będą niekompletne, ale nie spowoduje błędu przetwarzania.
W tym artykule używamy terminów „produkt” i „wersja produktu”. Terminu „produkt” używamy do opisania pojedynczej wersji produktu. Produkt może występować w wielu wersjach. Te wersje mogą różnić się między sobą kolorem, rozmiarem lub stylem. Określenia „produkt” używamy również w odniesieniu do każdej takiej wersji. Każda pozycja w pliku danych o produktach powinna opisywać jedną wersję produktu.
Pamiętaj, aby w pliku danych podawać tylko atrybuty w języku angielskim, które znajdziesz w nawiasach kwadratowych poniżej. Nazwy opisowe oraz tłumaczenia nazw atrybutów podajemy tylko po to, aby lepiej wyjaśnić funkcje atrybutów.
Weź też pod uwagę, że jeśli podasz wiele wartości powtarzających się atrybutów (takich jak opis cech), będziemy mogli wyświetlić tylko kilka pierwszych wartości.
Przykłady:
- Szablon pliku danych Manufacturer Center w formacie TSV.tsv
- Szablon pliku danych Manufacturer Center w formacie XML.xml
Uwaga: podawane przez Ciebie wartości mogą być wyświetlane klientom, więc staraj się, by były dla nich zrozumiałe.
Informacje podstawowe
Poniższe atrybuty zawierają podstawowe informacje o Twoich produktach.
Aby wyświetlić pełne informacje o atrybucie, w tym sprawdzone metody dotyczące jego dodawania, wybierz link w tabeli z informacjami o atrybucie.
Atrybut | Format | Podsumowanie wymagań minimalnych |
---|---|---|
Identyfikator [id] |
Wymagany w przypadku wszystkich produktów Przykład Składnia/typ Powtórzona wartość/pole Tekst (TSV) |
Po przesłaniu produktu nie możesz zmieniać jego identyfikatora |
GTIN [gtin] |
Wymagany w przypadku wszystkich produktów Składnia Powtórzona wartość/pole Tekst (TSV) XML (pliki danych) |
|
MPN [mpn] |
Zalecany w przypadku wszystkich produktów Składnia/typ Tekst (TSV) XML (pliki danych) |
|
Tytuł [title] |
Wymagany w przypadku wszystkich produktów Tytuł produktu Składnia/typ Tekst (znaki Unicode) Zalecana liczba znaków: 80–140 Powtórzona wartość/pole Nie Tekst (TSV)
XML (pliki danych)
|
Ściśle przestrzegaj naszych wskazówek redakcyjnych, na przykład nie umieszczaj w tytule informacji promocyjnych i nie używaj nieuzasadnionych WIELKICH LITER. W przypadku różnych wersji produktu musisz przesłać nazwy handlowe wszystkich wersji, podając w tytułach różnice między nimi. Jeśli na przykład „Telefon Google Nexus 5 z Androidem 32 GB, bez blokady SIM, CDMA” jest dostępny w kolorze czerwonym i czarnym, należy przesłać 2 odrębne produkty o takich tytułach:
|
Wymagany w przypadku wszystkich produktów Marka produktu Składnia/typ Tekst (znaki Unicode) Powtórzona wartość/pole Nie Tekst (TSV)
XML (pliki danych)
|
||
Nazwa produktu [product_name] |
Opcjonalny Nazwa produktu Składnia/typ Tekst (znaki Unicode) Zalecana liczba znaków: 80–140 Powtórzona wartość/pole Nie Tekst (TSV)
XML (pliki danych)
|
|
Linia produktów [product_line] |
Zalecany w przypadku wszystkich produktów Nazwa grupy powiązanych produktów Składnia/typ Tekst (znaki Unicode) Powtórzona wartość/pole Nie Tekst (TSV)
XML (pliki danych)
|
|
Typ produktu [product_type] |
Opcjonalny Typ lub kategoria produktu Składnia/typ Tekst (znaki Unicode) z symbolem „>”, który oddziela poziomy hierarchii Powtórzona wartość/pole Tak (zalecamy maksymalnie 10 na produkt) Tekst (TSV)
XML (pliki danych)
|
|
Informacje o produkcie [product_highlight] |
Opcjonalny Najważniejsze informacje o produkcie Składnia/typ Tekst (znaki Unicode) Liczba znaków: 1–150 znaków na informację Zalecane: tylko ASCII Powtórzona wartość/pole Tak (zalecana liczba: 4–6) Minimum 2, maksymalnie 100 Tekst (TSV)
XML (pliki danych)
|
Więcej informacji
Atrybut | Format |
---|---|
Opis [description] |
Wymagany Składnia/typ Tekst (znaki Unicode) Tylko ASCII Zalecany zakres liczby znaków: od 500 do 1000 Powtórzona wartość/pole Nie Tekst (TSV)
XML (pliki danych)
|
Opis cech [feature_description] |
Zalecany Tekst (znaki Unicode) i obrazy Atrybuty podrzędne Powtórzona wartość/pole Tekst (TSV)
XML (pliki danych)
|
Link do zdjęcia [image_link] |
Wymagany Akceptowane formaty zdjęć to (w preferowanej kolejności): WEBP (.webp), JPEG (.jpg/.jpeg), PNG (.png), GIF bez animacji (.gif) i BMP (.bmp). Rozszerzenia plików powinny odpowiadać ich formatowi. Akceptowane protokoły URL to Adresy URL muszą być indeksowalne i nie mogą być chronione hasłem. Roboty „googlebot” i „googlebot-image” muszą mieć możliwość dostępu do katalogu z Twoim plikiem. Dowiedz się więcej o konfigurowaniu pliku robots.txt. URL zdjęcia produktu Składnia/typ Adres URL (musi rozpoczynać się od Powtórzona wartość/pole Nie Tekst (TSV)
XML (pliki danych)
Akceptowane formaty zdjęć to (w preferowanej kolejności): WEBP (.webp), JPEG (.jpg/.jpeg), PNG (.png), GIF bez animacji (.gif) i BMP (.bmp). Rozszerzenia plików powinny odpowiadać ich formatowi. Akceptowane protokoły URL: „ |
Link do dodatkowego zdjęcia [additional_image_link] |
Zalecany w przypadku produktów z wieloma zdjęciami Dodatkowe adresy URL zdjęć produktu Składnia/typ Adres URL (musi rozpoczynać się od Powtórzona wartość/pole Tak (zalecamy maksymalnie 10 na produkt) Tekst (TSV)
XML (pliki danych)
|
Link do filmu [video_link] |
Opcjonalny Adres URL filmu pokazującego produkt Składnia/typ Adres URL YouTube (musi zaczynać się od Powtórzona wartość/pole Tak (zalecamy maksymalnie 10 na produkt) Tekst (TSV)
XML (pliki danych)
|
URL strony produktu [product_page_url] |
Opcjonalny Adres URL strony producenta ze szczegółowymi informacjami o produkcie Składnia/typ Adres URL YouTube (musi zaczynać się od Powtórzona wartość/pole Nie Tekst (TSV)
XML (pliki danych)
|
Data ujawnienia [disclosure_date] |
Opcjonalny Data publicznej zapowiedzi produktu Składnia/typ Data Powtórzona wartość/pole Nie Tekst (TSV)
XML (pliki danych)
|
Szczegółowe treści dotyczące produktu [rich_product_content] |
Opcjonalny Szczegółowe opisy produktów i multimedia prezentujące szczególne cechy produktów Składnia/typ Powtórzona wartość/pole Nie Tekst (TSV) Uwaga: musisz otoczyć całe pole podwójnymi cudzysłowami i zmienić znaczenie podwójnego cudzysłowu wewnątrz pola, stosując 2 podwójne cudzysłowy. Zwykle będą się tym zajmować programy eksportujące do CSV/TSV.
XML (pliki danych) Uwaga: musisz zakodować to jako CDATA w pliku XML.
|
Data premiery [release_date] |
Opcjonalny Data wprowadzenia produktu do sprzedaży Składnia/typ Data Powtórzona wartość/pole Nie Tekst (TSV)
XML (pliki danych)
|
Sugerowana cena detaliczna [suggested_retail_price] |
Opcjonalny Sugerowana cena detaliczna producenta Składnia/typ Tekst (znaki Unicode) Powtórzona wartość/pole Nie Tekst (TSV)
XML (pliki danych)
|
Szczegóły produktu [product_detail] |
Opcjonalny Dodatkowe informacje i dane techniczne Składnia/typ Tekst (znaki Unicode) Liczba znaków Nazwa sekcji: zalecane ograniczenie do 140 znaków Nazwa atrybutu: zalecane ograniczenie do 140 znaków Wartość atrybutu: maksymalnie 1000 znaków Atrybuty podrzędne Nazwa sekcji Nazwa atrybutu Wartość atrybutu Powtórzona wartość/pole Tak Tekst (TSV)
XML (pliki danych)
|
Link do modelu 3D [virtual_model_link] |
Opcjonalny Model 3D produktu. Podaj miejsce docelowe funkcji 3D. Składnia/typ Adres URL (musi zaczynać się od „http://” lub „https://”) Liczba znaków Do 2000 znaków Powtórzona wartość/pole Nie Tekst (TSV)
XML (pliki danych)
|
Zalecane dla produktów, w przypadku których kraje, dla których dane są ważne, różnią się od krajów skonfigurowanych w pliku danych, który je zawiera. Syntax type Liczba znaków 2 Powtórzona wartość/pole Tak, do 100 Tekst (TSV) Przykład wielu krajów: XML (pliki danych)
Przykład wielu krajów: |
Informacje o wersji produktu
Przez wersje rozumiemy grupy podobnych produktów, które różnią się tylko takimi atrybutami jak kolor [color]
czy styl [style]
. Dodając wersje produktów, pomożesz nam ulepszyć informacje pokazywane klientom dzięki prawidłowemu grupowaniu produktów w reklamach i informacjach o produktach w usługach Google.
Jak przesłać dane wersji produktów
- Zacznij od dodania wszystkich odmian produktu.
- Jeśli na przykład masz w ofercie telefon w 4 kolorach (czarnym, białym, srebrnym i czerwonym) i z 3 rozmiarami pamięci (8 GB, 16 GB i 32 GB), dodaj 12 wersji (czarny z 8 GB pamięci, czarny z 16 GB pamięci, czarny z 32 GB pamięci, biały z 8 GB pamięci, biały z 16 GB pamięci itp.).
- Dla każdej wersji produktu użyj unikalnego atrybutu identyfikator
[id]
(podobnie jak dla każdego innego produktu w swoim pliku danych). - Aby oznaczyć poszczególne pozycje jako wersje jednego produktu, powiąż je ze sobą, używając atrybutu identyfikator grupy produktów
[item_group_id]
. Każdy produkt w grupie powinien mieć tę samą wartość atrybutu identyfikator grupy produktów. Zgodnie z ogólną zasadą, jeśli na stronie docelowej produktu użytkownik może wybrać różne kolory, wzory, rozmiary, style itp., należy dodać je jako oddzielne produkty i powiązać je ze sobą tym samym atrybutem identyfikator grupy produktów. - W tytule uwzględnij atrybuty, które wyróżniają poszczególne wersje. Aby odróżnić produkty od siebie, musisz przesłać atrybuty kolor
[color]
lub szczegóły produktu[product_detail]
.
Przygotowując wartość atrybutu tytuł [title]
różnych wersji produktu, podaj nazwę wspólną dla wszystkich wersji oraz atrybuty, które odróżniają poszczególne wersje od siebie.
Przykład:
- Telefon Google Nexus 5 z Androidem – 32 GB, czarny, bez blokady SIM, GSM
- Telefon Google Nexus 5 z Androidem – 16 GB, biały, T-Mobile
Atrybut | Format | Podsumowanie wymagań minimalnych |
---|---|---|
Opcjonalny; zalecany w przypadku produktów o wielu wersjach. Określa wersje stylistyczne lub wzory produktu Składnia/typ Tylko ASCII Maksymalna długość: 50 znaków Powtórzona wartość/pole Nie Tekst (TSV)
XML (pliki danych)
|
Zastosuj unikalną wartość dla każdej grupy wersji. Gdy to możliwe, używaj jednostki magazynowej produktu nadrzędnego. Nie zmieniaj wartości przy aktualizacji danych produktów. Używaj tylko prawidłowych znaków Unicode. Zastosuj atrybut identyfikator grupy produktów
W przypadku produktów różniących się cechami innymi niż powyższe atrybuty nie używaj atrybutu identyfikator grupy produktów Zastosuj te same atrybuty dla każdego produktu w grupie produktów. Jeśli na przykład produkty różnią się wartością atrybutów rozmiar |
|
Wymagany w przypadku wszystkich produktów w grupie, w której produkty różnią się zapachem. Zalecany w przypadku wszystkich produktów, dla których zapach jest ważnym, wyróżniającym je atrybutem. Zapach produktu Składnia/typ Tekst (znaki Unicode) Maksymalna długość: 100 znaków Powtórzona wartość/pole Nie Tekst (TSV)
XML (pliki danych)
|
||
Wymagany w przypadku wszystkich produktów należących do grupy, w której produkty różnią się smakiem. Zalecany w przypadku wszystkich produktów, dla których smak jest ważnym, wyróżniającym je atrybutem. Smak produktu Składnia/typ Tekst (znaki Unicode) Maksymalna długość: 100 znaków Powtórzona wartość/pole Nie Tekst (TSV)
XML (pliki danych)
|
||
Wymagany w przypadku wszystkich produktów należących do grupy, w której produkty różnią się formatem. Zalecany w przypadku wszystkich produktów, dla których format jest ważnym, wyróżniającym je atrybutem. Format nośnika produktu Składnia/typ Tekst (znaki Unicode) Maksymalna długość: 100 znaków Powtórzona wartość/pole Nie Tekst (TSV)
XML(pliki danych)
|
||
Wymagany w przypadku wszystkich produktów należących do grupy, w której produkty różnią się rozmiarem pamięci. Zalecany w przypadku wszystkich produktów, dla których rozmiar pamięci jest ważnym, wyróżniającym je atrybutem. Rozmiar pamięci masowej urządzenia elektronicznego Składnia/typ Liczba całkowita + jednostka Maksymalna długość: 100 znaków Powtórzona wartość/pole Nie Tekst (TSV)
XML (pliki danych)
|
Są 3 dozwolone wartości:
|
|
Zalecany w przypadku wszystkich produktów należących do grupy, w której produkty różnią się w zależności od płci, oraz wszystkich produktów, w przypadku których płeć jest ważnym, rozróżniającym atrybutem. Płeć, dla której przeznaczony jest produkt Składnia/typ Tekst (znaki Unicode) Powtórzona wartość/pole Nie Tekst (TSV)
XML (pliki danych)
|
Są 3 dozwolone wartości:
Dla tego atrybutu prześlij tylko wartości w języku angielskim. Jeśli prześlesz przetłumaczone wartości, Twój produkt może wyświetlać się bez tych informacji lub może zostać odrzucony. |
|
Wymagany w przypadku wszystkich produktów w grupie, w której produkty różnią się w zależności od docelowej grupy wiekowej. Wymagany w przypadku wszystkich artykułów odzieżowych. Zalecany w przypadku wszystkich produktów, dla których docelowa grupa wiekowa jest ważnym, wyróżniającym je atrybutem. Docelowa grupa wiekowa, dla której jest przeznaczony dany produkt Składnia/typ Tekst (znaki Unicode) Powtórzona wartość/pole Nie Tekst (TSV)
XML (pliki danych)
|
Jest 5 dozwolonych wartości:
Dla tego atrybutu prześlij tylko wartości w języku angielskim. Jeśli prześlesz przetłumaczone wartości, Twój produkt może wyświetlać się bez tych informacji lub może zostać odrzucony. |
|
Wymagany w przypadku wszystkich produktów w grupie, w której produkty różnią się rozmiarem. Wymagany w przypadku wszystkich produktów należących do kategorii „Ubrania i akcesoria > Ubrania” oraz „Ubrania i akcesoria > Buty” i ich kategorii podrzędnych. Zalecany w przypadku wszystkich produktów, dla których rozmiar jest ważnym, wyróżniającym je atrybutem. Rozmiar produktu Składnia/typ Tekst (znaki Unicode) Maksymalna długość: 100 znaków Powtórzona wartość/pole
Tekst (TSV) XL XML (pliki danych)
|
||
Tylko w przypadku produktów odzieżowych: Wymagany w przypadku wszystkich produktów w grupie, które różnią się rozmiarem. Wymagany w przypadku wszystkich produktów należących do kategorii „Ubrania i akcesoria > Ubrania” i jej kategorii podrzędnych. Rodzaj rozmiaru produktu Składnia/typ Ciąg znaków (znaki Unicode, zalecane: tylko ASCII) Powtórzona wartość/pole Tak (maksymalnie 2 wartości) Tekst (TSV)
XML (pliki danych)
|
Jest 6 dozwolonych wartości. Możesz podać 2 wartości (np. „big” i „tall”, „petite” i „maternity”).
Dla tego atrybutu prześlij tylko wartości w języku angielskim. Jeśli prześlesz przetłumaczone wartości, Twój produkt może wyświetlać się bez tych informacji lub może zostać odrzucony. |
|
Zalecany w przypadku produktów odzieżowych Tabela rozmiarów produktu Składnia/typ Tekst (znaki Unicode) Powtórzona wartość/pole Nie Tekst (TSV)
XML (pliki danych)
|
Oto 11 dozwolonych wartości:
UWAGA: jeśli nie określisz tego atrybutu, automatycznie zastosujemy domyślną wartość na podstawie kraju docelowego, w którym sprzedajesz produkt. |
|
Wymagany w przypadku wszystkich produktów w grupie, w której produkty różnią się kolorem. Wymagany w przypadku wszystkich artykułów odzieżowych. Zalecany w przypadku wszystkich produktów, dla których kolor jest ważnym, wyróżniającym je atrybutem. Kolor produktu Składnia/typ Tekst (znaki Unicode) Maksymalna długość: 100 znaków Powtórzona wartość/pole Nie Tekst (TSV)
XML (pliki danych)
|
||
Wymagany w przypadku wszystkich produktów w grupie, które różnią się motywem. Zalecany w przypadku wszystkich produktów, dla których motyw jest ważnym, wyróżniającym je atrybutem. Opis stylu tematycznego, obrazu i wyglądu przedmiotu Składnia/typ Tekst (znaki Unicode) Maksymalna długość: 100 znaków Powtórzona wartość/pole Nie Tekst (TSV)
XML (pliki danych)
|
||
Wymagany w przypadku wszystkich produktów należących do grupy, w której produkty różnią się wzorem. Zalecany w przypadku wszystkich produktów, dla których wzór jest ważnym, wyróżniającym je atrybutem. Wzór lub grafika znajdująca się na produkcie Składnia/typ Tekst (znaki Unicode) Maksymalna długość: 100 znaków Powtórzona wartość/pole Nie Tekst (TSV)
XML (pliki danych)
|
||
Wymagany w przypadku wszystkich produktów należących do grupy, w której produkty różnią się materiałem. Zalecany w przypadku wszystkich produktów, dla których materiał jest ważnym, wyróżniającym je atrybutem. Materiał, z jakiego wykonano produkt Składnia/typ Tekst (znaki Unicode) Maksymalna długość: 200 znaków Powtórzona wartość/pole Nie Tekst (TSV)
XML (pliki danych)
|
||
Wymagany w przypadku wszystkich produktów w grupie, w której produkty różnią się liczbą sztuk w opakowaniu. Zalecany w przypadku wszystkich produktów, dla których liczba sztuk jest ważnym, wyróżniającym je atrybutem. Liczba sztuk w opakowaniu o określonej wielkości Składnia/typ Liczba całkowita + jednostka Maksymalna długość: 100 znaków Powtórzona wartość/pole Nie Tekst (TSV)
XML (pliki danych)
|