このページは Cloud Translation API によって翻訳されました。

フルフィルメント時間と手数料（従来版のみ）

このチュートリアルでは、次のことについて説明します。

サポートされている料金とフルフィルメント時間のユースケースの概要
フィード内の action_link の注文フルフィルメント時間と料金を指定する具体的な手順
精度に対する期待

注文フルフィルメント時間と手数料の使用状況を示す完全なフィードサンプルについては、注文リダイレクト EPA のサンプルをご覧ください。

料金とフルフィルメント時間のユースケース

料金のユースケース

手数料を指定するには、いくつかの方法があります。以下の点では、サポートされているさまざまなユースケースと、ユーザーがフロントエンドに表示されるものと同様の言語の例について説明します。

固定料金: 「配送料 $5」または「サービス料 $5」
料金の割合: 「配送手数料 5%」または「サービス手数料 5%」
料金の範囲: 「送料 $2 ～$10」または「サービス料 3%～ 6%」
範囲の指定なし: 「配送料は 5% 以上」または「サービス手数料は $20 まで」

上記の例に示すように、料金は配送料またはサービス料のいずれかとして指定できます。複数の手数料を指定することもできます（例: 「サービス料 5%～ 10%、配送料 $5」）。

料金を 1 日を通して更新する必要があるユースケースや、ユーザーに関する情報に基づいて料金を変更する必要があるユースケースはサポートされていません。

フルフィルメント時間のユースケース

正確なデータを提供できるように、空き時間の指定には複数の形式を使用できます。以下の点は、サポートされているさまざまなユースケースと、ユーザーがフロントエンドで目にするような例文を示しています。

固定時間: 「30 分以内に配達」または「15 分以内に集荷」
時間帯: 「30 分～ 1 時間以内に配達」または「15 ～ 20 分以内に集荷」
時間の範囲が指定されていない場合: 「10 分以上で配達」または「1 時間以内に集荷」

集荷と配達の両方で、共通の形式（後述）を使用してフルフィルメント時間を指定できます。上記の例に示すように、ユーザーに表示されるテキストには、アクションリンクで指定されたフルフィルメントタイプが反映されます。

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
    }
  }
}

警告: 1 つの action_link オブジェクトの一部として fulfillment_lead_time_duration と fulfillment_lead_time_duration_range の両方を指定しないでください。

注: fulfillment_lead_time_duration、fulfillment_lead_time_duration_range.min_duration、fulfillment_lead_time_duration_range.max_duration は google.protobuf.Duration 型で、フルフィルメントアクションの予定時刻をユーザーに提供します。

フィードを使用して料金を指定する

注文の処理時間と同様に、料金は 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"
        }
      }
    }
  }
]

2 つの料金（サービス手数料 $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 です。

料金とフルフィルメント時間の正確性

料金の精度

販売者の手数料データを提供する際は、手数料を正確に表す必要があります。注文に適用される可能性のあるすべての配送料とサービス料を含める必要があります。

料金は時間の経過やユーザーによって異なる場合があります。そのため、料金を範囲として指定できます（範囲は開放型でもかまいません）。手数料が大幅に異なる場合は、取引中にユーザーに表示される手数料が範囲内に含まれるようにしてください。

お客様のケースで具体的に何が必要か不明な場合は、Actions Center の担当者にお問い合わせください。

注文処理時間の正確性

注文の処理時間はさまざまな要因によって変わることを理解しております。これらの要因には次のようなものがあります。

注文サイズに応じた注文処理時間の変更
注文と購入手続きの完了時間に基づく注文処理時間の変更
注文のフルフィルメント時間の変更がフィードを通じて更新されるまでのレイテンシ
ユーザーの配送先住所。

これらの要因のいずれかにより、最初にユーザーに表示された注文のフルフィルメント時間が、購入手続き時に表示されるフルフィルメント時間と正確に一致しない場合があります。フルフィルメント時間の実装の目的は、これらの問題を完全に排除することではなく、可能な限り頻繁にユーザーに明確な情報を提供することである。

パートナーは、可能な限り多くのユーザーに正確なフルフィルメント時間を表示できる実装を提供することが期待されます。これらの要因によりタイミングに大きなばらつきがある場合は、そのばらつきを包含する時間帯を指定することをおすすめします。また、注文の詳細によりフルフィルメント時間が変更される場合は、注文フローに到達したときにユーザーに明確に表示する必要があります。

お客様のケースで具体的に何が必要か不明な場合は、Actions Center の担当者にお問い合わせください。