يمكنك مشاركة ملف مع Merchant Center يحتوي على جميع بيانات المنتجات المحلّية. حسب الإعداد الذي تختاره، يمكنك مزامنة بيانات منتجاتك في Merchant Center مع ملف بيانات المنتجات تلقائيًا. إذا سبق لك تقديم ملف يحتوي على جميع بيانات المنتجات، يمكنك استخدام الملف نفسه من أجل "إعلانات المنتجات المتوفّرة في المتجر" و"البيانات المحلية المجانية".
نتناول في هذه المقالة ما يلي:
- مصدر بيانات المنتج
- إرسال مصدر بيانات المنتج
- ملخّص متطلبات السمات
- سمات التعريف المطلوبة
- سمات "فئة كفاءة استهلاك الطاقة" المطلوبة (في الاتحاد الأوروبي فقط)
- سمات الاستبعاد التي ننصح بها
- التنسيق
- مطابقة السمات إذا كنت تستخدم مصدر بيانات قديمًا للمنتجات المحلّية (اختياري)
- سلع الملابس
- سمات الأسعار (اختيارية)
- سمات "استلام الطلب" من المتجر (اختيارية)
- سمات "صفحة المنتجات الخاصة بالمتجر مع عرض السعر والتوفّر" (اختيارية)
- سمات إضافية (اختيارية)
مصدر بيانات المنتج
لاستخدام مصدر بيانات منتج حالي لم يتم تفعيله لكل من "إعلانات المنتجات المتوفّرة في المتجر" أو "البيانات المحلية المجانية"، يجب تفعيل إضافته وتفعيل إمكانية استخدام مصدر بيانات المنتج للمتسوّقين في المتجر باتّباع الخطوات التالية:
- في حسابك على Merchant Center، انقر على الإعدادات
في قائمة التنقل على اليمين.
- انقر على مصادر البيانات.
- اختَر مصدر المنتج الذي تريد تعديله.
- انقر على الإعداد وعدِّل "استخدام بيانات المنتجات من مصدر البيانات هذا" إلى "استخدام بيانات المنتجات للمتاجر المحلية والمتاجر على الإنترنت".
تنصح Google بإرسال كل منتجاتك ضمن ملف بيانات واحد لكلٍّ من "الإعلانات للمنتجات المتوفرة في المتجر" و"البيانات المحلية المجانية". بالنسبة إلى مصدر البيانات الذي تم إنشاؤه حديثًا، يمكن اختيار كل وجهات مصدر البيانات السارية أثناء إنشاء مصدر البيانات. وبالنسبة إلى مصادر البيانات الحالية، يمكنك استخدام إعدادات مصدر البيانات الأساسية لتفعيل "إعلانات المنتجات المتوفّرة في المتجر" و/أو "البيانات المحلية المجانية" كوجهات إضافية. أمّا إذا أردت استبعاد منتجات معيّنة من "إعلانات Shopping" أو "إعلانات المنتجات المتوفرة في المتجر" و"البيانات المحلية المجانية"، يمكنك استخدام سمة الوجهات المستبعَدة [excluded_destination]. مزيد من المعلومات حول سمة "الوجهات المستبعَدة"
إرسال مصدر بيانات المنتج
نوع الملف: يمكنك استخدام ملف نصي محدَّد (ننصح به) أو ملف XML أو واجهة برمجة تطبيقات.
تسجيل مصدر بيانات جديد: اتّبِع الخطوات العادية لتسجيل مصدر بيانات جديد.
قد يستغرق ظهور المنتجات على الموقع ما يصل إلى يومين بعد إرساله.
ملاحظة مهمة: تحتوي بعض السمات في مواصفات بيانات المنتجات هذه على مسافات وشرطات سفلية. وللتأكّد من إرسال السمات التي تتضمن المسافات والأحرف الصحيحة، يُرجى اتّباع الإرشادات الواردة أدناه والمرتبطة بنوع الملف الذي تستخدمه:
- مصادر بيانات محدّدة بعلامات جدولة: يجب فصلها بمسافات. وإذا كانت السمة تتضمن شرطات سفلية، يمكنك استخدام مسافة بدلاً من "_".
- مصادر بيانات XML أو واجهة برمجة تطبيقات XML: يجب استخدام شرطات سفلية ويتم تحويلها إلى مسافة بيضاء عند استلام مصدر البيانات
- JSON API: يجب استخدام شرطات سفلية ويتم تحويلها إلى مسافة بيضاء عند استلام مصدر البيانات
ملخّص متطلبات السمات
| السمة | متطلبات الإرسال |
العنوان [title] |
مطلوبة لكلّ المنتجات التي تبيعها في المتاجر |
رقم GTIN [gtin] |
مطلوبة لكلّ المنتجات الجديدة التي حدّدت الشركة المصنّعة رقم GTIN لها. اختيارية (ننصح بشدة باستخدامها) لكل المنتجات الأخرى |
العلامة التجارية [brand] |
مطلوبة لجميع المنتجات الجديدة (باستثناء الأفلام والكتب والعلامات التجارية للتسجيلات الموسيقية) اختيارية لجميع المنتجات الأخرى |
الحالة [condition] |
مطلوبة إذا كان المنتج مُستعمَلاً أو مُجدّدًا اختيارية للمنتجات الجديدة |
|
فئة كفاءة استهلاك الطاقة الحدّ الأدنى لفئة كفاءة استهلاك الطاقة [max_energy_efficiency_class] |
مطلوبة إذا كانت منتجاتك تستهدف أيًا من الدول الأعضاء في الاتحاد الأوروبي أو المملكة المتحدة أو سويسرا اختيارية إذا لم تكن منتجاتك تستهدف أيًا من الدول الأعضاء في الاتحاد الأوروبي أو المملكة المتحدة أو سويسرا |
الوجهة المستبعَدة [excluded_destination] |
يُنصح باستخدام هذه السمة إذا كنت تستخدم مصدر بيانات منتجات واحدًا لإرسال بيانات المنتجات لكلٍّ من العروض المحلية وعلى الإنترنت. استخدِم هذه السمة لاستبعاد المنتجات التي لا يتم بيعها في المتاجر ومنع ظهورها في "إعلانات المنتجات المتوفرة في المتجر" وفي "البيانات المحلية المجانية". |
|
اختيارية إذا كنت تستخدم مصدر بيانات قديمًا للمنتجات المحلّية بهدف إرسال بيانات المنتجات للعروض المحلية، يمكنك استخدام هذه السمات لمطابقة المنتجات التي تبيعها على الإنترنت وداخل المتجر في مصدر بيانات المنتجات ومصدر بيانات المنتجات المحلّية. لتنفيذ هذا الإجراء، يمكنك اتّباع أي من الخيارَين التاليَين:
[condition] في مصدر البيانات هذا. |
|
|
تاريخ سريان السعر المخفَّض مقياس تسعير الوحدات [unit_pricing_base_measure] |
يمكن إرسال سمات "السعر" يجب تضمين سمات "السعر" [unit_pricing_measure] و"المقياس الأساسي لتسعير الوحدات" [unit_pricing_base_measure] المطلوبتين لكل المنتجات الخاضعة للقوانين أو اللوائح التنظيمية المحلية. |
|
إذا أردت السماح للعملاء بشراء المنتجات على الإنترنت واستلامها من المتجر، عليك توفير السمتَين التاليتين:
ملاحظة مهمة: اعتبارًا من 1 سبتمبر 2024، أصبحت سمة "طريقة الاستلام"
[pickup_method] اختيارية لتفعيل ميزة "استلام الطلب من المتجر" في عروضك.مزيد من المعلومات حول استلام الطلب اليوم والاستلام لاحقًا حسب بيانات مخزون المتجر والاستلام لاحقًا باستخدام بيانات المنتج |
|
|
نموذج الرابط للأجهزة الجوّالة [ads_redirect] |
اختيارية إذا أردت المشاركة في واجهة محلّ مجاور يستضيفها تاجر سمة الرابط سمة "رابط مخصّص لواجهة محلّ مجاور يستضيفها تاجر" السمتان "رابط للأجهزة الجوّالة مخصّص لواجهة محلّ مجاور يستضيفها تاجر" |
ملاحظة مهمة (ملفات XML فقط): إذا أردت تعديل مصدر البيانات في حسابك على Merchant Center بتنسيق XML لأيّ من السمات الواردة أدناه، يجب إضافة تعريف مساحة الاسم في Google Merchant Center، وإلا قد لا تتمّ معالجة مصدر بياناتك بشكل صحيح.
سمات التعريف المطلوبة
تقدّم هذه السمات معلومات أساسية عن منتجاتك وتكون مطلوبة لكل السلع.
المعرّف [id] - معرّف السلعة
هو معرّف لكل سلعة يكون فريدًا في كل المتاجر، ولا يمكن إعادة استخدامه في مصادر البيانات من النوع نفسه وللبلد نفسه واللغة نفسها.
حالات استخدام هذه السمة: مطلوبة لكل السلع في مصدر بياناتك
| النوع | سلسلة |
| مثال على نص/ملف محدّد بعلامات جدولة | 421486 |
| مثال بتنسيق XML | <g:id>421486</g:id> |
ملاحظة مهمّة:
- تتمّ إزالة المسافات البيضاء في البداية والنهاية وأحرف الرجوع إلى أول السطر (0x0D).
- يتم استبدال كل تسلسل من أحرف الرجوع إلى أول السطر (0x0D) وأحرف المسافات البيضاء (أحرف يونيكود التي تتميّز بخاصية المسافة البيضاء) بمسافة بيضاء واحدة (0x20).
- يمكن استخدام أحرف يونيكود الصالحة فقط، وتُستثنى منها الأحرف التالية:
- أحرف التحكّم (ما عدا أحرف الرجوع إلى أول السطر 0x0D)
- أحرف الوظائف
- أحرف من فئة ترميز خاصة
- الأزواج البديلة
- قيم مواضع الرموز التي لم يتم ضبطها (لا سيّما أي قيمة موضع رمز أكبر من 0x10FFFF)
- بعد إرسال إحدى السلع، يجب ألا تتغير سمة المعرّف عند تعديل مصدر بياناتك، أو استخدامه لمنتج مختلف في وقت لاحق.
- إذا كنت تستخدم سمة المعرّف في حملات التسوّق، ننصحك باستخدام الأحرف الصغيرة أو غير الحسّاسة لحالة الأحرف فقط.
العنوان [title] - عنوان السلعة
هو اسم السلعة. تنصح Google بإدراج الخصائص التي تميّز السلعة عن غيرها من المنتجات في العنوان (مثل اللون أو العلامة التجارية). وفي حال وجود مطابقة، قد تعرض Google سلعتك على الإنترنت أو بيانات "كتالوج Google" بدلاً من ذلك.
حالات استخدام هذه السمة: مطلوبة لكل السلع في مصدر بياناتك
| النوع | نص (سلسلة)، لا يزيد عن 70 حرفًا |
| مثال على نص/ملف محدّد بعلامات جدولة | Netgear ReadyNAS Duo |
| مثال بتنسيق XML | <g:title>Netgear ReadyNAS Duo</g:title> |
ملاحظة مهمّة:
- اتّبِع إرشادات الصياغة بعناية. على سبيل المثال، ننصح بعدم إدراج أي نص ترويجي، مثل "شحن مجاني"، وعدم استخدام أحرف كبيرة لكلمات بأكملها.
- بالنسبة إلى خيارات المنتجات، يجب تضمين العنوان المشترك بين خيارات السلع. على سبيل المثال، إذا كان "قميص بولو بيكيه رجالي" متوفرًا باللونين الأحمر والأزرق، يمكنك استخدام أحد العناوين التالية:
- قميص بولو بيكيه رجالي (يمكن استخدامه لخيارَي المنتج)
- قميص بولو بيكيه رجالي - أحمر (للقميص الأحمر)
- قميص بولو بيكيه رجالي - أزرق (للقميص الأزرق)
الوصف [description] - وصف السلعة
يجب إدراج المعلومات ذات الصلة بالمنتج فقط. ويُرجى تقديم وصف للسمات الأكثر أهمية له، مثل المقاس أو المادّة أو الفئة العمرية المستهدفة أو الميزات الخاصة أو المواصفات الفنية الأخرى. يجب أيضًا تضمين تفاصيل حول السمات المرئية للمنتج (مثل الشكل والتصميم والنمط والزخرفة) لأننا قد نستخدم هذا النص للعثور على سلعتك.
ننصح بإدخال عدد أحرف يتراوح بين 500 و1,000 حرف تقريبًا، لكن يمكنك إرسال ما يصل إلى 5,000 حرف. ويجب أن تتّبع هذه الأوصاف القواعد النحوية العامة وأن تنتهي بعلامة ترقيم.
حالات استخدام هذه السمة: مطلوبة لكل السلع في مصدر بياناتك
الإصدار الثاني من Merchant API (JSON): "description": "Solid red, queen-sized bed sheets made from 100% woven polyester 300 thread count fabric. Set includes one fitted sheet, one flat sheet, and two standard pillowcases. Machine washable; extra deep fitted pockets."
الإصدار الثاني منMerchant API (XML): <description>Solid red, queen-sized bed sheets made from 100% woven polyester 300 thread count fabric. Set includes one fitted sheet, one flat sheet, and two standard pillowcases. Machine washable; extra deep fitted pockets.</description>
| النوع | النص |
| عدد الأحرف المسموح به | 5,000 |
| نص (بتنسيق TSV) | ملاءات سرير حجم كوين باللون الأحمر مصنوعة من البوليستر المنسوج بنسبة 100% من قماش مكوّن من 300 خيط يشمل الطقم ملاءة سفلية واحدة، وملاءة علوية واحدة، وغطاءَي وسادة من الحجم العادي. Machine washable; extra deep fitted pockets. |
| XML (مصادر البيانات) | <description>Solid red, queen-sized bed sheets made from 100% woven polyester 300 thread count fabric. يشمل الطقم ملاءة سفلية واحدة، وملاءة علوية واحدة، وغطاءَي وسادة من الحجم العادي. يمكن غسلها في الغسالة، وتتميّز بأطراف ذات طول إضافي.</description> |
ملاحظة مهمّة:
- يُرجى اتّباع إرشادات الصياغة لدى Google بعناية. مثلاً، لا تُدرِج أي نص ترويجي، مثل "شحن مجاني"، ولا تستخدم أحرفًا كبيرة لكلمات بأكملها، ولا تُدرِج وصفًا للعلامة التجارية أو الشركة.
- بالإضافة إلى ذلك، لا تُدرِج المعلومات التالية في الأوصاف:
- روابط توجّه إلى متجرك أو إلى مواقع إلكترونية أخرى
- معلومات متعلقة بالفوترة أو الدفع أو المبيعات
- مراجع لأنظمة التصنيف الداخلية، مثلاً "دمى وألعاب > دمى > دمى الأطفال"
- مقارنات بمنتجات أخرى لا تتعلق بالسلعة التي تبيعها، مثلاً "أفضل/أسرع/أكبر من X"
- تفاصيل حول منتجات أو ملحقات أخرى أو سلع مشابهة متوفرة
رابط الصورة [image_link] - عنوان URL لصورة السلعة
هذا هو عنوان URL الخاص بالصورة الرئيسية للمنتج وهي الصورة الأولى التي يراها العملاء في صفحات تفاصيل المنتج.
في حال توفّر صور متعدّدة ومختلفة للمنتج، يُرجى إرسال الصورة الرئيسية باستخدام هذه السمة وتضمين جميع الصور الأخرى في السمة رابط صور إضافيّة [additional_image_link].
حجم الصورة:
- يمكنك إرسال صورة ذات حجم أكبر للمنتج، ودقة أعلى، وذات حجم كامل، وبحجم ملف يصل إلى 16 ميغابايت.
- نقترح عليك استخدام الصور التي لا يقل حجمها عن 800 × 800 بكسل.
- بالنسبة إلى منتجات الملابس، يجب ألا تقل أبعاد الصور عن 250 × 250 بكسل وألا تزيد عن 64 ميغا بكسل. وبالنسبة إلى كل المنتجات الأخرى، يجب ألا تقلّ أبعاد الصور عن 100 × 100 بكسل وألا تزيد عن 64 ميغا بكسل.
- يجب عدم زيادة حجم الصور أو إرسال صور مصغّرة. وننصحك بألا تقلّ المساحة التي يشغلها المنتج في الصورة بأكملها عن %75 وألا تزيد عن %90.
حالات استخدام هذه السمة: مطلوبة لكل السلع في مصدر بياناتك
الإصدار الثاني من Merchant API (JSON): "imageLink": "http://www.example.com/image1.jpg"
الإصدار الثاني من Merchant API (XML): <image_link>http://www.example.com/image1.jpg</image_link>
| النوع | يجب أن يبدأ عنوان URL بأيّ من http:// أو https://. |
| عدد الأحرف المسموح به | 2000 |
| نص (بتنسيق TSV) | http://www.example.com/image1.jpg |
| XML (مصادر البيانات) |
|
من خلال استيفاء المتطلبات والاقتراحات أدناه، يمكنك تحسين تجربة التسوّق لدى العملاء.
المتطلبات:
- إذا لم تتوفّر لديك أي صورة للسلعة، لن تتمكّن من إرسال السلعة.
- لا يُسمح أيضًا بأنواع الصور التالية:
- العنصر النائب أو صور المنتجات غير الصحيحة
- الصور أو الرسومات أو الصور التوضيحية العامة التي لا تمثل الصور الفعلية للمنتج، باستثناء المنتجات في الفئات "Hardware" (632) (الأجهزة) أو "Vehicles and parts" (888) (المركبات وقطع الغيار)، مما يسمح بالرسومات و/أو الصور التوضيحية للمنتج الفعلي
- الصور الأحادية اللون على شكل مربع بلون واحد فقط، باستثناء المنتجات في الفئات "Vehicle Paint" (3812) (طلاء المركبات)، و"Craft Paint, Ink & Glaze" (505378) (طلاء الحرَف والحبر ومادّة الصقل)، و"Painting Consumables" (503740) (مستهلَكات الطلاء)
- الصور التي تتضمّن عناصر ترويجية (على سبيل المثال، عبارات تحث المستخدم على اتّخاذ إجراء، مثل "شراء"، أو معلومات متعلقة بالخدمة مثل "الضمان الممتد" أو "شحن مجاني"، أو معلومات متعلقة بالسعر، أو صفات ترويجية، مثل "أفضل ورخيص"، أو الحالة أو مدى التوافق، مثل "جديد وقطعتان"، و"قابلية للتكيّف")، أو أسماء و/أو شعارات التجّار بصرف النظر عمّا إذا كانت العناصر السابق ذكرها تظهر على المنتج أم لا، وينطبق هذا أيضًا على العلامات المائية التي تتضمّن عناصر ترويجية و/أو أسماء و/أو شعارات التجّار
- الصور التي تتضمّن محتوًى غير واضح (على سبيل المثال العلامات المائية و/أو أسماء العلامات التجارية و/أو الشعارات) يظهر على المنتج المعروض للبيع
- الصور التي تضمّ حدودًا
- صور الحزم التي لا تعرض الحزمة بأكملها
- صور حزمة من المنتج نفسه لا تعرض وحدة فردية من المنتج
- لا يُسمح أيضًا بالصفحات المقصودة التي لا تتضمّن صورة المنتج أو صور العناصر النائبة ولا تعرض المنتج الفعلي.
-
تأكَّد من تطابق الصورة التي تقدّمها لكل سلعة مع القيم المقدَّمة في السمات اللون
[color]والتصميم[pattern]والمادة الأساسية[material]، وإلا قد يتم رفض سلعتك.
الاقتراحات:
- إذا لم تتمكّن من تقديم الصور المناسبة لإرسال السلع كخيارات، يمكنك إدراج خيارات المنتج كسلعة واحدة تتضمّن عدة قيم لسمات الخيارات وتقديم الصورة المتاحة.
- يجب أن تعرض الصورة المنتج بدقة وألا تتضمّن مراحل تدريجية له أو أن تكون هذه المراحل التدريجية بحدّها الأدنى.
- بالنسبة إلى الخيارات التي تستند إلى اللون، يجب أن تحتوي كل سلعة ترسلها ذات خيار فردي على صورة تُظهر المنتج بلون واحد.
- يجب استخدام خلفية بلون أبيض أو رمادي أو لون فاتح في الصورة الرئيسية.
-
يجب أن تتضمّن الصورة الرئيسية للمنتج عرضًا رئيسيًا و/أو عرضًا واضحًا للمنتج المعروض للبيع. ويمكنك إرسال طرق عرض إضافية للمنتج (بخلاف طريقة العرض الأساسية) باستخدام السمة رابط صور إضافيّة
[additional_image_link].
التنسيق:
- إنّ تنسيقات الصور المقبولة هي التالية: ملف GIF غير متحرّك (.gif)، وJPEG (.jpg/.jpeg)، وPNG (.png)، وBMP (.bmp)، وTIFF (.tif/.tiff)، ويجب أن تتوافق امتدادات الملفات لهذه الصور مع تنسيقاتها.
- برتوكولات عناوين URL المقبولة هي "http" و"https". ويجب استبدال أي رموز مُستخدَمة ضمن عنوان URL للصورة بوحدات مرمّزة في عنوان URL (مثلاً، الفاصلة = %2C).
- وتنصح Google بإرسال عناوين URL ثابتة للصور وتعديل عنوان URL فقط إذا تم تغيير الصورة الفعلية للمنتج. ويُعتبر ذلك أمرًا مهمًا على وجه الخصوص إذا كنت تستخدم شبكة توصيل المحتوى لاستضافة الصور، وسيضمن إمكانية زحف Google إلى صورك بشكلٍ صحيح.
الاقتصاص:
قد نقتصّ صورتك تلقائيًا للتركيز بشكلٍ أكبر على المنتج.
الحالة [condition] - حالة السلعة
تسمح شركة Google بالترويج للمنتجات المستعملة ذات الجودة العالية. وتسمح أيضًا بالترويج للمنتجات المجدّدة شرط أن تكون متوافقة مع القوانين واللوائح المحلية وأن تكون متوافقة مع سياساتنا.
ثمة 3 قيم مقبولة فقط:
- جديد
[new]: المنتج جديد تمامًا ولم يسبق استخدامه. لم يتم فتح المنتج ولا يزال في عبوته الأصلية. - مُجدّد
[refurbished]: تمت إعادة المنتج بشكلٍ احترافي إلى حالة يكون فيها صالحًا للاستخدام باعتباره "منتج جديد" ويتم توفير ضمان معه. وقد يكون التغليف في حالته الأصلية أو لا يكون كذلك. يُشار أحيانًا في هذه الحالة إلى منتجك بـ "مُعادٌ تصنيعه". - مُستعمَل
[used]: استخدِم هذه القيمة إذا لم تنطبق القيمتان "جديد" و"مجدَّد". على سبيل المثال، إذا تم استخدام المنتج من قبل أو إذا كان خرطوشة طابعة مُعاد تعبئتها أو تم فتح التغليف الأصلي أو إذا كان التغليف الأصلي غير متوفّر.
حالات استخدام هذه السمة: مطلوبة إذا تم استخدام المنتج أو تجديده واختيارية للمنتجات الجديدة
الإصدار الثاني من Merchant API (JSON): "condition": "used"
الإصدار الثاني من Merchant API (XML): <condition>used</condition>
| النوع |
يتم قبول 3 قيم فقط:
|
| نص (بتنسيق TSV) | مُستعمَل |
| XML | <g:condition>used</g:condition> |
ملاحظة مهمّة: إذا أردت إرسال أسماء السمات باللغة الإنجليزية، عليك تقديم قيم السمات باللغة الإنجليزية أيضًا.
رقم GTIN [gtin] - الرقم التجاري العالمي للسلعة
يمكنك استخدام سمة رقم GTIN لإرسال الأرقام التجارية العالمية للسلع (GTIN) بأحد التنسيقات التالية:
- الرمز العالمي للمنتج (في أمريكا الشمالية/رقم GTIN-12): يتكوّن من 12 خانة، لذلك يجب تحويل رموز UPC-E المكوَّنة من 8 خانات إلى رموز مكوَّنة من 12 خانة.
- رقم EAN: (في أوروبا/رقم GTIN-13): يتكوّن من 13 خانة.
- JAN: (في اليابان/رقم GTIN-13): يتكوّن من 8 أو 13 خانة.
- رقم ISBN (للكتب): يتكوّن من 10 أو 13 خانة. إذا كان كلاهما متوفرًا، يجب تضمين الرقم المكوّن من 13 خانة فقط. لم تعد أرقام ISBN-10 مستخدَمة ويجب تحويلها إلى ISBN-13.
- ITF-14 (لحزم المنتجات / رقم GTIN-14): يتكوّن من 14 خانة.
| حالات استخدام هذه السمة | مطلوبة لكل المنتجات الجديدة التي حدّدت الشركة المصنّعة رقم GTIN لها |
| النوع | رقم يتكوّن من 8، أو 12، أو 13، أو 14 خانة (UPC، أو EAN، أو JAN، أو ISBN) |
| عدد الأحرف المسموح به | 50 |
| نص/ملفّ محدّد بعلامات جدولة | 3234567890126 |
| XML (مصادر البيانات) | <g:gtin>3234567890126</g:gtin> |
ملاحظة مهمّة:
- نقبل فقط أرقام GTIN صالحة وعلى النحو المحدّد في دليل التحقّق من صحة GS1 الرسمي، والذي يشمل المتطلبات التالية:
- يجب أن تكون خانة المجموع الاختباري ظاهرة وصحيحة.
- يجب ألّا يكون رقم GTIN مقيّدًا (تتراوح نطاقات بادئة GS1 بين 02 و04 و2).
- يجب ألّا يكون رقم GTIN عبارة عن قسيمة (تتراوح نطاقات بادئة GS1 بين 98 و99).
العلامة التجارية [brand] - العلامة التجارية للسلعة
حالات استخدام هذه السمة: مطلوبة لجميع المنتجات الجديدة (باستثناء الأفلام والكتب والعلامات التجارية للتسجيلات الموسيقية) واختيارية لجميع المنتجات الأخرى
الإصدار الثاني من Merchant API (JSON): "brand": "Acme"
الإصدار الثاني من Merchant API (XML): <brand>Acme</brand>
| النوع | النص |
| عدد الأحرف المسموح به | 70 |
| نص (بتنسيق TSV) | Acme |
| XML (مصادر البيانات) | <g:brand>Acme</g:brand> |
ملاحظة مهمّة: لا تقدّم اسم متجرك بصفته العلامة التجارية ما لم تكن تصنّع المنتج.
تكون سمات فئة كفاءة استهلاك الطاقة [energy_efficiency_class] والحدّ الأدنى لفئة كفاءة استهلاك الطاقة [min_energy_efficiency_class] والحدّ الأقصى لفئة كفاءة استهلاك الطاقة [max_energy_efficiency_class] اختيارية، ولكن قد يُطلب منك توفير هذه المعلومات وفقًا للقوانين أو اللوائح التنظيمية المحلية. على سبيل المثال، إذا كانت منتجاتك تستهدف أيًا من الدول الأعضاء في الاتحاد الأوروبي أو المملكة المتحدة أو سويسرا، يجب استيفاء المتطلبات القانونية بهذا الشأن والمحدّدة في قوانين التنفيذ الوطني للتوجيه الأوروبي 2017/1369 وأيّ قانون محلّي سارٍ آخر.
السمات "فئة كفاءة استهلاك الطاقة" [energy_efficiency_class] و"الحدّ الأدنى لفئة كفاءة استهلاك الطاقة" [min_energy_efficiency_class] و"الحدّ الأقصى لفئة كفاءة استهلاك الطاقة" [max_energy_efficiency_class]
تسمح لك هذه السمة بتحديد القيم المطلوبة لسمة "فئة كفاءة استهلاك الطاقة" في المنتج.
حالات استخدام هذه السمة: ننصحك بشدة بإرسال السمات "فئة كفاءة استهلاك الطاقة" و"الحدّ الأدنى لفئة كفاءة استهلاك الطاقة" و"الحدّ الأقصى لفئة كفاءة استهلاك الطاقة" للمنتجات المناسبة. وقد تحتاج إلى توفير هذه الفئة لأنواع المنتجات التالية:
| الثلاجات | الأفران |
| المجمّدات | أجهزة تسخين المياه |
| غسّالات الملابس | أجهزة تخزين المياه الساخنة |
| آلات تجفيف الملابس | مكيّفات الهواء |
| آلات تجفيف وغسل الملابس | المصابيح الكهربائية |
| أجهزة تخزين النبيذ | التركيبات الضوئية |
| غسالات الأطباق | التلفزيونات |
| النوع |
القيم المقبولة:
|
| نص (بتنسيق TSV) | A+ |
| مثال بتنسيق XML | <g:energy_efficiency_class>A+</g:energy_efficiency_class> |
ملاحظة مهمّة:
- يجب أن تكون قيمة السمة الحدّ الأدنى لفئة كفاءة استهلاك الطاقة
[min_energy_efficiency_class]أقلّ من قيمة السمة الحدّ الأقصى لفئة كفاءة استهلاك الطاقة[max_energy_efficiency_class]. على سبيل المثال، يجب أن تتدرّج الفئات من "أ" إلى "د" وليس من "د" إلى "أ". - يجب أن تكون قيمة السمة فئة كفاءة استهلاك الطاقة
[energy_efficiency_class]التي توفّرها ضمن نطاق قيمة سمة "الحدّ الأدنى لفئة كفاءة استهلاك الطاقة" وقيمة سمة "الحدّ الأقصى لفئة كفاءة استهلاك الطاقة". على سبيل المثال، إذا تدرّج نطاقك من "أ" إلى "د"، لا يجوز لقيمة سمة "فئة كفاءة استهلاك الطاقة" أن تكون "هـ".
سمات الاستبعاد التي ننصح بها
يمكنك استخدام السمة الوجهات المستبعَدة [excluded_destination] لاستبعاد المنتجات غير المؤهّلة لوجهة معيّنة. ويجب استخدامها للتحكم في المواقع الجغرافية المختلفة التي يمكن أن يظهر فيها المحتوى الخاص بك. على سبيل المثال، يمكنك استخدام هذه السمة إذا أردت أن يظهر منتج في حملة "إعلانات Shopping" بدون أن يظهر في العروض المحلية.
حالات استخدام هذه السمة: يُنصح باستخدامها إذا أردت عدم ظهور منتجك في أنواع معيّنة من الإعلانات والبيانات.
القيم المسموح بها:
- إعلانات Shopping
[Shopping_ads]. لمنع ظهور عروض منتجك في "إعلانات Shopping". مزيد من المعلومات حول إعلانات Shopping - الإعلانات الصورية
[Display_ads]. لمنع ظهور عروض منتجاتك في إعلانات تجديد النشاط التسويقي الديناميكي. مزيد من المعلومات حول تجديد النشاط التسويقي الديناميكي للبيع بالتجزئة - إعلانات للمنتجات المتوفرة في المتجر
[Local_inventory_ads]: لمنع ظهور عروض منتجاتك في "الإعلانات للمنتجات المتوفرة في المتجر". مزيد من المعلومات حول "الإعلانات للمنتجات المتوفرة في المتجر" - بيانات مجانية
[Free_listings]. لمنع ظهور عروض منتجاتك في البيانات المجانية. مزيد من المعلومات حول عرض منتجاتك مجانًا على Google - البيانات المحلية المجانية
[Free_local_listings]: لمنع ظهور عروض المنتجات المحلية مجانًا على Google. مزيد من المعلومات حول إدراج منتجاتك المحلية مجانًا على Google
Shopping Actions وSurfaces across Google وLocal surfaces across Google. سيتم قبول هذه القيم، ولكن ننصحك بتعديل منتجاتك لتتضمّن القيم الجديدة لهذه الوجهات: Free_listings وFree_local_listings.التنسيق
اتّبِع إرشادات الصياغة هذه لتتأكّد من أنّنا نفهم البيانات التي ترسلها.
| القيم المسموح بها | Shopping_ads وDisplay_ads وLocal_inventory_ads وFree_listings وFree_local_listings |
| حقل متكرّر | نعم |
| تنسيق الملف | مثال على القيمة |
| مصادر البيانات النصية | Display_ads |
| مصادر بيانات XML | <g:excluded_destination>Display_ads</g:excluded_destination> |
الحقول المتكررة
النص
لإرسال وجهات متعددة تريد استبعادها، يُرجى إرسال السمة عدة مرات، مرة لكل وجهة (إجراء مقترَح)، مثلاً:
| بيانات المنتج لفراش تقويم العظام المخصّص للكلاب | |
| السمة | القيمة |
العنوان [title] |
فراش تقويم العظام للكلاب بحجم XXL |
الوجهة المستبعَدة [excluded_destination] |
Display_ads |
الوجهة المستبعَدة [excluded_destination] |
Shopping_ads |
يمكنك أيضًا الفصل بين أنواع الوجهات باستخدام فاصلة ( , ):
Display_ads وShopping_ads
XML
لإرسال وجهات متعددة تريد استبعادها في مصدر بيانات بتنسيق XML، يجب تضمين سمة منفصلة لكل وجهة مُستبعَدة:
<g:excluded_destination>Display_ads</g:excluded_destination>
<g:excluded_destination>Shopping_ads</g:excluded_destination>
للاطّلاع على المزيد من المعلومات حول واجهة برمجة التطبيقات، يُرجى مراجعة Merchant API.
مطابقة السمات إذا كنت تستخدم مصدر بيانات قديمًا للمنتجات المحلّية (اختياري)
رقم تعريف مطابق [webitemid] - مطابقة المعرّفات المحلية والمعرّفات على الإنترنت
إذا تعذّرت عليك مطابقة سمة المعرّف [id] في مصدر بيانات المنتجات المحلّية مع السمة نفسها في مصدر بيانات المنتجات، يمكنك استخدام سمة "رقم تعريف مطابق" لإجراء المطابقة. ويمكنك تقديم قيم مختلفة لسمة "المعرّف"، ولكن عليك تقديم القيمة نفسها للسمتَين "رقم تعريف مطابق" و"المعرّف". ويجب دائمًا تحقيق مطابقة مع السمة "المعرّف" للخيار المقابل في مصدر بيانات المنتجات، إن توفَّر.
بما أنّ استخدام سمة "رقم تعريف مطابق" يقتصر على المطابقة فقط، يجوز أن تتشارك عدة سلع قيمة سمة "رقم تعريف مطابق" نفسها إذا تم ربطها بالسلعة نفسها في مصدر بيانات المنتجات.
حالات استخدام هذه السمة: ننصح بإدراجها لجميع السلع التي لها معرّفات/رموز تخزين تعريفي مختلفة للمنتجات المحلية مقارنةً بالمنتجات على الإنترنت.
| النوع | نص (سلسلة) |
| نص (بتنسيق TSV) | WB1011 |
| مثال بتنسيق XML | <g:webitemid>WB1011</g:webitemid> |
ملاحظة مهمّة:
- تتمّ إزالة المسافات البيضاء في البداية والنهاية وأحرف الرجوع إلى أول السطر (0x0D).
- يتم استبدال كل تسلسل من أحرف الرجوع إلى أول السطر (0x0D) وأحرف المسافات البيضاء (أحرف يونيكود التي تتميّز بخاصية المسافة البيضاء) بمسافة بيضاء واحدة (0x20).
- يمكن استخدام أحرف يونيكود الصالحة فقط، وتُستثنى منها الأحرف التالية:
- أحرف التحكّم (ما عدا أحرف الرجوع إلى أول السطر 0x0D)
- أحرف الوظائف
- أحرف من فئة ترميز خاصة
- الأزواج البديلة
- قيم مواضع الرموز التي لم يتم ضبطها (لا سيّما أي قيمة موضع رمز أكبر من 0x10FFFF)
- بعد إرسال إحدى السلع، يجب ألا تتغير قيمة السمة "رقم تعريف مطابق" [webitemid] عند تعديل مصدر بياناتك، كما يجب ألا يتم استخدامها لمنتج مختلف في وقت لاحق.
رقم GTIN [gtin] - الرقم التجاري العالمي للسلعة
في هذه السمة، عليك إدراج الأرقام التجارية العالمية للسلعة (أرقام GTIN) لمنتجاتك.
حالات استخدام هذه السمة: إذا كنت تبيع السلع في المتجر وعلى الإنترنت ولا يمكنك استخدام سمة المعرّف [id] لتحقيق المطابقة، عليك استخدام السمة "رقم تعريف مطابق" [webitemid] أو معرّفات المنتج الفريدة كَسِمَات متطابقة.
إذا كنت تستخدِم أي معرّفات منتجات فريدة لتحقيق المطابقة، عليك تضمين الحالة في مصدر البيانات هذا.
| النوع | نص (سلسلة) |
| نص (بتنسيق TSV) | 0606449056822 |
| مثال بتنسيق XML | <g:gtin>0606449056822</g:gtin> |
رقم MPN [mpn] - رقم القطعة المحدّد من الشركة المصنّعة للسلعة
يحدّد هذا الرمز الفريد المنتج حسب شركته المصنّعة. ويمكن تحديد المنتج بشكل واضح من خلال الجمع بين العلامة التجارية ورقم القطعة المحدّد من الشركة المصنّعة.
حالات استخدام هذه السمة: إذا كنت تبيع السلع في المتجر وعلى الإنترنت ولا يمكنك استخدام سمة المعرّف [id] لتحقيق المطابقة، عليك استخدام السمة "رقم تعريف مطابق" [webitemid] أو معرّفات المنتج الفريدة كَسِمَات متطابقة.
إذا كنت تستخدِم أي معرّفات منتجات فريدة لتحقيق المطابقة، عليك تضمين الحالة في مصدر البيانات هذا.
| النوع | نص (سلسلة) |
| نص (بتنسيق TSV) | RND2150 |
| مثال بتنسيق XML | <g:mpn>RND2150</g:mpn> |
العلامة التجارية [brand] - العلامة التجارية للسلعة
حالات استخدام هذه السمة: إذا كنت تبيع المنتجات في المتجر وعلى الإنترنت ولا يمكنك استخدام سمة المعرّف [id] لتحقيق المطابقة، عليك استخدام السمة "رقم تعريف مطابق" [webitemid] أو معرّفات المنتج الفريدة كَسِمَات متطابقة.
إذا كنت تستخدِم أي معرّفات منتجات فريدة لتحقيق المطابقة، عليك تضمين الحالة في مصدر البيانات هذا.
| النوع | نص (سلسلة) |
| نص (بتنسيق TSV) | Netgear |
| مثال بتنسيق XML | <g:brand>Netgear</g:brand> |
سلع الملابس
تتطلّب سلع الملابس تضمين عدة سمات إضافية في مصدر البيانات الأساسي:
معرّف مجموعة السلع [item_group_id] - معرّف مشترك لكل خيارات المنتج نفسه
مع جميع السلع التي تمثّل خيارات للمنتج نفسه، يجب تضمين قيمة سمة "معرّف مجموعة السلع" نفسها. إذا كان لديك "رمز تخزين تعريفي أساسي" مشترك بين كل خيارات المنتج، يمكنك تقديمه كقيمة لسمة "معرّف مجموعة السلع".
حالات استخدام هذه السمة: مطلوبة لكل السلع في البرازيل وفرنسا وألمانيا واليابان والمملكة المتحدة والولايات المتحدة، والتي تتضمّن خيارات منتج تستخدم هذه السمات التفصيلية للمنتج: اللون [color] والمقاس [size] والنقش [pattern] والمادة الأساسية [material] والفئة العمريّة [age group] والجنس [gender] ونوع المقاس [size type] ونظام المقاسات [size_system]. ويُنصح باستخدامها في كل البلدان الأخرى.
الإصدار الثاني من Merchant API (JSON): "itemGroupId": "AB12345"
الإصدار الثاني من Merchant API (XML): <item_group_id>AB12345</item_group_id>
| النوع | رمز أبجدي رقمي |
| عدد الأحرف المسموح به | 50 |
| نص (بتنسيق TSV) | AB12345 |
| XML (مصادر البيانات) | <g:item_group_id>AB12345</g:item_group_id> |
ملاحظة مهمّة:
- تختلف السمة معرّف مجموعة السلع
[item_group_id]عن السمة المعرّف[id]. وتتضمن سمة "معرّف مجموعة السلع" قيمًا مشتركة لمجموعة من خيارات المنتج، بينما يجب أن تتضمّن سمة المعرّف قيمًا فريدة في كل مجموعة خيارات للمنتج ولكل السلع الأخرى أيضًا. - يجب أن تكون القيم المُرسلة لسمة معرّف مجموعة السلع فريدة لكل منتج، وأن تكون مشتركة فقط بين السلع التي تمثّل خيارات للمنتج نفسه.
- إذا أرسلت سمة معرّف مجموعة السلع، سنبحث تلقائيًا عن سمات لخيارات المنتج. وفي حال استخدمت سمة "معرّف مجموعة السلع" لسلعة معينة، تأكَّد من أن هذه السلعة تتضمّن سمة منتج مفصّلة واحدة على الأقل.
اللون [color] - لون السلعة
تحدّد هذه السمة الألوان السائدة للسلعة. وإذا كانت لديك سلعة واحدة متعدّدة الألوان، يمكنك إرسال ما يصل إلى قيمتَين إضافيتَين كألوان تمييز:
- يمكنك جمع الألوان باستخدام "/" حسب بروزها (اللون السائد أولاً، ثم لونَي تمييز كحدّ أقصى). على سبيل المثال، يجب أن يتضمّن الحذاء الأسود مع لون تمييز بالأخضر قيمة اللون "أسود/أخضر". بالنسبة إلى سلع الملابس التي لا يتغير شكلها، مثل المجوهرات أو الإكسسوارات الخشبية التي تكون فيها الطبقات الخارجية أو المواد تساوي قيمة اللون، يمكن إرسال اسم الطبقة الخارجية أو المادة في سمة اللون
[color](على سبيل المثال "ماهوغاني" مقابل "فولاذي" مقابل "ذهب وردي"). - إذا كنت تستخدم تنسيق XML، عليك تمثيل "/" بـ ";#47".
حالات استخدام هذه السمة: مطلوبة لكل المنتجات في مجموعة سلع تختلف حسب اللون ولجميع سلع الملابس في مصادر البيانات التي تستهدف العملاء في البرازيل وفرنسا وألمانيا واليابان والمملكة المتحدة والولايات المتحدة. ويُنصح باستخدامها لجميع المنتجات التي يكون اللون سمة مهمة ومميِّزة فيها.
الإصدار الثاني من Merchant API (JSON): "color": "Black"
الإصدار الثاني من Merchant API (XML): <color>Black</color>
| النوع | النص |
| عدد الأحرف المسموح به | 100 |
| نص (بتنسيق TSV) | Black |
| XML (مصادر البيانات) | <g:color>Black</g:color> |
العناصر التي يجب عدم تضمينها::
- قيم اللون التي تتضمّن أرقامًا (على سبيل المثال: "0 2 4 6 8")
- قيم اللون التي تتضمّن أحرفًا ليست أبجدية رقمية (على سبيل المثال: "
#fff000") - قيم اللون للأحرف المفردة (على سبيل المثال: "G") في اللغات ذات الأصل اللاتيني ويُسمح باستخدام قيم اللون للأحرف المفردة باللغات الصينية واليابانية والكورية (على سبيل المثال: "红").
- قيم اللون التي تشير إلى المنتج أو صورة المنتج (على سبيل المثال: "الاطّلاع على الصورة")
- القيم الوصفية التي لا تمثّل أسماءً صالحة للون (على سبيل المثال: متعدد الألوان ومتنوع والصنف والاطّلاع على الصورة ولا ينطبق)
- قيم اللون الطويلة التي تتجاوز 40 حرفًا
- قيم اللون الطويلة التي تكون مجموعة من عدة ألوان أخرى (على سبيل المثال:
RedPinkBlue) بدلاً من ذلك:- إذا أردت الإشارة إلى عدة ألوان في سلعة واحدة (وليس إلى خيارات المنتج)، يمكنك تحديد لون أساسي متبوعًا بلونَين ثانويَين على الأكثر وفصلها بـ "/". على سبيل المثال، يمكنك استبدال القيمة
RedPinkBlueبالقيمةRed/Pink/Blue. - إذا أردت الإشارة إلى عدة ألوان في سلع متعددة متشابهة (خيارات المنتج)، يمكنك إرسالها كمنتجات منفصلة على حدة باستخدام معرّف مجموعة السلع نفسه وقيمة لون مختلفة.
- إذا أردت الإشارة إلى عدة ألوان في سلعة واحدة (وليس إلى خيارات المنتج)، يمكنك تحديد لون أساسي متبوعًا بلونَين ثانويَين على الأكثر وفصلها بـ "/". على سبيل المثال، يمكنك استبدال القيمة
ملاحظة بشأن عمليات الإرسال غير الصالحة:
- إذا كنت ترسل قيمة لون تخالف القواعد النحوية أعلاه، قد ترفض Google السلعة بأكملها في وقت إرسال مصدر البيانات.
- تتحقّق Google بانتظام من صحة السمات التي ترسلها، بما في ذلك سمة اللون. وفي حال العثور على أي قيم غير صحيحة، قد تزيل Google كل سلعك من علامة التبويب "التسوّق".
ملاحظة مهمّة:
- بالنسبة إلى خيارات المنتج، يجب إرسال كل لون مختلف أو مجموعة ألوان مختلفة كسلعة منفصلة، فضلاً عن إرسال سمة معرّف مجموعة السلع.
- استخدِم أسماءً متّسقة للألوان في كل خيارات المنتج نفسه، وكذلك في جميع المنتجات المتعدّدة من الفئة نفسها.
- إن القيم التي تقدّمها قد يتم عرضها للعملاء، وبالتالي يُرجى تقديم قيم يمكنهم فهمها.
المقاس [size] - مقاس السلعة
تشير هذه السمة إلى مقاس المنتج. بالنسبة إلى السلع ضمن فئة "ملابس وإكسسوارات"، يمكنك أيضًا إرسال السمتَين نوع المقاس [size_type] ونظام المقاسات [size_system] لتقديم المزيد من التفاصيل حول المقاس.
- أرسِل سمة واحدة فقط لكل سلعة. وفي حال تقديم سمات متعددة خاصة بالمقاس للسلعة نفسها، سيتم تطبيق السمة الأولى فقط وتجاهل السمات الإضافية، وستتلقّى تحذيرًا.
حالات الاستخدام: مطلوبة لكل المنتجات في مجموعة السلع التي تختلف حسب المقاس. وهي أيضًا مطلوبة لكل سلع الملابس ضمن فئات المنتجات "ملابس وإكسسوارات > ملابس" و"ملابس وإكسسوارات > أحذية" في بيانات المنتجات التي تستهدف العملاء في البرازيل وفرنسا وألمانيا واليابان والمملكة المتحدة والولايات المتحدة. ويُنصح باستخدامها لجميع المنتجات التي يكون المقاس سمة مهمة ومميِّزة فيها.
الإصدار الثاني من Merchant API (JSON): "sizes": ["XL"]
الإصدار الثاني من Merchant API (XML): <size>XL</size>
| النوع |
إذا كنت تستهدف العملاء في الولايات المتحدة، يمكنك الرجوع إلى قائمة القيم المقبولة (الولايات المتحدة فقط) بالنسبة إلى كل البلدان الأخرى، يمكنك الاطلاع على أمثلة بالمقاسات. |
| عدد الأحرف المسموح به | 100 |
| نص (بتنسيق TSV) | XL |
| XML (مصادر البيانات) | <g:size>XL</g:size> |
ملاحظة مهمّة:
- بالنسبة إلى خيارات المنتج، يجب إرسال كل مقاس مختلف أو مجموعة مقاسات مختلفة كسلعة منفصلة، فضلاً عن إرسال سمة "معرّف مجموعة السلع". مزيد من المعلومات حول إرسال منتجات الملابس
- إذا كانت المقاسات تضمّ أبعادًا مختلفة، يجب جمعها في قيمة واحدة (على سبيل المثال: "16/34 طويل" لمقاس الرقبة 16 سم وطول الكمّ 34 سم ومناسب "لطويلي القامة").
- استخدِم قيمًا متسقة للمقاس في كل خيارات المنتج نفسه، وكذلك في جميع المنتجات المتعدّدة من الفئة نفسها. على سبيل المثال، ضمن مجموعة من القمصان، استخدِم المقاسات "S" (صغير) و"M" (متوسط) و"L" (كبير)، ولا تستخدِم "S"، و"Medium"، و"Lrg".
- في حال لم تتوفّر صور محدّدة، يمكنك استخدام الصورة نفسها لخيارات مقاس المنتج، ولكنّنا ننصحك بربط سمة "الرابط" [link] بصفحة تضمّ كل تفاصيل خيار السلعة.
- إن القيم التي تقدّمها قد يتم عرضها للعملاء، وبالتالي يُرجى توفير قيم يمكنهم فهمها.
- يمكنك تقديم تفاصيل إضافية حول المقاس في السلسلة النصية. على سبيل المثال، يمكنك تقديم القيمة "3.5 للأطفال" أو "3.5 للأطفال الصغار".
- في هذه السمة، إذا كان مقاس سلعتك ملائمًا للجميع أو لمعظم الأشخاص، يمكنك استخدام القيمة "one size" (مقاس واحد) أو "OS" أو "one size fits all" (مقاس واحد يلائم الجميع) أو "OSFA" أو "one size fits most" (مقاس واحد يلائم معظم الأشخاص) أو "OSFM".
مثال على قيم المقاس
قد يصعب تمثيل قيم المقاس في أنواع مختلفة من منتجات الملابس. وليس من الضروري تقديم هذه القيم الدقيقة، ولكن قد يكون من المفيد توحيد قيم المقاس لمنتجات الملابس. يمكنك أيضًا إرسال السمتَين نوع المقاس [size_type] ونظام المقاسات [size_system] لتقديم المزيد من المعلومات حول مقاس المنتجات.
البلوزات والملابس الخارجية والأثواب
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
الملابس السفلية
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
بالنسبة إلى السراويل: 24x30 و24x32 و24x34
كبير جدًا وصغير جدًا وكبير وطويل وطول الأرجل وما إلى ذلك
- عندما تنطبق سلعة على مجموعة مقاسات خاصة، مثل كبير جدًا أو صغير جدًا أو للنساء الحوامل أو كبير وطويل، يمكنك استخدام السمة نوع المقاس
[size_type]. - عندما تتضمّن إحدى السلع طول الأرجل، يُرجى استخدام هذا التنسيق للمقاس: 30 للقصير، و30 للمتوسط، و30 للطويل.
الأحذية
- بالنسبة إلى الولايات المتحدة: 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
- بالنسبة إلى أوروبا: 37 و38 و39 و40 و41 و42 و43 و44 و45
الجنس [gender] - جنس السلعة
"gender": "male" الإصدار الثاني من Merchant API (XML) <gender>male</gender>| التنسيق |
يتم قبول 3 قيم فقط:
|
| نص (بتنسيق TSV) | male |
| XML (مصادر البيانات) | <g:gender>male</g:gender> |
ملاحظة مهمّة:
- إذا كنت تريد إرسال أسماء السمات باللغة الإنجليزية، يجب تقديم قيم السمات باللغة الإنجليزية أيضًا.
- مع أنّ هذه السمة ليست إلزامية، ولكن يُنصح باستخدامها مع الفئات الفرعية "أزرار بدبابيس خلفية" و"مشابك ربطات العنق" و"أساور المعصم" و"أغطية الأحذية" و"أربطة الأحذية" و"مهاميز" و"أحزمة الساعات" في فئة "الملابس والإكسسوارات".
الفئة العمريّة [age_group] - الفئة العمرية التي تستهدفها السلعة
"ageGroup": "adult"الإصدار الثاني من Merchant API (XML): <age_group>adult</age_group>
| التنسيق |
هناك 5 قيم مقبولة فقط:
|
| نص (بتنسيق TSV) | adult |
| XML (مصادر البيانات) | <g:age_group>adult</g:age_group> |
ملاحظة مهمّة:
- يتم تحديد السوق المستهدفة لكل قيمة كما يلي:
- حديثو الولادة
[newborn]: حتى عمر 3 أشهر. وغالبًا ما يتم تحديد مقاسات حديثي الولادة حسب الفئة العمريّة بالأشهر (من 0 إلى 3) و/أو القيمة الفردية "newborn" (حديثو الولادة). - الأطفال الرضّع
[infant]: من عمر 3 أشهر إلى 12 شهرًا. وغالبًا ما يتم تحديد مقاسات الأطفال الرضّع حسب الفئة العمريّة بالأشهر (من 3 إلى 12). - الأطفال الصغار [toddler]: من عمر سنة إلى 5 سنوات. وغالبًا ما يتم تحديد مقاسات الأطفال الصغار حسب الفئة العمريّة بالأشهر (من 12 إلى 24) أو السنوات (من 1 إلى 5).
- الأطفال
[kids]: من عمر 5 سنوات إلى 13 سنة. وقد تم تصنيع كل المقاسات في هذه الفئة العمريّة لتناسب الطفل في هذه الفئة العمريّة. - الأشخاص البالغون
[adult]: المراهقون أو الفئات الأكبر. وتمّ تصنيع كل المقاسات في هذه الفئة العمرية لتناسب الأشخاص البالغين أو المراهقين الذين تندرج أعمارهم ضمنها. - إذا أردت إرسال أسماء السمات باللغة الإنجليزية، يجب تقديم قيم السمات باللغة الإنجليزية أيضًا.
- حديثو الولادة
- مع أنّ هذه السمة ليست إلزامية، ولكن يُنصح باستخدامها مع الفئات الفرعية "أزرار بدبابيس خلفية" و"مشابك ربطات العنق" و"أساور المعصم" و"أغطية الأحذية" و"أربطة الأحذية" و"مهاميز" و"أحزمة الساعات" في فئة "الملابس والإكسسوارات".
- إذا لم تكن سلعة مخصّصة بشكل واضح للأطفال وحدهم، يجب تصنيفها ضمن الفئة "الأشخاص البالغون"
[adult]لأنه لا يمكن إرسال سوى قيمة واحدة فقط لكل سلعة.
سمات الأسعار (اختيارية)
تتوفَّر أيضًا بعض السمات الاختيارية التي يمكنك إرسالها إذا كانت منطبقة.
السعر [price] - السعر التلقائي الوطني للسلعة
إذا كان سعر المنتج موحدًا في المتاجر، استخدِم هذه السمة لإرسال هذا السعر التلقائي. يجب إرسال هذا السعر إذا كان سعر المنتج موحّدًا في جميع المتاجر، أو إذا كنت تستخدِم ميزة صفحات المنتجات مع عرض التوفّر في المتجر.
وفي حال عدم إرسال السعر، ستحلّ أي أسعار خاصة بالمتاجر تُضمّنها في مصدر بيانات المخزون المتوفّر في المتجر محلّ قيمة السمة هذه.
إذا كنت تستخدم ميزة صفحات المنتجات مع عرض التوفّر في المتجر، يجب استخدام سمات السعر ويجب أن تتطابق مع السعر المعروض على صفحتك المقصودة.
ملاحظة: تفترض Google العملة بناءً على البلد الذي يقع فيه المتجر. وفي حال ضبط العملة على مستوى السلعة، تأكَّد من توافقها مع معيار ISO 4217.
حالات استخدام هذه السمة: نوصى بإدراجها لجميع السلع.
| النوع | السعر (العائم) |
| نص (بتنسيق TSV) | 299.99 SAR |
| مثال بتنسيق XML | <g:price>299.99</g:price> |
السعر المخفَّض [sale_price] - السعر المخفَّض المُعلن عنه للسلعة
تنصح Google بإرسال السمة تاريخ سريان السعر المخفَّض [sale_price_effective_date] لأي سلع بأسعار مخفَّضة، لأنّ ذلك سيحدّد تاريخ سريان السعر المخفَّض. وإذا لم يتم إرسالها، سيتمّ تطبيق السعر المخفَّض لهذه السلعة طيلة الوقت المحدّد في مصدر البيانات.
حالات استخدام هذه السمة: يُنصح باستخدامها للسلع المعروضة بسعر مخفَّض.
| النوع | الرقم |
| نص (بتنسيق TSV) | 249.99 |
| مثال بتنسيق XML | <g:sale_price>249.99</g:sale_price> |
تاريخ سريان السعر المخفَّض [sale_price_effective_date] - النطاق الزمني الذي تُعرض فيه سلعة للبيع بأسعار مُخفَّضة
يجب استخدامها جنبًا إلى جنب مع السمة السعر المخفَّض [sale_price]. تشير هذه السمة إلى التواريخ التي يسري خلالها السعر المخفَّض. مزيد من المعلومات حول تعريفات السعر المخفَّض
| النوع | يتم الفصل بين تواريخ بدء التخفيضات وانتهائها بشرطة مائلة للأمام (/). ويتمّ تحديد تاريخ البدء باستخدام التنسيق (YYYY-MM-DD) متبوعًا بالحرف "T"، وهو الوقت الذي يبدأ فيه البيع بالسعر المخفَّض، متبوعًا بذكر المنطقة الزمنية للبيع بالسعر المخفَّض حسبما يحدّده المعيار ISO 8601. ويجب توفير تاريخ الانتهاء بالتنسيق نفسه. وفي حال عدم تحديد المنطقة الزمنية، تفترض Google أنّ التوقيت العالمي المتفق عليه هو التوقيت المعتمد. |
| نص (بتنسيق TSV) |
مثال على التوقيت العالمي المنسَّق: 2021-07-19T17:00:00/2021-07-27T05:00:00 مثال على توقيت المحيط الهادئ: 2021-07-19T09:00:00-08:00/2021-07-26T21:00:00-08:00 |
| XML | <g:sale_price_effective_date>2021-07-19T17:00:00/2021-07-27T05:00:00</g:sale_price_effective_date> |
مقياس تسعير الوحدات [unit_pricing_measure] - تحديد مقياس منتجك وأبعاده
استخدِم السمة مقياس تسعير الوحدات [unit_pricing_measure] لتحديد مقياس منتجك وأبعاده. تتيح هذه القيمة للعملاء الاطّلاع على التكلفة الدقيقة لكلّ وحدة من منتجك.
حالات استخدام هذه السمة: سمة اختيارية لكلّ المنتجات باستثناء تلك الخاضعة للقوانين أو الأنظمة المحليّة.
| النوع | وحدة ورقم موجب |
| نص (بتنسيق TSV) | 1.5 كلغ |
| مثال بتنسيق XML | <g:unit_pricing_measure>1.5kg</g:unit_pricing_measure> |
المقياس الأساسي لتسعير الوحدات [unit_pricing_base_measure] - تضمين مقام سعر الوحدة
تشير هذه السمة إلى المقياس الأساسي الذي يتمّ تسعير المنتج على أساسه (على سبيل المثال، تعني "100ml" أنّه يتم احتساب السعر على أساس وحدات بقيمة 100 مل). إذا كنت تستخدم مقياس تسعير الوحدات [unit_pricing_measure]، استخدِم سمة المقياس الأساسي لتسعير الوحدات لتضمين المقام لسعر الوحدة. ولجعل أسعار الوحدات أكثر قابلية للمقارنة لكل الإعلانات والبيانات المحلية المجانية على الصفحة، يمكن أن يعرض منتجك مقياسًا أساسيًا مختلفًا عن المقياس الذي تقدّمه هنا.
حالات استخدام هذه السمة: سمة اختيارية لكل المنتجات باستثناء تلك الخاضعة للقوانين أو الأنظمة المحليّة.
| النوع | وحدة وعدد صحيح |
| نص (بتنسيق TSV) | 100 غ |
| مثال بتنسيق XML | <g:unit_pricing_base_measure>100 غ</g:unit_pricing_base_measure> |
سمات "استلام الطلب" من المتجر (اختيارية)
يمكنك تمييز خيار استلام الطلب من المتجر عن طريق إضافة السمتَين التاليتين إلى مصدر بياناتك. ويمكنك إضافة هذه السمات إلى مصدر البيانات الأساسي لأي سلع تكون فيها القيم صحيحة في كل المتاجر (على سبيل المثال، يمكن للعميل استلام تلفزيون XYZ في أي متجر من المتاجر في البلد).
طريقة الاستلام [pickup_method] - خيار استلام السلعة من المتجر
يمكنك تحديد ما إذا كان بالإمكان استلام الطلبات من المتجر لهذا العرض وما إذا كان من المفترض عرض خيار الاستلام باعتباره "شراء" أو "حجز" أو "الشحن إلى المتجر" أو "غير متاح".
- الشراء
[buy]: تتمّ المعاملة كاملةً على الإنترنت - حجز
[reserve]: يتم حجز السلعة على الإنترنت وتتم المعاملة داخل المتجر - الشحن إلى المتجر
[ship_to_store]: يتم شراء السلعة على الإنترنت وشحنها إلى متجر محلي ليتمكّن العميل من استلامها - غير متاح
[not_supported]: لا يتوفّر خيار استلام السلعة من المتجر
| النوع | نص (سلسلة نصية) يجب أن يكون قيمة من القيم المحدّدة أعلاه. |
| نص (بتنسيق TSV) | شراء |
| مثال بتنسيق XML | <g:pickup_method>buy</g:pickup_method> |
اتفاقية مستوى الخدمة للاستلام [pickup_sla] - المخطط الزمني لاستلام السلعة من المتجر
يمكنك تحديد التاريخ المتوقّع الذي سيكون فيه الطلب جاهزًا للاستلام وذلك حسب وقت تقديمه.
- اليوم نفسه
[same_day]: يشير إلى أنّ السلعة تكون متاحة للاستلام في يوم تقديم الطلب، وتخضع لشروط آخر موعد لاستلام الطلبات. - اليوم التالي
[next_day]: يشير إلى أنّ السلعة تكون متاحة للاستلام في اليوم الذي يلي تاريخ تقديم الطلب. - يومان
[2-day]: يشير إلى أنّه سيتم شحن السلعة إلى متجر ليستلمها عميل بعد يومين. - 3 أيام
[3-day]: تشير هذه القيمة إلى أنّه سيتم شحن السلعة إلى متجر ليستلمها عميل بعد 3 أيام. - 4 أيام
[4-day]: تشير هذه القيمة إلى أنّه سيتم شحن السلعة إلى متجر ليستلمها عميل بعد 4 أيام. - 5 أيام
[5-day]: تشير هذه القيمة إلى أنّه سيتم شحن السلعة إلى متجر ليستلمها عميل بعد 5 أيام. - 6 أيام
[6-day]: تشير هذه القيمة إلى أنّه سيتم شحن السلعة إلى متجر ليستلمها عميل بعد 6 أيام. - 7 أيام
[7-day]: يشير إلى أنّه سيتم شحن السلعة إلى متجر ليستلمها عميل بعد 7 أيام. - عدّة أسابيع
[multi-week]: يشير إلى أنّه سيتم شحن السلعة إلى متجر ليستلمها عميل بعد أكثر من أسبوع واحد.
| النوع | نص (سلسلة نصية) يجب أن يكون قيمة من القيم المحدّدة أعلاه. |
| نص (بتنسيق TSV) | same_day |
| مثال بتنسيق XML | <g:pickup_sla>same day</g:pickup_sla> |
سمات "صفحة المنتجات الخاصة بالمتجر مع عرض السعر والتوفّر" (اختيارية)
لاستخدام ميزة صفحة منتج خاص بالمتجر مع عرض السعر والتوفّر، أضِف السمتَين إعادة التوجيه من الإعلانات [ads_redirect] و"رابط مخصّص لواجهة محلّ مجاور يستضيفها تاجر" [link_template] إلى مصدر البيانات الأساسي. يمكنك أيضًا إضافة السمة الاختيارية "رابط للأجهزة الجوّالة مخصّص لواجهة محلّ مجاور يستضيفها تاجر" [mobile_link_template] لتقديم واجهة محلّ مجاور يستضيفها تاجر مُحسّنة للأجهزة الجوّالة وقياس معدَّل النقرات على الأجهزة الجوّالة.
الرابط [link]
عندما ينقر العملاء على إعلانك أو على بيانات مجانية معيّنة، يتم توجيههم إلى صفحة مقصودة على موقعك الإلكتروني تعرض المنتج إذا كانت ميزة صفحة المنتج مع عرض التوفّر في المتجر مفعّلة في حسابك. ويمكنك ضبط عنوان URL لهذه الصفحة المقصودة باستخدام سمة الرابط [link].
ملاحظة مهمّة:
- استخدِم اسم نطاقك بعد تأكيد ملكيته.
- ابدأ بـ
httpأوhttps. - استخدِم عنوان URL مرمّزًا يتوافق مع RFC 2396 أو RFC 1738. على سبيل المثال، يجب استخدام علامة "%2C" للإشارة إلى الفاصلة.
- لا تضمِّن رابطًا للانتقال إلى صفحة بينية ما لم يكن ذلك مطلوبًا قانونًا.
| النوع | عنوان URL .(يجب أن يبدأ عنوان URL بأيّ من http:// أو https://). |
| نص (بتنسيق TSV) | http://mikemart.com/123 |
| XML | <g:link>http://mikemart.com/123</g:link> |
رابط مخصّص لواجهة محلّ مجاور يستضيفها تاجر [link_template]
عندما ينقر العملاء على إعلانك أو بياناتك المجانية، يتم توجيههم إلى صفحة مقصودة على موقعك الإلكتروني تعرض المنتج إذا كانت ميزة صفحة منتج خاص بالمتجر مع عرض السعر والتوفّر مفعّلة في حسابك. ويمكنك ضبط عنوان URL لهذه الصفحة المقصودة باستخدام السمة "رابط مخصّص لواجهة محلّ مجاور يستضيفها تاجر" [link_template].
ملاحظة مهمّة:
- يجب تضمين معلمة ValueTrack لسمة رمز المتجر {
store_code}. وتختلف بنية عناوين URL باختلاف المواقع الإلكترونية. وقد تمثّل رموز المتاجر مَعلَمات عناوين URL أو جزءًا من مسار عنوان URL. - يجب تأكيد ملكية عنوان URL لموقعك الإلكتروني والمطالبة به والتأكّد من أنّ عنوان URL للموقع الإلكتروني المسجَّل في Merchant Center يتطابق مع النطاق الوارد في سمة "نموذج الرابط". وإذا لم يكن عنوان URL للموقع الإلكتروني متطابقًا مع النطاق المسجَّل، يمكنك الاطّلاع على كيفية حلّ هذه المشكلة.
- يجب تضمين مَعلَمات قياس عناوين URL في سمة إعادة التوجيه من الإعلانات
[ads_redirect]فقط.
| النوع | عنوان URL .(يجب أن يبدأ عنوان URL بأيّ من http:// أو https://). |
| نص (بتنسيق TSV) | http://mikemart.com/123?store={store_code} |
| XML | <g:link_template>http://mikemart.com/123?store={store_code}</g:link_template> |
رابط للأجهزة الجوّالة مخصّص لواجهة محلّ مجاور يستضيفها تاجر [mobile_link_template]
عندما ينقر العملاء على إعلانك أو بياناتك المجانية، يتم توجيههم إلى صفحة مقصودة على موقعك الإلكتروني تعرض المنتج إذا كانت ميزة صفحة منتج خاص بالمتجر مع عرض السعر والتوفّر مفعّلة في حسابك.
تتيح لك السمة "رابط للأجهزة الجوّالة مخصّص لواجهة محلّ مجاور يستضيفها تاجر" [mobile_link_template] تضمين عنوان URL ينقل إلى إصدار مُحسّن للأجهزة الجوّالة من صفحتك المقصودة. وسيتمّ عرض هذا الإصدار للعملاء من مستخدمي الأجهزة الجوّالة، مثل الهواتف أو الأجهزة اللوحية.
ملاحظة مهمّة:
- يجب تضمين معلمة ValueTrack لسمة رمز المتجر {
store_code}. وتختلف بنية عناوين URL باختلاف المواقع الإلكترونية. وقد تمثّل رموز المتاجر مَعلَمات عناوين URL أو جزءًا من مسار عنوان URL. - يجب إثبات ملكية عنوان URL لموقعك الإلكتروني والمطالبة به والتأكّد من أنّ عنوان URL للموقع الإلكتروني المسجَّل في Merchant Center يتطابق مع النطاق الوارد في سمة "رابط مخصّص لواجهة محلّ مجاور يستضيفها تاجر"
[link_template]. وإذا لم يكن عنوان URL للموقع الإلكتروني متطابقًا مع النطاق المسجَّل، يمكنك الاطّلاع على كيفية حلّ هذه المشكلة. - يُرجى تضمين مَعلَمات قياس عناوين URL في سمة إعادة التوجيه من الإعلانات
[ads_redirect]فقط.
| النوع | عنوان URL .(يجب أن يبدأ عنوان URL بأيّ من http:// أو https://). |
| نص (بتنسيق TSV) | http://mikemart.com/123?store={store_code} |
| XML | <g:mobile_link_template>http://mikemart.com/123?store={store_code}</g:mobile_link_template> |
إعادة التوجيه من الإعلانات [ads_redirect]
عندما ينقر العملاء على إعلانك، يتم توجيههم إلى صفحة مقصودة على موقعك الإلكتروني تعرض المنتج إذا كانت ميزة صفحة منتج خاص بالمتجر مع عرض السعر والتوفّر مفعّلة في حسابك.
يمكنك استخدام سمة "إعادة التوجيه من الإعلانات" لضبط عنوان URL يتضمّن مَعلَمات قياس من شأنها مساعدتك على فهم عدد الزيارات إلى صفحتك المقصودة بشكلٍ أفضل.
ملاحظة مهمّة:
- يجب تضمين معلمة ValueTrack لسمة رمز المتجر {
store_code}. وتختلف بنية عناوين URL باختلاف المواقع الإلكترونية. وقد تمثّل رموز المتاجر مَعلَمات عناوين URL أو جزءًا من مسار عنوان URL. - يجب تأكيد ملكية عنوان URL لموقعك الإلكتروني والمطالبة به والتأكّد من أنّ عنوان URL للموقع الإلكتروني المسجَّل في Merchant Center يتطابق مع النطاق الوارد في سمة "نموذج الرابط". وإذا لم يكن عنوان URL للموقع الإلكتروني متطابقًا مع النطاق المسجَّل، يمكنك الاطّلاع على كيفية حلّ هذه المشكلة.
- عند إعداد هذه السمة، سيتم توجيه العميل الذي ينقر على إعلانك إلى الموقع ضمن سمة إعادة التوجيه من الإعلانات
[ads_redirect]بدلاً من المواقع التي أعددتها في سمة "رابط مخصّص لواجهة محلّ مجاور يستضيفها تاجر"[link_template]أو سمة "رابط للأجهزة الجوّالة مخصّص لواجهة محلّ مجاور يستضيفها تاجر"[mobile_link_template].
| النوع | عنوان URL .(يجب أن يبدأ عنوان URL بأيّ من http:// أو https://). |
| نص (بتنسيق TSV) | http://mikemart.com/123?store={store_code} |
| XML | <g:ads_redirect>http://mikemart.com/123?store={store_code}</g:ads_redirect> |
سمات إضافية (اختيارية)
يمكنك إرسال معلومات إضافية عن منتجاتك في مصدر البيانات الأساسي لعرض إعلانات أو بيانات أكثر تفصيلاً. ويمكنك أيضًا الاطّلاع على مواصفات بيانات المنتجات لكلّ السمات المحتملة.