يُبرز هذا الدليل متطلبات وأمثلة على عروض طلب الطعام.
الأهلية والسياسات
يُبرز هذا القسم معايير الأهلية المهمة التي يجب أن يلتزم بها الشركاء عند تقديم العروض. من المهم اختبار جميع أنواع العروض التي تخطط لإطلاقها أثناء اختبار خلاصة وضع الحماية. إذا لم تكن متأكدًا مما إذا كان العرض مؤهلاً، يُرجى التواصل مع جهة اتصال عمليات الشركاء (POC) في Google.
استبعاد العروض المخصّصة والعروض التي تُستخدم مرة واحدة
لضمان توفير تجربة عالية الجودة ومتّسقة للمستخدمين، يجب عدم تضمين العروض التي تقتصر على مجموعات فرعية معيّنة من المستخدمين. لا تكون العروض المخصّصة التي يتم إنشاؤها للمستخدمين المحدّدين فقط مؤهّلة. يُسمح بالعروض على مستوى المنصة والمؤهّلة لجميع المستخدمين، مثل المستخدمين الجدد أو الذين يطلبون للمرة الأولى من مطعم معيّن، شريطة أن يتم عرض العرض على الصفحة المقصودة للعرض لجميع المستخدمين. يجب أن يتم توضيح شروط العرض في عنوان العرض وعلى الصفحة المقصودة لعنوان URL الخاص بالعرض. يجب أن تكون العروض مرئية على الصفحة المقصودة للعرض لجميع المستخدمين عند تسجيل الخروج أو تسجيل الدخول إلى موقعك الإلكتروني أو تطبيقك.
العروض التي تتضمّن رموز قسائم
تتطلب بعض العروض إدخال المستخدم رمز قسيمة، مثل "طبِّق الرمز SAVE20 للحصول على خصم% 20 على الفاتورة الإجمالية". من المهم ملاحظة أنّ Google لا تعرض رموز القسائم من تعريف القسيمة. يمكن للشركاء تضمين هذه المعلومات ضمن الـ OfferDetails.offer_display_text لعرضها للمستخدمين. تندرج العروض المستندة إلى القسائم بشكل عام ضمن فئتَين:
- العروض التي يتم فيها تقديم القسيمة تلقائيًا عند الدفع لأي مستخدم يصل من Google. يُسمح بهذه العروض.
- لا يُسمح بالعروض التي تتطلب من المستخدم إدخال رمز القسيمة عند الدفع ولكن لا تقدّم تعليمات حول كيفية تطبيق رمز القسيمة على الصفحة المقصودة لعنوان URL الخاص بالعرض، أو لا تطبّق القسيمة تلقائيًا عند اتّباع عنوان URL الخاص بالعرض.
محتوى العرض وبنيته
يوضّح هذا القسم متطلبات محتوى العروض وبنيتها المقدَّمة في الخلاصة، بما في ذلك أمثلة على البيانات الوصفية المنظَّمة.
نص العرض ومواصفاته
إنّ OfferDetails.offer_display_text هو حقل مطلوب يعمل كعنوان موجز لضمان ظهوره فورًا في قسم العروض على "بحث Google"، مثل "خصم 10$" أو "توفير %15".
إنّ OfferDetails.offer_specification
هو حقل مطلوب "أحد الحقول التالية" ضمن OfferDetails. يعني ذلك أنّه يجب تقديم حقل واحد فقط من الحقول الثلاثة التالية لتحديد الصفقة:
discount_valuediscount_percentageother_offer_details_text
إنّ الحقل OfferDetails.other_offer_details_text
هو حقل نصي ذو تنسيق حر يُستخدم لتكميل offer_display_text
عندما لا يمكن التعبير عن العرض كقيمة خصم ثابتة أو نسبة مئوية. إذا كان offer_display_text كافيًا بالفعل لنقل جميع المعلومات الضرورية عن العرض، يجب ملء الحقل other_offer_details_text بالنص نفسه الذي تم استخدامه في offer_display_text. ومع ذلك، بالنسبة إلى الصفقات المعقّدة، يجب أن يقدّم هذا الحقل وصفًا محدّدًا للمكافأة.
حقول البيانات الوصفية المنظَّمة
لتحسين وضوح العرض والسماح بتحسين الترتيب والتصفية، يجب أن يقدّم الشركاء بيانات العرض الوصفية في الحقول المنظَّمة المعنيّة. الحقل terms.terms_and_conditions مطلوب. يجب أن تتضمّن القيمة شروطًا حول كيفية الاستفادة من العرض. على سبيل المثال، يمكنك ملء هذا الحقل بالشروط التفصيلية التي يتم عرضها للمستخدمين على الصفحة المقصودة للعرض.
يجب أن تستخدم العروض الخاصة بمجموعات فرعية من السلع terms.terms_and_conditions أو offer_restrictions.inclusions و offer_restrictions.exclusions لتحديد السلع المؤهّلة.
أمثلة على 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" }
عرض "اشترِ قطعة واحصل على الثانية مجانًا"
مثال: اشترِ مقبّلاً واحصل على الثاني مجانًا، العرض سارٍ من الإثنين إلى الخميس
{ "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" }
عرض خصم بنسبة مئوية
مثال: خصم% 25 على جميع السندويشات
{ "offer_id": "offer-example-3-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": "25% off on all Sandwiches", "discount_percent": 25.0 }, "validity_periods": [ { "valid_period": { "valid_from_time": { "seconds": 1768953600 }, "valid_through_time": { "seconds": 1795219200 } } } ], "offer_restrictions": { "combinable_with_other_offers": true, "combinable_offer_ids": ["offer-example-4-delivery"], "inclusions": [ "Sandwiches" ] }, "terms": { "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders. Applies to specific items only. Single use per order. May be combined with any other offers, discounts, or promotions." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/base_offer_2" }
عرض التوصيل مجانًا
مثال: التوصيل مجانًا للطلبات التي تزيد قيمتها عن 30$. وتبلغ تكلفة التوصيل 7.00 $في الحالات الأخرى.
{ "offer_id": "offer-example-4-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": "Free delivery on orders over $30", "discount_value": { "currency_code": "USD", "units": 7 }, "min_spend_value": { "currency_code": "USD", "units": 30 } }, "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": "For use only at the participating restaurant location on qualifying delivery orders with $30 minimum spend. Delivery is $7.00 otherwise. Single use per order. May be combined with any other offers, discounts, or promotions." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/base_offer_3" }
مثال على عرض أساسي مع عرض إضافي
مثال: يقدّم مطعم خصمًا بنسبة% 10 على وجبة الغداء فقط في أيام الأسبوع، وخصمًا بنسبة% 5 في أي وقت عند الدفع باستخدام بطاقة ائتمان معيّنة.
[ { "offer_id": "offerId1", "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", "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_TAKEOUT", "offer_modes": ["OFFER_MODE_ONLINE_ORDER"], "offer_category": "OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER", "offer_details": { "offer_display_text": "5% off", "discount_percent": 5.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_ids": ["offerId1"] }, "payment_instrument": { "items": [ { "type": "PAYMENT_INSTRUMENT_CREDIT_CARD", "name": "Participating Credit Card" } ], "provider_name": "Card Provider" }, "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/addon_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. استخدِم قيمة نطاق الرسوم للرسوم المتغيّرة، على سبيل المثال، إذا كانت رسوم التوصيل تتغيّر استنادًا إلى موقع المستخدم.