Cómo inspeccionar públicos personalizados en la línea de comandos

Protected Audience proporciona una serie de APIs para unirse a públicos personalizados y abandonarlos como parte del paquete android.adservices.customaudience. Para fines de depuración, hay comandos de la CLI disponibles para enumerar y ver públicos personalizados. En esta guía, se describen los pasos que deben seguir los desarrolladores de tecnología publicitaria para inspeccionar el estado de sus públicos personalizados unidos.

Configuración

Por motivos de seguridad y privacidad, los públicos personalizados no son visibles de forma predeterminada y solo se pueden inspeccionar directamente para depurar. Solo se pueden ver con estos comandos si se cumplen los siguientes requisitos:

  • Se habilitaron las opciones para desarrolladores en todo el sistema
  • android:debuggable="true" se declara en el archivo AndroidManifest.xml de la app desde la que se unió CustomAudience (con joinCustomAudience o fetchAndJoinCustomAudience).
  • El consentimiento para los anuncios sugeridos por apps está activado

Habilita los comandos de shell de adservices

  1. Reinicia el dispositivo para finalizar el proceso de adservices.
  2. Confirma que adservices no se esté ejecutando. Se espera un resultado vacío para el siguiente comando.
adb shell ps -A | grep adservices

Luego, para habilitar los comandos del shell de adservices, ejecuta los siguientes comandos:

adb shell setprop debug.adservices.adservices_shell_command_enabled true
adb shell setprop debug.adservices.fledge_is_custom_audience_cli_enabled true

Enumera públicos personalizados

Para ver un público personalizado específico, ejecuta el siguiente comando y especifica owner como el paquete que creó el público y buyer como el identificador de la red publicitaria que administra el público:

adb shell cmd adservices_manager custom-audience list --owner <owner> --buyer <buyer>

El resultado será un objeto JSON que contiene un array custom_audiences. La estructura de los elementos dentro de este array coincide con el resultado del comando de público personalizado de la vista que se describe a continuación.

Cómo ver un público personalizado específico

Para ver un público personalizado específico, ejecuta el siguiente comando y especifica owner como el paquete que creó el público, buyer como el identificador de la red publicitaria que administra el público y name como el nombre del público:

adb shell cmd adservices_manager custom-audience view --owner <owner> --buyer <buyer> --name <name>

Actualiza un público personalizado específico

Para ver el activador de actualización diaria de forma manual para un público personalizado específico, ejecuta el siguiente comando y especifica owner como el paquete que creó el público, buyer como el identificador de la red publicitaria que administra el público y name como el nombre del público:

adb shell cmd adservices_manager custom-audience refresh --owner <owner> --buyer <buyer> --name <name>
> Successfully updated custom audience.