Notas da versão

As versões da prévia para desenvolvedores do Sandbox de privacidade do Android têm como objetivo ajudar com o desenvolvimento, testes e feedback. As prévias para desenvolvedores do Sandbox de privacidade do Android são builds iniciais que ainda estão em desenvolvimento ativo. Por isso, nem sempre tudo vai funcionar da forma esperada. A prévia para desenvolvedores do Sandbox de privacidade está sujeita a mudanças. Envie seu feedback.

Para começar, configure seu ambiente de desenvolvimento e atualize o Sandbox de privacidade do Android no seu dispositivo de teste ou emulador.

Versão atual

Sandbox de privacidade na prévia para desenvolvedores 4 do Android

Data de lançamento: 14 de julho de 2022

O Sandbox de privacidade na prévia para desenvolvedores 4 do Android inclui melhorias às seguintes áreas:

SDK Runtime

  • Os apps agora podem se comunicar com os SDKs ativados no momento da execução (RE-SDKs, na sigla em inglês) pela adição da sendData().
  • O armazenamento local agora está disponível no processo do SDK Runtime.
  • Um SDK também pode renderizar anúncios ou conteúdos em vídeo independentes no SDK Runtime.
  • Adicionamos esclarecimentos sobre a reflexão para incluir a capacidade de usá-la, desde que o conteúdo não esteja em outro RE-SDK.

API Attribution Reporting

Esta versão introduz mudanças para melhorar a clareza sobre o uso da API Attribution Reporting, como:

  • Mudanças no formato de relatórios agregados para melhorar a legibilidade.
  • Atualização nos campos de cabeçalho dos recursos de lance e filtro de conversão.
  • Incluímos esclarecimentos na referência da API WebApp para explicar o registro de origem e acionamento, bem como a disponibilidade da API de privacidade e consentimento.

FLEDGE na API Android

Esta versão inclui novos recursos para ajudar nos testes e na capacidade de depuração, além de melhorias internas:

  • Inclusão de suporte à substituição de URLs remotos para recuperar lógica do JavaScript durante o desenvolvimento.
  • Relatórios de erros aprimorados durante a seleção de anúncios.
  • Os públicos-alvo personalizados inativos vão ser filtrados durante a seleção de anúncios.

API Topics

Esta versão inclui várias mudanças importantes na API Topics, principalmente:

  • O tipo de retorno da API [getTopics()] foi mudado para o novo tipo de objeto Topic, que encapsula IDs de números inteiros que correspondem a temas na taxonomia, informações sobre o classificador e as versões da taxonomia. Atualize os apps existentes que usam essa API.
  • O uso da API Topics agora exige uma nova permissão normal.
  • Introdução do sistema "Classificador no dispositivo" para atribuir temas dinamicamente com base nas informações do app disponíveis publicamente.

Versões anteriores

Prévia para desenvolvedores 3

Data de lançamento: 9 de junho de 2022

O Sandbox de privacidade na prévia para desenvolvedores 3 do Android adiciona funcionalidades à API Attribution Reporting e ao FLEDGE no Android.

API Attribution Reporting

A API Attribution Reporting melhora a privacidade do usuário ao remover a dependência de identificadores do usuário entre diferentes partes, e também oferece suporte aos principais casos de uso para avaliação de métricas de conversão e atribuição em apps.

Esta versão inclui recursos para desenvolvedores e ajuda você a testar os recursos da API Attribution Reporting abaixo:

  • Registro de fonte de atribuição e acionamento de eventos.
  • Uso de atribuição com prioridade de fonte e pós-instalação.
  • Recebimento de relatórios de eventos.
  • Recebimento de relatórios agregáveis, que não são criptografados nesta versão.

Fornecemos um app de exemplo e um servidor de tecnologias de publicidade de referência para ajudar nos testes.

Problemas conhecidos:

FLEDGE no Android

O FLEDGE no Android apresenta uma nova maneira de mostrar anúncios com base em públicos-alvo personalizados definidos pelos desenvolvedores de apps com base nas interações no app. Essa solução armazena as informações e os anúncios associados localmente e fornece um framework para organizar os fluxos de trabalho de seleção de anúncios.

Esta versão inclui recursos para desenvolvedores e ajuda você a testar estes recursos do FLEDGE no Android:

  • Participação ou saída de um público-alvo personalizado e observação de como os valores de parâmetro podem afetar os resultados do leilão.
  • Busca do código JavaScript de leilões em endpoints remotos.
  • Configuração e início de leilões de anúncios no dispositivo.
  • Processamento de relatórios de impressão.
  • Fornecimento de um app de exemplo e uma configuração de servidor simulada para ajudar nos testes.

Problemas conhecidos:

Prévia para desenvolvedores 2

Data de lançamento: 17 de maio de 2022

A prévia para desenvolvedores 2 inclui as primeiras visualizações das APIs de relatórios de atribuição do MeasurementManager.

  • Você pode chamar registerSource() e registerTrigger() para registrar eventos de anúncio do app e receber dados do relatório no nível do evento para a atribuição de app para app. A implementação atual usa a atribuição de último toque. Os relatórios são programados para serem enviados conforme definido pelas janelas de geração de relatórios. Consulte a referência da API MeasurementManager para mais informações.

  • O upload do relatório ocorre ao final de intervalos de tempo fixos, e não no horário exato programado. O intervalo de upload de relatórios é de quatro horas por padrão, mas ele pode ser substituído pelo seguinte comando do adb:

    adb shell device_config put adservices measurement_main_reporting_job_period_ms <duration in milliseconds>

  • Um app de exemplo e um servidor de tecnologias de publicidade de referência para testar APIs vão ser publicados em uma versão futura.

  • Outros recursos da API Attribution Reporting da classe MeasurementManager, como relatórios agregados, atribuição pós-instalação e redirecionamentos, vão estar disponíveis em uma versão futura.

Prévia para desenvolvedores 1

Data de lançamento: 28 de abril de 2022

A prévia para desenvolvedores 1 inclui pré-lançamentos da API Topics e do SDK Runtime. A funcionalidade para FLEDGE no Android e APIs Attribution Reporting vai ser disponibilizada em uma versão futura.

  • API Topics
    • No momento, a API getTopics() retorna valores de teste com base em classificação off-line para um conjunto limitado de apps. As classificações no dispositivo ainda não foram implementadas.
    • Você pode usar comandos adb para substituir intervalos e forçar a contabilização da época.
    • Leia o guia para desenvolvedores da Topics para ver mais detalhes.
  • SDK Runtime
    • É possível empacotar e criar SDKs ativados pelo ambiente de execução (SDKs RE) usando o novo elemento <sdk-library> no arquivo de manifesto do app do SDK. Instale os SDKs RE em um dispositivo ou emulador de teste com suporte, da mesma forma que você instalaria um app durante o desenvolvimento.
    • É possível integrar um app com SDKs RE, carregá-los no ambiente de execução do SDK e testar o impacto do acesso restrito no código do SDK: permissões, memória e comunicações entre app e SDK. As APIs Storage para SDKs RE ainda não foram implementadas e vão ser disponibilizadas em uma versão futura.
    • Um SDK pode renderizar anúncios de banner ou de conteúdo baseados em WebView no ambiente de execução do SDK.
    • Veja mais informações no guia para desenvolvedores do ambiente de execução do SDK.
  • Verificações de lint para Android
    • As verificações de lint do Android podem mostrar avisos incorretamente em projetos compilados com o nível da API TiramisuPrivacySandbox. Por exemplo, você pode encontrar a mensagem de aviso "A chamada requer o nível 33 da API". Esse problema pode ser resolvido temporariamente usando a anotação @SuppressLint("NewApi").