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
(mediantejoinCustomAudience
ofetchAndJoinCustomAudience
).- El consentimiento para anuncios sugeridos por apps está activado
Habilita los comandos de shell de adservices
- Reinicia el dispositivo para finalizar el proceso de
adservices
. - 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.