附加價值商機

背景

您現在可以更新物件和類別，以便納入附加價值商機模組。模組會顯示在詳細資料頁面上，並可連結至發布者內容。本文件將逐步說明如何使用 Google Wallet API 啟用及使用模組。

注意：禮物卡、會員卡和優惠也支援 Shopping Merchant Center 的自動整合功能。

功能範例

單一檢視	清單檢視

以下指南假設您已熟悉 Google 錢包的基本概念，且已完成建議的前置條件。如有任何問題或意見，請與 Google 電子錢包 POC 聯絡。

整合步驟

如要新增模組，您必須更新物件和/或類別，以便納入 ValueAddedModuleData。ValueAddedModuleData 包含下列欄位：

[必要] LocalizedString 標頭

模組上顯示的標頭。字元限制為 60 個半形字元，過長的字串會遭到截斷。

LocalizedString 內容

模組上顯示的內文。字元上限為 50 個，超過此上限的字串會遭到截斷。

圖片圖片

模組上顯示的圖片。建議的圖片比例為 1:1，系統會調整圖片大小，以符合這個比例。

[必填] 字串 uri

使用者點選後模組導向的 URI。可以是網頁連結或深層連結。

ModuleViewConstraints viewConstraints

顯示模組必須完全符合的限制。ModuleViewConstraints 具有下列欄位：

TimeInterval displayInterval (時間間隔)

向使用者顯示模組的時間範圍。可以同時定義 `startTime` 和 `endTime`。除非設定 `startTime`，否則模組會在插入後立即顯示。如果未設定 `endTime`，則模組會無限期顯示。

int32 sortIndex

用於排序模組的索引。排序索引較低的模組會顯示在排序索引較高的模組之前。如未指定，系統會假定排序索引為 INT_MAX。而對於具有相同索引的兩個模組，系統未定義其排序行為。

ValueAddedModuleData 範例：

  {
    "valueAddedModuleData": [
      {
        "header": {
          "defaultValue": {
            "language": "en-US",
            "value": "10% off merch"
          }
        },
        "body": {
          "defaultValue": {
            "language": "en-US",
            "value": "Shirts, caps, mugs, and more"
          }
        },
        "image": {
          "sourceUri": {
            "uri": "http://www.images.google.com/opportunity"
          }
        },
        "uri": "http://www.google.com/opportunity",
        "viewConstraints": {
          "displayInterval": {
            "start": {
              "date": "2024-08-01T18:30:00"
            },
            "end": {
              "date": "2025-08-01T18:30:00"
            }
          }
        },
        "sortIndex": 0
      },
      {
        "header": {
          "defaultValue": {
            "language": "en-US",
            "value": "10% off concessions"
          }
        },
        "uri": "http://www.google.com/new_opportunity"
      }
    ]
  }

注意：您最多可在物件中新增十個模組，在類別中最多可新增十個模組。不過，票證上最多只會顯示十個模組。我們會從物件中篩除不符合檢視限制的模組，並優先顯示這些模組。

預期行為

成功更新物件和/或類別後，您現在會在對應的傳遞中看到模組。如果您只新增一個模組，系統會在票證正面顯示該模組。

附加商機模組的規範

模組可讓您透過額外動作提升使用者的票證體驗。建立及管理模組時，請考量以下幾點：

• 定義模組時，應使用適當的語言表示這些模組可供使用者操作，讓使用者瞭解這些模組可供點選。
• 模組應定義與特定模組相關的適當圖像。
• 您可以控管模組，並應根據重要性和相關性主動管理模組的優先順序。
• 請只顯示有效的使用者模組。您可以透過設定模組的 displayInterval，或主動在類別或物件中新增或移除 displayInterval，來控制這項功能。

例外狀況處理

訊息	原因
ValueAddedModuleData 必須包含標頭。	ValueAddedModuleData 沒有標頭。
ValueAddedModuleData 必須包含非空白的 URI。	ValueAddedModuleData 沒有非空白的 URI。
每門課程最多可新增 10 個加值模組。	需要減少課程的附加價值模組。
每個物件最多可加入 10 個附加價值模組。	需要減少物件上的附加價值模組。