使用裝置喚回功能 (Beta 版) 偵測重複濫用行為

本頁面說明如何使用裝置記憶功能,儲存及擷取特定裝置的自訂資料。即使裝置重設,只要在同一部裝置上安裝應用程式,就能再次穩定喚回自訂資料。這項功能可讓您根據指定的動作或行為,偵測並防止裝置重複使用,同時保護使用者隱私。

裝置記憶功能的運作方式

裝置記憶功能可保護使用者隱私,同時儲存及喚回與特定裝置相關的自訂資料。這類資料會儲存在 Google 伺服器,因此即使在應用程式重新安裝或裝置重設後,應用程式仍能穩定地喚回自訂資料。舉例來說,您可以使用這項功能,撤銷有嚴重濫用行為的裝置、已兌換高價值商品 (例如免費試用) 的裝置,或重複用於建立新帳戶以進行濫用行為的裝置。裝置記憶功能可維護使用者隱私,因為要求的應用程式只能喚回與裝置相關聯的有限資料,無法存取任何裝置或使用者 ID。開啟裝置記憶功能後,您可以執行下列操作:

  • 讀取每部裝置的資料:取得完整性判定結果時,您可以讀取每部裝置的三個自訂值或位元。您可以自行定義這些值的意義,例如將這些值視為三個獨立標記,或合併這些值來代表八個自訂標籤。
  • 修改個別裝置資料:取得完整性權杖後,您可以使用該權杖向 Google Play 伺服器發出伺服器端呼叫,修改一或多個值。請在 14 天內使用權杖。舉例來說,如果濫用行為在您首次執行完整性檢查後的兩週內才變得明顯,您就可以修改值。修改值時,系統也會儲存修改的月份和年份。

裝置記憶功能的必要條件和注意事項

裝置記憶功能只能用於儲存及叫用資訊,以保護應用程式安全,並防範濫用、詐欺和未經授權的存取行為。您不得使用裝置記憶功能,對個別使用者或裝置進行指紋辨識或追蹤,也不得追蹤使用者或裝置的敏感特徵,例如性別、年齡或位置資料。

裝置記憶功能有下列先決條件:

  • 裝置記憶功能適用於手機、平板電腦、摺疊式裝置、電視、Auto 和 Wear OS。在 Wear OS 上,裝置記憶功能僅適用於搭載 Wear OS 5 以上版本的裝置。模擬器不支援裝置記憶功能。
  • 裝置記憶功能需要裝置安裝並啟用最新版本的 Google Play 商店和 Google Play 服務。
  • 使用者帳戶必須獲得 Play 授權,才能使用裝置記憶功能,否則判定結果將無法評估。

使用裝置記憶功能時,請注意以下時間點:

  • 驗證完整性權杖後,您最多有 14 天的時間,可以使用該權杖儲存自訂裝置記憶資料。
  • 裝置記憶功能包含時間戳記,因此您可以將最近修改的資料視為優先順序高於很久以前修改的資料。請考慮在經過足夠長的時間後忽略或重設資料,以考量裝置可能易主或翻新並轉售。
  • 裝置的召回位元會在最後一次讀取或寫入存取後儲存 3 年。
  • 如要刪除與裝置相關聯的所有資料,應用程式可以將該裝置上的這三個值全部重設為 false。系統會自動重設時間戳記。

如果開發人員有多個應用程式,或要轉移應用程式,裝置記憶功能的運作方式如下:

  • Google Play 開發人員帳戶中的所有應用程式,都能存取每部裝置的三個相同值。換句話說,如果其中一個應用程式修改了其中一個值,則所有應用程式在安裝到同一部裝置時,都會讀取修改後的值。
  • 如果應用程式從一個開發人員帳戶轉移到另一個帳戶,裝置記憶功能會反映新開發人員帳戶的每部裝置資料,而非舊開發人員帳戶的每部裝置資料。

開啟裝置記憶功能

準備就緒後,請在 Play 管理中心開啟裝置記憶功能:

  1. 登入 Play 管理中心
  2. 選取要使用裝置記憶功能的應用程式。
  3. 在左選單中,前往「由 Google Play 保護」。
  4. 按一下「Play Integrity API」旁邊的「管理」。
  5. 在頁面的「回應」部分,按一下「變更回應」。
  6. 開啟裝置記憶功能。
  7. 按一下 [儲存變更] 。

開啟或關閉裝置記憶功能後,系統會刪除您在 Play 管理中心設定的所有 Play Integrity API 測試回應,您必須重新建立。

讀取裝置記憶值

裝置記憶功能適用於 Play Integrity API 傳統和標準要求。在標準要求中,裝置記憶會在暖機呼叫中重新整理。換句話說,修改每部裝置的資料後,您需要再次執行暖機作業,才能看到更新後的值。啟用裝置記憶功能後,您就能在完整性判定結果中讀取裝置記憶值。

修改裝置記憶值

您可以發出伺服器對伺服器 API 呼叫,修改裝置記憶值,方法類似於解碼完整性判定結果。將位元設為 true 也會更新寫入日期 (即使位元已設為 true)。將位元設為 false 會將寫入日期重設為空白。要求中未指定的任何位元都會保持不變。在寫入位元和能夠在判定結果中讀取位元之間,會有短暫的傳播延遲。這項延遲最長可達 30 秒,但通常會短得多。裝置記憶寫入要求的頻率應低於完整性權杖要求。這些要求不會計入完整性權杖要求配額,但有獨立的頻率限制。

playintegrity.googleapis.com/v1/PACKAGE_NAME/deviceRecall:write -d \
'{
  "integrityToken": "INTEGRITY_TOKEN",
  "newValues": {
    "bitFirst": true,
    "bitThird": false
  }
}'
newValues.BitFirst = true // ForceSendFields optional for value true
newValues.BitSecond = false // ForceSendFields required for value false
newValues.BitThird = nil // do not set ForceSendFields for unspecified bits
newValues.ForceSendFields = []string{"BitSecond"}