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 la depuración, hay comandos de la CLI disponibles para enumerar y visualizar 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 con fines de depuración. Solo se pueden ver con estos comandos si se cumplen los siguientes requisitos:

  • Se habilitaron las opciones para desarrolladores de todo el sistema
  • android:debuggable="true" se declara en el archivo AndroidManifest.xml de la app desde la que se unió CustomAudience (mediante joinCustomAudience o fetchAndJoinCustomAudience).
  • El consentimiento para 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 de 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

Enumerar públicos personalizados

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

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 vista de público personalizado 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 especificando owner como el paquete que creó el público, buyer como el identificador de la red de publicidad 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>

Actualizar un público personalizado específico

Para ver la actualización diaria del activador 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 de publicidad 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.