نظرة عامة

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

يتم نقل بيانات القائمة باستخدام الخلاصات العامة. قبل البدء:

1. تأكَّد من إكمال إعداد الحساب.
2. فهم عملية تحميل الخلاصة العامة
3. فهم كيفية ضبط حسابك لعمليات تحميل الخلاصة العامة

المخطط

يمكنك الاطّلاع على مخطّط القائمة الكامل هنا.

إنشاء خلاصات قوائم الطعام وتحميلها

عند إنشاء خلاصات قوائم الطعام وتحميلها، اتّبِع الإرشادات والقواعد التالية:

• لتقديم تفاصيل المطعم، اتّبِع مواصفات البيانات الموضّحة في خلاصة التاجر. للاطّلاع على مثال على ملف JSON، يمكنك الرجوع إلى نموذج ملف JSON. يجب أن تكون أسماء ملفات البيانات فريدة بين عمليات التحميل. ننصحك بتضمين طابع زمني في اسم الملف، على سبيل المثال menu1_1633621547.json.
• في وصف مجموعة الملفات لخلاصة القائمة، اضبط الحقل name على google.food_menu. للاطّلاع على مثال على محتوى ملف الوصف، يمكنك الرجوع إلى نموذج ملف الوصف بتنسيق JSON. يجب أن تكون أسماء ملفات الوصف فريدة بين عمليات التحميل. ننصح بتضمين طابع زمني في اسم الملف، على سبيل المثال descriptor_1633621547.filesetdesc.json. يجب تحميل ملف الوصف إلى صندوق تحميل SFTP العام كجزء من خلاصة القائمة.
• يجب تحميل الخلاصات إلى صندوق تحميل SFTP العام بشكل يومي كعمليات إعادة تحميل كاملة.
• يجب الحد من الخلاصات إلى 1,000 شريحة (ملف) كما هو موضّح في مقالة استخدام مربّع dropbox للخلاصة العامة.

يمكن العثور على حالة نقل الخلاصة في قسم الخلاصات > السجلّ في بوابة الشركاء. يمكن العثور على معلومات ملف SFTP في الخلاصة في قسم الإعدادات > الخلاصات في "بوابة الشركاء".

يمكن العثور على حالة نقل الخلاصة في قسم الخلاصات > السجلّ في "بوابة الشركاء". يمكن العثور على معلومات ملف SFTP للخلاصة في قسم الإعداد > الخلاصات في "بوابة الشركاء".

العمل مع خيارات عناصر القائمة

يمكن تحديد خيارات عناصر القائمة باستخدام MenuItemOption proto. ستعتمد تجربة المستخدم الدقيقة على مساحة العرض في Google، ويتم عرض خيارات عناصر القائمة كقائمة مسطّحة ضمن عنصر القائمة. راجِع المثال التالي:

لا تتوفّر خيارات عناصر القائمة إلا إذا كان الطبق يتطلّب اختيار أحد الخيارات. على سبيل المثال، عند طلب بيتزا، يكون المقاس خيارًا مطلوبًا. لا يمكن استخدام خيارات عناصر القائمة الاختيارية (مثل "خيار إضافة أفوكادو") ولا يجب تضمينها في الخلاصات.

بما أنّ خيارات عناصر القائمة يتم عرضها كقائمة مسطّحة واحدة، على الشركاء الذين لديهم مجموعات متعدّدة من الخيارات المطلوبة لعنصر قائمة واحد (مثل قهوة لاتية مع خيارات الحجم وخيارات الحليب) تحديد أفضل طريقة لعرض هذه الخيارات في Google. ننصح باتّباع الإرشادات التالية:

• إذا كانت مجموعة خيارات مطلوبة واحدة فقط تؤثر في السعر، يُفضّل تضمين مجموعة الخيارات هذه في الخلاصات.
• في جميع الحالات الأخرى، يعود الأمر إلى الشريك لتحديد أفضل طريقة لعرض خيارات قائمة الطعام. لا يُنصح بإنشاء قوائم طويلة من الخيارات لكل التركيبات المحتملة للخيارات. تجنَّب تنظيم خياراتك على النحو التالي:
  • بوريتو بالدجاج
  • بوريتو دجاج مع جبنة
  • بوريتو دجاج مع صلصة
  • بوريتو دجاج مع صلصة وشرائح جبن
  • بوريتو دجاج مع غواكامولي
  • بوريتو دجاج مع غواكامولي وصلصة

عند تضمين خيارات عناصر قائمة الطعام ضمن عنصر قائمة طعام، يجب إجراء أحد الخيارَين التاليَين:

• يجب أن يتضمّن عنصر القائمة عرضًا واحدًا على الأقل يتضمّن سعرًا (في الحالات التي لا تؤثّر فيها خيارات عنصر القائمة في السعر).
• يجب أن يحتوي عنصر القائمة على مجموعة من الخيارات مع ضبط سعر كل خيار على السعر الإجمالي ل سلعة الخيار المحدّد.

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

المطاعم التي تقدّم قوائم طعام متعدّدة

يمكن أن يتضمّن مطعم واحد (كيان) قائمة طعام واحدة فقط. بالنسبة إلى المطعم الذي يقدّم قوائم طعام متعددة (أي قوائم غداء وعشاء منفصلة)، يمكنك دمج كل القوائم في قائمة واحدة باستخدام MenuSections (أي قائمة واحدة تتضمّن قسمًا للغداء وقسمًا للعشاء). ستكون القائمة الناتجة بالبنية التالية:

• القائمة
• قسم الغداء
• حساء
• الحساء 1
• حساء 2
• سندويتشات
• ساندوتش 1
• Sandwich 2
• قسم العشاء
• المقبلات
• Starter 1
• المستوى السهل 2
• الخطوط الرئيسية
• الطبق الرئيسي 1
• الطبق الرئيسي 2

مشاركة القوائم في جميع المطاعم

يمكن مشاركة قائمة طعام واحدة في عدة مطاعم من خلال تضمين جميع المطاعم في قائمة merchant_ids الخاصة بالقائمة. يُرجى العِلم أنّ هذه القائمة تقبل أرقام تعريف الكيانات للشركاء الذين يستخدِمون خلاصة الكيان.

أفضل الممارسات

في ما يلي أفضل الممارسات التي يجب اتّباعها عند تطوير خلاصات قوائم الطعام.

• اربط مطعمًا بأحد قوائم الطعام فقط.
• قدِّم اللغة المفضّلة كأول لغة في TextField. إذا كنت ترسل عناصر LocalizedText متعددة، يتم عرض العنصر الأول في قائمة النصوص للمستخدمين.
• يجب إضافة جميع عناصر القائمة إلى أقسام القائمة. لا تُضِف عناصر القائمة مباشرةً إلى عنصر القائمة.
• قدِّم المحتوى باستخدام ترميز UTF-8. ليس من الضروري إلغاء أحرف غير ascii.
• إذا كنت بصدد الإطلاق في مناطق متعدّدة، تأكَّد من استخدام رموز العملات و الفئات الصحيحة في حقلَي الوحدات والنانو، مع الانتباه بشكل خاص إلى حقل النانو الذي يمثّل 10^-9 من الوحدة. استخدِم أداة "عرض القائمة" في عارض المستودع للتأكّد من ضبط الأسعار بشكل صحيح.
• إنّ تقديم قوائم ثرية وشاملة وحديثة للمستخدمين هو أمر أساسي لتوفير تجربة مفيدة وجذابة لهم. إنّ الأسعار والأوصاف والصور ومعلومات النظام الغذائي هي جميعها عناصر رئيسية في عملية اتخاذ القرار، وننصح الشركاء بتقديم أكبر عدد ممكن من هذه البيانات لتوفير تجربة مثالية للمستخدمين والتجار.

أدوات التطوير والاختبار

بعد إطلاق خلاصات قوائم الطعام، ستصبح بيانات خلاصة قائمة الطعام مؤهّلة للظهور في تجارب الاكتشاف، وقد تظهر في علامة التبويب "قائمة الطعام" ضمن بطاقة بيانات المطعم. تتوفّر علامة التبويب "القائمة" على "بحث Google" (على الأجهزة الجوّالة وأجهزة الكمبيوتر المكتبي)، وسيتم توسيع نطاق التجربة ليشمل مساحات عرض إضافية، بما في ذلك "خرائط Google". قد تختلف التجربة المعروضة حسب السطح.

للتأكّد من أنّ قائمة الطعام منظَّمة بشكل صحيح، استخدِم أداة "عرض القائمة" في عارض المستودع لمعاينة قوائم الطعام.

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