Configurar o acesso à API do seu app ou SDK

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Para acessar as APIs de preservação de privacidade (PPAPIs, na sigla em inglês) para seu app ou SDK durante a prévia para desenvolvedores, primeiro é necessário realizar as seguintes etapas:

É necessário o acesso às APIs que preservam a privacidade e ao SDK Runtime.

Isso é necessário para APIs de preservação de privacidade específicas usadas no seu app ou SDKs.

Permitir acesso às APIs do Sandbox de privacidade

Os designs do Sandbox de privacidade do Android permitem que os usuários controlem se as PPAPIs e o SDK Runtime estão ativos nos dispositivos. Essas configurações ficam desativadas por padrão a partir da prévia para desenvolvedores 5. Para fins de desenvolvimento, ative o acesso à API com o seguinte comando adb:

adb shell device_config put adservices ppapi_app_allow_list \"*\"

FLEDGE

O registro no FLEDGE é válido a partir da prévia para desenvolvedores 6. Para fins de desenvolvimento, ative o acesso à API com o seguinte comando adb:

adb shell "device_config put adservices disable_fledge_enrollment_check true"

Configurar permissões do AdServices

Siga as instruções abaixo para declarar permissões específicas da API e configurar o acesso do SDK aos recursos gerenciados pela API de destino.

Declarar permissões específicas da API AdServices

O acesso a cada PPAPI requer uma permissão normal da AdServices. No manifesto, declare as permissões de acesso apropriadas que correspondem às APIs necessárias no app ou SDK.

API Attribution Reporting

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

FLEDGE / API de público-alvo personalizado:

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

API Topics:

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

Configurar serviços de anúncios específicos das APIs

Semelhante às permissões de acesso à PPAPI, cada API tem uma entrada correspondente na configuração dos serviços de anúncios. Essa configuração oferece acesso de controle refinado a recursos gerenciados pelas APIs no seu app ou SDK incorporado. No manifesto, especifique uma propriedade adservicesConfig, como mostrado no exemplo abaixo:

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

      ...
</application>

Especifique o recurso XML dos serviços de publicidade referenciados no manifesto, como res/xml/ad_services_config.xml. Para cada API de preservação de privacidade aplicável ao app (ou SDK incorporado), use o atributo allowAllToAccess para conceder acesso.

As plataformas de tecnologias de publicidade também precisam garantir que os clientes do seu app concedam corretamente o acesso às APIs de preservação de privacidade necessárias na configuração dos serviços de anúncio.

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

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

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

Limitação de acesso em primeiro plano

Para oferecer transparência, o acesso ao SDK Runtime e às APIs de preservação de privacidade é limitado a apps com uma atividade visível ou com uma RunningAppProcessInfo de IMPORTANCE_FOREGROUND