Inspecionar públicos-alvo personalizados na linha de comando

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 o CustomAudience foi mesclado (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. 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.