Specyfikacja danych produktów dostępnych lokalnie

Ta specyfikacja pozwoli Ci sformatować informacje o produktach na potrzeby skutecznego wyświetlania w Google produktów dostępnych lokalnie. Prześlij dane produktów we właściwym formacie – umożliwi Ci to tworzenie skutecznych reklam lokalnego asortymentu produktów i bezpłatnych lokalnych informacji o produktach.

Informacje o produktach, które przesyłasz za pomocą poniższych atrybutów, to podstawa tworzenia skutecznych reklam i bezpłatnych lokalnych informacji. Dane, które przesyłasz, powinny mieć odpowiednią jakość, ponieważ będą widoczne w reklamach wyświetlanych klientom.

W tym artykule opisujemy wszystkie atrybuty, które możesz dodać do pliku danych, gdy wprowadzasz reklamy lokalnego asortymentu produktów i bezpłatne lokalne informacje.

Podstawowe pliki danych

Aby użyć dotychczasowego podstawowego pliku danych, który nie został włączony dla reklam lokalnego asortymentu produktów lub bezpłatnych lokalnych informacji, musisz włączyć rozszerzenie lokalne i wybrać miejsca docelowe. Aby włączyć lokalne miejsca docelowe:

1. Zaloguj się na konto Merchant Center.
2. Kliknij Produkty.
3. Kliknij Pliki danych.
4. Wybierz podstawowy plik danych, który chcesz zmienić.
5. Dodaj reklamy lokalnego asortymentu produktów lub bezpłatne lokalne informacje o produktach jako miejsce docelowe dla wszystkich krajów i języków z tego pliku danych.

Uwaga: jeśli przesyłasz oddzielnie podstawowe pliki danych dla ofert internetowych (reklam produktowych i bezpłatnych informacji o produktach) oraz dla ofert lokalnych, upewnij się, że nie przesyłasz tych samych produktów w obu plikach danych.

Zalecamy przesłanie wszystkich produktów w jednym pliku danych zarówno dla reklam lokalnego asortymentu produktów, jak i bezpłatnych lokalnych informacji. W przypadku nowo utworzonych plików danych ich miejsca docelowe będzie można wybrać podczas tworzenia tych plików. Dowiedz się, jak utworzyć podstawowy plik danych. W przypadku dotychczasowych plików danych skorzystaj z ustawień podstawowego pliku danych, aby włączyć reklamy lokalnego asortymentu produktów lub bezpłatne lokalne informacje jako dodatkowe miejsca docelowe. Jeśli chcesz wykluczyć produkty z reklam produktowych lub reklam lokalnego asortymentu produktów i bezpłatnych lokalnych informacji o produktach, możesz użyć atrybutu wykluczone miejsce docelowe [excluded_destination]. Dowiedz się więcej o wykluczonych miejscach docelowych.

Jeśli masz starszą wersję pliku danych o produktach utworzoną przed 3 października 2019 r., opisana sytuacja Cię nie dotyczy. Możesz dalej przesyłać oferty w oddzielnych plikach danych.

Przesyłanie podstawowego pliku danych

Typ pliku: możesz użyć pliku tekstowego rozdzielanego znakami (zalecane), pliku XML lub interfejsu API.

Rejestrowanie nowego pliku danych: wykonaj standardowe czynności, aby zarejestrować nowy plik danych.

Produkty powinny pojawić się w ciągu 2 dni od momentu przesłania pliku danych.

Ważne: niektóre atrybuty w tej specyfikacji danych produktów zawierają spacje i podkreślenia. Aby sprawdzić, czy przesyłane atrybuty zawierają prawidłowe znaki i spacje, postępuj zgodnie z wytycznymi poniżej dotyczącymi Twojego typu pliku:

• Pliki rozdzielane tabulatorami: wymagane są spacje. Jeśli atrybut ma podkreślenia, użyj spacji zamiast znaku „_”.
• Pliki XML lub XML API: wymagane są podkreślenia; po otrzymaniu pliku są zamieniane na odstępy.
• JSON API: wymagane są podkreślenia; po otrzymaniu pliku są zamieniane na odstępy.

Podsumowanie wymagań dotyczących atrybutów

Atrybut	Wymagania
Opis [description] Identyfikator [id] Link do zdjęcia [image_link] Tytuł [title]	Wymagane dla wszystkich produktów, które sprzedajesz stacjonarnie.
GTIN [gtin]	Wymagany dla wszystkich nowych produktów z numerem GTIN przypisanym przez producenta. Opcjonalny (zalecany) w przypadku wszystkich innych produktów.
Marka [brand]	Wymagany (w przypadku wszystkich nowych produktów poza markami filmów, książek i nagrań muzycznych). Opcjonalny w przypadku wszystkich innych produktów.
Stan [condition]	Wymagany, jeśli produkt jest używany lub odnowiony. Opcjonalny w przypadku nowych produktów.
Certyfikat [certification] Certyfikaty, np. oceny efektywności energetycznej, powiązane z produktem. Dostępne w krajach UE i EFTA oraz Wielkiej Brytanii. Wymagany w przypadku produktów, które wymagają wyświetlania określonych informacji o certyfikatach w reklamach produktowych lub bezpłatnych informacjach, np. ze względu na lokalne przepisy dotyczące etykiet efektywności energetycznej. Opcjonalny w przypadku wszystkich innych produktów. Uwaga: jeśli nie możesz znaleźć produktu w bazie danych EPREL UE, możesz zamiast tego korzystać z atrybutów klasy efektywności energetycznej przez ograniczony okres wprowadzania zmiany.	Aby określić, czy musisz podać ten atrybut, sprawdź unijne przepisy dotyczące efektywności energetycznej lub obowiązujące przepisy lokalne.
Klasa efektywności energetycznej [energy_efficiency_class] Minimalna klasa efektywności energetycznej [min_energy_efficiency_class] Maksymalna klasa efektywności energetycznej [max_energy_efficiency_class]	Wymagany w przypadku produktów kierowanych na kraje członkowskie UE, Wielką Brytanię lub Szwajcarię. Opcjonalny w przypadku produktów, które nie są kierowane na kraje członkowskie UE, Wielką Brytanię lub Szwajcarię. Uwaga: te atrybuty są wycofywane. Zamiast tego użyj atrybutu certyfikat [certification], aby wyświetlać klasę efektywności energetycznej UE.
Wykluczone miejsce docelowe [excluded_destination]	Zalecany, jeśli korzystasz z jednego podstawowego pliku danych do przesyłania danych produktów zarówno dla ofert online, jak i ofert lokalnych. Użyj tego atrybutu, aby wykluczyć produkty, które nie są sprzedawane w sklepach stacjonarnych. Dzięki temu nie będą się one wyświetlały w reklamach lokalnego asortymentu produktów ani w bezpłatnych lokalnych informacjach.
GTIN [gtin] MPN [mpn] Marka [brand]	Opcjonalny Jeśli do przesyłania danych produktów dla ofert lokalnych używasz starszej wersji pliku danych o produktach dostępnych lokalnie, możesz używać tych atrybutów, aby dopasowywać produkty sprzedawane w internecie i sklepach stacjonarnych w plikach danych o produktach i plikach danych o produktach dostępnych lokalnie. Aby to zrobić, możesz skorzystać z 2 opcji: Dopasuj wartość atrybutu identyfikator [id] do wartości zgodnego identyfikatora [webitemid] Dopasuj wartości atrybutów GTIN [gtin] + marka [brand] lub MPN [mpn] + marka [brand] Jeżeli dopasowujesz identyfikatory za pomocą unikalnych identyfikatorów produktów, musisz także dodać do pliku danych atrybut stan [condition].
Cena [price] Cena promocyjna [sale_price] Okres obowiązywania ceny promocyjnej [sale_price_effective_date] Miara ceny jednostkowej [unit_pricing_measure] Podstawowa miara ceny jednostkowej [unit_pricing_base_measure]	Zalecane: atrybuty cena [price], cena promocyjna [sale_price] i okres obowiązywania ceny promocyjnej [sale_price_effective_date] możesz przesłać w podstawowym pliku danych, jeśli cena produktu jest taka sama w różnych sklepach.   Wymagane: atrybuty cena [price], cena promocyjna [sale_price] i okres obowiązywania ceny promocyjnej [sale_price_effective_date] są wymagane w podstawowym pliku danych, jeśli używasz lokalnej witryny sklepowej sprzedawcy (w ramach podstawowej implementacji). Wymagane: atrybuty miara ceny jednostkowej [unit_pricing_measure] i podstawowa miara ceny jednostkowej [unit_pricing_base_measure] są wymagane, jeśli stanowią tak przepisy obowiązujące w danym kraju.
Metoda odbioru [pickup_method] Gwarantowana dostępność produktu do odbioru [pickup_sla]	Jeśli chcesz umożliwić klientom zakup produktów online i odebranie ich w sklepie stacjonarnym, musisz dodać te 2 atrybuty. Atrybuty metoda odbioru [pickup_method] oraz gwarantowana dostępność produktu do odbioru [pickup_sla] można też przesłać z poziomu sklepu w pliku danych o asortymencie produktów dostępnych lokalnie. Ważne: od 1 września 2024 r. atrybut metoda odbioru [pickup_method] nie będzie już wymagany, aby umożliwić odbiór w sklepie w przypadku Twoich ofert. Dowiedz się więcej o odbiorze dziś, odbiorze w późniejszym terminie dla reklam lokalnego asortymentu produktów i odbiorze później dla reklam produktowych.
Link [link] Link do lokalnej witryny sklepowej sprzedawcy [link_template] Link mobilny do lokalnej witryny sklepowej sprzedawcy [mobile_link_template] Przekierowanie z reklam [ads_redirect]	Opcjonalne, jeśli chcesz korzystać z lokalnej witryny sklepowej sprzedawcy. Atrybut link [link] jest wymagany w przypadku lokalnej witryny sklepowej sprzedawcy (w ramach podstawowej implementacji). W przypadku lokalnej witryny sklepowej sprzedawcy (w ramach pełnej implementacji) link do lokalnej witryny sklepowej sprzedawcy [link_template] jest wymagany. Atrybuty link mobilny do lokalnej witryny sklepowej sprzedawcy [mobile_link_template] i przekierowanie z reklam [ads_redirect] są opcjonalne.

Ważna uwaga (tylko pliki XML): jeśli aktualizujesz plik danych Merchant Center w formacie XML dla każdego z wymienionych poniżej atrybutów, musisz dodać deklarację przestrzeni nazw Google Merchant Center. W przeciwnym razie plik może nie zostać prawidłowo przetworzony.

Wymagane atrybuty identyfikacji

Te atrybuty określają podstawowe informacje o Twoich produktach i są wymagane w przypadku wszystkich produktów.

Identyfikator [id] – identyfikator produktu

Identyfikator każdego produktu jest unikalny we wszystkich sklepach i nie można go użyć ponownie w plikach danych tego samego typu, przeznaczonych dla tego samego kraju i zawierających dane w tym samym języku.

Kiedy używać: wymagany w przypadku wszystkich produktów w pliku danych.

Typ	Ciąg znaków
Przykład dla tekstu rozdzielanego tabulatorami	421486
Przykład w formacie XML	<g:id>421486</g:id>

Ważne:

• Odstępy na początku i na końcu oraz znaki przejścia do nowej linii (0x0D) są usuwane
• Każda sekwencja znaku przejścia do nowej linii (0x0D) i znaków odstępu (znaków Unicode z cechą odstępu) jest zamieniana na jeden odstęp (0x20).
• Dopuszczalne są tylko prawidłowe znaki Unicode, co wyklucza następujące znaki:
  • znaki sterujące (poza znakiem przejścia do nowej linii 0x0D),
  • znaki funkcyjne,
  • znaki prywatnego użytku,
  • pary zastępcze,
  • nieprzypisane punkty kodowe (w szczególności wszystkie punkty kodowe większe niż 0x10FFFF).
• Gdy już prześlesz produkt, nie możesz zmienić jego atrybutu identyfikator podczas aktualizowania pliku danych. Tego samego identyfikatora nie można też później użyć dla innego produktu.
• Jeśli używasz atrybutu identyfikator w kampaniach produktowych, zalecamy używanie tylko małych liter lub znaków, dla których wielkość nie jest rozróżniana.

Tytuł [title] – tytuł produktu

Nazwa produktu. W tytule warto podać cechy charakterystyczne produktu np. wyróżniający go kolor lub markę. Jeśli istnieje dopasowanie, Google może zamiast niego wyświetlać Twoje produkty online lub dane z katalogu Google.

Kiedy używać: wymagany w przypadku wszystkich produktów w pliku danych.

Typ	Tekst (ciąg znaków), nie dłuższy niż 70 znaków
Przykład dla tekstu rozdzielanego tabulatorami	Netgear ReadyNAS Duo
Przykład w formacie XML	<g:title>Netgear ReadyNAS Duo</g:title>

Ważne:

• Przestrzegaj ściśle wskazówek redakcyjnych. Na przykład nie umieszczaj w tytule tekstów promocyjnych (typu „Bezpłatna dostawa”) i nie używaj w nim samych WIELKICH LITER.
• W przypadku różnych wersji produktu musisz podać główny tytuł poszczególnych wersji. Jeśli np. „Męska bawełniana koszulka polo” jest dostępna w kolorach czerwonym i niebieskim, możesz zastosować któryś z tych tytułów:
  • Męska bawełniana koszulka polo (tytuł odpowiedni dla obu wersji),
  • Męska bawełniana koszulka polo – czerwona (dla czerwonej koszulki),
  • Męska bawełniana koszulka polo – niebieska (dla niebieskiej koszulki).

Opis [description] – opis produktu

Podaj tylko istotne informacje o produkcie. Opisz jego najważniejsze cechy, np. rozmiar, materiał, przedział wiekowy użytkowników, specjalne właściwości lub inne dane techniczne. Uwzględnij również cechy wyglądu, np. kształt, wzór, teksturę i projekt, ponieważ możemy je wykorzystać do wyszukania Twojego produktu.

Zalecana długość opisu to 500–1000 znaków, ale możesz przesłać tekst o długości do 5000 znaków. Opis powinien być zgodny z regułami gramatycznymi i kończyć się kropką.

Kiedy używać: wymagany w przypadku wszystkich produktów w pliku danych.

Typ	Tekst
Limit znaków	5000
Tekst (TSV)	Gładka czerwona pościel na łóżka małżeńskie, wykonana w 100% z włókna poliestrowego, gramatura 150 g/m2. Komplet składa się z prześcieradła na materac, poszwy na kołdrę i 2 standardowych poszewek na poduszki. Można prać w pralce. Prześcieradło pasuje na bardzo grube materace.
XML (pliki danych)	<description>Gładka czerwona pościel na łóżka małżeńskie, wykonana w 100% z włókna poliestrowego, gramatura 150 g/m2. Komplet składa się z prześcieradła na materac, poszwy na kołdrę i 2 standardowych poszewek na poduszki. Można prać w pralce. Prześcieradło pasuje na bardzo grube materace.</description>

Ważne:

• Przestrzegaj ściśle wskazówek redakcyjnych Google. Na przykład nie umieszczaj w opisie żadnych tekstów promocyjnych (typu „Bezpłatna dostawa”), nie używaj w nim samych WIELKICH LITER ani nie przedstawiaj swojej marki lub firmy.
• Poza tym w opisie nie należy umieszczać następujących informacji:
  • linków do swojego sklepu lub innych stron;
  • informacji o zasadach rozliczeń, płatności lub sprzedaży;
  • odniesień do wewnętrznych systemów podziału na kategorie, np. „Gry i zabawki > Zabawki > Lalki bobasy”;
  • porównań z produktami spoza własnej oferty, np. „lepszy/szybszy/większy niż produkt X”;
  • szczegółowych informacji o innych produktach, akcesoriach lub podobnych produktach z własnej oferty.

Link do zdjęcia [image_link] – adres URL zdjęcia produktu

Jest to adres URL głównego zdjęcia produktu (pierwszego, które klienci widzą na stronie produktu).

Jeśli masz wiele różnych zdjęć produktu, prześlij zdjęcie główne za pomocą tego atrybutu, a pozostałe zdjęcia za pomocą atrybutu link do dodatkowego zdjęcia [additional_image_link].

Rozmiar obrazu:

• Użyj pełnowymiarowego zdjęcia produktu, w największej możliwej rozdzielczości, o rozmiarze pliku do 16 MB.
• Zalecany rozmiar zdjęcia to co najmniej 800 × 800 pikseli.
• W przypadku produktów odzieżowych zdjęcie musi mieć co najmniej 250 x 250 pikseli i nie może być większe niż 64 megapiksele. W przypadku wszystkich innych produktów zdjęcie musi mieć co najmniej 100 x 100 pikseli i nie może być większe niż 64 megapiksele.
• Nie używaj małych zdjęć powiększonych do dużego rozmiaru ani miniaturek. Zalecamy, aby produkt zajmował od 75% do 90% powierzchni zdjęcia.

Kiedy używać: wymagany w przypadku wszystkich produktów w pliku danych.

Typ	Adres URL (musi rozpoczynać się od http:// lub https://)
Limit znaków	2000
Tekst (TSV)	http://www.example.com/image1.jpg
XML (pliki danych)	<g:image_link>http://www.example.com/image1.jpg </g:image_link>

Stosując się do poniższych wymagań i zaleceń, możesz poprawić wrażenia klientów.

Wymagania:

• Nie możesz zamieścić produktu bez zdjęcia.
• Niedozwolone są również takie rodzaje zdjęć:
  • Obrazy zastępcze lub zdjęcia niewłaściwych produktów.
  • Zdjęcia, grafika i ilustracje ogólne, które nie przedstawiają rzeczywistego wyglądu produktu. Nie obejmuje to produktów z kategorii „Sprzęt” (632) i „Pojazdy i części” (888) – w ich przypadku dozwolone są ilustracje lub grafika przedstawiające produkt.
  • Jednokolorowe obrazy w formie kwadratu z wyjątkiem produktów z kategorii „Lakiery samochodowe” (3812), „Farby, tusze i laserunki” (505378) oraz „Materiały malarskie” (503740).
  • Zdjęcia zawierające elementy promocyjne, takie jak wezwania do działania (np. „Kup”), informacje dotyczące serwisu (np. o przedłużonej gwarancji), informacje o bezpłatnej dostawie, informacje o cenie, przymiotniki promujące (np. „najlepszy, tani”), informacje o stanie lub zgodności (np. nowy, dwuczęściowy, z możliwością dostosowania), a także zawierające nazwy lub logo sprzedawców, niezależnie od tego, czy elementy te przesłaniają produkt. Dotyczy to również znaków wodnych z elementami promocyjnymi albo nazwami lub logo sprzedawców.
  • Zdjęcia zawierające przeszkadzające elementy (np. znaki wodne, nazwy marek, logo) przesłaniające sprzedawany produkt.
  • Zdjęcia z ramkami.
  • Zdjęcia pakietu nieprzedstawiające go w całości.
  • Zdjęcia opakowania zbiorczego, na których nie widać pojedynczego egzemplarza produktu.
  • Nie są też dozwolone strony docelowe bez zdjęć lub ze zdjęciami zastępczymi, które nie przedstawiają rzeczywistego produktu.
• Sprawdź, czy przesłane zdjęcia poszczególnych produktów odpowiadają wartościom atrybutów kolor [color], wzór [pattern] i materiał [material]. Jeśli tak nie jest, możemy odrzucić Twój produkt.

Zalecenia:

• Jeśli nie masz odpowiednich zdjęć wersji produktów, możesz dodać wersje produktów jako pojedynczy produkt z wieloma wartościami atrybutów wersji i przesłać dostępne zdjęcie.
• Zdjęcie musi przede wszystkim dokładnie przedstawiać produkt – ekspozycja nie powinna być za bardzo „efekciarska”.
• W przypadku wersji produktów różniących się atrybutem kolor do każdej wersji produktu należy przesłać zdjęcie przedstawiające produkt w jednym kolorze.
• Zdjęcie powinno mieć jednolite białe, szare lub jasne tło.
• Główne zdjęcie powinno wyraźnie przedstawiać główny widok produktu. Dodatkowe ujęcia produktu (inne niż na zdjęciu głównym) prześlij za pomocą atrybutu link do dodatkowego zdjęcia [additional_image_link].

Format:

• Akceptowane formaty zdjęć to nieanimowane pliki GIF (.gif), JPEG (.jpg/.jpeg), PNG (.png), BMP (.bmp) i TIFF (.tif/.tiff). Rozszerzenia plików zdjęć powinny odpowiadać ich formatowi.
• Akceptowane protokoły URL: „http” i „https”. Wszelkie symbole używane w linku do zdjęcia muszą zostać zastąpione elementami zakodowanymi na potrzeby adresu URL (np. przecinek = %2C).
• Zalecamy podawanie stałych adresów URL zdjęć i aktualizowanie ich tylko w przypadku zmiany zdjęcia produktu. Jest to szczególnie ważne, gdy hostujesz obrazy w sieci dystrybucji treści, bo pozwala nam prawidłowo indeksować Twoje zdjęcia.

Przycinanie:

Możemy automatycznie przyciąć zdjęcie, aby zwrócić większą uwagę na produkt.

Stan [condition] – stan produktu

Google zezwala na promowanie używanych produktów wysokiej jakości. Dozwolone jest również promowanie przedmiotów odnowionych, o ile nie naruszają one lokalnych przepisów i regulacji prawnych ani naszych zasad.

Ten atrybut może przyjmować tylko 3 wartości:

• Nowy [new]: produkt jest fabrycznie nowy i nigdy nie był używany. Znajduje się w oryginalnym opakowaniu, które nie było otwierane.
• Odnowiony [refurbished]: produkt został profesjonalnie doprowadzony do stanu używalności, jest „jak nowy” i jest objęty gwarancją. Opakowanie nie musi być oryginalne. Takie przedmioty nazywa się też „regenerowanymi”.
• Używany [used]: użyj tego atrybutu, jeśli do danego produktu nie pasują atrybuty „nowy” ani „odnowiony”. Przykładem może być produkt wcześniej używany, ponownie napełniony wkład do drukarki lub produkt z otwartym albo brakującym oryginalnym opakowaniem.

Kiedy używać: ten atrybut jest wymagany, jeśli produkt jest używany lub odnowiony. Opcjonalny w przypadku nowych produktów.

Typ	Tylko 3 dopuszczalne wartości: Nowy [new] Odnowiony [refurbished] Używany [used]
Tekst (TSV)	used
Kod XML	<g:condition>used</g:condition>

Ważne: jeśli nazwy atrybutów podajesz w języku angielskim, podawaj w tym języku również ich wartości.

GTIN [gtin] – globalny numer jednostki handlowej (GTIN) produktu

Użyj atrybutu GTIN do podawania globalnych numerów jednostki handlowej w jednym z następujących formatów:

• UPC (w Ameryce Północnej / GTIN-12): 12-cyfrowy numer – składające się z 8 cyfr kody UPC-E E należy przekonwertować na format 12-cyfrowy.
• EAN (w Europie / GTIN-13): numer składający się z 13 cyfr.
• JAN (w Japonii / GTIN-13): numer składający się z 8 lub 13 cyfr.
• ISBN (dla książek): numer składający się z 10 lub 13 cyfr. Jeśli dysponujesz obydwoma, podaj tylko numer 13-cyfrowy. Numery ISBN-10 nie są już używane – należy je przekonwertować na format ISBN-13.
• ITF-14 (opakowania zbiorcze / GTIN-14): numer składający się z 14 cyfr.

Kiedy używać	Wymagany dla wszystkich nowych produktów z numerem GTIN przypisanym przez producenta
Typ	Numer 8-, 12-, 13- lub 14-cyfrowy (UPC, EAN, JAN lub ISBN)
Limit znaków	50
Tekst rozdzielany tabulatorami	3234567890126
XML (pliki danych)	<g:gtin>3234567890126</g:gtin>

Ważne:

• Akceptujemy wyłącznie poprawne numery GTIN zdefiniowane w oficjalnym przewodniku weryfikacji GS1, który obejmuje następujące wymagania:
  • Suma kontrolna została załączona i jest prawidłowa.
  • GTIN nie jest zastrzeżony (zakres prefiksów GS1: 02, 04, 2).
  • GTIN nie jest kuponem (zakres prefiksów GS1: 98–99).

Marka [brand] – marka produktu

Kiedy używać: wymagana w przypadku wszystkich nowych produktów (poza markami filmów, książek i nagrań muzycznych). Opcjonalna w przypadku wszystkich innych produktów.

Typ	Tekst
Limit znaków	70
Tekst (TSV)	Acme
XML (pliki danych)	<g:brand>Acme</g:brand>

Ważne: nie podawaj nazwy sklepu jako marki, chyba że wytwarzasz produkt.

Certyfikat [certification] – certyfikat produktu

Użyj atrybutu certyfikat [certification], aby dodać informacje o certyfikatach, np. certyfikacie efektywności energetycznej, powiązanych z produktem.

Zastosowanie:

Wymagany w przypadku produktów, które wymagają wyświetlania określonych informacji w reklamach produktowych lub bezpłatnych informacjach, np. ze względu na lokalne przepisy dotyczące etykiety efektywności energetycznej.

Opcjonalny w przypadku wszystkich innych produktów.

Jeśli kierujesz produkty na jeden z krajów członkowskich Unii Europejskiej, EFTA albo Wielką Brytanię, zapoznaj się z przepisami dotyczącymi efektywności energetycznej lub obowiązującymi przepisami lokalnymi, aby sprawdzić, czy musisz podać ten atrybut (np. jeśli produkt jest obecny w bazie danych EPREL).

Może być konieczne wyświetlanie klasy efektywności energetycznej UE w reklamach produktowych i bezpłatnych informacjach. Aby to zrobić, w danych o odpowiednich produktach umieść atrybut certyfikat [certification]. Google wyszuka produkt w bazie danych EPREL Unii Europejskiej i wyrenderuje odpowiednią klasę efektywności energetycznej w formie graficznej lub tekstowej w reklamach produktowych i bezpłatnych informacjach. Przykład:

Uwaga: jeśli nie możesz znaleźć kodu EPREL produktu, ale masz informacje dotyczące efektywności energetycznej produktu tylko w postaci samej oceny, możesz podać wszystkie 3 atrybuty klasa efektywności energetycznej [energy_efficiency_class] do końca okresu wprowadzania zmiany, czyli do 1 września 2024 r.

Atrybuty podrzędne:

• Urząd [certification_authority] (wymagany): organ lub podmiot wydający certyfikat. Obecnie obsługujemy tylko wartości EC lub European_Commission.
• Nazwa [certification_name] (wymagany): nazwa certyfikatu. Obecnie obsługujemy tylko wartość EPREL, która reprezentuje certyfikaty efektywności energetycznej w bazie danych europejskiego rejestru produktów do celów etykietowania energetycznego (EPREL).
• Kod [certification_code] (wymagany): kod certyfikatu. Na przykład w przypadku certyfikatu EPREL z linkiem https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456 kod to 123456.

Typ	Tekst
Tekst (TSV)	EC:EPREL:123456
Plik danych XML	<g:certification>   <g:certification_authority>EC</g:certification_authority>   <g:certification_name>EPREL</g:certification_name>   <g:certification_code>123456</g:certification_code> </g:certification>

Wymagane atrybuty klasy efektywności energetycznej (tylko w krajach należących do UE)

Uwaga: te atrybuty zostaną wycofane 1 września 2024 r. Zamiast tego użyj atrybutu certyfikat [certification], aby wyświetlać klasę efektywności energetycznej UE w reklamach i bezpłatnych informacjach.

Kod EPREL powinien być łatwo dostępny w kodzie QR etykiety energetycznej na produkcie. Jeśli nie możesz go znaleźć, ale masz informacje o efektywności energetycznej produktu dostarczone przez producenta, nadal możesz podać wszystkie 3 atrybuty klasa efektywności energetycznej [energy_efficiency_class] w okresie wprowadzania zmiany, który kończy się 1 września 2024 r.

Klasa efektywności energetycznej [energy_efficiency_class], minimalna klasa efektywności energetycznej [min_energy_efficiency_class], maksymalna klasa efektywności energetycznej [max_energy_efficiency_class]

Ten atrybut umożliwia określenie klasy efektywności energetycznej produktu.

Zastosowanie: zalecamy przesłanie atrybutów klasa efektywności energetycznej, minimalna klasa efektywności energetycznej i maksymalna klasa efektywności energetycznej dla odpowiednich produktów. Być może konieczne będzie podanie tej klasy w przypadku tego typu produktów:

Lodówki	Piekarniki
Zamrażarki	Podgrzewacze wody
Pralki	Bojlery
Suszarki bębnowe	Klimatyzatory
Pralko-suszarki	Lampy elektryczne
Urządzenia do przechowywania wina	Oprawy oświetleniowe
Zmywarki	Telewizory

Typ	Akceptowane wartości: A+++ A++ A+ A B C D E F G
Tekst (TSV)	A+
Przykład w formacie XML	<g:energy_efficiency_class>A+</g:energy_efficiency_class>

Ważne:

• Wartość atrybutu minimalna klasa efektywności energetycznej [min_energy_efficiency_class] musi być mniejsza niż wartość atrybutu maksymalna klasa efektywności energetycznej [max_energy_efficiency_class]. Na przykład Twoja skala musi zaczynać się od A i kończyć na D, a nie odwrotnie.
• Wartość atrybutu klasa efektywności energetycznej [energy_efficiency_class] musi mieścić się w przedziale wyznaczonym przez atrybuty minimalna klasa efektywności energetycznej i maksymalna klasa efektywności energetycznej. Jeśli na przykład zakres mieści się w granicach od A do D, wartość atrybutu klasa efektywności energetycznej nie może wynosić G.

Zalecane atrybuty wykluczenia

Uwaga: poniższe atrybuty są zalecane, jeśli używasz jednego podstawowego pliku danych do przesyłania danych produktów zarówno dla ofert online, jak i ofert lokalnych wyświetlanych w reklamach i bezpłatnych informacjach o produktach.

Możesz użyć atrybutu wykluczone miejsce docelowe [excluded_destination], aby wykluczyć produkty, które nie mają zastosowania do określonego miejsca docelowego. Dzięki temu możesz kontrolować lokalizacje, w których będą wyświetlać się Twoje treści. Możesz na przykład wykorzystać ten atrybut, jeśli chcesz, aby dany produkt wyświetlał się w kampanii reklam produktowych, ale nie w ofertach lokalnych.

Kiedy stosować: zalecane, jeśli chcesz, aby produkty nie wyświetlały się w reklamach i informacjach określonego typu.

Obsługiwane wartości:

• Reklamy produktowe [shopping_ads]. Blokuje wyświetlanie ofert produktu w reklamach produktowych. Więcej informacji o reklamach produktowych
• Reklamy displayowe [display_ads]. Blokuje wyświetlanie ofert produktu w reklamach remarketingu dynamicznego. Więcej informacji o remarketingu dynamicznym dla sklepów
• Reklamy lokalnego asortymentu produktów: [local_inventory_ads]. Blokuje wyświetlanie ofert produktu w reklamach lokalnego asortymentu produktów. Więcej informacji o reklamach lokalnego asortymentu produktów
• Bezpłatne informacje [free_listings]. Blokuje wyświetlanie ofert produktu w bezpłatnych informacjach. Więcej informacji o bezpłatnym wyświetlaniu produktów w Google
• Bezpłatne lokalne informacje [free_local_listings]. Blokuje bezpłatne wyświetlanie ofert produktów dostępnych lokalnie w Google. Więcej informacji o bezpłatnym wyświetlaniu produktów dostępnych lokalnie w Google

Uwaga: niektóre nazwy miejsc docelowych produktów zostały zaktualizowane. Możliwe, że wcześniej zdarzyło Ci się przesyłać te wartości jako miejsca docelowe dla Twoich produktów: Shopping Actions, Surfaces across Google, Local surfaces across Google. Te wartości nadal będą akceptowane, ale zalecamy zaktualizowanie produktów tak, aby zawierały nowe wartości dla tych miejsc docelowych: Buy_on_Google_listings, Free_listings, Free_local_listings.

Format

Przestrzegaj tych wytycznych dotyczących formatowania, abyśmy mogli prawidłowo zinterpretować dane, które przesyłasz.

Obsługiwane wartości	Shopping_ads, Display_ads, Local_inventory_ads, Free_listings, Free_local_listings
Pole powtarzane	Tak

Format pliku	Przykładowa wartość
Pliki danych w formacie tekstowym	display_ads
Pliki danych w formacie XML	<g:excluded_destination>display_ads</g:excluded_destination>

Pola powtarzane

Pliki danych w formacie tekstowym

Aby wskazać wiele miejsc docelowych, które chcesz wykluczyć, prześlij atrybut kilka razy, oddzielnie dla każdego miejsca docelowego (zalecane). Przykład:

Dane produktu: ortopedyczne legowisko dla psa
Atrybut	Wartość
Tytuł [title]	Ortopedyczne legowisko dla psa XXL
Wykluczone miejsce docelowe [excluded_destination]	display_ads
Wykluczone miejsce docelowe [excluded_destination]	shopping_ads

Każde miejsce docelowe możesz też rozdzielić przecinkami ( , ):

display_ads, shopping_ads

Kod XML

Aby przesłać wiele miejsc docelowych, które chcesz wykluczyć, w pliku danych XML dodaj oddzielny atrybut dla każdego wykluczonego miejsca docelowego:

<g:excluded_destination>display_ads</g:excluded_destination>

<g:excluded_destination>shopping_ads</g:excluded_destination>

Więcej informacji dotyczących formatu danych w interfejsie API można znaleźć w artykule na temat Content API for Shopping

Jak dopasowywać atrybuty ze starszej wersji pliku danych o produktach dostępnych lokalnie (opcjonalnie)

Uwaga: informacje opisane poniżej mają zastosowanie tylko wtedy, gdy korzystasz ze starszej wersji pliku danych o produktach dostępnych lokalnie.

Zgodny identyfikator [webitemid] – dopasowanie identyfikatorów online i lokalnych

Jeśli nie możesz dopasować atrybutu identyfikator [id] z pliku danych o produktach dostępnych lokalnie do identyfikatora pliku danych o produktach, możesz użyć zgodnego identyfikatora. Możesz przesłać różne wartości atrybutu identyfikator, ale tę samą wartość atrybutów identyfikator i zgodny identyfikator. Powinna ona być taka sama jak wartość atrybutu identyfikator odpowiedniej wersji w pliku danych o produktach, jeśli taka wersja istnieje.

Atrybut zgodny identyfikator jest używany tylko do dopasowywania, dlatego wiele produktów może mieć ten sam zgodny identyfikator, jeśli odpowiadają temu samemu produktowi w pliku danych o produktach.

Kiedy używać: zalecany w przypadku wszystkich produktów, których wersje online mają identyfikatory lub kody SKU inne niż ich wersje lokalne.

Typ	Tekst (ciąg znaków)
Tekst (TSV)	WB1011
Przykład w formacie XML	<g:webitemid>WB1011</g:webitemid>

Ważne:

• Odstępy na początku i na końcu oraz znaki przejścia do nowej linii (0x0D) są usuwane
• Każda sekwencja znaku przejścia do nowej linii (0x0D) i znaków odstępu (znaków Unicode z cechą odstępu) jest zamieniana na jeden odstęp (0x20).
• Dopuszczalne są tylko prawidłowe znaki Unicode, z wyjątkiem tych znaków:
  • znaki sterujące (poza znakiem przejścia do nowej linii 0x0D),
  • znaki funkcyjne,
  • znaki prywatnego użytku,
  • pary zastępcze,
  • nieprzypisane punkty kodowe (w szczególności wszystkie punkty kodowe większe niż 0x10FFFF).
• Gdy już prześlesz produkt, nie możesz zmieniać atrybutu zgodny identyfikator [webitemid] podczas aktualizowania pliku danych. Tego samego identyfikatora nie można też później użyć dla innego produktu.

GTIN [gtin] – globalny numer jednostki handlowej (GTIN) produktu

Ten atrybut zawiera globalny numer jednostki handlowej (GTIN) Twoich produktów.

Kiedy używać: jeśli sprzedajesz produkty zarówno stacjonarnie, jak i przez internet, i nie możesz korzystać z atrybutu identyfikator [id], musisz użyć atrybutu zgodny identyfikator [webitemid] lub unikalnych identyfikatorów produktów jako atrybutów dopasowania.

Jeżeli dopasowujesz identyfikatory za pomocą unikalnych identyfikatorów produktów, musisz także dodać do pliku danych atrybut stan.

Typ	Tekst (ciąg znaków)
Tekst (TSV)	0606449056822
Przykład w formacie XML	<g:gtin>0606449056822</g:gtin>

MPN [mpn] – numer katalogowy (MPN) produktu

To unikalny numer, który służy producentowi do identyfikowania produktu. Kombinacja marki i numeru MPN wyraźnie określa dany produkt.

Kiedy używać: jeśli sprzedajesz produkty zarówno stacjonarnie, jak i przez internet, i nie możesz korzystać z atrybutu identyfikator [id], musisz użyć atrybutu zgodny identyfikator [webitemid] lub unikalnych identyfikatorów produktów jako atrybutów dopasowania.

Jeżeli dopasowujesz identyfikatory za pomocą unikalnych identyfikatorów produktów, musisz także dodać do pliku danych atrybut stan.

Typ	Tekst (ciąg znaków)
Tekst (TSV)	RND2150
Przykład w formacie XML	<g:mpn>RND2150</g:mpn>

Marka [brand] – marka produktu

Kiedy używać: jeśli sprzedajesz produkty zarówno stacjonarnie, jak i przez internet, i nie możesz korzystać z atrybutu identyfikator [id], musisz użyć atrybutu zgodny identyfikator [webitemid] lub unikalnych identyfikatorów produktów jako atrybutów dopasowania.

Jeżeli dopasowujesz identyfikatory za pomocą unikalnych identyfikatorów produktów, musisz także dodać do pliku danych atrybut stan.

Typ	Tekst (ciąg znaków)
Tekst (TSV)	Netgear
Przykład dla formatu XML	<g:brand>Netgear</g:brand>

Produkty odzieżowe

Produkty odzieżowe wymagają podania kilku dodatkowych atrybutów w podstawowym pliku danych:

Identyfikator grupy produktów [item_group_id] – wspólny identyfikator wszystkich wersji tego samego produktu

Wszystkie wersje jednego produktu muszą mieć tę samą wartość atrybutu identyfikator grupy produktów. Jeśli masz „nadrzędny kod SKU” wspólny dla wszystkich wersji produktu, możesz podać go jako wartość atrybutu identyfikator grupy produktów.

Kiedy używać: atrybyt wymagany w przypadku Brazylii, Francji, Japonii, Niemiec, Stanów Zjednoczonych i Wielkiej Brytanii dla wszystkich produktów z wersjami wykorzystującymi następujące szczegółowe atrybuty produktu: kolor [color], rozmiar [size], wzór [pattern], materiał [material], grupa wiekowa [age_group], płeć [gender], rodzaj rozmiaru [size_type] oraz tabela rozmiarów [size_system]. Zalecany w przypadku wszystkich innych krajów.

Typ	Kod alfanumeryczny
Limit znaków	50
Tekst (TSV)	AB12345
XML (pliki danych)	<g:item_group_id>AB12345</g:item_group_id>

Ważne:

• Atrybut identyfikator grupy produktów [item_group_id] różni się od atrybutu identyfikator [id]. Atrybut identyfikator grupy produktów ma wspólne wartości dla grupy wersji, a atrybut identyfikator powinien zawierać unikalne wartości dla grupy wersji oraz dla wszystkich innych produktów.
• Wartości atrybutu identyfikator grupy produktów powinny być niepowtarzalne i mogą być stosowane tylko w przypadku wersji tego samego produktu.
• Jeśli podasz atrybut identyfikator grupy produktów, automatycznie będziemy szukać atrybutów wersji. Jeśli produkt ma atrybut identyfikator grupy produktów, musi mieć co najmniej 1 szczegółowy atrybut produktu.

Kolor [color] – kolor produktu

Określa dominujące kolory produktu. Jeśli produkt jest wielokolorowy, możesz podać maksymalnie 2 dodatkowe wartości jako kolory uzupełniające:

• Podaj kolory rozdzielone znakiem „/” w kolejności dominacji (najpierw kolor dominujący, a następnie do 2 kolorów uzupełniających). Na przykład czarnym butom z zielonymi akcentami w atrybucie kolor przypisz wartość „czarny/zielony”. W przypadku nieodkształcalnych wyrobów odzieżowych, np. biżuterii czy dodatków drewnianych, dla których odpowiednik koloru stanowi sposób wykończenia lub materiał, możesz jako wartość atrybutu kolor [color] podać nazwę sposobu wykończenia lub nazwę materiału (np. „mahoń”, „stal nierdzewna”, „różowe złoto”).
• Jeśli używasz formatu XML, do wpisania symbolu „/” użyj kodu „#47”.

Kiedy używać: atrybut wymagany w przypadku wszystkich produktów w grupie, które różnią się kolorem, oraz w przypadku wszystkich produktów odzieżowych w plikach danych kierowanych na Brazylię, Francję, Japonię, Niemcy, Stany Zjednoczone i Wielką Brytanię. Zalecany w przypadku wszystkich produktów, dla których kolor jest ważnym, wyróżniającym je atrybutem.

Typ	Tekst
Limit znaków	100
Tekst (TSV)	Czarny
XML (pliki danych)	<g:color>czarny</g:color>

Czego nie należy stosować:

• Wartości kolorów zawierających cyfry (np. „0 2 4 6 8”).
• Wartości kolorów zawierających znaki niealfanumeryczne (np. „#fff000”).
• Wartości kolorów, które są pojedynczymi literami alfabetu łacińskiego (np. „G”). Dozwolone są jednoliterowe wartości kolorów w językach chińskim, japońskim i koreańskim (np. „红”).
• Wartości kolorów, które odsyłają do produktu lub jego zdjęcia (np. „patrz zdjęcie”).
• Wartości opisowych, które nie są prawidłowymi nazwami kolorów (np. wielobarwny, różne, rozmaite, patrz zdjęcie, nd.).
• Wartości kolorów, których nazwy przekraczają 40 znaków.
• Długich wartości kolorów, które łączą nazwy kilku kolorów (np. CzerwonyRóżowyNiebieski). Zamiast tego:
  • Aby wskazać, że jeden produkt (a nie jego wersje) jest wielokolorowy, podaj kolor dominujący, a po nim maksymalnie 2 kolory uzupełniające rozdzielone znakiem „/”. Na przykład zamień CzerwonyRóżowyNiebieski na Czerwony/Różowy/Niebieski.
  • Aby wskazać, że wiele podobnych produktów występuje w wielu kolorach (wersje produktu), podaj je jako osobne produkty o tej samej wartości atrybutu identyfikator grupy produktów i różnych wartościach atrybutu kolor.

Uwaga o nieprawidłowych danych:

• Jeśli podasz wartość koloru, która narusza powyższe reguły składniowe, to po otrzymaniu pliku danych możemy odrzucić cały produkt.
• Regularnie sprawdzamy prawidłowość przesyłanych przez Ciebie atrybutów, w tym koloru. Jeśli podane wartości będą nieprawidłowe, możemy usunąć wszystkie produkty z karty Zakupy.

Ważne:

• Poszczególne wersje produktu różniące się kolorem lub kombinacją kolorów trzeba podawać jako odrębne produkty o wspólnej wartości atrybutu identyfikator grupy produktów.
• Stosuj spójne nazwy kolorów dla wszystkich wersji tego samego produktu, jak również dla wszystkich produktów, które należą do tej samej kategorii.
• Podawane przez Ciebie wartości mogą być wyświetlane klientom, więc zadbaj o to, by były dla nich zrozumiałe.

Rozmiar [size] – rozmiar produktu

Oznacza rozmiar produktu. Aby dokładniej określić rozmiar w przypadku produktów z kategorii „Ubrania i akcesoria”, możesz także przesłać atrybuty rodzaj rozmiaru [size_type] i tabela rozmiarów [size_system].

• Prześlij tylko jeden atrybut dla danego produktu. Jeśli dla tego samego produktu podasz więcej atrybutów rozmiaru, zastosowany zostanie tylko pierwszy z nich. Pozostałe atrybuty rozmiaru zostaną odrzucone i otrzymasz ostrzeżenie.

Kiedy używać: atrybut wymagany w przypadku wszystkich produktów w grupie, które różnią się rozmiarem. Wymagany w przypadku wszystkich produktów odzieżowych, które należą do kategorii produktów „Ubrania i akcesoria > Ubrania” oraz „Ubrania i akcesoria > Buty” w danych produktów kierowanych na Brazylię, Francję, Japonię, Niemcy, Stany Zjednoczone i Wielką Brytanię. Zalecany w przypadku wszystkich produktów, dla których rozmiar jest ważnym, wyróżniającym je atrybutem.

Typ	Tekst Jeśli kierujesz reklamy na Stany Zjednoczone, zapoznaj się z listą rozpoznawanych wartości (tylko USA) W przypadku wszystkich innych krajów sprawdź przykładowe rozmiary.
Limit znaków	100
Tekst (TSV)	XL
XML (pliki danych)	<g:size>XL</g:size>

Ważne:

• W przypadku wersji produktów poszczególne rozmiary i ich zestawienia trzeba podawać jako odrębne produkty o wspólnej wartości atrybutu identyfikator grupy produktów. Więcej informacji o przesyłaniu produktów odzieżowych
• Jeśli podajesz złożone rozmiary, połącz je w jedną wartość (np. „40/86 wysoki” dla obwodu szyi 40 cm, długości rękawa 86 cm i kroju przeznaczonego dla wysokich osób).
• Stosuj spójne wartości rozmiaru dla wszystkich wersji tego samego produktu i wszystkich produktów należących do tej samej kategorii. Na przykład w grupie koszulek używaj rozmiarów „S”, „M” i „L”, a nie „S”, „śr.” i „duży”.
• Jeśli nie masz osobnych zdjęć różnych wersji rozmiarów, możesz użyć tego samego zdjęcia. Zalecamy jednak, aby atrybut link [link] prowadził do strony, na której określa się wszystkie szczegóły danej wersji produktu.
• Podawane przez Ciebie wartości mogą być wyświetlane klientom, więc zadbaj o to, by były dla nich zrozumiałe.
• Możesz podać dodatkowe informacje na temat rozmiaru w ciągu tekstowym. Możesz na przykład wpisać „Dzieci, EU 16” lub „Noworodek, 9 cm”.
• Jeśli produkt ma rozmiar uniwersalny, możesz w tym atrybucie użyć wyrażenia „jeden rozmiar”, „R.U.” lub „rozmiar uniwersalny”.

Przykładowe wartości rozmiaru

W przypadku wielu rodzajów produktów odzieżowych wartości rozmiaru mogą być trudne do określenia. Nie jest wymagane podawanie dokładnie takich wartości, ale mogą Ci one posłużyć za wskazówkę przy samodzielnym ustalaniu spójnych wartości rozmiaru produktów odzieżowych. Aby dokładniej określić rozmiar, możesz także użyć atrybutów rodzaj rozmiaru [size_type] i tabela rozmiarów [size_system].

Góry, odzież wierzchnia i sukienki

XXS, XS, S, M, L, XL, 1XL, 2XL, 3XL, 4XL, 5XL, 6XL
00, 0, 02, 04, 06, 08, 10, 12, 14, 16, 18, 20, 22, 24, 26, 28, 30, 32, 34

Doły

XXS, XS, S, M, L, XL, 1XL, 2XL, 3XL, 4XL, 5XL, 6XL
00, 0, 02, 04, 06, 08, 10, 12, 14, 16, 18, 20, 22, 24, 26, 28, 30, 32, 34
23, 24, 26, 27, 28, 29, 30, 32, 34, 36, 38, 40, 42, 44
Spodnie: 24x30, 24x32, 24x34

Duży damski, mały damski, duży, wysoki, wewnętrzna długość nogawki itd.

• Jeśli dany produkt należy do grupy rozmiarów specjalnych, np. duży damski, mały damski, odzież ciążowa lub duży rozmiar dla wysokich, użyj atrybutu rodzaj rozmiaru [size_type]
• Jeśli dla danego wyrobu określona jest wewnętrzna długość nogawki, podaj ją np. w następujący sposób: 30 krótka, 30 zwykła, 30 długa

Buty

• Stany Zjednoczone: 5, 5.5, 6, 6.5, 7, 7.5, 8, 8.5, 9, 9.5, 10, 10.5, 11, 11.5, 12, 12.5, 13, 13.5, 14, 14.5, 15, 15.5, 16.
• Europa: 37, 38, 39, 40, 41, 42, 43, 44, 45.

Uwaga: jeśli obuwie jest dostępne w różnych rozmiarach szerokości, zalecane jest stosowanie następującego oznaczenia: 9.5 M, 8 W, 12 N.

Płeć [gender] – płeć, dla której jest przeznaczony dany produkt

Kiedy używać: atrybut wymagany w przypadku wszystkich produktów w grupie, które są przeznaczone dla różnych płci, oraz w przypadku wszystkich produktów odzieżowych w plikach danych kierowanych na Brazylię, Francję, Japonię, Niemcy, Stany Zjednoczone i Wielką Brytanię. Zalecany w przypadku wszystkich produktów, dla których płeć użytkownika jest ważnym, wyróżniającym je atrybutem.

Format	Tylko 3 dopuszczalne wartości: male (męski) female (damski) unisex (uniseks)
Tekst (TSV)	male
XML (pliki danych)	<g:gender>male</g:gender>

Uwaga

• Jeśli nazwy atrybutów podajesz w języku angielskim, podawaj w tym języku również ich wartości.
• Ten atrybut jest zalecany (lecz niewymagany) dla następujących podkategorii z działu Ubrania i akcesoria: „przypinki”, „spinki do krawatów”, „opaski na rękę”, „ochraniacze na buty”, „sznurowadła”, „ostrogi” i „paski do zegarków”.

Grupa wiekowa [age_group] – docelowa grupa wiekowa, dla której jest przeznaczony dany produkt

Użyj atrybutu grupa wiekowa, aby wskazać wiek osób, dla których przeznaczony jest produkt.

Kiedy używać: atrybut wymagany w przypadku wszystkich produktów w grupie, które są przeznaczone dla różnych grup wiekowych, oraz w przypadku wszystkich produktów odzieżowych w plikach danych kierowanych na Brazylię, Francję, Japonię, Niemcy, Stany Zjednoczone i Wielką Brytanię. Zalecany w przypadku wszystkich produktów, dla których docelowa grupa wiekowa jest ważnym, wyróżniającym je atrybutem.

Format	Ten atrybut może przyjmować tylko 5 wartości: Noworodki [newborn] Niemowlęta [infant] 1–5 lat [toddler] Dzieci [kids] Dorośli [adult]
Tekst (TSV)	adult
XML (pliki danych)	<g:age_group>adult</g:age_group>

Ważne:

• Oto opis grup docelowych określanych tymi atrybutami:
  • Noworodki [newborn]: do 3 miesiąca życia. Rozmiary odzieży dla noworodków są często określane miesiącem życia (0–3) lub pojedynczą wartością „noworodki” [newborn].
  • Niemowlęta [infant]: od 3 do 12 miesiąca życia. Rozmiary odzieży dla niemowląt są często określane miesiącem życia (3–12).
  • 1–5–lat [toddler]: od 1 do 5 roku życia. Rozmiary odzieży dla dzieci są określane miesiącem (12–24) lub rokiem (1–5) życia.
  • Dzieci [kids]: od 5 do 13 roku życia. Wszystkie rozmiary w tej grupie są przeznaczone dla dzieci w tym przedziale wiekowym.
  • Dorośli [adult]: odzież dla nastolatków i dorosłych. Wszystkie rozmiary w tej grupie są przeznaczone dla nastolatków i dorosłych.
• Jeśli nazwy atrybutów podajesz w języku angielskim, podawaj w tym języku również ich wartości.
• Ten atrybut jest zalecany (lecz niewymagany) dla następujących podkategorii z działu Ubrania i akcesoria: „przypinki”, „spinki do krawatów”, „opaski na rękę”, „ochraniacze na buty”, „sznurowadła”, „ostrogi” i „paski do zegarków”.
• Jeśli produkt wyraźnie nie jest przeznaczony tylko dla dzieci, powinien mieć wartość „dorośli” [adult], ponieważ każdy atrybut może mieć tylko jedną wartość.

Atrybuty ceny (opcjonalne)

Jest też kilka opcjonalnych atrybutów, które możesz przesłać, jeżeli mają zastosowanie w Twoim przypadku.

Cena [price] – domyślna cena produktu w danym kraju

Jeśli cena produktu jest taka sama w różnych sklepach, użyj tego atrybutu, aby przesłać cenę domyślną. Prześlij tę cenę, jeśli cena produktu jest taka sama w przypadku wszystkich sklepów lub jeśli wdrażasz funkcję lokalnej witryny sklepowej sprzedawcy w wersji podstawowej.

W przeciwnym razie wszystkie ceny, które podasz w pliku danych o asortymencie produktów dostępnych lokalnie, zastąpią tę wartość atrybutu.

Jeśli wdrażasz funkcję lokalnej witryny sklepowej sprzedawcy (wersja podstawowa), atrybuty cena są wymagane i muszą odpowiadać cenie na stronie docelowej.

Uwaga: Google zakłada, że cena została podana w walucie kraju, w którym znajduje się sklep. Jeśli waluta jest ustawiona na poziomie produktu, musi ona być zgodna z normą ISO 4217.

Kiedy używać: atrybut zalecany w przypadku wszystkich produktów.

Typ	Cena (liczba zmiennoprzecinkowa)
Tekst (TSV)	299.99 PLN
Przykład dla formatu XML	<g:price>299,99</g:price>

Cena promocyjna [sale_price] – reklamowana obniżona cena produktu

Ten atrybut służy do podawania reklamowanej ceny danego produktu w wyprzedaży.

Zalecamy przesłanie atrybutu okres obowiązywania ceny promocyjnej [sale_price_effective_date] w przypadku wszystkich produktów, dla których obowiązują ceny promocyjne, ponieważ będzie on określać, kiedy cena promocyjna powinna zacząć obowiązywać. Jeśli atrybut okres obowiązywania ceny promocyjnej nie zostanie podany, obniżona cena będzie obowiązywać dla danego produktu tak długo, jak jest on zawarty w pliku danych.

Zastosowanie: atrybut zalecany dla wszystkich produktów oferowanych po obniżonej cenie.

Typ	Liczba
Tekst (TSV)	249.99
Przykład dla formatu XML	<g:sale_price>249.99</g:sale_price>j

Okres obowiązywania ceny promocyjnej [sale_price_effective_date] – zakres dat, w którym produkt jest oferowany po obniżonej cenie

Używaj w połączeniu z atrybutem cena promocyjna [sale_price]. Wskazuje on daty, w których obowiązuje cena promocyjna. Więcej informacji o definicjach cen promocyjnych

Uwaga: strefa czasowa jest opcjonalna. Aby dodać strefę czasową, wpisz + lub - liczbę godzin i minut w stosunku do godziny UTC (na przykład -08:00 w przypadku PST). Jeśli nie podasz żadnej strefy czasowej, Google dla każdego sklepu przyjmie strefę czasową UTC. Do określania godziny stosuje się system 24-godzinny.

Typ	Daty rozpoczęcia i zakończenia rozdzielone ukośnikiem (/). Rozpoczęcie to data w formacie RRRR-MM-DD z następującą po niej literą „T”, wskazującą godzinę, od której produkt będzie dostępny, oraz określeniem strefy czasowej wg normy ISO 8601. Datę zakończenia należy podać w takim samym formacie. Jeśli strefa czasowa nie została określona, przyjmuje się strefę UTC.
Tekst (TSV)	Przykłady w strefie UTC: 2021-07-19T17:00:00/2021-07-27T05:00:00 Przykład w strefie PST: 2021-07-19T09:00:00-08:00/2021-07-26T21:00:00-08:00
Kod XML	<g:sale_price_effective_date>2021-07-19T17:00:00/2021-07-27T05:00:00</g:sale_price_effective_date>

Miara ceny jednostkowej [unit_pricing_measure] – określanie miary i wymiarów produktu

Atrybut miara ceny jednostkowej [unit_pricing_measure] pozwala określić miarę i rozmiar produktu. Ta wartość mówi klientom, jaki jest dokładny koszt jednostkowy Twojego produktu.

Zastosowanie: opcjonalny dla każdego produktu, chyba że jest wymagany przez przepisy obowiązujące w danym kraju.

Typ	Liczba dodatnia i jednostka
Tekst (TSV)	1.5 kg
Przykład dla formatu XML	<g:unit_pricing_measure>1,5 kg</g:unit_pricing_measure>

Podstawowa miara ceny jednostkowej [unit_pricing_base_measure] – zawiera mianownik ceny jednostkowej

Miara produktu będąca podstawą do wyceny (na przykład 100 ml oznacza, że cena jest obliczana na podstawie jednostki 100 mililitrów). Jeśli używasz atrybutu miara ceny jednostkowej [unit_pricing_measure], użyj atrybutu podstawowa miara ceny jednostkowej, aby określić mianownik ceny jednostkowej. Aby ułatwić porównywanie cen jednostkowych we wszystkich reklamach i bezpłatnych lokalnych informacjach na stronie, można wyświetlać inną miarę podstawową niż podana tutaj.

Zastosowanie: opcjonalny, chyba że jest wymagany przez przepisy obowiązujące w danym kraju.

Typ	Liczba całkowita + jednostka
Tekst (TSV)	100 g
Przykład dla formatu XML	<g:unit_pricing_base_measure>100 g</g:unit_pricing_base_measure>

Atrybuty odbioru w sklepie (opcjonalne)

Możesz zaznaczyć, że oferujesz także możliwość odbioru produktów w sklepie. Wystarczy, że dodasz do pliku danych te 2 atrybuty. Dodaj te atrybuty do podstawowego pliku danych w przypadku wszystkich produktów, dla których ustawiono wartość prawda we wszystkich sklepach (np. klient może odebrać telewizor XYZ w każdym z Twoich sklepów na obszarze całego kraju).

Metoda odbioru [pickup_method] – opcja odbioru produktu w sklepie

Ważne: od 1 września 2024 r. atrybut metoda odbioru [pickup_method] nie będzie już wymagany, aby umożliwić odbiór w sklepie w przypadku Twoich ofert.

Określ, czy w przypadku tej oferty opcja odbioru w sklepie jest dostępna i czy opcja odbioru powinna być wyświetlana jako kup, zarezerwuj, odbiór osobisty w sklepie lub nieobsługiwany.

• Kup [buy]: cała transakcja jest dokonywana online
• Zarezerwuj [reserve]: produkt jest rezerwowany online, a transakcja jest dokonywana w sklepie.
• Odbiór osobisty w sklepie [ship_to_store]: produkt jest kupowany online i wysyłany do odbioru w sklepie.
• Nieobsługiwany [not_supported]: produkt nie jest dostępny do odbioru w sklepie.

Typ	Tekst (ciąg znaków). Musi być jedną z wymienionych powyżej wartości.
Tekst (TSV)	buy
Przykład w formacie XML	<g:pickup_method>buy</g:pickup_method>

Gwarantowana dostępność produktu do odbioru [pickup_sla] – czas, w którym produkt jest dostępny do odbioru w sklepie

Określ przewidywaną datę, kiedy zamówienie będzie gotowe do odbioru, w zależności od daty złożenia zamówienia.

• Tego samego dnia [same_day]: produkt jest dostępny do odbioru w określonych godzinach tego samego dnia, w którym zostało złożone zamówienie.
• Następnego dnia [next_day]: produkt jest dostępny do odbioru następnego dnia po złożeniu zamówienia.
• 2 dni [2_day]: produkt zostanie wysłany do sklepu i klient będzie mógł go odebrać za 2 dni.
• 3 dni [3_day]: produkt zostanie wysłany do sklepu i klient będzie mógł go odebrać za 3 dni.
• 4 dni [4_day]: produkt zostanie wysłany do sklepu i klient będzie mógł go odebrać za 4 dni.
• 5 dni [5_day]: produkt zostanie wysłany do sklepu i klient będzie mógł go odebrać za 5 dni.
• 6 dni [6_day]: produkt zostanie wysłany do sklepu i klient będzie mógł go odebrać za 6 dni.
• 7 dni [7_day]: produkt zostanie wysłany do sklepu i klient będzie mógł go odebrać za 7 dni.
• Ponad tydzień [multi_week]: produkt zostanie wysłany do sklepu i klient będzie mógł go odebrać za ponad tydzień.

Typ	Tekst (ciąg znaków). Musi być jedną z wymienionych powyżej wartości.
Tekst (TSV)	same_day
Przykład w formacie XML	<g:pickup_sla>same_day</g:pickup_sla>

Atrybuty lokalnej witryny sklepowej sprzedawcy (opcjonalne)

Aby korzystać z lokalnej witryny sklepowej sprzedawcy, dodaj do podstawowego pliku danych atrybuty przekierowanie z reklam [ads_redirect] i link do lokalnej witryny sklepowej sprzedawcy [link_template]. Możesz też dodać opcjonalny atrybut link mobilny do lokalnej witryny sklepowej sprzedawcy [mobile_link_template], aby zoptymalizować lokalną witrynę sklepową sprzedawcy pod kątem urządzeń mobilnych i śledzić kliknięcia na urządzeniach mobilnych.

Link [link]

Jeśli klient kliknie reklamę lub wyznaczoną bezpłatną informację, a na Twoim koncie włączona jest funkcja lokalna witryna sklepowa sprzedawcy (w ramach podstawowej implementacji), zostanie odesłany na stronę docelową produktu w Twojej witrynie. Podaj adres URL strony docelowej za pomocą atrybutu link [link].

Ważne:

• Użyj nazwy zweryfikowanej domeny.
• Rozpocznij od http lub https.
• Użyj zakodowanego adresu URL zgodnego ze standardem RFC 2396 lub RFC 1738. Np. przecinek będzie w nim przedstawiony jako „%2C”.
• Nie podawaj linków do strony pełnoekranowej, o ile nie wymagają tego przepisy.

Typ	Adres URL (musi rozpoczynać się od http:// lub https://)
Tekst (TSV)	http://mikemart.com/123
Kod XML	<g:link>http://mikemart.com/123</g:link>

Link do lokalnej witryny sklepowej sprzedawcy [link_template]

Jeśli klient kliknie reklamę lub bezpłatne informacje, a na Twoim koncie włączona jest funkcja lokalna witryna sklepowa sprzedawcy (w ramach pełnej implementacji), zostanie odesłany na stronę docelową produktu w Twojej witrynie. Podaj adres URL strony docelowej za pomocą atrybutu link do lokalnej witryny sklepowej sprzedawcy [link_template].

Ważne:

• Podaj parametr ValueTrack kodu sklepu {[store_code]}. Różne witryny mają różną strukturę adresów URL. Kodami sklepów mogą być parametry adresu URL lub część ścieżki adresu URL.
• Prześlij adres URL witryny do weryfikacji i zgłoś do niego prawa. Pamiętaj, by adres URL witryny zarejestrowanej w Merchant Center odpowiadał domenie podanej w szablonie linku. Jeśli adres URL witryny nie odpowiada zarejestrowanej domenie, dowiedz się, jak rozwiązać ten problem.
• Podaj parametry śledzenia adresu URL wyłącznie dla atrybutu przekierowanie z reklam [ads_redirect].

Typ	Adres URL (musi rozpoczynać się od http:// lub https://)
Tekst (TSV)	http://mikemart.com/123?store={store_code}
Kod XML	<g:link_template>http://mikemart.com/123?store={store_code}</g:link_template>

Link mobilny do lokalnej witryny sklepowej sprzedawcy [mobile_link_template]

Jeśli klient kliknie reklamę lub bezpłatne informacje, a na Twoim koncie włączona jest funkcja lokalna witryna sklepowa sprzedawcy (w ramach pełnej implementacji), zostanie odesłany na stronę docelową produktu w Twojej witrynie.

Atrybut link mobilny do lokalnej witryny sklepowej sprzedawcy [mobile_link_template] pozwala umieścić adres URL do strony docelowej w wersji mobilnej. Adres ten będzie wyświetlany użytkownikom urządzeń mobilnych, takich jak telefony czy tablety.

Ważne:

• Podaj parametr ValueTrack kodu sklepu {[store_code]}. Różne witryny mają różną strukturę adresów URL. Kodami sklepów mogą być parametry adresu URL lub część ścieżki adresu URL.
• Prześlij adres URL witryny do weryfikacji i zgłoś do niego prawa. Pamiętaj, aby adres URL witryny zarejestrowanej w Merchant Center odpowiadał domenie podanej w atrybucie link do lokalnej witryny sklepowej sprzedawcy [link_template]. Jeśli adres URL witryny nie odpowiada zarejestrowanej domenie, dowiedz się, jak rozwiązać ten problem.
• Podaj parametry śledzenia adresów URL wyłącznie dla atrybutu przekierowanie z reklam [ads_redirect].

Typ	Adres URL (musi rozpoczynać się od http:// lub https://)
Tekst (TSV)	http://mikemart.com/123?store={store_code}
Kod XML	<g:mobile_link_template>http://mikemart.com/123?store={store_code}</g:mobile_link_template>

Przekierowanie z reklam [ads_redirect]

Jeśli na Twoim koncie włączona jest funkcja lokalnej witryny sklepowej sprzedawcy, gdy klienci klikną Twoją reklamę, zostaną przekierowani na stronę docelową, na której znajdą produkt.

Użyj atrybutu przekierowanie z reklam, za pomocą którego podajesz parametry śledzenia ułatwiające uzyskanie informacji o ruchu na stronie docelowej.

Ważne:

• Podaj parametr ValueTrack kodu sklepu {[store_code]}. Różne witryny mają różną strukturę adresów URL. Kodami sklepów mogą być parametry adresu URL lub część ścieżki adresu URL.
• Prześlij adres URL witryny do weryfikacji i zgłoś do niego prawa. Pamiętaj, by adres URL witryny zarejestrowanej w Merchant Center odpowiadał domenie podanej w szablonie linku. Jeśli adres URL witryny nie odpowiada zarejestrowanej domenie, dowiedz się, jak rozwiązać ten problem.
• Po skonfigurowaniu tego atrybutu klient, który kliknie reklamę, trafi na stronę podaną w atrybucie przekierowanie z reklam [ads_redirect] zamiast na stronę podaną w atrybucie link do lokalnej witryny sklepowej sprzedawcy [link_template] lub link mobilny do lokalnej witryny sklepowej sprzedawcy [mobile_link_template].

Typ	Adres URL (musi rozpoczynać się od http:// lub https://)
Tekst (TSV)	http://mikemart.com/123?store={store_code}
Kod XML	<g:ads_redirect>http://mikemart.com/123?store={store_code}</g:ads_redirect>

Atrybuty dodatkowe (opcjonalne)

Aby zamieścić więcej szczegółów w reklamach i informacjach o produktach, prześlij dodatkowe dane w podstawowym pliku danych. Wszystkie atrybuty znajdziesz w specyfikacji danych produktów.