O programa Sandbox de privacidade no Android Beta oferece APIs estáveis. Estamos e planejava várias versões Beta ao longo de 2023. É 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 e registrar qualquer app que use as 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 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 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:
- 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" />
- Se você estiver usando a biblioteca jetpack
androidx.privacysandbox.ads, verifique se está usando 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 o 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 as configurações patches de segurança e que seu ambiente é compatível com os das suas dependências. Para ficar por dentro dos lançamentos, inscreva-se para receber atualizações por e-mail.