附加價值商機

背景

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

功能範例


單一檢視	清單檢視

本指南假設您已熟悉 Google 錢包的基本概念，並已完成建議的必要條件。如有任何問題或意見，請與 Google 錢包聯絡窗口聯絡。

整合步驟

如要新增模組，您需要更新物件和/或類別，加入 ValueAddedModuleData。ValueAddedModuleData 具有以下欄位：

[必要] LocalizedString 標題

模組上顯示的標題。字元上限為 60 個，超過上限的字串會遭到截斷。價值商機標題範例

LocalizedString 內文

模組上顯示的內文。字元上限為 50 個，超過上限的字串會遭到截斷。
價值商機內容範例

圖片

模組上顯示的圖片。建議圖片比例為 1:1，系統會調整圖片大小以符合此比例。
價值商機圖片範例

[Required] string uri

使用者點選模組時前往的 URI。可以是網頁連結或深層連結。

ModuleViewConstraints viewConstraints

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

TimeInterval displayInterval

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

int32 sortIndex

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

Example 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，或主動從類別或物件新增/移除這項行為。

例外狀況處理

訊息	原因
ValueAddedModuleData 必須包含標頭。	ValueAddedModuleData 沒有標頭。
ValueAddedModuleData 必須包含非空白的 URI。	ValueAddedModuleData 沒有非空白的 URI。
每堂課最多可使用 15 個加值模組。	需要減少課程中的加值模組。
每個物件最多可有 15 個加值模組。	需要減少物件上的加值模組。