禮物卡 (又稱優待券)

本指南將說明在商品動態饋給中導入禮物卡 (又稱優待券) 的相關規定、資料模型建議和最佳做法。這些建議是標準行動中心文件的補充資料，可解決禮物卡專屬的整合問題。

提供模式和分類

提交禮物卡庫存時，請確保下列核心屬性設定正確無誤：

  • 優惠模式：offer_modes 一律必須設為包含 "OFFER_MODE_GIFT_CARD_PURCHASE" 的單例陣列：

    "offer_modes": ["OFFER_MODE_GIFT_CARD_PURCHASE"]

  • 儲值金憑證與即時折扣：

    • gift_card_info 僅適用於預購的儲值憑證和禮物卡 (OFFER_MODE_GIFT_CARD_PURCHASE)。
    • 如果顧客在實體商店櫃檯直接付款，立即享有折扣，且未購買兌換券代碼以供日後兌換，請將這項優惠視為標準的臨櫃折扣 (OFFER_MODE_WALK_IN)，並完全省略 gift_card_info 訊息。

  • 面額模型：禮物卡面額應代表憑證價值 (可兌換的金額)，而非使用者支付的金額 (使用者支付折扣價)。

  • 合併多種面額：如果多張優待券的折扣百分比和條款完全相同，但面額不同，則必須歸入單一優惠項目。由於 denomination_type 運算子會以 oneof 形式運作，合作夥伴必須選擇設定 fixed_denominations 或 custom_range：

    • 固定面額：提供預設的禮物卡金額 (例如 ₹500、₹1,000 和 ₹2,000，一律享有 10% 折扣)。請確保從動態饋給提交內容中，明確排除到達網頁上已售完或無法使用的固定面額。
    • 自訂範圍：僅適用於使用者可在購買頁面上的定義範圍內，自由輸入任意面額的情況 (例如，介於 ₹100 和 ₹5,000 之間的值，並享有 5% 折扣)。如果目的地到達網頁提供預設金額，請嚴格按照fixed_denominations對廣告空間進行建模。此外，如果優惠同時提供固定面額和自訂面額，合作夥伴應設定彈性自訂範圍。

處理多地點連鎖店

如果禮物券適用於大型零售或餐飲連鎖店，且多個興趣點 (POI) 的條款相同，請不要為每個商店地點提供個別的 Offer 物件。請改用匯總式動態饋給方法，提供包含所有參與商店實體 ID 清單 (entity_ids) 的單一 Offer 物件。

入口網站品牌宣傳 (brand_id)

部分優待券是透過特定銀行或會員入口網站 (例如銀行會員方案或合作夥伴平台) 提供，而非主要商家網站。為確保這些入口網站的品牌宣傳正確無誤，合作夥伴必須在頂層「供應項目」物件中填入 brand_id 欄位。

雖然省略 brand_id 會預設為帳戶的主要品牌 (使用帳戶的預設品牌時，brand_id 並非必要)，但明確填寫 brand_id 可準確將目錄與相應的品牌入口網站建立關聯，確保向使用者顯示正確的合作夥伴專屬標誌和名稱。如要取得更詳細的品牌設定操作說明，請參閱「品牌設定」。

有效性結構 (ValidityScope)

禮物卡的效期結構獨特，購買優惠的時間範圍與兌換禮物卡的時間長度不同。合作夥伴一律必須使用相關的 ValidityScope 列舉值：

  • VALIDITY_SCOPE_CLAIM：定義合作夥伴平台提供禮物卡購買服務的時間範圍。這個項目一律必須存在。提交動態饋給時，請從動態饋給的確切提交日期開始，填寫買家保證效期。此外，如果到達網頁明確宣傳活動結束日期，請務必設定 valid_through_time，與宣傳的有效期限相符，切勿將索取期限設為無期限。
  • VALIDITY_SCOPE_REDEEM：定義購買後兌換憑證的時間長度 (使用者在購買憑證後，必須在店內兌換憑證的時間範圍，可指定為時間長度或時間範圍)。

動作類型對應

合作夥伴通常會使用「可線上/線下兌換」、「線上/門市」或「店內」等結構，將優待券分類。在動態饋給提交中，這項屬性必須對應至 ActionType 列舉，才能準確定義產品的消耗方式：

  • 餐飲 / 食品垂直領域：將「店內用餐」禮物卡對應至 ACTION_TYPE_DINING。將「運送」禮物卡對應至 ACTION_TYPE_FOOD_DELIVERY。將「外帶」禮物卡對應至 ACTION_TYPE_FOOD_TAKEOUT。
  • 購物零售垂直領域：將「店內」禮物卡對應至 ACTION_TYPE_SHOPPING_IN_STORE。(注意：不支援僅限線上使用的零售憑證)。
  • 單一管道對應：每個 offer_id 只能屬於一個 ActionType。如果目錄項目支援多個履行管道 (例如外送和外帶)，請為每種模式建立具有專屬 ID 的不同 Offer 物件。

分級折扣和加購優惠

  • 不同付款方式適用的折扣等級：如果根據使用的特定付款工具提供不同折扣百分比 (例如電子錢包的折扣高於信用卡)，則必須將這些折扣建立為個別的 Offer 物件。合作夥伴應針對所有支援的付款方式 (例如電子錢包、信用卡、簽帳金融卡、網路銀行) 提供完整的促銷活動涵蓋範圍，確保消費者享有可靠的省錢體驗。如果優惠適用於平台接受的所有付款方式，則不應設定付款方式欄位。
  • 加購優惠建構：如要表示堆疊福利，例如銀行專屬的獎勵點數或適用於禮物卡購買的額外現金回饋，請使用適當的 OfferCategory 列舉 OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER，將這些福利做為完全獨立的加購優惠提交。在 OfferDetails.other_offer_details_text 中說明獎勵 (例如「最高可享 5 倍紅利點數」)，並填入基本禮物卡的 offer_id，將獎勵連結至基本禮物卡交易的 OfferRestrictions.combinable_offer_ids。

條款和特別條件

合作夥伴應依據 terms.terms_and_conditions 提供禮物卡或優待券的完整法律條款及細則。將所有使用者操作說明和使用指南整合到這個欄位。

如果重要限制需要專屬 UI 顯著性 (例如單次使用餘額到期、不可退款，或交易合併上限，如「每張帳單最多可合併 2 張抵用券」)，請在 offer_restrictions.special_conditions 中醒目顯示。

優惠標題建議

優惠標題長度應嚴格限制在 40 個半形字元以下。從 offer_display_text 中移除商家品牌名稱，因為優惠會直接顯示在商家的專屬地點資訊頁面上。建議使用下列標題格式：

用途 建議標題
憑證固定折扣 X% off on Gift Cards
折扣金額會因付款方式而異 X% off on Gift Cards using {e-wallet}
不同面額的折扣金額不同 X% off on Gift Cards(將不同折扣分別做為獨立優惠傳送)
B2B2C 禮物卡 X% off on Gift Cards (品牌會透過使用 brand_id 的縮圖顯示)
加購優惠 Flat/Up to 5X reward points/ <Platform> coins

到達網頁規定

每個宣傳的 offer_url 都必須直接傳回 HTTP 200 OK，不得有中介重新導向，並解析為有效的到達網頁，以佐證優惠內容。

動態饋給不得包含已售完或無法使用的面額。確保動態饋給面額欄位與目的地到達網頁上的即時購買選項之間，維持嚴格的庫存同步。

到達網頁應清楚說明優惠適用於禮物卡或優待券。

舉例來說，如果合作夥伴到達網頁只顯示「支付帳單」等一般付款號召性用語，但未明確說明完成交易會發行儲值禮物卡憑證，從 Google 重新導向的使用者可能會感到困惑或放棄交易，因為他們原本是想購買禮物卡。即使後續結帳步驟會顯示優待券通知，初始到達網頁仍須清楚顯示相關資訊。

提供優待券代碼的優惠

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

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

禮物卡優惠 JSON 範例

{
  "data": [
    {
      "offer_id": "example-dining-gift-card-10off",
      "entity_ids": [
        "dining-1",
        "dining-2"
      ],
      "offer_modes": [
        "OFFER_MODE_GIFT_CARD_PURCHASE"
      ],
      "action_type": "ACTION_TYPE_DINING",
      "offer_source": "OFFER_SOURCE_AGGREGATOR",
      "offer_category": "OFFER_CATEGORY_BASE_OFFER",
      "offer_details": {
        "offer_display_text": "10% off on Gift Cards",
        "discount_percent": 10.0,
        "gift_card_info": {
          "fixed_denominations": {
            "amounts": [
              {
                "units": 500,
                "currency_code": "INR"
              },
              {
                "units": 1000,
                "currency_code": "INR"
              },
              {
                "units": 2000,
                "currency_code": "INR"
              }
            ]
          }
        }
      },
      "offer_restrictions": {
        "combinable_with_other_offers": false,
        "special_conditions": [
          "Single-use balance expiration applies",
          "Maximum 2 gift card vouchers can be combined per bill",
          "No cash refund will be provided against this voucher"
        ]
      },
      "terms": {
        "restricted_to_certain_users": false,
        "terms_and_conditions": "1. Redeemable exclusively at participating dining outlets.\n2. Single-use balance expiration applies.\n3. Maximum 2 gift card vouchers can be combined per bill.\n4. No cash refund will be provided against this voucher."
      },
      "validity_periods": [
        {
          "valid_period": {
            "valid_from_time": {
              "seconds": "1774934350"
            },
            "valid_through_time": {
              "seconds": "1806470350"
            }
          },
          "validity_scope": "VALIDITY_SCOPE_CLAIM"
        },
        {
          "validity_duration_in_days": 365,
          "validity_scope": "VALIDITY_SCOPE_REDEEM"
        }
      ],
      "offer_url": "https://www.example-portal.com/dining-gift-cards/buy"
    }
  ]
}