規定和優惠示例

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

資格條件和政策

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

排除個人化和一次性優惠

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

提供優待券代碼

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

  • 系統會在結帳時自動向從 Google 進入網站的使用者顯示優待券。這些都是允許的。
  • 如果促銷活動要求使用者在結帳時輸入優待券代碼，但未在促銷活動網址到達網頁上提供如何套用優待券代碼的說明，或未在使用者前往促銷活動網址時自動套用優待券，則不符合規定。

提供內容和結構

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

優惠顯示文字和優惠規格

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

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

  • discount_value
  • discount_percentage
  • other_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欄位為必填欄位。值應包含兌換優惠的條件。舉例來說，您可以在這個欄位中填入向使用者顯示的詳細條款，這些條款會顯示在優惠到達網頁上。

方案 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"
}

買一送一優惠

示例：週一至週四，買一送一開胃菜

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

折扣百分比優惠

示例：三明治 75 折優惠

{
  "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 Sandwitches",
    "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
  },
  "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.00 美元。

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

基本優惠和加購優惠範例

示例：餐廳提供平日午餐 9 折優惠，以及使用特定信用卡付款享 95 折優惠。

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

出貨和限制

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

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

如果單一優惠同時適用於外送和外帶，動態饋給中必須有兩項優惠。每個項目都必須有專屬的 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 指定手續費。如果運費會因使用者所在位置而異，請使用費用範圍值表示變動費用。