A API Protected Audience fornece uma série de APIs para acessar e sair da públicos-alvo como parte do pacote android.adservices.customaudience. Para Para fins de depuração, há comandos da CLI disponíveis para listar e visualizar públicos-alvo personalizados. Este guia descreve as etapas que os desenvolvedores de adtech precisam para seguem para inspecionar o estado dos públicos-alvo personalizados associados.
Configuração
Por motivos de segurança e privacidade, os públicos-alvo personalizados não são visíveis por padrão e só podem ser inspecionados diretamente para fins de depuração. Eles são visíveis apenas usando esses comandos se os seguintes requisitos forem verdadeiros:
- As opções do desenvolvedor do sistema estão ativadas
android:debuggable="true"
é declarado no arquivo AndroidManifest.xml do app de onde oCustomAudience
foi combinado (usandojoinCustomAudience
oufetchAndJoinCustomAudience
).- O consentimento para anúncios sugeridos por apps está ativado
Ativar comandos do shell adservices
- Reinicie o dispositivo para encerrar o processo de
adservices
. - Confirme se
adservices
não está em execução. A saída deve estar vazia comando a seguir.
adb shell ps -A | grep adservices
Em seguida, para ativar os comandos do shell do adservices
, execute os seguintes comandos:
adb shell setprop debug.adservices.adservices_shell_command_enabled true
adb shell setprop debug.adservices.fledge_is_custom_audience_cli_enabled true
Listar públicos-alvo personalizados
Para conferir um público-alvo personalizado específico, execute o seguinte comando especificando o
owner
como o pacote que criou o público-alvo, e buyer
como o
identificador da rede de publicidade que gerencia o público-alvo:
adb shell cmd adservices_manager custom-audience list --owner <owner> --buyer <buyer>
A saída será um objeto JSON que contém uma matriz custom_audiences
.
A estrutura dos elementos nessa matriz corresponde à saída da visualização.
público-alvo personalizado descrito a seguir.
Ver um público-alvo personalizado específico
Para conferir um público-alvo personalizado específico, execute o seguinte comando especificando o
owner
como o pacote que criou o público-alvo, e buyer
como o
para a rede de publicidade que gerencia o público-alvo, e o name
como o
nome do público-alvo:
adb shell cmd adservices_manager custom-audience view --owner <owner> --buyer <buyer> --name <name>
Atualizar um público-alvo personalizado específico
Para acessar manualmente a atualização diária do acionador de um público-alvo personalizado específico, execute o
comando a seguir, especificando o owner
como o pacote que criou o
público-alvo, o buyer
como o identificador para a rede de publicidade que gerencia o
público-alvo, e name
como o nome do público-alvo:
adb shell cmd adservices_manager custom-audience refresh --owner <owner> --buyer <buyer> --name <name>
> Successfully updated custom audience.