Google'ın Kabul Edeceği product_detail ve product_highlight Değerlerini Yazma: Örnek Feed Satırlarıyla

Google'ın kendi product detail ve product highlight spesifikasyonlarına göre, product_detail özniteliği ürün başına en fazla 100 girdi kabul eder ve her girdi 1 ila 150 karakter uzunluğunda olabilir. product_highlight ise ürün başına en az 2, önerilen olarak 4 ila 6 kısa fayda ifadesi ister. İkisi de isteğe bağlıdır; bu yüzden çoğu feed bunları atlar ya da Merchant Center'ın hatalı biçimlendirilmiş olarak işaretlediği bir özellik tablosunu olduğu gibi yapıştırır.

Google, product_detail özniteliğinin ürünlerin AI Mode gibi yapay zeka yüzeylerinde görünmesine yardımcı olduğunu söylüyor. Mayıs 2026'da aynı fikir üzerine daha fazla konuşma tabanlı öznitelik ekledi.

Bu referans, ürün verisini Google Merchant Center'a gönderen feed yöneticileri ve ajanslar için hazırlandı. Sonunda her iki özniteliği de TSV ve XML'de yazabilecek, onları bozan karakterleri kaçışlayabilecek, yasaklı içeriği dışarıda tutabilecek ve göndermeden önce bir satırı puanlayabileceksiniz.

product_detail ve product_highlight ne işe yarar?

İki öznitelik birbirine benzer görünür ve çoğu zaman aynı kaynaktan doldurulur, ancak Google bunlara farklı görevler verir. product_detail, başka bir öznitelikle karşılanmayan teknik ve doğrulanabilir özellikleri taşır: paket içeriği, bağlantı seçenekleri, içindekiler, güç gereksinimleri, yüzey işlemi, koku ve benzeri bilgiler. product_highlight ise düz cümleler olarak yazılmış kısa satış faydalarını taşır.

Pratik testimiz şu: satır etiket ve değer içeren bir özellik tablosuna uyuyorsa product_detail'dir. Bir mağaza çalışanının söyleyeceği bir cümle gibi okunuyorsa product_highlight'tır. Google'ın highlight spesifikasyonu da aynı ayrımı yapar ve birini diğerinin içinde tekrar etmemenizi ister.

Spesifikasyona genel bakış

Aşağıdakiler, Google'ın bugün yayımladığı sınırlardır. Google, product_detail için herhangi bir schema.org özelliği listelemez; dolayısıyla yapılandırılmış veri işaretlemenizden alınmaz, feed'in içinde yer almalıdır.

Kaynaklar: Google Merchant Center Yardım, Product detail [product_detail] ve Product highlight [product_highlight].

product_detail TSV, XML ve Merchant API'de nasıl yazılır?

Satırların çoğu biçimde hata verir. Her detay, iki iki nokta üst üste ile birleştirilmiş üç değerden oluşur ve sıra şöyledir: bölüm adı, öznitelik adı, öznitelik değeri. Google, metin feed'lerinde her detayın iki iki nokta üst üste içermesi gerektiğini ve başlıkta tanımladığınızdan farklı sayıda alt öznitelik göndermenin "Dikkat gerekiyor" altında geçersiz alt öznitelik biçimi sorunu doğurduğunu açıkça belirtir.

TSV başlığı ve tek bir hücre

Alt öznitelikleri sütun başlığında, parantez içinde ve iki nokta üst üste ile ayırarak tanımlayın. Başlıkta adlandırıldıktan sonra değerler, tanımladığınız sırayla gelebilir. Tanım yapılmazsa Google sırayı bölüm, ad, değer olarak varsayar.

product_detail(section_name:attribute_name:attribute_value)

Üç detay içeren bir hücre şöyle görünür:

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

Bir detayın bölümü yoksa baştaki iki nokta üst üsteyi koruyun ve ilk alanı boş bırakın:

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

İki nokta üst üste, virgül ve tırnak işaretlerini kaçışlama

Google'ın tırnak içine alınmış öznitelikler kuralları, bunun gibi grup özniteliklerine uygulanır:

• Virgül veya iki nokta üst üste içeren her alt öznitelik değerini düz çift tırnak içine alın. Tüm grubu değil, tek tek değeri tırnaklayın.
• Düz bir çift tırnağı iki çift tırnak olarak yazın. Google'ın kendi örneği, inç işaretiyle biten bir değer için "APS-C max. 12""" biçimindedir.
• Ters eğik çizgiyle kaçışlama kullanmayın. Google ters eğik çizgiyi düz bir karakter olarak okur.
• Tırnak içine alınmış alanlar Google Sheets veri kaynaklarında desteklenmez. Mevcut dosya kaynaklarında, tırnaklı alanların veri kaynağı kurulumunda açılması gerekir.

XML

XML'de her detay üç alt öğeye sahip kendi öğesidir; bu nedenle iki nokta üst üste veya virgül kaçışlamaya gerek yoktur:

<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>

Özellik yoğun kategorilerde XML daha güvenli bir biçimdir; çünkü doğal virgüller ve iki nokta üst üste artık bir ayrıştırma riski olmaktan çıkar.

Merchant API

Merchant API üzerinden her detay, sectionName, attributeName ve attributeValue alanlarına sahip bir ProductDetail nesnesidir; bkz. API istemci referansı.

product_highlight nasıl yazılır?

Highlight'lar daha basittir: her highlight için tek bir metin dizesi. Bir metin feed'inde highlight'ları virgülle ayırın ve virgül ya da iki nokta üst üste içeren her highlight'ı çift tırnak içine alın. XML'de her highlight'a kendi <g:product_highlight> öğesini verin.

"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"

Her birini tek bir faydayla sınırlı tutun. Google; profesyonel, dil bilgisi açısından doğru bir dil ister. Tamamı büyük harfli vurgu, sembol ve promosyon ifadeleri kullanılmamalıdır.

Google'ın her iki özniteliğe de izin vermediği içerikler

Biçim hataları görünür hatalara yol açar. İçerik hataları ise daha sessizdir: bir satır kabul edilse bile politikayı ihlal edebilir. Bu tablo, iki spesifikasyondaki yasakları bir araya getirir.

Google gözden kaçması kolay bir kural daha ekler: aynı bilgiyi zaten içeren document_link dosyaları gönderiyorsanız, bu bilgiyi bu özniteliklerin dışında bırakın ve Google'ın bunu belgelerden çıkarmasına izin verin.

Uygulamalı örnek: özellik tablosundan kabul edilen satırlara

Aşağıda, ürün özelliklerini tek bir serbest metin alanı olarak dışa aktaran bir mağazadan tipik bir satır yer alıyor. Ürün bir elektrikli Türk kahvesi makinesi; mağaza Türkiye'de ve Körfez pazarlarına İngilizce olarak satış yapıyor.

Önce

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

Tek hücrede beş sorun var. Ayırıcılar karışık olduğu için iki nokta üst üste sayısı başlıkla uyuşmuyor. "Stainless Steel, Plastic" tırnaksız olduğundan virgülü detayı bölüyor. Brand, brand özniteliğini tekrar ediyor. "FREE SHIPPING" büyük harfle yazılmış bir kargo metni. Son parça ise bir anahtar kelime dizisi.

Sonra, İngilizce feed

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"

Marka kendi özniteliğine taşındı, kargo bilgisi shipping özniteliğine taşındı, anahtar kelimeler silindi, değerler Google'ın önerdiği gibi cümle düzeninde yazıldı ve virgül içeren her değer tırnak içine alındı. "Automatic shut-off: Yes" kaldı, çünkü üretici bunu doğruluyor; platformunuzun varsayılan olarak "No" yaptığı bir alan kalmazdı.

Sonra, Türkçe feed

Google, bölüm adlarının, öznitelik adlarının ve değerlerin her dildeki feed'de yerelleştirilmesini ister; bu yüzden Türkçe feed, İngilizce satır yerine kendi satırını alır:

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"

Türkiye dışındaki ekipler için iki bölgesel not. Birincisi, Türkçe harfleri koruyun. Google'ın ASCII önerisi bir tercihtir, zorunluluk değildir ve highlight spesifikasyonu aksanlı harflere açıkça izin verir. "Paslanmaz çelik" ifadesini "Paslanmaz celik" olarak harf dönüştürmek yazım hatası üretir ve bu, Google'ın dil bilgisi ve yazım yönergeleriyle çelişir. İkincisi, bir kural bu değerleri küçük harfe çeviriyor veya cümle düzenine sokuyorsa, "İ" ve "I" harflerinin yanlış harflere dönüşmemesi için yerel ayara duyarlı harf büyüklüğü kullanması gerekir. Bu sorunu Türkçe başlık harf düzeni rehberimizde ele almıştık.

Değerleri kataloğunuzdan nasıl oluşturursunuz?

Bu öznitelikleri şu sırayla dört geçişte dolduruyoruz.

1. Önce yapılandırılmış kaynakları eşleyin. Platformunuzun zaten etiket ve değer çifti olarak sakladığı tüm özellikleri listeleyin; örneğin bir özellik sekmesi, bir metafield ya da bir ERP özniteliği. Her çift bir product_detail olur ve kaynak grup section_name olarak kullanılır. Kaynak katalog dokunulmadan kalsın ve Google çıktısı diğer kanallardan farklı olabilsin diye feed kuralları veya ek feed gibi bir feed katmanı kullanın.
2. Başka bir özniteliğe ait olan her şeyi kaldırın. Marka, renk, beden, malzeme, fiyat ve kargo satırları zaten kendi özel özniteliklerinde yer alıyorsa çıkarın. Ardından metni başlıkta veya açıklamada zaten geçen her detayı da çıkarın.
3. Highlight'ları elle ya da gözden geçirilmiş AI taslaklarıyla yazın. Highlight'lar, AI ile zenginleştirmenin en çok işe yaradığı ve en çok başarısız olduğu yerdir. Bir model "Kahve severler için ideal hediye" gibi promosyon niteliğinde bir ifadeyi ya da üründe olmayan bir özelliği rahatça yazabilir. Taslakları yalnızca doğrulanmış özelliklerden üretin ve yukarıdaki yasak tablosuna göre gözden geçirin.
4. Dışa aktarmadan önce uzunluğu ve sözdizimini doğrulayın. Her detayın ve her highlight'ın 150 karakter veya daha kısa olduğunu, her detayın tırnaksız tam olarak iki iki nokta üst üste içerdiğini ve ürün başına highlight sayısının en az 2 olduğunu kontrol edin.

Göndermeden önce uygulayacağınız bir puanlama ölçütü

Her kategoriden 20 satırlık bir örneklemi puanlayın. Her kontrol geçti (1) veya kaldı (0) olarak değerlendirilir; satır başına en fazla 10 puan alınır. 9 veya 10'u hazır, 7 veya 8'i düzelt-sonra-gönder, daha düşüğünü ise bu özniteliklerin göndermeye değmesi için kaynak verinin üzerinde çalışılması gerektiğinin işareti sayıyoruz.

Bu rehberin yetersiz kaldığı noktalar

Bu özniteliklerin sıralamayı veya tıklama oranını ne kadar etkilediğini bilmiyoruz. Google, product_detail özniteliğinin ürünlerin ilgili sorgularda, AI Mode dahil, görünmesine yardımcı olduğunu söylüyor ancak bir rakam yayımlamıyor ve kontrollü bir kamuya açık çalışma görmedik. Yöntem sunmayan satıcı yüzdelerine şüpheyle yaklaşın.

Bu bir Google referansıdır. OpenAI'ın ürün feed spesifikasyonu, genel bir anahtar-değer özellik alanına veya highlight alanına sahip değildir; material, dimensions ve weight gibi düz alanların yanı sıra 5.000 karakterlik bir açıklama kullanır. O feed'i de gönderiyorsanız, özelliklerinizin bu alanlara ya da açıklamaya eşlenmesi gerekir. Bu rehber için Meta veya TikTok karşılıklarını doğrulamadık.

Rehber ayrıca, yukarıdaki örtüşme kuralı dışında question_and_answer ve document_link gibi daha yeni konuşma tabanlı öznitelikleri kapsam dışında bırakır. Channable ve Productsup dahil birçok feed sağlayıcısı bu öznitelikler için eşleme rehberlerini bizden önce yayımladı; o seti şimdi kullanmanız gerekiyorsa okumaya değer.

Son olarak, kataloğunuzda yapılandırılmış özellikler yoksa bu yöntem onları yaratamaz; doğrulanmış bir kaynağı olmayan AI taslakları ise Google'ın "yalnızca doğrulanmış değerleri gönderin" kuralının engellemek için var olduğu şeydir.

Sık sorulan sorular

product_detail Google Merchant Center'da zorunlu mu?

Hayır. Google bunu her ürün için isteğe bağlı olarak listeler. Başka hiçbir özniteliğin kapsamadığı, doğrulanmış özelliklere sahip olduğunuz yerlerde eklemeye değer; çünkü Google bunun ürünlerin AI Mode dahil ilgili sorgularda görünmesine yardımcı olduğunu söylüyor.

Kaç ürün highlight'ı göndermeliyim?

Google en az 2 highlight ister, en fazla 100'e izin verir ve ürün başına 4 ila 6 önerir. Her highlight en fazla 150 karakter olabilir.

Merchant Center neden product_detail özniteliğimin geçersiz alt öznitelik biçimine sahip olduğunu söylüyor?

Bir değerdeki alt öznitelik sayısı başlıkla uyuşmuyordur; bunun nedeni genellikle bir detayda iki nokta üst üstenin eksik olması ya da bir değerin içindeki tırnaksız bir virgül veya iki nokta üst üstenin detayı bölmesidir. Bu karakterleri içeren her değeri tırnak içine alın ve detay başına iki iki nokta üst üste kullanın.

Türkçe bir feed'de Türkçe karakterler kullanmalı mıyım?

Evet. Google Unicode'u kabul eder ve ASCII'yi yalnızca bir tercih olarak önerir; highlight yönergesi ise aksanlı harflere izin verir ve doğru yazım ister. Türkçe harfleri silmek yanlış yazılmış kelimeler oluşturur.

Ürün highlight'larımı AI yazabilir mi?

Taslak hazırlayabilir, ancak yalnızca doğruladığınız özelliklerden yararlanarak; ayrıca her taslak promosyon ifadeleri, karşılaştırmalar ve uydurulmuş özellikler açısından kontrol edilmelidir. Google highlight'larda ilk ikisini yasaklıyor, uydurulmuş bir özellik ise doğrudan yanlış ürün verisidir.

Google Sheets tırnak içine alınmış product_detail değerlerini destekliyor mu?

Hayır. Google'ın tırnak içine alınmış öznitelikler rehberi, tırnaklı alanların Google Sheets veri kaynaklarında desteklenmediğini belirtir; bu nedenle virgül veya iki nokta üst üste içeren özellik değerlerini bir TSV dosyası, XML ya da Merchant API ile göndermek daha doğrudur.

Bu öznitelikleri eklemeden önce feed'inizi kontrol edin

Bu öznitelikler yalnızca dayandıkları alanlar temizse işe yarar. Detay ve highlight yazmaya başlamadan önce ürün bazında eksiksizlik, kalite ve teknik sorunları görmek için feed'inizi ücretsiz ürün feed'i denetim aracından geçirin.