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

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

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

يُبرز هذا القسم معايير الأهلية المهمة التي يجب أن يلتزم بها الشركاء عند تقديم العروض. من المهم اختبار جميع أنواع العروض التي تخطط لإطلاقها أثناء اختبار خلاصة وضع الحماية. إذا لم تكن متأكدًا مما إذا كان العرض مؤهلاً، يُرجى التواصل مع جهة اتصال عمليات الشركاء (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_value
  • discount_percent
  • other_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، يُعتبر العرض ساريًا على إجمالي مبلغ الطلب.

عروض رسوم التسليم

يجب أن تستخدم عروض رسوم التسليم 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 على عصير التوت

مثال: عرض على مستوى السلعة بخصم% 50

{
  "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-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$" مع أي عرض أساسي للموقع الجغرافي.

[
  {
    "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",
      "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 dellivery"
    },
    "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"
  }
]

التنفيذ والقيود

يوضّح هذا القسم المتطلبات وأفضل الممارسات المتعلقة بمواصفات تنفيذ العروض والقيود المرتبطة بها.

وضع التنفيذ (التسليم واستلام الطلبات من المتجر)

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