يبرز هذا الدليل المتطلبات والأمثلة على عروض طلب الطعام.
الأهلية والسياسات
يسلّط هذا القسم الضوء على معايير الأهلية المهمة التي يجب أن يلتزم بها الشركاء عند تقديم العروض. من المهم اختبار جميع أنواع العروض التي تخطّط لإطلاقها أثناء اختبار الخلاصة في وضع الحماية. إذا لم تكن متأكدًا من أهلية عرض ترويجي، يُرجى التواصل مع جهة التواصل في Google.
استبعاد العروض المخصّصة والعروض للاستخدام الواحد
لضمان تقديم تجربة مستخدم عالية الجودة ومتّسقة، يجب على الشركاء عدم تضمين عروض تقتصر على مجموعات فرعية معيّنة من المستخدمين (على سبيل المثال، عروض الاشتراك لأول مرة أو العروض التي يتم إنشاؤها باستخدام خوارزميات مستندة إلى المستخدم). يُسمح بالعروض على مستوى المنصة والمؤهَّلة لجميع المستخدمين أو لجميع المستخدمين الذين يقدّمون طلبًا لأول مرة في مطعم معيّن، بشرط أن يتم عرض العرض على الصفحة المقصودة للعرض لجميع المستخدمين. يُسمح أيضًا بالعروض المتاحة لجميع المستخدمين ولكن تتطلّب اشتراكًا.
يجب ذكر شروط العرض بوضوح في خلاصات العروض وعلى الصفحة المقصودة لعنوان URL الخاص بالعرض. يجب أن تكون العروض مرئية على الصفحة المقصودة للعرض لجميع المستخدمين عند تسجيل الخروج أو تسجيل الدخول إلى موقعك الإلكتروني أو تطبيقك.
العروض التي تتضمّن رموز القسائم
تتطلّب بعض العروض من المستخدم إدخال رمز قسيمة، مثل "استخدِم الرمز SAVE20 للحصول على خصم %20 على إجمالي الفاتورة". ملاحظة مهمة:
لا يعرض محرّك بحث Google رموز القسائم من تعريف القسيمة
. يمكن للشركاء تضمين هذه المعلومات في
OfferDetails.offer_display_text
ليتم عرضها للمستخدمين. إذا تم تضمين القسيمة في الحقل offer_display_text أو coupon، يجب عرضها على
الصفحة المقصودة للعرض أيضًا. تندرج العروض المستندة إلى القسائم بشكل عام ضمن فئتَين:
- العروض التي تظهر فيها القسيمة تلقائيًا عند الدفع لأي مستخدم يصل من Google ويُسمح باستخدامها.
- لا يُسمح بالعروض التي تتطلّب من المستخدم إدخال رمز القسيمة عند الدفع ولكنّها لا تقدّم تعليمات حول كيفية تطبيق رمز القسيمة على الصفحة المقصودة لعنوان URL الخاص بالعرض، أو لا تطبّق القسيمة تلقائيًا عند اتّباع عنوان URL الخاص بالعرض.
محتوى العرض وبنيته
يوضّح هذا القسم بالتفصيل متطلبات محتوى العروض المقدَّمة في الخلاصة وبنيتها، بما في ذلك أمثلة على البيانات الوصفية المنظَّمة.
نص العرض الترويجي الذي يظهر للمستخدم ومواصفات العرض الترويجي
حقل OfferDetails.offer_display_text هو حقل مطلوب يمثّل العنوان الموجز الذي يظهر فورًا في قسم العروض على "بحث Google"، مثل "خصم بقيمة 10 دولار أمريكي" أو "خصم بنسبة %15".
يُعدّ الحقل OfferDetails.offer_specification
مطلوبًا من نوع "one of" ضمن OfferDetails. وهذا يعني أنّه يجب تقديم حقل واحد بالضبط من الحقول الثلاثة التالية لتحديد الصفقة:
discount_valuediscount_percentother_offer_detail_text
إنّ حقل OfferDetails.other_offer_detail_text هو حقل نصي بتصميم مرن يُستخدَم لتكملة السمة offer_display_text عندما يتعذّر التعبير عن العرض كقيمة خصم ثابتة أو نسبة مئوية. إذا كانت السمة offer_display_text كافية لنقل جميع المعلومات اللازمة حول العرض، يجب ملء حقل other_offer_detail_text بالنص نفسه المستخدَم في السمة offer_display_text. ومع ذلك، بالنسبة إلى الصفقات المعقّدة، يجب أن يقدّم هذا الحقل وصفًا محدّدًا للمكافأة.
حقول البيانات الوصفية المنظَّمة
لتحسين وضوح العروض وإتاحة ترتيبها وفلترتها بشكل أفضل، على الشركاء
تقديم البيانات الوصفية للعروض في الحقول المنظَّمة ذات الصلة. يجب تحديد
البنود. ننصحك بضبط الحقل terms.terms_and_conditions
على الشروط التفصيلية التي تظهر للمستخدمين في الصفحة المقصودة
للعرض.
إجمالي العروض الخاصة بالطلبات والسلع
يجب أن تستخدم العروض الخاصة بمجموعات فرعية من السلع الحقلَين
offer_restrictions.inclusions
و
offer_restrictions.exclusions
لتحديد السلع المؤهَّلة. إذا كان العرض الترويجي مخصّصًا لسلعة معيّنة،
يجب تضمين اسم السلعة في offer_display_text. عند تضمين اسم السلعة في offer_display_text، ليس من الضروري ضبط offer_restrictions.inclusions.
إذا لم يتم ضبط السمة offer_restrictions.inclusions أو إذا لم يتم تضمين اسم السلعة في السمة offer_display_text، يُعتبر العرض ساريًا على إجمالي مبلغ الطلب.
عروض الاشتراك
يُسمح بعروض الاشتراك شرط أن يتم عرضها على الصفحة المقصودة للعرض لجميع المستخدمين عند تسجيل الخروج أو تسجيل الدخول إلى موقعك الإلكتروني أو تطبيقك. إذا كان العرض يتطلب اشتراكًا، يجب تضمين حقل OfferDetails.subscription مع تفاصيل الاشتراك. يجب عرض عرض الاشتراك للمستخدمين إذا قاموا بالتسجيل أو لديهم اشتراك نشط.
عروض على رسوم التوصيل
يجب أن تستخدم عروض رسوم التسليم السمة offer_category
OFFER_CATEGORY_ADD_ON_FEE_REDUCTION_OFFER. يتيح ذلك عرض العرض الترويجي فقط عند دمجه مع عرض أساسي آخر للموقع الجغرافي. ولن يتم عرض عرض رسوم التوصيل كعرض أساسي.
أمثلة على JSON للعروض
خصم ثابت بقيمة 20 دولار أمريكي
مثال: خصم ثابت بقيمة 20 ريال سعودي على إجمالي الطلب في أيام الثلاثاء بحدّ أدنى للإنفاق يبلغ 15 ريال سعودي
{ "offer_id": "offer-example-1-takeout", "offer_source": "OFFER_SOURCE_AGGREGATOR", "action_type": "ACTION_TYPE_FOOD_TAKEOUT", "offer_modes": ["OFFER_MODE_ONLINE_ORDER"], "offer_category": "OFFER_CATEGORY_BASE_OFFER", "offer_details": { "offer_display_text": "$20 off on Tuesdays", "discount_value": { "currency_code": "USD", "units": 20 }, "min_spend_value": { "currency_code": "USD", "units": 15 } }, "validity_periods": [ { "valid_period": { "valid_from_time": { "seconds": 1768953600 }, "valid_through_time": { "seconds": 1795219200 } }, "time_of_day": [ { "time_windows": { "open_time": { "hours": 9 }, "close_time": { "hours": 20, "minutes": 59, "seconds": 59 } }, "day_of_week": ["TUESDAY"] } ] } ], "offer_restrictions": { "combinable_with_other_offers": false }, "terms": { "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders with $15 minimum spend. Single use per order. Offer may not be combined with any other offers, discounts, or promotions. Valid only on Tuesdays." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/base_offer_1" }
عروض الخصم بالنسبة المئوية
مثالان على العروض: خصم %50 على مستوى السلعة وخصم %5 على إجمالي مبلغ الطلب.
[ { "offer_id": "offer-example-1-takeout", "offer_source": "OFFER_SOURCE_AGGREGATOR", "action_type": "ACTION_TYPE_FOOD_TAKEOUT", "offer_modes": ["OFFER_MODE_ONLINE_ORDER"], "offer_category": "OFFER_CATEGORY_BASE_OFFER", "offer_details": { "offer_display_text": "50% off on Berry Smoothie", "discount_percent": 50.0 }, "validity_periods": [ { "valid_period": { "valid_from_time": { "seconds": 1768953600 }, "valid_through_time": { "seconds": 1795219200 } } } ], "offer_restrictions": { "combinable_with_other_offers": true, "inclusions": [ {"description":"Berry Smoothie"} ] }, "terms": { "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders. Single use per order." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/base_offer_1" }, { "offer_id": "offer-example-2-takeout", "offer_source": "OFFER_SOURCE_AGGREGATOR", "action_type": "ACTION_TYPE_FOOD_TAKEOUT", "offer_modes": ["OFFER_MODE_ONLINE_ORDER"], "offer_category": "OFFER_CATEGORY_BASE_OFFER", "offer_details": { "offer_display_text": "5% off on all orders", "discount_percent": 5.0 }, "validity_periods": [ { "valid_period": { "valid_from_time": { "seconds": 1768953600 }, "valid_through_time": { "seconds": 1795219200 } } } ], "offer_restrictions": { "combinable_with_other_offers": false }, "terms": { "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders. Single use per order." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/base_offer_1" } ]
عرض "اشترِ واحدًا واحصل على الآخر مجانًا"
مثال: اشترِ مقبّلات واحصل على عرض مجاني، صالح من الاثنين إلى الخميس
{ "offer_id": "offer-example-2-delivery", "offer_source": "OFFER_SOURCE_AGGREGATOR", "action_type": "ACTION_TYPE_FOOD_DELIVERY", "offer_modes": ["OFFER_MODE_ONLINE_ORDER"], "offer_category": "OFFER_CATEGORY_BASE_OFFER", "offer_details": { "offer_display_text": "Buy one appetizer, get one free", "other_offer_detail_text": "Buy one appetizer, get one free" }, "validity_periods": [ { "valid_period": { "valid_from_time": { "seconds": 1768953600 }, "valid_through_time": { "seconds": 1795219200 } }, "time_of_day": [ { "time_windows": { "open_time": { "hours": 10 }, "close_time": { "hours": 23, "minutes": 59, "seconds": 59 } }, "day_of_week": ["MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY"] } ] } ], "offer_restrictions": { "combinable_with_other_offers": true, "inclusions": [ { "description": "appetizers" } ] }, "terms": { "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders. Single use per order. Valid on all menu appetizers. Offer may be combined with any other offers, discounts, or promotions. Valid Monday through Thursday." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/base_offer_4" }
عرض "التوصيل المجاني"
مثال: توصيل مجاني كإضافة إلى عرض أساسي سيتم عرض عرض "رسوم التوصيل 0 ريال سعودي" مع العرض الأساسي "خصم %10" للموقع الجغرافي.
[ { "offer_id": "offerId1", "offer_source": "OFFER_SOURCE_AGGREGATOR", "action_type": "ACTION_TYPE_FOOD_DELIVERY", "offer_modes": ["OFFER_MODE_ONLINE_ORDER"], "offer_category": "OFFER_CATEGORY_BASE_OFFER", "offer_details": { "offer_display_text": "10% off on all orders", "discount_percent": 10.0 }, "validity_periods": [ { "valid_period": { "valid_from_time": { "seconds": 1768953600 }, "valid_through_time": { "seconds": 1795219200 } }, "time_of_day": [ { "day_of_week": ["MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY"] } ] } ], "offer_restrictions": { "combinable_with_other_offers": true, "combinable_offer_categories": ["OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER"] }, "terms": { "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders. Single use per order. Offer may be combined with any other offers, discounts, or promotions." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/base_offer_5" }, { "offer_id": "offerId2", "offer_source": "OFFER_SOURCE_AGGREGATOR", "action_type": "ACTION_TYPE_FOOD_DELIVERY", "offer_modes": ["OFFER_MODE_ONLINE_ORDER"], "offer_category": "OFFER_CATEGORY_ADD_ON_FEE_REDUCTION_OFFER", "offer_details": { "offer_display_text": "$0 Delivery Fee", "other_offer_detail_text": "Free Delivery" }, "validity_periods": [ { "valid_period": { "valid_from_time": { "seconds": 1768953600 }, "valid_through_time": { "seconds": 1795219200 } } } ], "offer_restrictions": { "combinable_with_other_offers": true }, "terms": { "terms_and_conditions": "Delivery is free at the participating restaurant location on qualifying delivery or takeout orders. Single use per order. Offer may be combined with any other offers, discounts, or promotions." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/addon_offer_1" } ]
عروض الاشتراك
مثال: خصم %10 على جميع الطلبات عندما يشترك المستخدم أو يكون لديه اشتراك نشط.
{ "offer_id": "offer-example-1-takeout", "offer_source": "OFFER_SOURCE_AGGREGATOR", "action_type": "ACTION_TYPE_FOOD_TAKEOUT", "offer_modes": ["OFFER_MODE_ONLINE_ORDER"], "offer_category": "OFFER_CATEGORY_BASE_OFFER", "offer_details": { "offer_display_text": "10% off on all orders", "discount_percent": 10.0 }, "subscription": { "name": "My Provider Subscription", "subscription_duration": { "seconds": 31536000 }, "cost": { "units": 50, "currency_code": "USD" } }, "validity_periods": [ { "valid_period": { "valid_from_time": { "seconds": 1768953600 }, "valid_through_time": { "seconds": 1795219200 } } } ], "offer_restrictions": { "combinable_with_other_offers": false }, "terms": { "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders with a subscription. Single use per order." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/subscription_offer_1" }
التنفيذ والقيود
يوضّح هذا القسم بالتفصيل المتطلبات وأفضل الممارسات المتعلقة بمواصفات تنفيذ العروض والقيود المرتبطة بها.
وضع توصيل الطلبات (التوصيل والاستلام)
إذا كان العرض الترويجي الواحد ينطبق على كل من التوصيل والوجبات الجاهزة، يجب أن يتضمّن عرضَين في الخلاصة. يجب أن يتضمّن كل إدخال سمة ActionType مخصّصة:
ACTION_TYPE_FOOD_DELIVERYACTION_TYPE_FOOD_TAKEOUT
يضمن ذلك أن يظهر للمستخدمين الذين يصلون إلى موقع الشريك الإلكتروني سياق التنفيذ الصحيح.
الفترات الزمنية
من المتوقّع أن تظهر العروض على الصفحة المقصودة للعرض لجميع المستخدمين سواء كانوا مسجّلين الدخول إلى موقعك الإلكتروني أو تطبيقك أم لا. إذا كان العرض صالحًا خلال فترة زمنية محدّدة، يجب تضمين الحقل validity_periods.valid_period لتحديد مدة الصلاحية. يؤدي ذلك إلى منع عرض العرض الترويجي خارج الفترة الزمنية المحدّدة. يجب أيضًا ضبط الفترة الزمنية إذا كان العرض يظهر على عنوان URL الخاص به خلال ساعات معيّنة من اليوم. على سبيل المثال، إذا كانت الصفحة المقصودة لا تعرض العروض عندما يكون المطعم مغلقًا، يجب تضمين أوقات الفتح والإغلاق في TimeOfDayWindow.
التعامل مع الأطر الزمنية التي تتجاوز منتصف الليل
يجب تقسيم العروض التي تمتد إلى ما بعد منتصف الليل (على سبيل المثال، العروض الصالحة من الساعة 10:00 مساءً يوم الثلاثاء إلى الساعة 2:00 صباحًا يوم الأربعاء) لتتم معالجتها بشكل صحيح من خلال مسار نقل البيانات. الشرط: استخدِم الحقل TimeOfDayWindow لتقسيم النافذة إلى شريحتَين مختلفتَين:
- الشريحة 1: من الساعة 10:00 مساءً إلى 11:59:59 مساءً في يوم البدء (مثلاً، الثلاثاء).
- الشريحة 2: من الساعة 12:00 صباحًا حتى الساعة 2:00 صباحًا في اليوم التالي (على سبيل المثال، الأربعاء).
يضمن ذلك أن تظهر صلاحية العرض بدقة طوال الفترة بأكملها.
مواصفات الرسوم
يمكن تحديد رسوم التوصيل والطلبات الخارجية باستخدام الحقل OfferDetails.additional_fees. يجب تحديد رسم الخدمة الإضافي باستخدام OfferDetails.convenience_fee.