Anúncios da privacysandbox

  
Essa biblioteca permite a integração com as APIs que preservam a privacidade e que fazem parte do Sandbox de privacidade do Android.
Atualização mais recente Versão estável Versão candidata a lançamento Versão Beta Versão Alfa
7 de maio de 2025 - - 1.1.0-beta13 -

Declarar dependências

Para adicionar uma dependência a privacysandbox-ads, é preciso adicionar o repositório Maven do Google ao seu projeto. Leia Repositório Maven do Google para mais informações.

Adicione as dependências dos artefatos necessários ao arquivo build.gradle do seu app ou módulo:

Groovy

dependencies {
 
    implementation "androidx.privacysandbox.ads:ads-adservices:1.1.0-beta13"
   
    implementation "androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta13"
 
}

Kotlin

dependencies {

    implementation("androidx.privacysandbox.ads:ads-adservices:1.1.0-beta13")

    implementation "androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta13"
   
}

Para mais informações sobre dependências, consulte Adicionar dependências de build.

Feedback

Seu feedback ajuda a melhorar o Jetpack. Avise se você descobrir novos problemas ou tiver ideias para melhorar esta biblioteca. Consulte os problemas conhecidos nesta biblioteca antes de criar um novo. Adicione seu voto a um problema clicando no botão de estrela.

Criar novo problema

Consulte a documentação do Issue Tracker para saber mais.

Versão 1.1

Versão 1.1.0-beta12

12 de março de 2025

Lançamento de androidx.privacysandbox.ads:ads-adservices:1.1.0-beta12 e androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta12. A versão 1.1.0-beta12 contém estas confirmações.

Novos recursos

  • Prioridade do público-alvo personalizado: adicionamos um campo de prioridade ao público-alvo personalizado. Isso permite que os compradores especifiquem um valor de prioridade em um CustomAudience. Esse valor seria usado para identificar públicos-alvo personalizados que precisam ser incluídos em um leilão se o conjunto de públicos-alvo personalizados do comprador exceder os limites de tamanho por comprador.
  • Configuração do vendedor: esse recurso permite que os vendedores definam parâmetros de leilão para controlar o tamanho do payload e os participantes do leilão. A configuração do leilão do vendedor permitiria que os vendedores especificassem:
    • Lista de compradores permitidos
    • Nos leilões iniciados pelo vendedor, apenas os compradores na lista de permissões poderiam contribuir com CustomAudiences para o leilão.
    • Limite de tamanho por comprador
    • Os vendedores podem especificar um limite por comprador para regular o tamanho dos dados enviados por comprador para o payload que está sendo enviado ao SellerFrontendService. Se o comprador exceder o limite de tamanho por comprador, a prioridade CustomAudience definida na configuração de payload do comprador será usada para conseguir os dados nos limites esperados.
    • Limite de tamanho máximo do payload
    • Vendedores diferentes podem ter alocação de recursos diferente e podem definir um limite de tamanho máximo para o payload de leilão por solicitação. O limite de tamanho máximo respeitaria os buckets de tamanho fixo definidos pela API ProtectedAudience.
  • Atualizações de público-alvo personalizado com atraso: esse recurso permite que os compradores programem atualizações adiadas para públicos-alvo personalizados. Cada solicitação de atualização permite que o autor da chamada programe uma atualização atrasada usando a nova API scheduleCustomAudienceUpdate(). Em cada atualização, o usuário pode especificar conjuntos de públicos-alvo personalizados para participar ou sair.

Mudanças na API

  • A configuração do vendedor foi adicionada à API GetAdSelectionRequest (Ibb5c7).
  • A API ScheduleCustomAudienceUpdate foi introduzida como experimental (I6b905).

Versão 1.1.0-beta11

30 de outubro de 2024

Lançamento de androidx.privacysandbox.ads:ads-adservices:1.1.0-beta11 e androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta11. A versão 1.1.0-beta11 contém estas confirmações.

Novos recursos

  • Esta atualização remove o suporte para medição do Sandbox de privacidade e APIs adid no Android R, que foi descontinuado. As chamadas para receber as classes de gerenciador no Android R agora retornam nulo.

Versão 1.1.0-beta10

21 de agosto de 2024

Lançamento de androidx.privacysandbox.ads:ads-adservices:1.1.0-beta10 e androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta10. A versão 1.1.0-beta10 contém estas confirmações.

Mudanças na API

  • Adição de sobrecargas de contêineres Java ausentes para as APIs experimentais GetAdSelectionDataOutcome, PersistAdSelectionResultRequest, ReportEventRequest e FetchAndJoinCustomAudienceRequest. (I19e7f).

Versão 1.1.0-beta09

10 de julho de 2024

Lançamento de androidx.privacysandbox.ads:ads-adservices:1.1.0-beta09 e androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta09. A versão 1.1.0-beta09 contém estas confirmações.

Mudanças na API

  • Adição de sobrecargas de construtor Java ausentes para a API Experimental GetAdSelectionDataRequest. (Ifbf88).

Versão 1.1.0-beta08

26 de junho de 2024

Lançamento de androidx.privacysandbox.ads:ads-adservices:1.1.0-beta08 e androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta08. A versão 1.1.0-beta08 contém estas confirmações.

Novos recursos

  • Adição de suporte a indicadores de apps protegidos.
  • Suporte a vários provedores de nuvem para leilões de servidores de B&A.

Mudanças na API

  • A API experimental GetAdSelectionDataRequest::seller não pode ser nula. (I68044).
  • Adição da API experimental GetAdSelectionDataRequest::coordinatorOriginUri. (I18c0b).
  • A API updateSignals foi adicionada. (Ia8512).

Versão 1.1.0-beta07

14 de maio de 2024

Lançamento de androidx.privacysandbox.ads:ads-adservices:1.1.0-beta07 e androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta07. A versão 1.1.0-beta07 contém estas confirmações.

Novos recursos

  • Agora, o GetTopics oferece suporte a respostas criptografadas como parte de GetTopicsResponse.

Mudanças na API

  • EncryptedTopic foi adicionado à classe GetTopicResponse. (Iab362).

Versão 1.1.0-beta06

17 de abril de 2024

Lançamento de androidx.privacysandbox.ads:ads-adservices:1.1.0-beta06 e androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta06. A versão 1.1.0-beta06 contém estas confirmações.

Observação

  • A partir da versão 1.1.0-beta06 do jetpack privacysandbox-ads, todos os dispositivos Android R com flags ativadas poderão acessar as PPAPIs. Para qualquer caso de uso que não ofereça suporte ao Android R, serão necessários outros protetores no código usando o código do jetpack privacysandbox-ads.

Novos recursos

  • Suporte à compatibilidade com versões anteriores do Android R.

Versão 1.1.0-beta05

3 de abril de 2024

Lançamento de androidx.privacysandbox.ads:ads-adservices:1.1.0-beta05 e androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta05. A versão 1.1.0-beta05 contém estas confirmações.

Correções de bugs

  • Adição de captura de erros quando uma definição de classe não é encontrada em dispositivos Android S devido à ausência da tag uses-library no manifesto.

Versão 1.1.0-beta04

24 de janeiro de 2024

Lançamento de androidx.privacysandbox.ads:ads-adservices:1.1.0-beta04 e androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta04. A versão 1.1.0-beta04 contém estas confirmações.

Novos recursos

  • Nova API para oferecer suporte a relatórios de eventos do usuário pós-leilão
  • Adição de suporte à filtragem do limite de frequência para anúncios de remarketing
  • Suporte para a delegação de "Participar de público-alvo personalizado"
  • Suporte ao truncamento da cadeia de mediação em hierarquia
  • Suporte a leilões protegidos em servidores de lances e leilões

Mudanças na API

  • Introdução da API experimental AdSelectionManager::selectAds(AdSelectionFromOutcomesConfig) (I86cd2).
  • Introdução da API experimental ReportEventRequest::inputEvent (Ib94f3).
  • Agora, o ReportImpressionRequest::adSelectionConfig é opcional (Ief280).
  • Introdução das APIs experimentais AdSelectionManager::getAdSelectionData e AdSelectionManager::persistAdSelectionResultUnified (Ie4d0e).
  • Introdução da API experimental CustomAudienceManager::fetchAndJoinCustomAudience (I09152).
  • Introdução da API experimental AdSelectionManager::reportEvent (I0d7dc).
  • Introdução da API experimental AdSelectionManager::updateAdCounterHistogram e alteração de AdData para indicar uma série de AdFilters (I87b83).

Correções de bugs

  • Os URIs de entrada agora são correspondidos em um site/origem compartilhado, em vez de exigir uma correspondência exata do nome do host.
  • Correção de falha no teste devido ao esquema HTTPS ausente (d573058).
  • Correção do esquema HTTPS ausente em URLs da Web (cecdcb8).
  • A anotação "throws" foi adicionada às APIs de medição (2dba359).

Versão 1.1.0-beta03

15 de novembro de 2023

Lançamento de androidx.privacysandbox.ads:ads-adservices:1.1.0-beta03 e androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta03. A versão 1.1.0-beta03 contém estas confirmações.

Novos recursos

  • Suporte à compatibilidade com versões anteriores do Android S.

Versão 1.1.0-beta02

4 de outubro de 2023

Lançamento de androidx.privacysandbox.ads:ads-adservices:1.1.0-beta02 e androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta02. A versão 1.1.0-beta02 contém estas confirmações.

Mudanças na API

  • A verificação da versão do T+ foi removida das classes de solicitação de medição. Os clientes não precisam verificar a versão da plataforma T+ para acessar as classes de solicitação MeasurementManager do sandbox de privacidade. O MeasurementManager será nulo com o novo comportamento. (Ieb105).

Versão 1.1.0-beta01

23 de agosto de 2023

Lançamento de androidx.privacysandbox.ads:ads-adservices:1.1.0-beta01 e androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta01, sem mudanças. A versão 1.1.0-beta01 contém estas confirmações.

Versão 1.1.0-alpha01

9 de agosto de 2023

Lançamento de androidx.privacysandbox.ads:ads-adservices:1.1.0-alpha01 e androidx.privacysandbox.ads:ads-adservices-java:1.1.0-alpha01. A versão 1.1.0-alpha01 contém estas confirmações.

Mudanças na API

  • Introdução da lista registerSource (Iae92f).
  • Remoção de usos da API experimental isAtLeastU() (Ie9117, b/289269026).

Correções de bugs

Versão 1.0

Versão 1.0.0-beta05

7 de junho de 2023

Lançamento de androidx.privacysandbox.ads:ads-adservices:1.0.0-beta05 e androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta05. A versão 1.0.0-beta05 contém estas confirmações.

Correções de bugs

  • Adiciona uma verificação de extensão 5 do SDK a TopicsManager
  • Aumento da dependência de corrotinas do Kotlin para 1.7.1 para evitar erros de build de classe duplicados no Gradle

Versão 1.0.0-beta04

10 de maio de 2023

Lançamento de androidx.privacysandbox.ads:ads-adservices:1.0.0-beta04 e androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta04. A versão 1.0.0-beta04 contém estas confirmações.

Correções de bugs

  • Solução de problemas de intertravamento quando as APIs de medição de adservices são invocadas na linha de execução principal pelo autor da chamada. (I65361).

Versão 1.0.0-beta03

19 de abril de 2023

Lançamento de androidx.privacysandbox.ads:ads-adservices:1.0.0-beta03 e androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta03. A versão 1.0.0-beta03 contém estas confirmações.

Novos recursos

  • A API Preview foi ativada para a API Topics.

Versão 1.0.0-beta02

22 de março de 2023

Lançamento de androidx.privacysandbox.ads:ads-adservices:1.0.0-beta02 e androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta02. A versão 1.0.0-beta02 contém estas confirmações.

Correções de bugs

  • As APIs MeasurementManager foram ativadas para a versão 5 e mais recentes da extensão do SDK.
  • As APIs MeasurementManager foram desativadas para a versão 4 e anteriores da extensão do SDK.

Versão 1.0.0-beta01

22 de fevereiro de 2023

Lançamento de androidx.privacysandbox.ads:ads-adservices:1.0.0-beta01 e androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta01 sem mudanças importantes. A versão 1.0.0-beta01 foi lançada em uma ramificação interna.

Mudanças de comportamento

  • A API Attribution Reporting foi desativada e não está disponível para uso nesta versão.

Versão 1.0.0-alpha01

11 de janeiro de 2023

Lançamento de androidx.privacysandbox.ads:ads-adservices:1.0.0-alpha01 e androidx.privacysandbox.ads:ads-adservices-java:1.0.0-alpha01. A versão 1.0.0-alpha01 foi lançada em uma ramificação interna.

  • Essa é uma nova biblioteca do Jetpack que permite a integração com as APIs que preservam a privacidade do Sandbox de privacidade (Topics, FLEDGE e Attribution Reporting).
  • As APIs do Sandbox de privacidade do Jetpack podem ser usadas para substituir as fornecidas no SDK de extensão 4.