メインコンテンツへスキップ

メニューの設定とメニューの内容

Marketplace APIs are limited access

弊社のマーケットプレイス統合パイプラインは、現在上限に達しています。加盟店オンボーディング用セルフサービスツール開発する当面の間は、新しいパートナーを受け付けておりません。統合の構築にDoorDashにお問い合わせいただくには、 マーケットプレイス統合に関するお問い合わせ フォームにご入力ください。

ネストされたメニューのサンプルデータはどこで確認できますか?

「参照」セクションをご覧ください。

メニューサイズに上限はありますか?

メニューは、最大 25MB までのファイルサイズであれば正常に処理できます。

「おすすめ」セクションはどのように生成されますか?

このセクションは、機械学習を通じた DoorDash による計算に基づいて入力されます。メニュー段階が失敗した場合は、メニューは作成されず、メニュー ID が null になります。

メニューを削除するにはどうすればよいですか?

DoorDash のプラットフォーム上の表示からメニューを削除するには、「active」を「false」に設定するメニュー PATCH リクエストを送信してください。

メニューのステータスを管理できますか?

はい、できます。メニューを有効/無効にするには、必要な結果に応じて、activeフィールドをtrueまたはfalseに設定したメニュー更新リクエストを送信します。

price と base_price の違いは何ですか?

base_price」は、商品/商品の追加オプションレベルで保存できる省略可能なフィールドです。これを使用すると、お客様のテイクアウト用に二重の価格設定を行うことができます。このフィールドには、配達価格に適用されるインフレを除外した、商品/オプションの店内価格が入ります。「price」フィールドは必須フィールドで、商品/オプションの配達価格が入ります(加盟店が希望する場合にはインフレを含めます)。商品/オプションに「base_price」がある場合、テイクアウトメニューにはその価格が適用されます。お客様がサイトでテイクアウトと配達を切り替えると、それに従って価格が「base_price(テイクアウト)」 と「price (配達)」の間で変更されます。お客様のカスタマーエクスペリエンスを守るために、テイクアウト価格のサポートを構築することをお勧めします。詳細については、こちらをご覧ください。この機能を使用することに興味がおありの場合は、ビジネスレベルでこの機能を有効化するよう、DoorDash 担当者に連絡してください。

商品/追加/オプションとは?

ItemExtra

税率の指定方法を教えてください。

2020 年現在、DoorDash は、メニュー内の商品/商品追加オプションレベルでの税率の送信に対応しています。この値を送信すると、マーケットプレイスファシリテーター法が施行されていない州(非 MPF 州)では、この税率を使用して税金が計算されます。率には整数を送信してください。たとえば、ある商品の税率を 5%にしたいものとします。この場合、メニューペイロードで「tax_rate」を「5」(「.05」ではなく)にして送信してください。メニューの税率を送信しなかった場合、サードパーティの税金エンジンで税金が計算されます。メニューの税率を送信することを計画している場合は、DoorDash 担当者にご連絡ください。デフォルトでは、非 MPF 州の加盟店のメニューペイロードで指定された商品レベルの税率のみが適用されます。MPF 州の加盟店の場合は、DoorDash が加盟店に代わって税金を納める必要があるため、DoorDash の税金計算が使用されます。MPF 州の加盟店の中に DoorDash で計算した税額の使用が免除される加盟店があると思われる場合は、DoorDash の主要連絡先にお問い合わせください。この免除は、DoorDash の税務チームの承認を待ち、特別な場合にのみ付与されます。

マーケットプレイスファシリテーター州のリストはどこで入手できますか?

マーケットプレイスファシリテーター州の最新リストはこちらでご確認いただけます。

DoorDash の税エンジンには砂糖入り飲料に課税される砂糖税やボトルデポジットなどのサーチャージが含まれていますか?

現在、DoorDash の税エンジンでは、注文の税金を計算する際にこれらのサーチャージのいずれも含まれていません。このような税金が適用される場合は、いずれも加盟店によってメニューを通じて提供される必要があります。

デフォルトの itemOption を作成するにはどうすればよいですか?

itemOption」がデフォルトで選択されるようにするには、メニューペイロードで値を「true」に設定し、パラメータにデフォルトを含めてください。

カテゴリー、商品、商品オプションはどのように並べられますか?

すべてのエンティティは、メニューペイロードで定義されている「sort_id」に従って並べられます。このフィールドが定義されていない場合、デフォルトではアルファベット順に並べ替えられます。

ラジオボタンを作成するにはどうすればよいですか?

ラジオボタンを作成するには、「max_num_options = 1」、「min_num_options = 1」を設定して 1 つのオプションのみを選択できるようにします。

最小/最大フィールドではそれぞれ何が管理されますか?

これらのフィールドがしっかり連携されるよう、設定が正しく行われているかを確認してください。設定が正しく行なわれていないと、お客様が各フィールドの要件を満たすことができず、カートに商品を追加できないという問題が発生します。たとえば、「min_nim_options = 1」(お客様が少なくとも 1 つのオプションを選択しなければならないことを意味します)を設定しつつ、「max_option_choice_quantity = 0」(お客様がすべてのオプションで 0 以上を選択できないことを意味します)を設定することはできません。

これらフィールドの詳細は以下をご覧ください。

_num_options: 選択できるオプションの数を管理します。最大値が特定の「追加」商品に関して、使用可能なオプションの数を超えることはありません。 この例では、「骨なしチキンウィングのフレーバーを選択」で「min_num_options = 2」、「max_num_options = 2」となっています。これにより、「追加」が必須になり、お客様は選択肢が 2 つを超えないように強制されます。

_option_choice_quantity: 1 つのオプションに指定できる最大数量を管理します。ここに null 以外の値が入る場合、チェックボックスまたはラジオボタンの代わりに複数の数量セレクターが表示されます(以下のスクリーンショットを参照)。 この例では、「min_option_choice_quantity = 2」となっています。これは、お客様が選択するフレーバーごとに 2 個以上のチキンウィングを選択できることを意味します。 この例では、「max_option_choice_quantity = 10」となっています。これは、お客様が選択するフレーバーごとに 10 個以下のチキンウィングを選択できることを意味します。

_aggregate_choice_quantity: 指定できるオプション数量の最大合計数を管理します。 この例では、「min_aggregate_choice_quantity = 10」、「max_aggregate_choice_quantity = 10」となっています。この場合、お客様は、選択するフレーバー全体で合計 10 個のチキンウィングを選択することが強制されます。

num_free_options: option_choice_quantity に関連付けられます。注文に対して選択されたオプションの指定数を超えると、連続する各オプションには価格が適用されます。 この例では、「_num_free_options = 4」となっています。つまり、お客様が 5 個以上のオプションを選択した場合は、送信された価格に応じて、追加オプションごとに課金されることを意味します。 オプションの価格が異なり、選択した数が「num_free_options」を超える場合、DoorDash はより高価なオプションの料金をお客様に請求します。

複数のメニュー(デイパーティング/1 日分割)を維持するには?

複数のメニュー(デイパーティングされたメニュー)を別々の時間で POST すると、その時間に適用されるメニューがデフォルトで表示されます。メニュー 1 の終了時間とメニュー 2 の開始時間の間隔が 1 分未満の場合、連続メニューロジックがこれらのメニューに適用されます。つまりこの場合、DoorDash はメニュー 1 の終了時間に 20 分の余分時間を適用しません。

時間が重複する複数のメニューを POST すると、以下のスクリーンショットのドロップダウンメニューで示されているように、これらすべてのメニューが DoorDash のプラットフォームに表示されます。時間が重複している期間中は、最後に作成されたメニューがデフォルトで表示されます。たとえば、朝食メニューと終日メニューがある場合、最後に作成されたメニューが DoorDash でデフォルト表示されます。

メニューに画像を追加するにはどうすればよいですか?

POS 統合が強化され、当日プルするメニューのその他の部分と一緒に、写真もソースから直接プルされるようになりました。商品に指定された写真の URL が前回のメニュー更新のときと同じだった場合、新しい写真は取り込まれません。写真の URL が新しくなっていた場合は、画像が DoorDash システムに取り込まれ、社内の写真チームに提供されます。画像を受け取ったチームは、画質ガイドラインに基づいて写真の確認、承認、トリミング、およびリンクを行うか、その写真を却下します。このリンクプロセスでは、 POS メニューペイロードから取得したItem<>PhotoURLマッピングを使用して、どの写真をどの商品にリンクする必要があるかが判断されます。承認された画像については、3 営業日以内に画像が表示されるようになります。

URL の要件

  1. 形式が http または https であること
  2. URL 内にクエリパラメータがないこと
  3. 末尾が.JPG、.JPEG、.PNG のいずれかであること
  4. 画像が DoorDash からアクセス可能で、許可要件(403 問題)でロックされていないこと

写真の仕様

DoorDash プラットフォームにおいて、写真がサイトに正しく表示されるには、特定の条件を満たしている必要があります。要件は以下の通りです。

  1. アスペクト比: 16:9

  2. 最大ファイルサイズ: 2MB

  3. 形式: JPG、JPEG、または PNG

    ファイルサイズ、ファイル形式、URL の基準のいずれかが満たされていないと、この新機能はうまく動作せず、写真が商品にリンクされません。写真のアスペクト比の要件が満たされていない場合、DoorDash は、画像の質を維持しながら写真をトリミングするように試みます。トリミングすると構図がおかしくなる場合、写真は却下されます。

DoorDash メニューでアルコールを販売することはできますか?

DoorDash において、アルコールに関する追記に署名すれば、加盟店は当プラットフォームでアルコールを販売することができます。アルコールに関する追記を確認して署名するには、DoorDash の担当者までお問い合わせください。これが完了すると、メニューペイロードにアルコール商品を示すための「is_alcohol」というフラグができます。これを「true」に設定すると、最終的に商品が 21+としてマークされます。法律上の問題を避けるために、アルコール商品は必ずメニューで「true」としてマークされるようにしてください。

メニューに含めることができる商品/代替品/サブ代替品の数に制限はありますか?

DoorDash では、メニュー(ItemOptions、ItemExtraOptions)に合計で約 600,000 個(代替品とサブ代替品を含む)まで商品を載せることができます。この制限に達した場合は、すべてのメニュー PTACH 更新で、最初のメニュー POST で使用したのと同じ「merchant_supplied_id」値を使用していることを確認してください。POST とそれ以降のメニュー PATCH で「merchant_supplied_id」値が変わっていると、一意の値それぞれが新しい商品としてカウントされ、思ったよりもはるかに早く 600,000 個のしきい値に達してしまいます。