このガイドでは、デリバリー＆テイクアウトの特典の要件と例について説明します。
利用資格とポリシー
このセクションでは、パートナーが特典を提供する際に遵守する必要がある重要な利用資格の条件について説明します。サンドボックス フィードのテストでは、リリース予定のすべての特典タイプをテストすることが重要です。特典の利用資格について不明な点がある場合は、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_percentageother_offer_details_text
OfferDetails.other_offer_details_text
フィールドは、特典を定額割引または割合で表すことができない場合に、offer_display_text
を補足するために使用されるフリーフォームのテキスト フィールドです。offer_display_text
で特典に関する必要な情報をすべて伝えることができる場合は、other_offer_details_text フィールドに offer_display_text
と同じテキストを入力する必要があります。ただし、複雑なディールの場合は、このフィールドに特典の詳細な説明を入力する必要があります。
構造化メタデータ フィールド
特典を明確にし、ランキングとフィルタリングを改善するには、パートナーは特典のメタデータをそれぞれの構造化フィールドに入力する必要があります。 terms.terms_and_conditions フィールドは必須です。値には、特典の利用方法に関する条件を含める必要があります。たとえば、特典のランディングページにユーザーに表示される詳細な利用規約をこのフィールドに入力できます。
一部の商品に限定した特典の場合は、 terms.terms_and_conditions フィールドまたは offer_restrictions.inclusions フィールドと offer_restrictions.exclusions フィールドを使用して、対象商品を定義する必要があります。
特典の 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" }
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" }
割合割引の特典
例: すべてのサンドイッチが 25% オフ
{ "offer_id": "offer-example-3-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": "25% off on all Sandwiches", "discount_percent": 25.0 }, "validity_periods": [ { "valid_period": { "valid_from_time": { "seconds": 1768953600 }, "valid_through_time": { "seconds": 1795219200 } } } ], "offer_restrictions": { "combinable_with_other_offers": true, "combinable_offer_ids": ["offer-example-4-delivery"], "inclusions": [ "Sandwiches" ] }, "terms": { "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders. Applies to specific items only. Single use per order. May be combined with any other offers, discounts, or promotions." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/base_offer_2" }
送料無料の特典
例: 30 ドル以上のご注文で送料無料。それ以外の場合は送料 7 ドル。
{ "offer_id": "offer-example-4-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": "Free delivery on orders over $30", "discount_value": { "currency_code": "USD", "units": 7 }, "min_spend_value": { "currency_code": "USD", "units": 30 } }, "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": "For use only at the participating restaurant location on qualifying delivery orders with $30 minimum spend. Delivery is $7.00 otherwise. Single use per order. May be combined with any other offers, discounts, or promotions." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/base_offer_3" }
アドオン特典付きの基本特典の例
例: 平日のランチのみ 10% オフ、特定のクレジットカードで支払うといつでも 5% オフ
[ { "offer_id": "offerId1", "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": "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_TAKEOUT", "offer_modes": ["OFFER_MODE_ONLINE_ORDER"], "offer_category": "OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER", "offer_details": { "offer_display_text": "5% off", "discount_percent": 5.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_ids": ["offerId1"] }, "payment_instrument": { "items": [ { "type": "PAYMENT_INSTRUMENT_CREDIT_CARD", "name": "Participating Credit Card" } ], "provider_name": "Card Provider" }, "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/addon_offer_1" } ]
フルフィルメントと制約
このセクションでは、特典のフルフィルメント仕様と、それに関連する制約に関する要件とベスト プラクティスについて詳しく説明します。
フルフィルメント モード（配達とテイクアウト）
1 つのディールが配達とテイクアウトの両方に適用される場合は、フィードに 2 つの特典を含める必要があります。各エントリには、専用の ActionTypeが必要です。
ACTION_TYPE_FOOD_DELIVERYACTION_TYPE_FOOD_TAKEOUT
これにより、パートナーのサイトにアクセスしたユーザーに正しいフルフィルメント コンテキストが表示されます。
時間ウィンドウ
特典は、サイトまたはアプリにログインしているかログアウトしているかにかかわらず、すべてのユーザーに特典のランディングページに表示される必要があります。特典が特定の期間に有効な場合は、 validity_periods.valid_period フィールドを含めて、有効期間を指定する必要があります。これにより、特典が期間外に表示されるのを防ぐことができます。特典が特定の時間帯に特典の URL のランディングページに表示される場合は、時間ウィンドウも設定する必要があります。たとえば、レストランが閉店しているときに ランディングページに特典が表示されない場合は、 TimeOfDayWindow の開店時間と閉店時間を含める必要があります。
深夜をまたぐ時間枠を処理する
深夜をまたぐ特典（例: 火曜日の午後 10 時から水曜日の午前 2 時まで有効）は、取り込みパイプラインで正しく処理されるようにセグメント化する必要があります。 要件: TimeOfDayWindow フィールドを使用して、ウィンドウを 2 つの異なるセグメントに分割します。
- セグメント 1: 開始日の午後 10 時から午後 11 時 59 分 59 秒まで（例: 火曜日）。
- セグメント 2: 翌日の午前 0 時から午前 2 時まで（例: 水曜日）。
これにより、特典の有効期間が期間全体にわたって正確に反映されます。
料金の仕様
配達とテイクアウトの料金は、 OfferDetails.additional_fees フィールドを使用して指定できます。手数料は、 OfferDetails.convenience_feeを使用して指定する必要があります。 配達料金がユーザーの所在地によって異なる場合など、変動する料金には料金範囲の値を使用します。