الوقت والرسوم لاستيفاء الطلب

الهدف: معرفة كيفية تحديد مدة تنفيذ الطلب والرسوم المتعلقة بالروابط التي تؤدي إلى إجراءات طلب الطعام لاستلامه وتوصيله، وكيفية تعديل القيم عند حدوث تغيير

ملاحظة: ينطبق هذا الدليل فقط على الشركاء الذين يجرون إعدادًا حاليًا للمستودع من خلال دمج إعادة توجيه الطلبات في مركز الإجراءات مع إجراءات طلب الطعام.

يقدم هذا الدليل التوجيهي شرحًا لما يلي:

1. وصف مفصّل لحالات الاستخدام المرتبطة بالرسوم ومدة التنفيذ
2. تعليمات محدّدة حول كيفية تحديد مدة توصيل الطلبات والرسوم مقابل action_link في خلاصاتك
3. توقعات الدقة

للاطّلاع على عيّنة كاملة تعرض استخدام مدة توصيل الطلبات ورسومها، يمكنك مراجعة نموذج EPA (نموذج طلب إعادة التوجيه).

حالات الاستخدام المتعلقة بالرسوم ومدة التنفيذ

حالات استخدام الرسوم

نوفر طرقًا مختلفة لتحديد الرسوم. توضح النقاط أدناه حالات الاستخدام المختلفة المتاحة، بالإضافة إلى بعض الأمثلة على اللغات المشابهة لما سيظهر للمستخدم في الواجهة الأمامية.

• الرسوم الثابتة: "رسوم التسليم 5 دولار أمريكي" أو "5 دولار أمريكي على رسوم الخدمة"
• الرسوم بالنسبة المئوية: "رسوم التسليم 5%" أو "رسوم الخدمة 5%"
• نطاقات الرسوم: "رسوم التسليم من 2 إلى 10 دولار أمريكي" أو "رسوم الخدمة من 3% إلى 6%"
• نطاقات مفتوحة: "تبدأ رسوم التسليم من %5" أو "رسوم الخدمة تصل إلى 20 دولار أمريكي (أو ما يعادله بالعملة المحلية)"

كما هو موضّح في الأمثلة أعلاه، يمكن تحديد الرسوم كرسوم تسليم أو رسوم خدمة. يمكنك أيضًا تحديد رسوم متعددة (مثل "رسوم الخدمة من 5% إلى 10%، رسوم التسليم 5 دولار أمريكي").

لا يمكن استخدامها في حالات الاستخدام التي تتطلب تعديل الرسوم على مدار اليوم أو تغييرها استنادًا إلى معلومات حول المستخدم.

حالات الاستخدام لوقت التنفيذ

نسمح بعدة تنسيقات مختلفة لتحديد وقت التوفّر للمساعدة في ضمان تقديم بيانات دقيقة. توضح النقاط أدناه حالات الاستخدام المختلفة المتاحة، بالإضافة إلى بعض الأمثلة على اللغات المشابهة لما سيظهر للمستخدم في الواجهة الأمامية.

• أوقات محددة: "يتم التوصيل بعد 30 دقيقة" أو "الاستلام بعد 15 دقيقة"
• النطاقات الزمنية: "يتم تسليم الطلب بعد 30 دقيقة إلى ساعة واحدة" أو "استلام الطلب بعد 15 إلى 20 دقيقة".
• نطاقات زمنية مفتوحة: "يتم توصيل الطلبات خلال أكثر من 10 دقائق" أو "استلام الطلب خلال أقل من ساعة"

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

لا يمكن استخدام هذه الميزة في حالات الاستخدام التي تتطلب تعديل الأوقات على مدار اليوم، أو تغييرها استنادًا إلى معلومات عن المستخدم.

تحديد مدة توصيل الطلب من خلال الخلاصات

يتم تضمين وقت تنفيذ الطلب لروابط الإجراءات في رسالة خلاصة التاجر action_link كجزء من حقل food_ordering_metadata. لكل action_link مرتبط بالتاجر، عليك تقديم معلومات توصيل الطلب باستخدام أحد مسارات الرسائل.

وقت توصيل الطلب ثابت

• Merchant.action_link.food_ordering_metadata.fulfillment_lead_time_duration

يجب أن تكون هذه الرسائل بالتنسيق التالي:

{
  "fulfillment_lead_time_duration": {
    "seconds" : 1800
  }
}

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

• Merchant.action_link.food_order_metadata.fulfillment_lead_time_duration_range

يجب أن تكون هذه الرسالة بالتنسيق التالي:

{
  "fulfillment_lead_time_duration_range": {
    "min_duration": {
       "seconds" : 1800
     },
    "max_duration": {
     "seconds" : 2400
    }
  }
}

تحذير: لا تحدّد كلاً من fulfillment_lead_time_duration وfulfillment_lead_time_duration_range كجزء من عنصر action_link واحد.

ملاحظة: تعد السمات fulfillment_lead_time_duration وfulfillment_lead_time_duration_range.min_duration وfulfillment_lead_time_duration_range.max_duration من النوع google.protobuf.Duration، وتوفّر للمستخدمين الوقت المقدّر للوصول لإجراء توصيل الطلبات.

ملاحظة: إذا كان لدى تاجر واحد خيارات متعددة لتوصيل الطلب (استلام الطلب وتوصيله)، يجب تحديد مدة توصيل الطلب بشكل منفصل باستخدام خيارين action_link منفصلين. يُرجى مراجعة التفريق بين خدمة استلام الطعام في خدمة استلام الطلب عن خدمة التوصيل لفهم توفير عدة action_link لكل تاجر.

ملاحظة: للحصول على التعريف المرجعي للسمة food_ordering_metadata، يمكنك الاطّلاع على مرجع خلاصة التاجر. للاطّلاع على نموذج خلاصة يتضمّن مدة توصيل الطلب بتنسيق JSON، يُرجى الاطّلاع على نموذج رمز البيانات الوصفية لطلب الطعام.

تحديد الرسوم من خلال الخلاصات

كما هو الحال مع مدة توصيل الطلب، يمكن تضمين الرسوم كجزء من رسالة action_link ضمن الحقل food_ordering_metadata. يمكنك تقديم معلومات الرسوم لكل action_link مرتبطة بتاجر باستخدام مسار الرسالة:

merchant.action_link.food_ordering_metadata.fee_details

في ما يلي العديد من الأمثلة لحالات الاستخدام المختلفة.

• رسوم تسليم ثابتة قيمتها 1.99 دولار أمريكي:

  [
    {
      "type": "DELIVERY",
      "fee_amount": {
        "amount": {
          "currency_code": "USD",
          "units": "1",
          "nanos": "990000000"
        }
      }
    }
  ]
  

• رسوم تسليم بنسبة مئوية قدرها 5.6%.

  [
    {
      "type": "DELIVERY",
      "fee_amount": {
        "cart_percentage": {
          "value": "5.6"
        }
      }
    }
  ]
  

• تتراوح رسوم الخدمة بين 1.99 دولار أمريكي و9.99 دولار أمريكي

  [
    {
      "type": "SERVICE",
      "fee_amount": {
        "amount_range": {
          "min_amount": {
            "currency_code": "USD",
            "units": "1",
            "nanos": "990000000"
          },
          "max_amount": {
            "currency_code": "USD",
            "units": "9",
            "nanos": "990000000"
          }
        }
      }
    }
  ]
  

• تتراوح النسبة المئوية لرسوم الخدمة بين 1.2% و2.7%

  [
    {
      "type": "SERVICE",
      "fee_amount": {
        "cart_percentage": {
          "value_range": {
            "min_value": "1.2",
            "max_value": "2.7"
          }
        }
      }
    }
  ]
  

• رسوم خدمة قدرها 5 دولارات ورسوم تسليم تبلغ 1.2%.

  [
    {
      "type": "SERVICE",
      "fee_amount": {
        "amount": {
          "currency_code": "USD",
          "units": "5",
          "nanos": "0"
        }
      }
    },
    {
      "type": "DELIVERY",
      "fee_amount": {
        "cart_percentage": {
          "value": "1.2"
        }
      }
    }
  ]
  

ملاحظة: الإدخالان amount وamount_range من النوع google.type.Money

دقة الرسوم ومدة التنفيذ

دقة الرسوم

عندما تقدّم بيانات رسوم لتاجر، نتوقع منك تقديم وصف دقيق لرسومك. يجب تضمين جميع رسوم التسليم والخدمة التي قد تنطبق على الطلب.

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

إذا لم تكن متأكدًا من الإجراء المطلوب على وجه التحديد، يُرجى التواصل مع جهة اتصال "مركز الإجراءات".

دقة مدة تنفيذ الطلبات

نحن ندرك أنّ تفاصيل وقت تنفيذ الطلبات تتغيّر استنادًا إلى مجموعة متنوعة من العوامل. وتشمل هذه العوامل ما يلي:

• التغييرات في مدة تنفيذ الطلب استنادًا إلى حجم الطلب
• التغييرات في وقت توصيل الطلبات استنادًا إلى الوقت اللازم لإكمال الطلب والدفع
• وقت الاستجابة بين وقت تعديل تغييرات وقت تنفيذ الطلب من خلال الخلاصات
• عنوان التسليم الخاص بالمستخدم.

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

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

إذا لم تكن متأكدًا من الإجراء المطلوب على وجه التحديد، يُرجى التواصل مع جهة اتصال "مركز الإجراءات".