Jak pisać wartości product_detail i product_highlight akceptowane przez Google – z przykładowymi wierszami feedu

Atrybut Google product_detail przyjmuje do 100 wpisów na produkt, każdy o długości od 1 do 150 znaków, a product_highlight wymaga co najmniej 2 i zaleca od 4 do 6 krótkich opisów korzyści na produkt – wynika to ze specyfikacji Google: product detail i product highlight. Oba atrybuty są opcjonalne, więc większość feedów je pomija albo wkleja do nich tabelę specyfikacji, którą Merchant Center oznacza jako źle sformatowaną.

Google twierdzi, że product_detail pomaga wyświetlać produkty na powierzchniach AI, takich jak AI Mode, a w maju 2026 r. dodał kolejne atrybuty konwersacyjne oparte na tym samym pomyśle.

Ten przewodnik jest przeznaczony dla osób zarządzających feedami i agencji, które wysyłają dane produktowe do Google Merchant Center. Po jego lekturze będziesz umieć zapisać oba atrybuty w TSV i XML, poprawnie escapować znaki, które je psują, unikać zakazanych treści i oceniać wiersz przed wysłaniem.

Do czego służą product_detail i product_highlight

Oba atrybuty wyglądają podobnie i często są wypełniane z tego samego źródła, ale Google przypisuje im różne zadania. product_detail zawiera techniczne, weryfikowalne specyfikacje, których nie obejmuje żaden inny atrybut: zawartość opakowania, łączność, skład, wymagania zasilania, wykończenie, zapach i podobne fakty. product_highlight zawiera krótkie korzyści sprzedażowe zapisane zwykłymi zdaniami.

Nasz szybki test: jeśli linijka pasuje do tabeli specyfikacji z etykietą i wartością, to jest to product_detail. Jeśli brzmi jak zdanie, które powiedziałby sprzedawca w sklepie, to jest to product_highlight. Specyfikacja highlightów Google wprowadza ten sam podział i prosi, by nie powtarzać treści z jednego atrybutu w drugim.

Specyfikacja w skrócie

To limity w takiej postaci, w jakiej Google publikuje je obecnie. Google nie podaje właściwości schema.org dla product_detail, więc atrybut nie jest pobierany z oznaczeń danych strukturalnych; musi znaleźć się w feedzie.

Źródła: Pomoc Google Merchant Center, Product detail [product_detail] i Product highlight [product_highlight].

Jak zapisać product_detail w TSV, XML i Merchant API

To format jest miejscem, w którym wywala się najwięcej wierszy. Każdy szczegół to trzy wartości połączone dwoma dwukropkami, w kolejności: nazwa sekcji, nazwa atrybutu, wartość atrybutu. Google wyraźnie zaznacza, że w feedach tekstowych każdy szczegół musi mieć dwa dwukropki, a podanie innej liczby podatrybutów niż deklaruje nagłówek skutkuje problemem „nieprawidłowy format podatrybutu” w sekcji „Wymaga uwagi”.

Nagłówek TSV i pojedyncza komórka

Zadeklaruj podatrybuty w nagłówku kolumny, w nawiasach i oddzielone dwukropkami. Gdy są nazwane w nagłówku, wartości mogą następować w dowolnej zadeklarowanej przez Ciebie kolejności. Bez deklaracji Google zakłada kolejność: sekcja, nazwa, wartość.

product_detail(section_name:attribute_name:attribute_value)

Komórka z trzema szczegółami wygląda wtedy tak:

General:Brew type:Turkish coffee,General:Capacity:4 cups,Power:Rated power:1000 W

Jeśli szczegół nie ma sekcji, zachowaj początkowy dwukropek i zostaw pierwsze pole puste:

:What's in the box?:"Machine,Measuring spoon,User manual"

Escapowanie dwukropków, przecinków i cudzysłowów

Zasady Google dotyczące atrybutów w cudzysłowie obowiązują dla atrybutów grupowych, takich jak ten:

• Każdą wartość podatrybutu zawierającą przecinek lub dwukropek ujmij w proste cudzysłowy podwójne. Cytuj pojedynczą wartość, nie całą grupę.
• Dosłowny cudzysłów podwójny zapisz jako dwa cudzysłowy podwójne. Przykład Google to "APS-C max. 12""" dla wartości kończącej się znakiem cala.
• Nie używaj escapowania ukośnikiem wstecznym. Google traktuje ukośnik wsteczny jak zwykły znak.
• Pola w cudzysłowie nie są obsługiwane w źródłach danych Arkuszy Google. W przypadku istniejących źródeł plikowych pola w cudzysłowie trzeba włączyć w konfiguracji źródła danych.

XML

W XML każdy szczegół jest osobnym elementem z trzema elementami potomnymi, więc nie trzeba escapować dwukropków ani przecinków:

<g:product_detail><g:section_name>Materials</g:section_name><g:attribute_name>Body</g:attribute_name><g:attribute_value>Stainless steel, BPA-free plastic</g:attribute_value></g:product_detail>

W kategoriach z dużą liczbą specyfikacji XML jest bezpieczniejszym formatem, bo naturalne przecinki i dwukropki przestają być ryzykiem dla parsowania.

Merchant API

W Merchant API każdy szczegół jest obiektem ProductDetail z polami sectionName, attributeName i attributeValue, zgodnie z dokumentacją klienta API.

Jak pisać product_highlight

Highlighty są prostsze: jeden ciąg znaków na highlight. W feedzie tekstowym oddzielaj highlighty przecinkami, a każdy highlight zawierający przecinek lub dwukropek ujmij w cudzysłowy podwójne. W XML każdy highlight otrzymuje własny element <g:product_highlight>.

"Brews up to 4 cups in one cycle","Foam sensor stops brewing before the pot overflows","Switches off automatically after brewing","Stainless steel body wipes clean"

Każdy highlight ogranicz do jednej korzyści. Google oczekuje profesjonalnego, poprawnego gramatycznie języka, bez wyróżnień wielkimi literami, symboli i sformułowań promocyjnych.

Treści, których Google nie dopuszcza w żadnym z atrybutów

Błędy formatowania powodują widoczne komunikaty. Błędy treści są cichsze: wiersz może zostać zaakceptowany i mimo to naruszać zasady. Ta tabela łączy zakazy z obu specyfikacji.

Google dodaje jeszcze jedną łatwą do przeoczenia zasadę: jeśli przesyłasz pliki document_link, które już zawierają te same informacje, pomiń je w tych atrybutach i pozwól Google wydobyć je z dokumentów.

Przykład krok po kroku: tabela specyfikacji zamieniona w zaakceptowane wiersze

Poniżej typowy wiersz ze sklepu, który eksportuje specyfikacje produktów jako jedno pole z dowolnym tekstem. Produktem jest elektryczny ekspres do kawy po turecku; sklep sprzedaje w Turcji oraz po angielsku na rynkach Zatoki Perskiej.

Przed

product_detail: Brand: Acme, Power: 1000W, Material: Stainless Steel, Plastic, FREE SHIPPING, best turkish coffee maker cheap

Pięć problemów w jednej komórce. Separatory są pomieszane, więc liczba dwukropków nie zgadza się z nagłówkiem. „Stainless Steel, Plastic” nie jest ujęte w cudzysłów, więc jego przecinek dzieli szczegół. Brand dubluje atrybut brand. „FREE SHIPPING” to tekst o wysyłce zapisany wielkimi literami. Ostatni fragment to ciąg słów kluczowych.

Po, feed angielski

General:Brew type:Turkish coffee,General:Capacity:4 cups,Power:Rated power:1000 W,Materials:Body:"Stainless steel, BPA-free plastic",Safety:Automatic shut-off:Yes,:What's in the box?:"Machine,Measuring spoon,User manual"

Brand przeniesiono do własnego atrybutu, wysyłkę do shipping, słowa kluczowe usunięto, wartości zapisano zgodnie z zaleceniem Google (wielka litera tylko na początku zdania), a każdą wartość z przecinkiem ujęto w cudzysłów. „Automatic shut-off: Yes” zostaje, bo potwierdza to producent; pole, które Twoja platforma domyślnie ustawia na „No”, już by nie zostało.

Po, feed turecki

Google prosi o lokalizację nazw sekcji, nazw atrybutów i wartości w feedzie każdego języka, więc feed turecki dostaje własny wiersz zamiast angielskiego:

Genel:Demleme türü:Türk kahvesi,Genel:Kapasite:4 fincan,Güç:Nominal güç:1000 W,Malzeme:Gövde:"Paslanmaz çelik, BPA içermeyen plastik",:Kutu içeriği:"Makine,Ölçü kaşığı,Kullanım kılavuzu"

Dwie uwagi regionalne dla zespołów spoza Turcji. Po pierwsze, zachowaj tureckie litery. Zalecenie Google dotyczące ASCII to preferencja, nie wymóg, a specyfikacja highlightów wprost dopuszcza litery z akcentami; transliteracja „Paslanmaz çelik” na „Paslanmaz celik” daje błąd ortograficzny, co koliduje z wytycznymi Google dotyczącymi gramatyki i pisowni. Po drugie, jeśli reguła zamienia te wartości na małe litery lub stosuje wielką literę tylko na początku zdania, musi uwzględniać ustawienia regionalne, aby „İ” i „I” nie zamieniły się w niewłaściwe litery – problem ten omówiliśmy w naszym przewodniku o wielkości liter w tytułach po turecku.

Jak budować wartości na podstawie katalogu

Wypełniamy te atrybuty w czterech przebiegach, w tej kolejności.

1. Najpierw zmapuj źródła ustrukturyzowane. Wypisz każdą specyfikację, którą Twoja platforma już przechowuje jako parę etykieta–wartość, np. zakładkę ze specyfikacją, metapole lub atrybut z ERP. Każda para staje się jednym product_detail, a grupa źródłowa – section_name. Użyj warstwy feedu, takiej jak Feed Rules lub feed uzupełniający, aby katalog źródłowy pozostał nietknięty, a wyjście dla Google mogło różnić się od innych kanałów.
2. Usuń wszystko, co należy do innego atrybutu. Usuń linie z marką, kolorem, rozmiarem, materiałem, ceną i wysyłką, jeśli są już w dedykowanych atrybutach. Następnie usuń każdy szczegół, którego tekst pojawia się już w tytule lub opisie.
3. Pisz highlighty ręcznie lub na podstawie zweryfikowanych szkiców AI. Highlighty to miejsce, w którym wzbogacanie przez AI pomaga najbardziej, ale też zawodzi najczęściej. Model chętnie napisze „Ideal gift for coffee lovers”, co jest promocyjne, albo wymyśli funkcję, której produkt nie ma. Generuj szkice wyłącznie na podstawie potwierdzonych specyfikacji i sprawdzaj je z powyższą tabelą zakazów.
4. Zweryfikuj długość i składnię przed eksportem. Sprawdź, czy każdy szczegół i każdy highlight ma 150 znaków lub mniej, czy każdy szczegół ma dokładnie dwa dwukropki poza cudzysłowem oraz czy liczba highlightów na produkt wynosi co najmniej 2.

Skala oceny do zastosowania przed wysyłką

Oceń próbkę 20 wierszy na kategorię. Każda kontrola kończy się wynikiem zaliczone (1) lub niezaliczone (0), co daje maksymalnie 10 punktów na wiersz. Za gotowe uznajemy 9 lub 10 punktów, 7 lub 8 oznacza „popraw, potem wysyłaj”, a wynik niższy to sygnał, że dane źródłowe wymagają pracy, zanim te atrybuty będzie warto wysyłać.

Gdzie ten przewodnik się kończy

Nie wiemy, jak bardzo te atrybuty wpływają na pozycję czy współczynnik klikalności. Google mówi, że product_detail pomaga wyświetlać produkty dla trafnych zapytań, w tym w AI Mode, ale nie publikuje żadnych liczb, a my nie widzieliśmy kontrolowanego, publicznego badania. Procentom podawanym przez dostawców podchodź z rezerwą, dopóki nie towarzyszy im metodologia.

To jest przewodnik po Google. Specyfikacja feedu produktowego OpenAI nie ma ogólnego pola klucz–wartość dla specyfikacji ani pola highlightów; używa płaskich pól, takich jak material, dimensions i weight, oraz opisu do 5000 znaków. Jeśli wysyłasz również ten feed, specyfikacje trzeba zmapować do tych pól lub do opisu. Nie sprawdzaliśmy odpowiedników w Meta ani TikTok na potrzeby tego przewodnika.

Pomija on także nowsze atrybuty konwersacyjne, takie jak question_and_answer i document_link, poza powyższą regułą dotyczącą nakładania się treści. Kilku dostawców narzędzi do feedów, w tym Channable i Productsup, opublikowało przewodniki po mapowaniu tych atrybutów wcześniej niż my i warto je przeczytać, jeśli potrzebujesz tego zestawu już teraz.

Wreszcie, jeśli Twój katalog nie ma ustrukturyzowanych specyfikacji, ta metoda ich nie stworzy, a szkice AI bez potwierdzonego źródła to dokładnie to, czemu ma zapobiegać zasada Google „przesyłaj tylko potwierdzone wartości”.

Najczęściej zadawane pytania

Czy product_detail jest wymagany w Google Merchant Center?

Nie. Google wymienia go jako opcjonalny dla każdego produktu. Warto go dodać tam, gdzie masz zweryfikowane specyfikacje, których nie obejmuje żaden inny atrybut, ponieważ Google twierdzi, że pomaga on produktom pojawiać się dla trafnych zapytań, także w AI Mode.

Ile highlightów produktu powinienem przesłać?

Google wymaga co najmniej 2, dopuszcza do 100 i zaleca od 4 do 6 na produkt. Każdy highlight może mieć do 150 znaków.

Dlaczego Merchant Center pisze, że mój product_detail ma nieprawidłowy format podatrybutu?

Liczba podatrybutów w wartości nie zgadza się z nagłówkiem – zwykle dlatego, że w szczegółowym wpisie brakuje dwukropka albo nieujęty w cudzysłów przecinek lub dwukropek wewnątrz wartości ją podzielił. Ujmij w cudzysłów każdą wartość zawierającą te znaki i zachowaj dwa dwukropki na szczegół.

Czy w tureckim feedzie używać tureckich znaków?

Tak. Google akceptuje Unicode i zaleca ASCII jedynie jako preferencję, a jego wytyczne dla highlightów dopuszczają litery z akcentami i wymagają poprawnej pisowni. Usuwanie tureckich liter tworzy błędnie napisane słowa.

Czy AI może pisać moje highlighty produktów?

Może przygotować szkice, ale tylko na podstawie potwierdzonych przez Ciebie specyfikacji, a każdy szkic należy sprawdzić pod kątem sformułowań promocyjnych, porównań i wymyślonych funkcji. Google zakazuje dwóch pierwszych w highlightach, a wymyślona funkcja to po prostu fałszywe dane produktowe.

Czy Arkusze Google obsługują wartości product_detail w cudzysłowie?

Nie. Wytyczne Google dotyczące atrybutów w cudzysłowie mówią, że pola w cudzysłowie nie są obsługiwane w źródłach danych Arkuszy Google, więc wartości specyfikacji z przecinkami lub dwukropkami lepiej wysyłać przez plik TSV, XML lub Merchant API.

Sprawdź swój feed, zanim dodasz te atrybuty

Te atrybuty pomagają tylko wtedy, gdy pola, na których się opierają, są czyste. Przepuść swój feed przez bezpłatne narzędzie do audytu feedu produktowego, aby zobaczyć kompletność, jakość i problemy techniczne dla każdego produktu, zanim zaczniesz pisać szczegóły i highlighty.