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

Protected Audience ofrece una serie de APIs para unirse y abandonar públicos como parte del paquete android.adservices.customaudience. Para para la depuración, hay comandos de la CLI disponibles para enumerarlos y visualizarlos. para tus 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 los públicos personalizados que se unieron.

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 son visibles. 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 del 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 la 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 la owner como el paquete que creó el público y buyer como el Identificador de la red de publicidad 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 de la vista 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 la owner como el paquete que creó el público, y buyer como el 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: siguiente comando especificando owner como el paquete que creó la público, buyer como el identificador de la red de publicidad que administra la 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.