A API Protected Audience oferece uma série de APIs para ingressar e sair de públicos-alvo personalizados como parte do pacote android.adservices.customaudience. Para fins de depuração, há comandos da CLI disponíveis para listar e visualizar públicos-alvo personalizados. Neste guia, descrevemos as etapas que os desenvolvedores de adtech precisam seguir para inspecionar o estado dos públicos-alvo personalizados mesclados.
Configuração
Por motivos de segurança e privacidade, os públicos-alvo personalizados não ficam visíveis por padrão e só podem ser inspecionados diretamente para fins de depuração. Elas só ficarão visíveis com esses comandos se os requisitos a seguir forem verdadeiros:
- As opções do desenvolvedor do sistema estão ativadas
- O
android:debuggable="true"
é declarado no arquivo AndroidManifest.xml do app em que oCustomAudience
foi mesclado (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. Uma saída vazia é esperada para o 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 o buyer
como o
identificador da rede de publicidade que gerencia o público:
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 do comando de 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, o buyer
como o
identificador da 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 conferir a atualização diária do acionador de um público-alvo personalizado específico, execute o
comando abaixo, especificando owner
como o pacote que criou o
público-alvo, buyer
como o identificador da 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.