出貨時間和費用

本教學課程將逐步說明：

  1. 詳細說明支援的費用與出貨時間
  2. 在動態饋給中指定 action_link 訂單出貨時間和費用的具體操作說明
  3. 準確性的期望

如需顯示訂單出貨時間和費用的完整動態饋給範例，請參閱 Ordering Redirect EPA 範例。

費用與出貨時間應用實例

費用用途

我們提供多種不同的費用指定方式。以下說明支援的不同用途，以及一些與使用者在前端看到的類似語言範例。

  • 固定費用：「運費 $5 美元」或「服務費 $5 美元」
  • 百分比費用：「運費 5%」或「服務費 5%」
  • 費用範圍：「運費範圍 $2-$10 美元」或「服務費 3%-6%」
  • 開放式範圍：「運費最低 5% 起」或「服務費最多 $20 美元」

如以上範例所示，您可將費用指定為運費或服務費。 您也可以指定多筆費用 (例如「服務費 5%-10%，運費 $5 美元」)。

不支援需要全天更新費用，或是根據使用者資訊進行變更的用途。

出貨時間用途

我們支援多種格式來指定有空時間，協助您提供準確的資料。以下說明支援的不同用途，以及一些與使用者在前端看到的範例語言。

  • 固定時間：「30 分鐘後送達」或「15 分鐘後取貨」
  • 時間範圍：「30 分鐘至 1 小時內送達」或「15-20 分鐘後取貨」
  • 開啟結束時間範圍：「10 分鐘內送達」或「1 小時內取貨」

您可以用通用格式 (如下所述) 指定自取和外送服務的出貨時間。如以上範例所示，使用者看到的文字會反映動作連結中指定的執行要求類型。

不支援需要在一天中隨時更新，或是根據使用者資訊進行變更的用途。

透過動態饋給指定訂單出貨時間

動作連結的訂單出貨時間會包含在商家動態饋給 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
    }
  }
}

透過動態饋給指定費用

與訂單出貨時間類似，您可以在 food_ordering_metadata 欄位下方的 action_link 訊息中加入費用。對於與商家相關的每項 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 聯絡人。