最佳做法

本指南重點說明美食訂餐優惠的規定和範例。

資格條件和政策

本節將說明合作夥伴提供方案時必須遵守的重要資格條件。在沙箱動態饋給測試期間，請務必測試所有打算推出的方案類型。如果不確定優惠是否符合資格，請洽詢您的 Google 聯絡窗口。

排除個人化和一次性優惠

為確保使用者享有優質且一致的體驗，合作夥伴不得提供僅限特定使用者群組的優惠。專為特定使用者建立的個人化優惠不符合資格。只要在所有使用者的優惠到達網頁上顯示優惠，即可提供適用於所有使用者的全平台優惠，例如首次使用者優惠或特定餐廳的首次訂購優惠。優惠條件必須清楚列在優惠標題和優惠網址到達網頁中。無論使用者是否登入網站或應用程式，都必須在優惠到達網頁上看到優惠。

提供優待券代碼的優惠

部分優惠需要使用者輸入優待券代碼，例如「套用代碼 SAVE20，即可享有帳單總金額 8 折優惠」。請注意，Google 不會顯示優待券定義中的優待券代碼。合作夥伴可以在 OfferDetails.offer_display_text 中加入這項資訊，供使用者查看。一般而言，以優待券為基礎的優惠可分為兩類：

  • 系統會自動在結帳時向從 Google 進入網站的任何使用者顯示優待券。這些做法都符合規定。
  • 如果優惠規定使用者必須在結帳時輸入優待券代碼，但未在優惠網址到達網頁上提供如何套用優待券代碼的說明，或未在使用者點選優惠網址時自動套用優待券，則不符合規定。

提供內容和結構

本節將詳細說明動態饋給中提供的方案內容和結構規定，包括結構化中繼資料範例。

優惠顯示文字和優惠規格

OfferDetails.offer_display_text 是必填欄位，可做為簡潔的標題，在 Google 搜尋的「優惠」專區中立即顯示，例如「現省 $10 美元」或「節省 15%」。

OfferDetails.offer_specification 是 OfferDetails 內的必要「其中之一」欄位。也就是說，您必須提供下列三個欄位中「其中一個」來指定交易：

  • discount_value
  • discount_percent
  • other_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 美元

示例：週二訂單滿 $15 美元，即可享 $20 美元折扣

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

莓果冰沙 5 折優惠

示例：商品層級的 5 折優惠。

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

買一送一優惠

示例：買一送一優惠，適用於週一至週四

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

免運費優惠

例如：免運費是基礎優惠的加購內容。系統會顯示地點的任何基本方案，以及免運費優惠。

[
  {
    "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"
  }
]
。

出貨和限制

本節將詳細說明與方案履行規格相關的規定和最佳做法，以及相關限制。

訂單履行模式 (外送和外帶)

如果單一優惠同時適用於外送和外帶，動態饋給中就必須有兩項優惠。每個項目都必須有專屬的 ActionType：

  • ACTION_TYPE_FOOD_DELIVERY
  • ACTION_TYPE_FOOD_TAKEOUT

確保使用者前往合作夥伴網站時，會看到正確的履約背景資訊。

時間範圍

使用者登入或登出網站/應用程式時，都應能在優惠到達網頁上看到優惠。如果優惠僅在特定時間範圍內有效，請務必加入 validity_periods.valid_period 欄位，指定有效期間。這樣一來，系統就不會在時間範圍外顯示優惠。如果優惠只在一天中的特定時段顯示在優惠網址上，也必須設定時間範圍。舉例來說，如果餐廳關門時到達網頁不會顯示優惠，您就必須加入 TimeOfDayWindow 開放和關閉時間。

處理跨午夜的時間範圍

如果優惠跨越午夜 (例如從週二晚上 10 點到週三凌晨 2 點)，必須分段處理，才能讓擷取管道正確處理。 規定：使用 TimeOfDayWindow 欄位將時間範圍分成兩個不同的區段：

  • 第 1 個區隔：開始當天 (例如星期二) 晚上 10:00 至晚上 11:59:59。
  • 第 2 個時段：隔天 (例如週三) 凌晨 12:00 至凌晨 2:00。

確保整個期間的優惠有效性都能準確反映。

費用規格

你可以使用 OfferDetails.additional_fees 欄位，指定外送和外帶的費用。手續費應使用 OfferDetails.convenience_fee 指定。如果運費會根據使用者所在位置而異，請使用費用範圍值表示變動費用。