Inspecionar públicos-alvo personalizados na linha de comando

A API Protected Audience oferece uma série de APIs para entrar 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. Este guia descreve as etapas que os desenvolvedores de adtech precisam seguir para inspecionar o estado dos públicos-alvo personalizados combinados.

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. Eles só ficam visíveis usando esses comandos se os seguintes requisitos forem atendidos:

  • As opções do desenvolvedor em todo o sistema estão ativadas
  • android:debuggable="true" é declarado no arquivo AndroidManifest.xml do app de onde o CustomAudience foi unido (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 adservices.
  2. Confirme se adservices não está em execução. A saída esperada para o comando a seguir é vazia.
adb shell ps -A | grep adservices

Em seguida, para ativar os comandos do shell 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 ver um público-alvo personalizado específico, execute o comando a seguir, 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-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 do comando de público-alvo personalizado da visualização 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 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 view --owner <owner> --buyer <buyer> --name <name>

Atualizar um público-alvo personalizado específico

Para acionar uma atualização diária manual de um público-alvo personalizado específico, execute o comando a seguir, 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.