測試獎勵

Play Billing Lab 是一款隨附應用程式，可協助您測試與 Google Play 結帳系統的整合情形。您可以使用 Play Billing Lab 的應用程式外購買 (OOAP) 預先發布版測試，驗證後端是否已正確設定，可處理在應用程式外取得的項目，包括 Play Games 獎勵。

您可以使用 OOAP 預先發布版功能，選取要在應用程式外介面 (例如 Google Play 的應用程式詳細資料頁面) 顯示的特定產品或優惠，並驗證端對端授權取得和履行流程。

必要條件

使用 Play Billing Lab 測試應用程式外購買 (OOAP) 流程，驗證 Play 遊戲獎勵設定前，請確認您符合下列規定：

1. 加入 Play 遊戲獎勵搶先體驗計畫。

2. 授權測試人員狀態：測試帳戶必須註冊為遊戲的授權測試人員。詳情請參閱 Google Play 授權測試人員說明文件。

   注意：雖然任何使用者都能查看 Play Billing Lab 應用程式，但只有許可清單中 EAP 開發人員的授權測試人員，才能設定及觸發 OOAP 覆寫。

3. 各平台帳戶一致：您必須使用同一個授權測試人員帳戶，登入 Play Billing Lab 和 Google Play 商店。如果帳戶不相符，Play 商店可能不會顯示覆寫的測試產品或優惠，或完成測試購買交易。

下載並安裝

您可以從 Google Play 下載並安裝 Play Billing Lab：

• Google Play 商店 (Android)：Play Billing Lab 應用程式
• 網頁測試群組： Play Billing Lab 網頁版選擇加入

EAP 整合與測試逐步指南

下列步驟詳細說明如何使用 Play Billing Lab 整合及測試 Play Games 獎勵。

步驟 1：啟動 Play Billing Lab 並登入

安裝後首次開啟 Play Billing Lab 時：

• 輕觸「使用 Google 帳戶登入」。
• 選取註冊為應用程式授權測試人員的 Google 帳戶。
• 登入後，您會看到主要的「資訊主頁」。

Play Billing Lab 資訊主頁。

步驟 2：前往應用程式外購 (OOAP) 測試

• 在「資訊主頁」中，找到「應用程式外購買交易」資訊卡。
• 輕觸「測試」，開啟 OOAP 設定畫面。

注意：如果您的應用程式未加入這項 EAP 的許可清單，或您的帳戶不是許可清單應用程式的授權測試人員，系統就不會顯示這張資訊卡，並會禁止您啟動 OOAP 預覽。

步驟 3：指定應用程式套件名稱和產品 ID

在 OOAP 設定畫面中，輸入必要的應用程式 ID：

1. 套件名稱：應用程式的確切 Android 套件名稱 (例如 com.example.app)。
2. 產品類型：使用下拉式選單選取「單次產品」(應用程式內商品) 或「訂閱項目」。
3. 產品 ID (SKU)：要測試的應用程式內商品或訂閱項目的產品 ID。

指定應用程式套件名稱和產品 ID。

步驟 4：選取符合資格的優惠

輸入套件名稱、產品 ID 和產品類型後，Play Billing Lab 會查詢後端，並顯示該產品的可用優惠清單。

注意：系統只會顯示並允許選取目前符合特定測試人員帳戶資格的優惠。如果帳戶已有特定產品的未消費授權，則不會顯示。

• 單次產品：選取適用的購買選項或優惠。

  

  選取符合資格的優惠。

步驟 5：開始 OOAP 測試

選取優惠後，輕觸「開始測試」。系統會儲存設定，並與 Google Play 後端伺服器同步。

啟用後，「資訊主頁」的「應用程式外購買交易」資訊卡會顯示「有效」徽章，以及設定的套件名稱、產品 ID (SKU) 和剩餘時間。

• 測試期間：有效的 OOAP 測試設定預設會保持有效 2 小時，之後會自動到期。

• 後端覆寫：啟用後，這項設定會在各種 OOAP 介面 (例如 Play 商店的應用程式詳細資料頁面) 顯示為最高優先順序。

  

  開始測試應用程式外購項目。

步驟 6：測試應用程式外優惠的端對端獲取流程

在 Play Billing Lab 執行 OOAP 測試時，請使用相同的授權測試人員帳戶登入 Google Play 商店應用程式：

1. 清除 Google Play 商店快取：
   1. 開啟裝置上的「設定」應用程式。
   2. 依序輕觸「應用程式」>「Google Play 商店」。
   3. 依序輕觸「儲存空間和快取」、「清除快取」和「清除儲存空間」。
2. 開啟 Google Play 商店應用程式。
3. 前往應用程式詳細資料頁面。

4. 完成測試購買交易 (Play Express 疊加層)：輕觸商品卡片。Google Play 快速結帳的原生底部功能表會疊加在 Play 商店中。

   • 查看價格、付款工具 (授權測試人員的測試工具) 和優惠詳情。
   • 輕觸「一鍵購買」完成交易。

   

   測試端對端獲客流程。

5. 驗證後端整合：

   • 成功購買後，請確認 Google Play 會將即時開發人員通知 (RTDN) 傳送至後端伺服器。
     • 注意：獎勵也會傳送 RTDN。
   • 確認伺服器呼叫 Google Play Developer API，確認購買交易並授予使用者授權。
   • 在 Play 商店應用程式中查看使用者購買記錄，確認測試訂單已記錄。

注意：這個步驟可確保後端已準備好處理獎勵。Play Games 獎勵會傳送類似的 RTDN，需要使用相同的 Google Play Developer API 確認及授予授權，並在 Google Play 商店應用程式的使用者購買記錄中記錄 0 美元的交易。

步驟 7：停止並清除 OOAP 測試

測試完成後：

1. 前往「應用程式外購」頁面。
2. 輕觸「清除測試」，即可停止 OOAP 測試並清除 OOAP 測試設定。

清除 OOAP 測試。

修改測試設定

OOAP 預覽測試執行期間，您無法變更套件名稱、產品 ID、優惠選項，或變更 Play 商店國家/地區覆寫設定。

如要這麼做，必須停止並清除目前的 OOAP 測試

如何編輯產品或優惠

如果您目前正在執行 OOAP 測試，並想測試其他產品或優惠：

1. 開啟 Play Billing Lab，然後在有效的「Out-of-app purchases」資訊卡上輕觸「View」。
2. 輕觸「編輯」，即可修改套件名稱、產品 ID 或測試優惠。
3. 在系統提示時，確認「停止測試」。測試將停止，所有相關輸入內容都會清除。
4. 輸入新產品或選取新優惠，然後重新啟動測試。

編輯產品或優惠。

如何使用國家/地區覆寫功能測試店面價格

Play Billing Lab 可讓您覆寫 Google Play 商店國家/地區，測試區域定價和貨幣格式。不過，國家/地區變更必須與 OOAP 測試同步：

1. 停止進行中的 OOAP 測試：如果在 OOAP 測試期間，您嘗試透過資訊主頁或「應用程式外購買」頁面編輯國家/地區覆寫設定，Play Billing Lab 會顯示警告，提示您先停止測試。輕觸「停止測試」確認後，系統會停止目前的 OOAP 測試，並清除測試輸入內容。

2. 設定國家/地區覆寫：停止 OOAP 測試後，您可以在「Configuration Settings」(配置設定) 頁面中編輯國家/地區設定。選取指定國家/地區 (例如日本、英國)，然後輕觸「套用」。

3. 重新啟動 OOAP 測試：國家/地區覆寫生效後，返回「應用程式外購買」資訊卡，選取產品和優惠，然後輕觸「開始測試」。

   資訊主頁現在會同時顯示有效的國家/地區覆寫和 OOAP 測試。

4. 在 Google Play 商店中驗證店面價格：開啟 Google Play 商店，然後前往應用程式的詳細資料頁面。現在，顯示的使用者介面資訊卡和 Play Express 底部功能表，會以覆寫國家/地區的當地幣別顯示產品價格！

使用國家/地區覆寫功能測試本地化價格。

疑難排解和常見問題

為什麼 Play 商店的應用程式詳細資料頁面，沒有顯示我設定的測試優惠？

• 帳戶一致性：確認登入 Play 商店應用程式的帳戶，與登入 Play Billing Lab 的帳戶完全相同。
• EAP 許可清單和授權測試人員狀態：確認您的開發人員帳戶已加入 Play Billing Lab OOAP 預先發布版 EAP 許可清單，且在 Play 管理中心列為有效的授權測試人員。
• 到期時間：進行中的 OOAP 測試會在 2 小時後到期。開啟 Play Billing Lab，確認測試標記是否已變更為「Expired」。如果是，請開始新的測試。

在 Play Billing Lab 設定產品時，為什麼無法選取或查看任何優惠？

• 優惠資格：Play Billing Lab 只會顯示特定測試人員帳戶目前符合購買資格的優惠。

為什麼在 Play Express 疊加層中測試購買失敗？

• 確認測試裝置搭載 Android 12 (API 級別 31) 以上版本，且已安裝最新版 Google Play 商店。
• 請檢查應用程式後端 RTDN Webhook 和 API 整合。透過 Play 商店測試時，購買交易會在應用程式標準 UI 以外進行。您的後端伺服器必須能可靠地接收 Google Play 的 RTDN 訊息，並以非同步方式確認購買交易。

如何在 2 小時內停止或清除進行中的測試？

• 開啟 Play Billing Lab，找出有效的資訊卡 (「應用程式外購」或「Configuration settings」)，然後輕觸「Stop」或「Delete」。系統提示時，請確認你的選擇。覆寫設定會立即從 Google Play 伺服器中移除。