كتابة قيم product_detail وproduct_highlight التي تقبلها Google، مع صفوف خلاصة منتجات تطبيقية

تقبل سمة product_detail من Google ما يصل إلى 100 إدخال لكل منتج، بطول يتراوح من 1 إلى 150 حرفًا لكل إدخال، بينما تطلب سمة product_highlight عبارتين على الأقل وتوصي بما بين 4 و6 عبارات قصيرة عن المزايا لكل منتج، وذلك وفق مواصفات Google نفسها: product detail وproduct highlight. السمتان اختياريتان، ولذلك تتجاهلهما معظم الخلاصات أو تلصق فيهما جدول مواصفات يصنّفه Merchant Center على أنه سيئ التنسيق.

تقول Google إن product_detail تساعد المنتجات على الظهور في واجهات الذكاء الاصطناعي مثل AI Mode، وقد أضافت في مايو 2026 المزيد من السمات الحوارية المبنية على الفكرة نفسها.

هذا المرجع موجّه إلى مديري الخلاصات والوكالات التي ترسل بيانات المنتجات إلى Google Merchant Center. وبنهايته ستتمكنون من كتابة السمتين بصيغتي TSV وXML، وتهريب الأحرف التي تتسبب في أعطالهما، وتجنّب المحتوى المحظور، وتقييم الصف قبل إرساله.

الغرض من product_detail وproduct_highlight

تبدو السمتان متشابهتين وغالبًا ما تُملآن من المصدر نفسه، لكن Google تسند إلى كل منهما وظيفة مختلفة. تحمل product_detail مواصفات تقنية قابلة للتحقق لا تغطيها سمة أخرى: محتويات العبوة، والاتصال، والمكوّنات، ومتطلبات الطاقة، والتشطيب، والرائحة، وما شابهها من الحقائق. أما product_highlight فتحمل مزايا بيعية قصيرة مكتوبة بجمل بسيطة.

اختبارنا السريع: إذا كان السطر يصلح لجدول مواصفات بعنوان وقيمة، فهو product_detail. وإذا كان يُقرأ كجملة يقولها موظف المبيعات في المتجر، فهو product_highlight. ومواصفات Google الخاصة بـ highlight تقيم الفصل نفسه وتطلب ألا تكرروا إحداهما في الأخرى.

المواصفات في لمحة

هذه هي الحدود كما تنشرها Google اليوم. لا تذكر Google أي خاصية schema.org مقابلة لـ product_detail، لذلك لا تُلتقط من ترميز البيانات المهيكلة لديكم؛ بل يجب أن تكون في الخلاصة.

المصادر: مركز مساعدة Google Merchant Center، Product detail [product_detail] وProduct highlight [product_highlight].

كيفية كتابة product_detail بصيغتي TSV وXML وفي Merchant API

الصيغة هي النقطة التي تفشل عندها معظم الصفوف. يتكوّن كل تفصيل من ثلاث قيم تربطها نقطتان رأسيتان، بالترتيب: اسم القسم، ثم اسم السمة، ثم قيمة السمة. وتؤكد Google أن كل تفصيل في الخلاصات النصية يجب أن يحتوي على نقطتين رأسيتين، وأن إرسال عدد من السمات الفرعية يختلف عما يعلنه الترويس يؤدي إلى مشكلة «تنسيق سمة فرعية غير صالح» ضمن «يتطلب الانتباه».

ترويس TSV وخلية واحدة

أعلنوا السمات الفرعية في ترويس العمود، بين قوسين وتفصل بينها نقطتان رأسيتان. وبمجرد تسميتها في الترويس يمكن أن تأتي القيم بأي ترتيب أعلنتموه. وبدون هذا الإعلان تفترض Google الترتيب: القسم، ثم الاسم، ثم القيمة.

product_detail(section_name:attribute_name:attribute_value)

وتبدو الخلية التي تحتوي على ثلاثة تفاصيل هكذا:

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

إذا لم يكن للتفصيل قسم، فأبقوا النقطتين الرأسيتين في البداية واتركوا الحقل الأول فارغًا:

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

تهريب النقطتين الرأسيتين والفواصل وعلامات الاقتباس

تنطبق قواعد Google الخاصة بـالسمات المقتبسة على سمات المجموعات مثل هذه:

• ضعوا أي قيمة سمة فرعية تحتوي على فاصلة أو نقطتين رأسيتين بين علامتي اقتباس مزدوجتين مستقيمتين. اقتبسوا القيمة المفردة، لا المجموعة كلها.
• اكتبوا علامة الاقتباس المزدوجة الحرفية كعلامتين مزدوجتين. ومثال Google نفسها هو "APS-C max. 12""" لقيمة تنتهي بعلامة البوصة.
• لا تستخدموا التهريب بالشرطة المائلة العكسية. فـ Google تقرأ الشرطة المائلة العكسية كحرف حرفي.
• الحقول المقتبسة غير مدعومة في مصادر بيانات Google Sheets. وبالنسبة لمصادر الملفات الحالية، يجب تفعيل الحقول المقتبسة في إعداد مصدر البيانات.

XML

في XML يكون كل تفصيل عنصرًا مستقلًا بثلاثة عناصر فرعية، لذلك لا حاجة إلى تهريب النقطتين الرأسيتين أو الفواصل:

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

في الفئات الغنية بالمواصفات، تُعدّ XML الصيغة الأكثر أمانًا لأن الفواصل والنقطتين الرأسيتين الطبيعية تتوقف عن كونها خطرًا على التحليل.

Merchant API

عبر Merchant API، يكون كل تفصيل كائن ProductDetail بحقول sectionName وattributeName وattributeValue، بحسب مرجع عميل API.

كيفية كتابة product_highlight

النقاط البارزة أبسط: نص واحد لكل نقطة. في الخلاصة النصية، افصلوا النقاط البارزة بفواصل وضعوا أي نقطة تحتوي على فاصلة أو نقطتين رأسيتين بين علامتي اقتباس مزدوجتين. وفي XML، خصصوا لكل نقطة بارزة عنصر <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"

اجعلوا كل نقطة تقتصر على ميزة واحدة. تطلب Google لغة احترافية سليمة نحويًا، دون تأكيد بالأحرف الكبيرة كلها، ودون رموز، ودون صياغة ترويجية.

المحتوى الذي لا تسمح به Google في أي من السمتين

أخطاء التنسيق تُنتج أخطاء ظاهرة. أما أخطاء المحتوى فهي أهدأ: قد يُقبل الصف ومع ذلك يخالف السياسة. يجمع هذا الجدول المحظورات الواردة في المواصفتين معًا.

تضيف Google قاعدة أخرى يسهل إغفالها: إذا كنتم ترسلون ملفات document_link التي تحتوي بالفعل على المعلومات نفسها، فاتركوها خارج هاتين السمتين ودعوا Google تستخرجها من المستندات.

مثال تطبيقي: جدول مواصفات يتحول إلى صفوف مقبولة

فيما يلي صف نموذجي من متجر يصدّر مواصفات منتجاته في حقل نصي حر واحد. المنتج آلة قهوة تركية كهربائية؛ ويبيع المتجر في تركيا وبالإنجليزية في أسواق الخليج.

قبل

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

خمس مشكلات في خلية واحدة. الفواصل مختلطة، لذلك لا يطابق عدد النقطتين الرأسيتين الترويس. وعبارة «Stainless Steel, Plastic» غير مقتبسة، فتقسم فاصلتها التفصيل. والعلامة التجارية تكرر السمة brand. وعبارة «FREE SHIPPING» نص شحن بأحرف كبيرة. والجزء الأخير سلسلة كلمات مفتاحية.

بعد، الخلاصة الإنجليزية

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"

انتقلت العلامة التجارية إلى سمتها الخاصة، وانتقل الشحن إلى shipping، وحُذفت الكلمات المفتاحية، وجاءت القيم بحالة الجملة كما توصي Google، واقتُبست كل قيمة تحتوي على فاصلة. وتبقى «Automatic shut-off: Yes» لأن الشركة المصنّعة تؤكدها؛ أما حقل تكون قيمته الافتراضية في منصتكم «No» فلن يُدرج.

بعد، الخلاصة التركية

تطلب Google توطين أسماء الأقسام وأسماء السمات والقيم في خلاصة كل لغة، ولذلك تحصل الخلاصة التركية على صفها الخاص بدلًا من الصف الإنجليزي:

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"

نقطتان إقليميتان للفرق خارج تركيا. أولًا، احتفظوا بالحروف التركية. فتوصية Google باستخدام ASCII تفضيل لا شرط، كما أن مواصفات highlight لديها تسمح صراحةً بالحروف ذات العلامات؛ وتحويل «Paslanmaz çelik» إلى «Paslanmaz celik» ينتج خطأً إملائيًا يتعارض مع إرشادات Google في القواعد والإملاء. ثانيًا، إذا كانت قاعدة ما تحوّل هذه القيم إلى أحرف صغيرة أو إلى حالة الجملة، فهي تحتاج إلى معالجة حالة الأحرف بحسب اللغة المحلية حتى لا يتحول «İ» و«I» إلى الحرفين الخطأ، وهي مشكلة تناولناها في دليلنا لحالة أحرف العناوين التركية.

كيفية بناء القيم من الكتالوج لديكم

نملأ هاتين السمتين على أربع مراحل، بهذا الترتيب.

1. ابدؤوا بالمصادر المهيكلة. أدرجوا كل مواصفة تخزنها منصتكم أصلًا كزوج من عنوان وقيمة، مثل تبويب المواصفات أو metafield أو سمة في ERP. يتحول كل زوج إلى product_detail واحد، مع جعل مجموعة المصدر هي section_name. استخدموا طبقة خلاصة مثل Feed Rules أو خلاصة تكميلية حتى يبقى كتالوج المصدر دون مساس ويمكن أن يختلف ناتج Google عن القنوات الأخرى.
2. أزيلوا كل ما تملكه سمة أخرى. احذفوا أسطر العلامة التجارية واللون والمقاس والمادة والسعر والشحن إذا كانت موجودة أصلًا في سماتها المخصصة. ثم احذفوا أي تفصيل يظهر نصه أصلًا في العنوان أو الوصف.
3. اكتبوا النقاط البارزة يدويًا أو بمسودات ذكاء اصطناعي تمت مراجعتها. النقاط البارزة هي المكان الذي يفيد فيه إثراء الذكاء الاصطناعي أكثر ويخفق فيه أكثر. فالنموذج سيكتب بسهولة «هدية مثالية لعشاق القهوة»، وهي صياغة ترويجية، أو يخترع ميزة لا يملكها المنتج. أنتجوا المسودات من مواصفات مؤكدة فقط، وراجعوها وفق جدول المحظورات أعلاه.
4. تحققوا من الطول والصيغة قبل التصدير. تأكدوا من أن كل تفصيل وكل نقطة بارزة لا يتجاوز 150 حرفًا، وأن كل تفصيل يحتوي على نقطتين رأسيتين غير مقتبستين بالضبط، وأن عدد النقاط البارزة لكل منتج لا يقل عن 2.

معيار تقييم تُجرونه قبل الإرسال

قيّموا عينة من 20 صفًا لكل فئة. كل فحص إما نجاح (1) أو إخفاق (0)، بحد أقصى 10 لكل صف. نعدّ 9 أو 10 جاهزًا، و7 أو 8 يحتاج إلى إصلاح ثم الإرسال، وأي نتيجة أقل مؤشرًا على أن بيانات المصدر تحتاج إلى عمل قبل أن يكون إرسال هاتين السمتين مجديًا.

أين يصل هذا الدليل إلى حدوده

لا نعرف مقدار تأثير هاتين السمتين في الترتيب أو معدل النقر. تقول Google إن product_detail تساعد المنتجات على الظهور للاستعلامات ذات الصلة، بما في ذلك في AI Mode، لكنها لا تنشر أي رقم، ولم نطلع على دراسة عامة مضبوطة. تعاملوا بحذر مع النسب التي يذكرها الموردون ما لم تأتِ مصحوبة بمنهجية.

هذا مرجع خاص بـ Google. فـمواصفات خلاصة المنتجات لدى OpenAI لا تتضمن حقلًا عامًا للمواصفات بنظام المفتاح والقيمة ولا حقلًا للنقاط البارزة؛ فهي تستخدم حقولًا مسطحة مثل material وdimensions وweight، إضافةً إلى وصف يصل إلى 5,000 حرف. وإذا كنتم ترسلون تلك الخلاصة أيضًا، فيجب ربط مواصفاتكم بتلك الحقول أو بالوصف بدلًا من ذلك. لم نتحقق من مكافئات Meta أو TikTok لهذا الدليل.

كما يستثني الدليل السمات الحوارية الأحدث، مثل question_and_answer وdocument_link، باستثناء قاعدة التداخل المذكورة أعلاه. وقد نشرت عدة جهات موردة للخلاصات، منها Channable وProductsup، أدلة ربط لتلك السمات قبلنا، وهي جديرة بالقراءة إذا كنتم تحتاجون إلى تلك المجموعة الآن.

وأخيرًا، إذا لم يكن في كتالوجكم مواصفات مهيكلة، فلا يمكن لهذه الطريقة أن تنشئها، ومسودات الذكاء الاصطناعي دون مصدر مؤكد هي ما وُضعت قاعدة Google «أرسلوا القيم المؤكدة فقط» لمنعه.

الأسئلة الشائعة

هل product_detail مطلوبة في Google Merchant Center؟

لا. تصنّفها Google اختيارية لكل منتج. وتستحق الإضافة حيثما تتوافر لديكم مواصفات موثّقة لا تغطيها أي سمة أخرى، لأن Google تقول إنها تساعد المنتجات على الظهور للاستعلامات ذات الصلة، بما في ذلك في AI Mode.

كم عدد النقاط البارزة للمنتج التي ينبغي إرسالها؟

تشترط Google نقطتين على الأقل وتسمح بما يصل إلى 100، وتوصي بما بين 4 و6 لكل منتج. ويمكن أن يصل طول كل نقطة بارزة إلى 150 حرفًا.

لماذا يعرض Merchant Center أن product_detail لدي ذات تنسيق سمة فرعية غير صالح؟

عدد السمات الفرعية في القيمة لا يطابق الترويس، وغالبًا لأن تفصيلًا ينقصه نقطتان رأسيتان أو لأن فاصلة أو نقطتين رأسيتين غير مقتبستين داخل قيمة قسّمتاه. اقتبسوا أي قيمة تحتوي على هذه الأحرف وأبقوا نقطتين رأسيتين لكل تفصيل.

هل ينبغي استخدام الحروف التركية في خلاصة تركية؟

نعم. تقبل Google الأحرف بصيغة Unicode وتوصي بـ ASCII كتفضيل فقط، بينما تسمح إرشاداتها الخاصة بالنقاط البارزة بالحروف ذات العلامات وتطلب إملاءً صحيحًا. وحذف الحروف التركية ينتج كلمات بأخطاء إملائية.

هل يمكن للذكاء الاصطناعي كتابة النقاط البارزة لمنتجاتي؟

يمكنه كتابة مسودات لها، لكن من مواصفات أكدتموها فقط، ويجب فحص كل مسودة للتأكد من خلوها من الصياغة الترويجية والمقارنات والميزات المخترعة. وتحظر Google الأولين في النقاط البارزة، أما الميزة المخترعة فهي ببساطة بيانات منتج خاطئة.

هل يدعم Google Sheets قيم product_detail المقتبسة؟

لا. تنص إرشادات Google حول السمات المقتبسة على أن الحقول المقتبسة غير مدعومة في مصادر بيانات Google Sheets، لذلك يُفضَّل إرسال قيم المواصفات التي تحتوي على فواصل أو نقطتين رأسيتين عبر ملف TSV أو XML أو Merchant API.

افحصوا الخلاصة قبل إضافة هاتين السمتين

لا تفيد هاتان السمتان إلا إذا كانت الحقول التي تقوم عليها نظيفة. مرّروا خلاصتكم عبر أداة تدقيق خلاصة المنتجات المجانية للاطلاع على مشكلات الاكتمال والجودة والمشكلات التقنية لكل منتج قبل البدء في كتابة التفاصيل والنقاط البارزة.