このチュートリアルでは、次のことを説明します。
- 料金と費用の概要フルフィルメント時間のユースケースをサポート
- 注文フルフィルメントの時間と手数料を指定する具体的な手順 サービス フィード。
- 期待される精度
注文の処理時間と手数料の使用状況を示す完全なフィード サンプルについては、 注文リダイレクト EPA のサンプル
料金
料金を指定する方法はいくつかあります。次に例を示します。
- 固定料金: 「配送料 5 ドル」「サービス手数料: $5」
- 手数料率: 「送料 5%」または「サービス手数料 5%」
- 手数料帯: 「送料 2 ~ 10 ドル」「サービス手数料 3%~ 6%」
- 制限のない範囲「配送料は 5% 以上」または「サービス手数料は最大 20 ドル」
料金は、配送料またはサービス手数料として指定できます。 複数の手数料を指定することもできます(例: サービス手数料 5%~ 10%、配送料 5 ドル)。
情報に基づいて料金を変更する必要があるユースケースはサポート対象外 ユーザーに関するメッセージです。
料金の例
配送料と受け取り手数料
アプリケーションは「DELIVERY」と「SERVICE」の料金タイプをサポートしています。配信
{ "fee": { "fee_id": "12345/delivery_fee", "fee_type": "DELIVERY", "fixed_amount": { "currency_code": "USD", "units": 10, "nanos": 0 }, "service_ids": ["service/entity002"] } }
サービス
{ "fee": { "fee_id": "12345/service_fee", "fee_type": "SERVICE", "fixed_amount": { "currency_code": "USD", "units": 10, "nanos": 0 }, "service_ids": ["service/entity002"] } }
さまざまな料金タイプ
選択した料金を指定する使いやすい例を次に示します。 あります。固定
{ "fee": { "fee_id": "12345/delivery_fee", "fee_type": "DELIVERY", "fixed_amount": { "currency_code": "USD", "units": 10, "nanos": 0 }, "service_ids": ["service/entity002"] } }
カートの割合
{ "fee": { "fee_id": "12345/delivery_fee", "fee_type": "DELIVERY", "cart_percentage": { "base_value": { "currency_code": "USD", "units": 3, "nanos": 500000000 }, "percentage_of_cart_value": 10 }, "service_ids": [ "service/entity002" ] } }
範囲
{ "fee": { "fee_id": "12345/delivery_fee", "fee_type": "DELIVERY", "range_amount": { "min_amount": { "currency_code": "USD", "units": 3, "nanos": 500000000 }, "max_amount": { "currency_code": "USD", "units": 5, "nanos": 600000000 } }, "service_ids": [ "service/entity002" ] } }
フルフィルメント時間
確実にお届けできるよう、お届け日数はさまざまな形式で指定できます 正確なデータを提供します以下では、サポートされているさまざまなユースケースについて説明し、 ユーザーがフロントエンドで目にするものに似たサンプル言語を使用します。
- 固定時間: 「30 分以内に配達」または「15 分後に受け取り」
- 期間: 「30 分~ 1 時間で配達」または「15 ~ 20 分後に受け取り」
発送準備時間は、受け取りと配送の両方に共通の形式を使用して指定できます。 (下記をご覧ください)。
ユーザーに関する情報に基づいて到着予定時刻を変更する必要があるユースケースはサポートされていません。
フルフィルメント時間の例
アクション リンクの注文処理時間がサービス フィードに含まれています
ETA
メッセージの一部として
FoodOrderingService
表示されます。
固定
{ "service": { "service_id": "service-id", "service_type": "TAKEOUT", "parent_entity_id": "entity-id", "lead_time": { "min_lead_time_duration": "900s" }, "action_link_id": "action-link-id" } },
期間
{ "service": { "service_id": "service-id", "service_type": "TAKEOUT", "parent_entity_id": "entity-id", "lead_time": { "min_lead_time_duration": "900s" "max_lead_time_duration": "1200s" }, "action_link_id": "action-link-id" } },
フルフィルメントの時間枠
ServiceHours
では、
フルフィルメントの時間は、特定の時間帯に設定できます。デフォルト
lead_time
が以下に設定されました:
FoodOrderingService
を使用
使用時間外に行われます
lead_time
2400s
は午前 11 時から午後 1 時 30 分まで表示されます。
1200s
のlead_time
が次の日付より前に表示されます
午前 11 時および午後 1 時 30 分以降。
{ "data": [ { "service": { "service_id": "merchant-1-service-delivery", "service_type": "DELIVERY", "parent_entity_id": "merchant-1", "lead_time": { "min_lead_time_duration": "1200s" }, "action_link_id": "merchant-1-takeout-delivery-action" } }, { "service_hours": { "hours_id": "merchant-1-advance-hours-delivery", "service_ids": ["merchant-1-service-delivery"], "asap_hours": [ { "time_windows": { "time_windows": { "open_time": { "hours": 11 }, "close_time": { "hours": 13, "minutes": 30 } } }, "lead_time": { "min_lead_time_duration": "2400s" } } ] } } ] }
料金とフルフィルメント時間の精度
料金の精度
販売者に手数料データを提供する際は、正確な情報を開示する必要があります。 お客様の手数料を節約できます注文に適用される可能性のあるすべての配送料とサービス手数料を含める必要があります。
料金は時間が経つとユーザーによって異なる場合があることを認識しています。このため、 自由に選択できる範囲を含め、料金を範囲として指定できます。料金が異なる場合 提示する範囲に、ユーザーが請求される可能性のある料金が含まれていることを 表示されます。
ご自身のケースで具体的に何が必要なのかご不明な場合は、 アクション センターの連絡先。
注文フルフィルメント時間の精度
注文処理の具体的な要件については 時間はさまざまな要因で変化します。たとえば、次のような要因があります。
- 注文数量に応じた注文フルフィルメント時間の変更
- 注文の完了までの時間に基づく、注文フルフィルメントの時間の変更 購入手続き
- 注文処理時間の変更がフィードで更新されるまでのレイテンシ
- ユーザーの配送先住所。
これらの要因のいずれかが原因で、注文が履行されない場合があります。 最初にユーザーに表示される時刻が、ユーザーが最初に表示した時刻とは正確ではありません。 購入手続きの際に表示されますフルフィルメント時間の実装の目標は、 これらは完全に排除しますが できるだけ頻繁に更新することです。
パートナー様は、 フルフィルメントの所要時間は、可能な限り頻繁に、ベスト エフォートでユーザーに表示されます あります。これらの要因によってタイミングが大きく変動する場合は、 その変動が含まれる期間を指定します。 また、注文の詳細によってフルフィルメント時間が変更される場合は、 注文フローの到着時にユーザーに明示する必要があります。
具体的に何をすればよいかわからない場合は が必要な場合は、アクション センターの担当者にお問い合わせください。
料金と到着予定時刻をタイムリーに更新
通常のフィードのアップロードを使用した変更には、少なくとも 2 時間かかることがあります ありません。これは、到着予定時刻を変更する予定がある場合は特に重要です できます。
パートナー様には、リアルタイム アップデートを実装することを強くおすすめします。 これにより、API 呼び出しでサービス フィード(料金や到着予定時刻を含む)を 5 分以内に変更できます。