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

フルフィルメント時間と手数料

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

サポートされる料金とフルフィルメント時間のユースケースの概要
フィードで action_link の注文フルフィルメント時間と料金を指定する方法の具体的な手順
精度に関する要求事項

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

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

料金のユースケース

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

固定料金: 「配送料 500 円」または「サービス手数料 500 円」
割合による料金: 「配送料 5%」または「サービス手数料 5%」
料金の範囲: 「配送料: 2 ～ 10 ドル」、「サービス手数料 3%～ 6%」
制限なしの範囲: 「配送料は 5% から」、「サービス手数料は 2,000 円以下」

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

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

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

正確なデータを提供できるように、利用可能時間の指定にはさまざまな形式を使用できます。以下のポイントでは、サポートされているさまざまなユースケースと、フロントエンドで表示されるものと同様の言語の例について説明します。

固定時間: 「30 分以内に配達」または「15 分で店舗受取可」
時間範囲: 「30 分～ 1 時間以内にお届け」、「15 ～ 20 分で店舗受取可」
時間制限の指定なし: 「10 分以内に配達」または「1 時間以内に受け取り」

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

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

フィードを使用して注文フルフィルメント時間を指定する

アクションリンクの注文フルフィルメント時間は、food_ordering_metadata フィールドの一部として、販売者フィードの action_link メッセージに含まれます。販売者に関連付けられた 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 オブジェクトの一部として 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 型であり、フルフィルメントアクションの到着予定時刻をユーザーに提供します。

フィードで料金を指定する

注文フルフィルメント時間と同様に、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"
        }
      }
    }
  }
]

手数料は 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 です。

手数料とフルフィルメント時間の精度

手数料の精度

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

料金は、時間の経過とともにユーザーによって異なる可能性があることを認識しています。このため、料金を無制限の範囲も含め、範囲として指定できるようになっています。手数料が大幅に変動する場合は、ユーザーが取引中に表示される手数料を含む範囲を指定するようにします。

ケースに具体的に何が必要かわからない場合は、アクションセンター担当者にお問い合わせください。

注文フルフィルメント時間の精度

Google は、さまざまな要因によって注文フルフィルメント時間の詳細が変わることを理解しています。たとえば、次のような要因があります。

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

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

パートナーは、ベストエフォートベースで、正確なフルフィルメント時間が可能な限り頻繁にユーザーに表示される実装を提供することが求められます。これらの要因によってタイミングに大きなばらつきがある場合は、そのばらつきを含む時間範囲を指定することをおすすめします。また、注文の詳細によってフルフィルメントの時間が変更される場合は、注文フローで到着した時点でユーザーに明確に示す必要があります。

このケースに具体的に何が必要かわからない場合は、アクションセンター担当者にお問い合わせください。