本教學課程將逐步說明:
- 詳細說明支援的費用與出貨時間
- 在動態饋給中指定
action_link
訂單出貨時間和費用的具體操作說明 - 準確性的期望
如需顯示訂單出貨時間和費用的完整動態饋給範例,請參閱 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 聯絡人。