このガイドでは、デリバリー＆テイクアウトの特典の要件と例について説明します。
利用資格とポリシー
このセクションでは、パートナーが特典を提供する際に遵守する必要がある重要な利用資格の条件について説明します。サンドボックス フィードのテストでは、リリース予定のすべての特典タイプをテストすることが重要です。特典の利用資格についてご不明な点がある場合は、Google の担当者にお問い合わせください。
パーソナライズされた特典と 1 回限りの特典を除外する
高品質で一貫したユーザー エクスペリエンスを提供するため、パートナーは特定のユーザー サブセットに限定された特典を含めてはなりません 。特定のユーザー向けにのみ作成されたパーソナライズされた特典は無効です。すべてのユーザーが利用できるプラットフォーム全体の特典（初めてのユーザーや特定のレストランでの初めての注文など）は、すべてのユーザーに特典のランディング ページが表示される場合に限り 許可されます。特典の条件は、特典のタイトルと特典の URL のランディング ページに明確に記載する必要があります。サイトまたはアプリにログインしているかログアウトしているかにかかわらず、すべてのユーザーに特典のランディング ページで特典が表示される必要があります。
クーポンコード付きの特典
一部の特典では、ユーザーがクーポンコードを入力する必要があります（例: 「コード SAVE20 を適用すると、合計金額から 20% 割引になります」）。Google では、 クーポン定義の クーポン クーポンコードは表示されません。パートナーは、この情報を OfferDetails.offer_display_text に含めてユーザーに表示できます。クーポンベースの特典は通常、次の 2 つのカテゴリに分類されます。
- Google からアクセスしたユーザーに、購入手続き時にクーポンが自動的に提示される特典。これは許可されます。
- 購入手続き時にユーザーがクーポンコードを入力する必要がある特典で、特典の URL のランディング ページにクーポンコードの適用方法が記載されていない場合や、特典の URL にアクセスしてもクーポンが自動的に適用されない場合は、許可されません。
特典のコンテンツと構造
このセクションでは、フィードで提供される特典のコンテンツと構造の要件について詳しく説明します。構造化メタデータの例も示します。
特典の表示テキストと特典の仕様
OfferDetails.offer_display_text は必須のフィールドで、Google 検索の特典セクションにすぐに表示される簡潔な見出しとして機能します（例:「$10 オフ」、「15% 割引」）。
OfferDetails.offer_specification
は、OfferDetails内の必須の「いずれか 1 つ」のフィールドです。つまり、ディールを指定するには、次の 3 つのフィールドのうち 1 つだけを指定する必要があります。
discount_valuediscount_percentother_offer_detail_text
OfferDetails.other_offer_detail_text
フィールドは、特典を定額割引の値または割合として表現できない場合に、offer_display_text
を補足するために使用される自由形式のテキスト フィールドです。offer_display_text
で特典に関する必要な情報をすべて伝えることができる場合は、other_offer_detail_text フィールドに offer_display_text
と同じテキストを入力する必要があります。ただし、複雑なディールの場合は、このフィールドに特典の詳細な説明を入力する必要があります。
構造化メタデータ フィールド
特典を明確にし、ランキングとフィルタリングを改善するには、パートナーはそれぞれの構造化フィールドに特典のメタデータを提供する必要があります。条件を
指定する
必要があります。特典のランディング
ページでユーザーに表示される詳細な条件を terms.terms_and_conditions フィールドに設定することをおすすめします。
注文合計と商品固有の特典
一部の商品に固有の特典の場合は、
offer_restrictions.inclusions
フィールドと
offer_restrictions.exclusions
フィールドを使用して、対象商品を定義する必要があります。特典が特定の商品に対するものである場合は、商品名を
offer_display_text に含める必要があります。商品名が offer_display_text
に含まれている場合は、offer_restrictions.inclusions を設定する必要はありません。
offer_restrictions.inclusions が設定されていない場合、または商品名が offer_display_text
に含まれていない場合、特典は注文合計金額に適用されるとみなされます。
配送料の特典
配送料の特典では、offer_category
OFFER_CATEGORY_ADD_ON_FEE_REDUCTION_OFFERを使用する必要があります。これにより、特典は、その地域の別の基本特典と組み合わせた場合にのみ表示されます。配送料の特典は、基本特典としては表示されません。
特典の JSON の例
一律 $20 オフ
例: 火曜日は注文合計から一律 $20 オフ（最低購入金額 $15）
{ "offer_id": "offer-example-1-takeout", "offer_source": "OFFER_SOURCE_AGGREGATOR", "action_type": "ACTION_TYPE_FOOD_TAKEOUT", "offer_modes": ["OFFER_MODE_ONLINE_ORDER"], "offer_category": "OFFER_CATEGORY_BASE_OFFER", "offer_details": { "offer_display_text": "$20 off on Tuesdays", "discount_value": { "currency_code": "USD", "units": 20 }, "min_spend_value": { "currency_code": "USD", "units": 15 } }, "validity_periods": [ { "valid_period": { "valid_from_time": { "seconds": 1768953600 }, "valid_through_time": { "seconds": 1795219200 } }, "time_of_day": [ { "time_windows": { "open_time": { "hours": 9 }, "close_time": { "hours": 20, "minutes": 59, "seconds": 59 } }, "day_of_week": ["TUESDAY"] } ] } ], "offer_restrictions": { "combinable_with_other_offers": false }, "terms": { "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders with $15 minimum spend. Single use per order. Offer may not be combined with any other offers, discounts, or promotions. Valid only on Tuesdays." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/base_offer_1" }
ベリー スムージー 50% オフ
例: 商品レベルの特典が 50% オフ
{ "offer_id": "offer-example-1-takeout", "offer_source": "OFFER_SOURCE_AGGREGATOR", "action_type": "ACTION_TYPE_FOOD_TAKEOUT", "offer_modes": ["OFFER_MODE_ONLINE_ORDER"], "offer_category": "OFFER_CATEGORY_BASE_OFFER", "offer_details": { "offer_display_text": "50% off on Berry Smoothie", "discount_percent": 50.0 }, "validity_periods": [ { "valid_period": { "valid_from_time": { "seconds": 1768953600 }, "valid_through_time": { "seconds": 1795219200 } } } ], "offer_restrictions": { "combinable_with_other_offers": true, "inclusions": [ {"description":"Berry Smoothie"} ] }, "terms": { "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders. Single use per order." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/base_offer_1" }
1 つ購入でもう 1 つ無料の特典
例: 前菜を 1 つ購入するともう 1 つ無料（月曜日から木曜日まで有効）
{ "offer_id": "offer-example-2-delivery", "offer_source": "OFFER_SOURCE_AGGREGATOR", "action_type": "ACTION_TYPE_FOOD_DELIVERY", "offer_modes": ["OFFER_MODE_ONLINE_ORDER"], "offer_category": "OFFER_CATEGORY_BASE_OFFER", "offer_details": { "offer_display_text": "Buy one appetizer, get one free", "other_offer_detail_text": "Buy one appetizer, get one free" }, "validity_periods": [ { "valid_period": { "valid_from_time": { "seconds": 1768953600 }, "valid_through_time": { "seconds": 1795219200 } }, "time_of_day": [ { "time_windows": { "open_time": { "hours": 10 }, "close_time": { "hours": 23, "minutes": 59, "seconds": 59 } }, "day_of_week": ["MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY"] } ] } ], "offer_restrictions": { "combinable_with_other_offers": true, "inclusions": [ { "description": "appetizers" } ] }, "terms": { "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders. Single use per order. Valid on all menu appetizers. Offer may be combined with any other offers, discounts, or promotions. Valid Monday through Thursday." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/base_offer_4" }
送料無料の特典
例: 基本特典に追加される送料無料。配送料 $0 の特典は、その地域の基本特典とともに表示されます。
[ { "offer_id": "offerId1", "offer_source": "OFFER_SOURCE_AGGREGATOR", "action_type": "ACTION_TYPE_FOOD_DELIVERY", "offer_modes": ["OFFER_MODE_ONLINE_ORDER"], "offer_category": "OFFER_CATEGORY_BASE_OFFER", "offer_details": { "offer_display_text": "10% off", "discount_percent": 10.0 }, "validity_periods": [ { "valid_period": { "valid_from_time": { "seconds": 1768953600 }, "valid_through_time": { "seconds": 1795219200 } }, "time_of_day": [ { "day_of_week": ["MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY"] } ] } ], "offer_restrictions": { "combinable_with_other_offers": true, "combinable_offer_categories": ["OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER"] }, "terms": { "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders. Single use per order. Offer may be combined with any other offers, discounts, or promotions." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/base_offer_5" }, { "offer_id": "offerId2", "offer_source": "OFFER_SOURCE_AGGREGATOR", "action_type": "ACTION_TYPE_FOOD_DELIVERY", "offer_modes": ["OFFER_MODE_ONLINE_ORDER"], "offer_category": "OFFER_CATEGORY_ADD_ON_FEE_REDUCTION_OFFER", "offer_details": { "offer_display_text": "$0 Delivery Fee", "other_offer_detail_text": "Free dellivery" }, "validity_periods": [ { "valid_period": { "valid_from_time": { "seconds": 1768953600 }, "valid_through_time": { "seconds": 1795219200 } } } ], "offer_restrictions": { "combinable_with_other_offers": true }, "terms": { "terms_and_conditions": "Delivery is free at the participating restaurant location on qualifying delivery or takeout orders. Single use per order. Offer may be combined with any other offers, discounts, or promotions." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/addon_offer_1" } ]
フルフィルメントと制約
このセクションでは、特典のフルフィルメントの仕様と、それに関連する制約に関する要件とベスト プラクティスについて詳しく説明します。
フルフィルメント モード（配達とテイクアウト）
1 つのディールが配達とテイクアウトの両方に適用される場合は、フィードに 2 つの特典を含める必要があります。各エントリには、専用の ActionTypeが必要です。
ACTION_TYPE_FOOD_DELIVERYACTION_TYPE_FOOD_TAKEOUT
これにより、パートナーのサイトにアクセスしたユーザーに正しいフルフィルメント コンテキストが表示されます。
時間ウィンドウ
サイトまたはアプリにログインしているかログアウトしているかにかかわらず、すべてのユーザーに特典のランディングページで特典が表示される必要があります。特典が特定の期間に有効な場合は、validity_periods.valid_periodフィールドを含めて、有効期間を指定する必要があります。これにより、特典が期間外に表示されるのを防ぐことができます。特典が 1 日の特定の時間に特典の URL に表示される場合は、時間ウィンドウも設定する必要があります。TimeOfDayWindow
深夜をまたぐ時間枠を処理する
深夜をまたぐ特典（例: 火曜日の午後 10 時から水曜日の午前 2 時まで有効）は、取り込みパイプラインで正しく処理されるようにセグメント化する必要があります。 要件: TimeOfDayWindow フィールドを使用して、ウィンドウを 2 つの異なるセグメントに分割します。
- セグメント 1: 開始日の午後 10 時～午後 11 時 59 分 59 秒（例: 火曜日）。
- セグメント 2: 翌日の午前 0 時～午前 2 時（例: 水曜日）。
これにより、特典の有効期間が期間全体にわたって正確に反映されます。
料金の仕様
配達とテイクアウトの料金は、 OfferDetails.additional_fees フィールドを使用して指定できます。手数料は、 OfferDetails.convenience_feeを使用して指定する必要があります。 料金が変動する場合は、料金範囲の値を使用します（例: 配送料がユーザーの所在地によって異なる場合）。