Inspecionar públicos-alvo personalizados na linha de comando

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 o CustomAudience foi combinado (usando joinCustomAudience ou fetchAndJoinCustomAudience).
  • O consentimento para anúncios sugeridos por apps está ativado

Ativar comandos do shell adservices

  1. Reinicie o dispositivo para encerrar o processo de adservices.
  2. 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.