在指令列上檢查自訂目標對象

Protected Audience 提供一系列 API,可加入及退出自訂目標對象,這些 API 屬於 android.adservices.customaudience 套件。為進行偵錯,您可以使用 CLI 指令列出及查看自訂目標對象。本指南概述廣告技術開發人員檢查已加入自訂目標對象狀態時,需要採取的步驟。

設定

基於安全性和隱私權考量,自訂目標對象預設不會顯示,只能直接檢查以進行偵錯。只有在符合下列條件時,才能使用這些指令查看:

  • 已啟用全系統開發人員選項
  • android:debuggable="true" 是在應用程式的 AndroidManifest.xml 檔案中宣告,而該應用程式是從中加入 CustomAudience 的 (使用 joinCustomAudiencefetchAndJoinCustomAudience)
  • 已開啟應用程式建議廣告的同意聲明

啟用 adservices 殼層指令

  1. 重新啟動裝置,終止 adservices 程序。
  2. 確認 adservices 未執行。下列指令預期會輸出空白內容。
adb shell ps -A | grep adservices

接著,請執行下列指令來啟用 adservices 殼層指令:

adb shell setprop debug.adservices.adservices_shell_command_enabled true
adb shell setprop debug.adservices.fledge_is_custom_audience_cli_enabled true

列出自訂目標對象

如要查看特定自訂目標對象,請執行下列指令,並指定 owner 做為建立目標對象的套件,以及 buyer 做為管理目標對象的廣告聯播網 ID:

adb shell cmd adservices_manager custom-audience list --owner <owner> --buyer <buyer>

輸出內容會是包含陣列 custom_audiences 的 JSON 物件。 這個陣列中的元素結構與下文所述的「查看自訂目標對象」指令輸出內容相符。

查看特定自訂目標對象

如要查看特定自訂目標對象,請執行下列指令,並指定 owner (建立目標對象的套件)、buyer (管理目標對象的廣告聯播網的 ID) 和 name (目標對象名稱):

adb shell cmd adservices_manager custom-audience view --owner <owner> --buyer <buyer> --name <name>

重新整理特定自訂目標對象

如要手動觸發特定自訂目標對象的每日更新,請執行下列指令,並指定 owner 做為建立目標對象的套件、buyer 做為管理目標對象的廣告聯播網 ID,以及 name 做為目標對象名稱:

adb shell cmd adservices_manager custom-audience refresh --owner <owner> --buyer <buyer> --name <name>
> Successfully updated custom audience.