Configura el acceso a la API para tu app o SDK

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

A fin de acceder a las APIs que preservan la privacidad (PPAPIs) de tu app o SDK durante la Vista preliminar para desarrolladores, primero debes realizar los siguientes pasos:

Se requiere acceso a la API para las APIs que preservan la privacidad y el entorno de ejecución del SDK.

Esto es necesario para las APIs específicas que preservan la privacidad y se usan en tu app o SDKs.

Habilita el acceso a las APIs de Privacy Sandbox

Los diseños para Privacy Sandbox en Android permiten a los usuarios controlar si las PPAPIs y el entorno de ejecución del SDK están activos en sus dispositivos. Estos parámetros de configuración están inhabilitada de forma predeterminada a partir de la Vista preliminar para desarrolladores 5. Para fines de desarrollo, puedes habilitar el acceso a la API con el siguiente comando adb:

adb shell device_config put adservices ppapi_app_allow_list \"*\"

Configura los permisos de AdServices

Sigue las instrucciones a continuación para declarar permisos específicos de la API y configurar el acceso al SDK a los recursos que administra la API objetivo.

Declara permisos específicos de la API de AdServices

El acceso a cada PPAPI requiere un permiso normal de AdServices. En tu manifiesto, declara los permisos de acceso adecuados que correspondan a las APIs necesarias en tu app o SDK.

API de Attribution Reporting:

<uses-permission android:name="android.permission.ACCESS_ADSERVICES_ATTRIBUTION" />

FLEDGE/API de público personalizado:

<uses-permission android:name="android.permission.ACCESS_ADSERVICES_CUSTOM_AUDIENCE" />

API de Topics:

<uses-permission android:name="android.permission.ACCESS_ADSERVICES_TOPICS" />

Configura servicios de anuncios específicos de la API

Al igual que los permisos de acceso a la PPAPI, cada API tiene una entrada correspondiente en la configuración de servicios de anuncios. Esta configuración te brinda un control detallado de los recursos que administran las APIs de tu app o SDK incorporado. En tu manifiesto, especifica una propiedad adservicesConfig como se muestra en el siguiente ejemplo:

<application ...>
      ...
    <property android:name="android.adservices.AD_SERVICES_CONFIG"
        android:resource="@xml/ad_services_config" />

      ...
</application>

Especifica el recurso XML de servicios de anuncios al que se hace referencia en el manifiesto, como res/xml/ad_services_config.xml. Para cada API de preservación de la privacidad aplicable a tu app (o SDK incorporado), usa el atributo allowAllToAccess a fin de otorgar acceso.

Las plataformas de tecnología publicitaria también deben asegurarse de que sus clientes de apps otorguen acceso a las APIs de preservación de la privacidad necesarias en la configuración de los servicios de anuncios.

<ad-services-config>
    <!-- Attribution API -->
    <attribution allowAllToAccess="true" />

    <!-- Topics API -->
    <topics allowAllToAccess="true" />

    <!-- FLEDGE on Android API -->
    <custom-audiences allowAllToAccess="true" />
</ad-services-config>

Limitación del acceso en primer plano

A fin de brindar transparencia, el acceso al entorno de ejecución del SDK y a las APIs que preservan la privacidad se limita a las apps con una actividad visible o con RunningAppProcessInfo de IMPORTANCE_FOREGROUND.