زمان انجام و هزینه ها

این آموزش به شرح زیر است:

  1. توصیف سطح بالایی از موارد استفاده از هزینه و زمان تکمیل پشتیبانی می شود
  2. دستورالعمل‌های خاص درباره نحوه تعیین زمان انجام سفارش و هزینه‌های مربوط به (های) action_link در فیدهای خود
  3. انتظارات برای دقت

برای نمونه فید کامل که استفاده از زمان انجام سفارش و هزینه‌ها را نشان می‌دهد، به نمونه EPA تغییر مسیر سفارش مراجعه کنید.

موارد استفاده هزینه و زمان تکمیل

موارد استفاده از هزینه

ما چندین روش مختلف برای تعیین هزینه ها ارائه می دهیم. نکات زیر کاربردهای مختلف پشتیبانی شده را به همراه چند زبان مثال مشابه آنچه کاربر در قسمت جلویی می بیند، توضیح می دهد.

  • هزینه ثابت: "هزینه تحویل 5 دلار" یا "هزینه خدمات 5 دلار"
  • درصد هزینه: "هزینه تحویل 5٪" یا "هزینه خدمات 5٪"
  • محدوده کارمزد: «هزینه تحویل 2 تا 10 دلار» یا «هزینه خدمات 3 تا 6 درصد»
  • محدوده باز: "هزینه های تحویل از 5٪ شروع می شود" یا "هزینه های خدمات تا 20 دلار"

همانطور که در مثال های بالا نشان داده شده است، هزینه ها را می توان به عنوان هزینه تحویل یا هزینه خدمات مشخص کرد. همچنین امکان تعیین هزینه های متعدد وجود دارد (به عنوان مثال "هزینه خدمات 5٪ - 10٪، هزینه تحویل 5 دلار").

موارد استفاده که مستلزم به‌روزرسانی هزینه‌ها در طول روز یا تغییر بر اساس اطلاعات کاربر هستند، پشتیبانی نمی‌شوند.

موارد استفاده از زمان تحقق

ما به چندین قالب مختلف برای تعیین زمان در دسترس بودن اجازه می‌دهیم تا اطمینان حاصل کنیم که داده‌های دقیق را ارائه می‌دهید. نکات زیر کاربردهای مختلف پشتیبانی شده را به همراه چند زبان مثال مشابه آنچه کاربر در قسمت جلویی می بیند، توضیح می دهد.

  • زمان‌های ثابت: "تحویل در 30 دقیقه" یا "تحویل در 15 دقیقه"
  • محدوده زمانی: "تحویل در 30 دقیقه تا 1 ساعت" یا "تحویل در 15 تا 20 دقیقه"
  • بازه‌های زمانی باز: "تحویل در بیش از 10 دقیقه" یا "تحویل در کمتر از 1 ساعت"

زمان تکمیل را می توان هم برای تحویل و هم برای تحویل با استفاده از یک قالب مشترک (در زیر توضیح داده شده) مشخص کرد. همانطور که در مثال های بالا نشان داده شده است، متن نشان داده شده به کاربران ، نوع انجام مشخص شده در پیوند عمل را منعکس می کند.

موارد استفاده ای که نیاز به زمان به روز رسانی در طول روز یا تغییر بر اساس اطلاعات کاربر دارند، پشتیبانی نمی شوند.

تعیین زمان انجام سفارش از طریق فیدها

زمان انجام سفارش برای پیوندهای اقدام در پیام action_link فید Merchant، به عنوان بخشی از قسمت 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
    }
  }
}

تعیین هزینه ها از طریق فیدها

مشابه زمان انجام سفارش، هزینه ها را می توان به عنوان بخشی از پیام 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"
          }
        }
      }
    ]
    

هزینه و دقت زمان انجام

دقت کارمزد

وقتی داده‌های کارمزد را برای یک تاجر ارائه می‌کنید، از شما انتظار داریم که نمایش دقیقی از کارمزدهای خود ارائه دهید. شما باید تمام هزینه های تحویل و خدماتی که ممکن است برای یک سفارش اعمال شود را درج کنید.

ما می دانیم که هزینه ها ممکن است در طول زمان و بین کاربران متفاوت باشد. به همین دلیل، ما توانایی تعیین هزینه‌ها را به عنوان محدوده، از جمله محدوده‌های پایان باز، ارائه می‌کنیم. در مواردی که کارمزدها می توانند به طور قابل توجهی متفاوت باشند، مطمئن شوید که محدوده ارائه شده شامل هزینه هایی است که کاربر می تواند در طول تراکنش خود ببیند.

اگر مطمئن نیستید که دقیقاً چه چیزی در مورد شما مورد نیاز است، با مخاطب Actions Center خود تماس بگیرید.

دقت زمان انجام سفارش

ما درک می کنیم که ویژگی های زمان انجام سفارش بر اساس عوامل مختلفی تغییر می کند. این عوامل عبارتند از:

  • تغییر در زمان انجام سفارش بر اساس اندازه سفارش
  • تغییرات در زمان انجام سفارش بر اساس زمان تکمیل سفارش و تسویه حساب
  • تأخیر بین زمانی که تغییرات زمان انجام سفارش از طریق فیدها به روز می شود
  • آدرس تحویل کاربر

هر یک از این عوامل ممکن است به شرایطی منجر شود که در آن زمان انجام سفارش که در ابتدا به کاربر نمایش داده می‌شود، زمان دقیقی نباشد که در هنگام تسویه‌حساب مشاهده می‌کند. هدف اجرای زمان تکمیل، حذف کامل این موارد نیست، بلکه ارائه اطلاعات واضح به کاربران تا حد امکان است.

از شرکا انتظار می رود که پیاده سازی را ارائه دهند که منجر به نمایش زمان تکمیل دقیق به کاربران تا آنجا که ممکن است، بر اساس بهترین تلاش باشد. اگر تغییرات قابل توجهی در زمان بندی به دلیل این عوامل وجود داشته باشد، پیشنهاد می کنیم محدوده زمانی را ارائه کنید که این تنوع را در بر می گیرد. علاوه بر این، اگر زمان انجام به دلیل جزئیات سفارش تغییر کند، این زمان باید به طور واضح به کاربران نشان داده شود که هنگام ورود به جریان سفارش شما.

اگر مطمئن نیستید که دقیقاً چه چیزی در مورد شما مورد نیاز است، با مخاطب Actions Center خود تماس بگیرید.