O programa Sandbox de privacidade no Android Beta oferece APIs estáveis. É possível usar as versões do programa Beta para criar e testar soluções para testes de produção limitados em dispositivos móveis Android 13 ou mais recentes para todas as APIs e Android 12 ou mais recentes para a API Attribution Reporting (ARA). Vamos oferecer suporte a uma pequena porcentagem de dispositivos e aumentar o número com o tempo. Para participar, as organizações podem solicitar acesso a um número limitado de dispositivos, além de registrar todos os apps que usam as APIs do Sandbox de privacidade.
No SDK Runtime, temos uma versão Beta fechada para que os desenvolvedores possam testar a 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 atualização da extensão do SDK da API de nível 33.
Extensões do SDK do Android
As APIs estáveis em versões Beta são entregues usando o novo método de lançamento das extensões do SDK do Android. Esse método permite o lançamento de recursos estáveis do Android entre as principais versões. Ele tem 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 a usar o Sandbox de privacidade para Android, siga estas etapas:
Etapa 1: fazer a inscrição e o registro no programa Beta
- Inscreva-se: conclua o processo de inscrição para usar as APIs relacionadas a anúncios.
- Registre-se:você precisa register para participar do programa Beta.
O registro permite:
- 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. Se você só precisa testar o SDK Runtime no dispositivo, essa etapa não é necessária.
Etapa 2: configurar seu ambiente de desenvolvimento
Configure 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 aos recursos gerenciados pela API de destino.
Etapa 4: configurar uma imagem de dispositivo ou emulador
Para realizar testes completos, é necessário interagir com um dispositivo Android 13 com suporte ou usar 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) o Sandbox de privacidade no Android para execução em dispositivos.
Resolver problemas conhecidos
Para evitar problemas conhecidos com a integração da API PP em dispositivos com o Android 12 e versões anteriores, os desenvolvedores que fazem a integração com as APIs de serviços de publicidade para esses dispositivos precisam fazer o seguinte:
- Verifique se o arquivo de manifesto do app cliente contém a tag
<uses-library>extservices. A tag relevante é:
<uses-library
android:name="android.ext.adservices"
android:required="false" />
- Se você estiver usando a biblioteca
androidx.privacysandbox.adsdo Jetpack, use a versão 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 no Android, consulte as notas da versão e use o Issue Tracker para informar problemas e enviar feedback.
Manter seu ambiente de desenvolvimento atualizado
É altamente recomendável manter seu ambiente de desenvolvimento atualizado com a versão mais recente. Isso garante que você tenha os recursos e patches de segurança mais recentes e que seu ambiente seja compatível com as versões mais recentes das dependências. Para receber notificações sobre novos lançamentos, inscreva-se para receber atualizações por e-mail.