Comece a usar o Sandbox de privacidade para Android

O programa Sandbox de privacidade no Android Beta oferece APIs estáveis. Estamos e planejava várias versões Beta ao longo de 2023. Você pode usar o programa Beta lançamentos para criar e testar soluções para testes de produção limitados no Android 13 dispositivos móveis. Começaremos a oferecer suporte a uma pequena porcentagem de dispositivos e aumentar o número com o tempo. Para participar, as organizações podem pedir acesso para um número limitado de dispositivos, além de registrar quaisquer aplicativos que usem o APIs do Sandbox de privacidade.

Para o SDK Runtime, temos uma versão Beta fechada para que os desenvolvedores testem. Distribuição do SDK ativado pelo ambiente de execução para alguns apps.

Para usar a versão Beta, os desenvolvedores precisam compilar as soluções com uma API da extensão do SDK de nível 33.

Extensões do SDK do Android

As APIs estáveis em versões Beta são fornecidas usando as novas extensões do SDK do Android. método de lançamento. Esse método permite o lançamento de versões estáveis do Android entre lançamentos importantes. Ele apresenta um novo mecanismo de controle de versão que disponibiliza novas APIs para apps em vários níveis da API usando as atualizações do sistema do Google Play. A extensão do SDK do Sandbox de privacidade no Android é chamada de Extensões de serviços de anúncio. Saiba mais sobre as Extensões do SDK do Android.

Primeiros passos

Para começar, siga estas etapas:

Etapa 1: fazer a inscrição e o registro no programa Beta

  • Inscrição:conclua o processo de inscrição para usar as APIs relacionadas a anúncios.
  • Registre-se:você precisa se registrar para participar do programa Beta. O registro permite que você:
    • Ative seus dispositivos para testes internos.
    • Especifique um número limitado de apps publicados na Google Play Store que podem integrar diretamente as APIs de preservação de privacidade ou soluções de SDK que usam as APIs.
    • Teste a distribuição do SDK ativada pelo ambiente de execução usando a Google Play Store. Esta etapa não será necessária se você precisar testar o SDK Runtime no dispositivo.

Etapa 2: configurar seu ambiente de desenvolvimento

Configurar o Sandbox de privacidade no SDK do Android usando o Android Studio.

Etapa 3: configurar as permissões do AdServices

Declare permissões específicas da API e configure o acesso do SDK para recursos gerenciados pela API de destino.

Etapa 4: configurar uma imagem de dispositivo ou emulador

Para realizar testes completos, é necessário interagir com uma versão com suporte do Android 13 dispositivo ou use uma imagem de emulador para a extensão do SDK adequada.

Etapa 5: configurar dispositivos para usar o Sandbox de privacidade no Android

Defina as configurações para ativar (ou desativar) a privacidade Sandbox no Android para execução em dispositivos.

Resolver problemas conhecidos

Para evitar problemas conhecidos com a integração da API PP no Android 12 e em dispositivos anteriores, os desenvolvedores que fazem a integração com APIs de serviços de publicidade para dispositivos Android 12 e anteriores precisam fazer o seguinte:

  1. Verifique se o arquivo de manifesto do app cliente contém a tag extservices <uses-library>. A tag relevante é a seguinte:
<uses-library
  android:name="android.ext.adservices"
  android:required="false" />
  1. Se você usa a biblioteca androidx.privacysandbox.ads do Jetpack, confira se a versão dele é a 1.1.0-beta05 ou mais recente.

Quais recursos estão disponíveis para os desenvolvedores?

O programa Sandbox de privacidade no Android Beta inclui as ferramentas e os recursos abaixo.

SDK e imagens do sistema do emulador

Com o Android Studio, é possível fazer o download da imagem mais recente da extensão dos serviços de publicidade e do sistema do emulador usando o SDK Manager. Saiba mais sobre como configurar seu ambiente de desenvolvimento e o acesso à API.

Referência da API

A referência da API completa está disponível.

Suporte e feedback

Ao testar e desenvolver com o Sandbox de privacidade do Android, revise a versão e use o Issue Tracker para informar problemas e enviar feedback.

Manter seu ambiente de desenvolvimento atualizado

Recomendamos manter seu ambiente de desenvolvimento atualizado com para a versão mais recente. Isso garante que você tenha os recursos e as configurações patches de segurança e que seu ambiente seja compatível com os das suas dependências. Para ficar por dentro dos lançamentos, inscreva-se para receber atualizações por e-mail.