Configurar AdServices

Ao ler a documentação do Sandbox de privacidade do Android, use o botão Prévia para desenvolvedores ou Beta para selecionar a versão do programa com que você está trabalhando, porque as instruções podem variar.


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 dos serviços de publicidade. No manifesto, declare as permissões de acesso que correspondem às APIs necessárias no app ou SDK.

API Attribution Reporting

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

API Attribution Reporting (com relatórios de depuração):

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

API de público-alvo personalizado, Protected Audience:

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

API Topics:

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

Se quiser receber relatórios de depuração com a API Attribution Reporting, inclua a permissão AD_ID:

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

Se o projeto tiver dependências em módulos ou SDKs, eles já podem declarar as permissões necessárias dos serviços de publicidade nos arquivos de manifesto. Por padrão, o build do Gradle mescla todos os arquivos de manifesto em um único arquivo, empacotado no app. Use a visualização manifesto integrado para verificar se as permissões corretas são usadas.

Se for necessário impedir que qualquer permissão seja mesclada no seu app por meio de dependências, por exemplo, SDKs, inclua o marcador de nó remove para as permissões específicas. O exemplo a seguir mostra como evitar a mesclagem da permissão da API Topics.

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

Configurar serviços de publicidade específicos das APIs

Semelhante às permissões de acesso à PPAPI, cada API tem uma entrada correspondente na configuração dos serviços de publicidade. 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, conforme 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 seu app (ou SDK incorporado), defina o atributo allowAllToAccess como true para conceder acesso aos autores de chamadas.

Como alternativa, é possível usar o atributo allowAdPartnersToAccess para conceder acesso detalhado à API para cada adtech. Será necessário fornecer uma lista de IDs de conta de registro de desenvolvedor recebidos por meio do registro. Se o atributo allowAllToAccess estiver definido como true, ele vai ter precedência sobre qualquer ID de conta de registro especificado no atributo allowAdPartnersToAccess.

As plataformas de adtech 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.

O exemplo abaixo mostra como especificar o acesso amplo para permitir o acesso ao ID de conta de registro a todas as APIs de preservação de privacidade:

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

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

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

O exemplo a seguir mostra como especificar acesso detalhado a cada API que preserva a privacidade para IDs de conta de registro específicos:

<ad-services-config>
    <!-- Attribution API -->
    <attribution allowAdPartnersToAccess="ENROLLMENT-ID" allowAllToAccess="false" />

    <!-- Topics API →-->
    <includes-sdk-library name="ENROLLMENT-ID" />
    <topics allowAdPartnersToAccess="ENROLLMENT-ID" allowAllToAccess="false" />

    <!-- Protected Audience on Android API -->
    <custom-audiences allowAdPartnersToAccess="ENROLLMENT-ID" allowAllToAccess="false" />
</ad-services-config>