المتطلبات وأمثلة على العروض

يبرز هذا الدليل المتطلبات والأمثلة على عروض "طلب الطعام".

الأهلية والسياسات

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

استبعاد العروض المخصّصة والعروض التي يمكن الاستفادة منها لمرّة واحدة

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

العروض التي تتضمّن رموز قسائم

تتطلّب بعض العروض أن يُدخل المستخدم رمز قسيمة، مثل "استخدِم الرمز SAVE20 للحصول على خصم% 20 على إجمالي الفاتورة". يُرجى العِلم أنّ محرّك بحث Google لا يعرض رموز القسائم من تعريف القسيمة. يمكن للشركاء تضمين هذه المعلومات ضمن OfferDetails.offer_display_text لعرضها للمستخدمين. تندرج العروض المستندة إلى القسائم بشكل عام ضمن فئتَين:

  • العروض التي يتم فيها تقديم القسيمة تلقائيًا عند الدفع لأي مستخدم يصل من Google. ويُسمح باستخدامها.
  • لا يُسمح بالعروض التي تتطلّب من المستخدم إدخال رمز القسيمة عند الدفع ولكنّها لا تقدّم تعليمات حول كيفية تطبيق رمز القسيمة على الصفحة المقصودة لعنوان URL الخاص بالعرض، أو لا تطبّق القسيمة تلقائيًا عند اتّباع عنوان URL الخاص بالعرض.

محتوى العرض وبنيته

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

نص العرض الترويجي ومواصفات العرض الترويجي

‫OfferDetails.offer_display_text هو حقل إلزامي يعمل كعنوان موجز لضمان الظهور الفوري في قسم العروض على "بحث Google"، مثل "خصم بقيمة 10 دولار أمريكي" أو "توفير %15".

OfferDetails.offer_specification هو حقل مطلوب من نوع "one of" ضِمن OfferDetails. وهذا يعني أنّه يجب تقديم حقل واحد بالضبط من الحقول الثلاثة التالية لتحديد الصفقة:

  • discount_value
  • discount_percentage
  • other_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. يجب أن تتضمّن القيمة شروطًا حول كيفية الاستفادة من العرض. على سبيل المثال، يمكنك ملء هذا الحقل بالعبارات التفصيلية التي تظهر للمستخدمين على الصفحة المقصودة الخاصة بالعرض.

أمثلة على 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 Sandwitches",
    "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
  },
  "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_DELIVERY
  • ACTION_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. استخدِم قيمة نطاق الرسوم للرسوم المتغيرة، مثلاً إذا كانت رسوم التوصيل تتغيّر حسب الموقع الجغرافي للمستخدم.