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

Protected Audience 提供一系列 API,用於加入及退出自訂 做為 android.adservices.customaudience 套件中的目標對象。適用對象 有針對偵錯目的,您可以使用 CLI 指令列出和查看 自訂目標對象本指南將概述廣告技術開發人員須採取的步驟 即可檢查已加入自訂目標對象的狀態。

設定

基於安全性和隱私權考量,自訂目標對象預設為不顯示 而且只能直接檢查偵錯用途只有其他人看得到 滿足以下需求時再執行指令:

  • 已啟用整個系統的開發人員選項
  • android:debuggable="true" 已在 加入 CustomAudience 的應用程式 (使用 joinCustomAudiencefetchAndJoinCustomAudience)。
  • 「應用程式建議廣告的同意聲明」設定已開啟

啟用 adservices shell 指令

  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.