privacysandbox-ads

  
Cette bibliothèque permet d'intégrer les API de protection de la confidentialité, qui font partie de la Privacy Sandbox sur Android.
Dernière mise à jour Version stable Version finale Version bêta Version alpha
12 mars 2025 - - 1.1.0-beta12 -

Déclarer des dépendances

Pour ajouter une dépendance sur privacysandbox-ads, vous devez ajouter le dépôt Maven de Google à votre projet. Pour en savoir plus, consultez la section Dépôt Maven de Google.

Ajoutez les dépendances correspondant aux artefacts dont vous avez besoin dans le fichier build.gradle de votre application ou de votre module :

Groovy

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

Kotlin

dependencies {

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

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

Pour en savoir plus sur les dépendances, consultez Ajouter des dépendances de compilation.

Commentaires

Vos commentaires nous aident à améliorer Jetpack. N'hésitez pas à nous contacter si vous découvrez de nouveaux problèmes ou si vous avez des idées pour améliorer cette bibliothèque. Veuillez consulter les problèmes existants de cette bibliothèque avant d'en signaler un nouveau. Vous pouvez ajouter votre vote à un problème existant en cliquant sur le bouton en forme d'étoile.

Signaler un nouveau problème

Pour en savoir plus, consultez la documentation sur l'outil Issue Tracker.

Version 1.1

Version 1.1.0-beta12

12 mars 2025

Publication d'androidx.privacysandbox.ads:ads-adservices:1.1.0-beta12 et d'androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta12. La version 1.1.0-beta12 contient ces commits.

Nouvelles fonctionnalités

  • Priorité de l'audience personnalisée: nous avons ajouté un champ de priorité dans l'audience personnalisée. Cela permet aux acheteurs de spécifier une valeur de priorité dans un CustomAudience. Cette valeur permet d'identifier les audiences personnalisées à inclure dans une mise aux enchères si l'ensemble des audiences personnalisées de l'acheteur dépasse les limites de taille par acheteur.
  • Configuration du vendeur: cette fonctionnalité permet aux vendeurs de définir des paramètres d'enchères afin de contrôler la taille de la charge utile ainsi que les participants. La configuration de la mise aux enchères permet aux vendeurs de spécifier les éléments suivants :
    • Liste des acheteurs autorisés
    • Pour les enchères initiées par le vendeur donné, seuls les acheteurs de la liste d'autorisation peuvent contribuer aux CustomAudiences pour l'enchère.
    • Limite de taille par acheteur
    • Les vendeurs peuvent spécifier une limite par acheteur pour réguler la taille des données importées par chaque acheteur dans la charge utile envoyée à SellerFrontendService. Si l'acheteur dépasse la limite de taille par acheteur, la priorité CustomAudience définie dans la configuration de la charge utile de l'acheteur sera utilisée afin d'obtenir les données dans les limites prévues.
    • Taille maximale de la charge utile
    • L'allocation des ressources peut varier d'un vendeur à l'autre, et vous pouvez définir une limite de taille maximale pour la charge utile de l'enchère par requête. La limite de taille maximale respecte les buckets de taille fixe définis par l'API ProtectedAudience.
  • Mises à jour différées des audiences personnalisées: cette fonctionnalité permet aux acheteurs de planifier des mises à jour différées pour les audiences personnalisées. Chaque requête de mise à jour permet à l'appelant de planifier une mise à jour différée à l'aide de la nouvelle API scheduleCustomAudienceUpdate(). Pour chaque mise à jour, l'utilisateur peut spécifier des ensembles d'audiences personnalisées à rejoindre ou à quitter.

Modifications apportées à l'API

  • Ajout de la configuration du vendeur dans l'API GetAdSelectionRequest (Ibb5c7)
  • Introduction de l'API ScheduleCustomAudienceUpdate en tant qu'API expérimentale (I6b905)

Version 1.1.0-beta11

30 octobre 2024

Publication d'androidx.privacysandbox.ads:ads-adservices:1.1.0-beta11 et d'androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta11. La version 1.1.0-beta11 contient ces commits.

Nouvelles fonctionnalités

  • Cette mise à jour supprime la prise en charge de la mesure de la Privacy Sandbox et des API adid sur Android R, qui ont été abandonnées. Les appels permettant d'obtenir les classes de gestionnaire sur Android R renvoient désormais la valeur "null".

Version 1.1.0-beta10

21 août 2024

Publication d'androidx.privacysandbox.ads:ads-adservices:1.1.0-beta10 et d'androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta10. La version 1.1.0-beta10 contient ces commits.

Modifications apportées à l'API

  • Ajout des surcharges de constructeur Java manquantes pour les API expérimentales GetAdSelectionDataOutcome, PersistAdSelectionResultRequest, ReportEventRequest et FetchAndJoinCustomAudienceRequest. (I19e7f)

Version 1.1.0-beta09

10 juillet 2024

Publication d'androidx.privacysandbox.ads:ads-adservices:1.1.0-beta09 et d'androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta09. La version 1.1.0-beta09 contient ces commits.

Modifications apportées à l'API

  • Ajout des surcharges de constructeur Java manquantes pour l'API expérimentale GetAdSelectionDataRequest. (Ifbf88)

Version 1.1.0-beta08

26 juin 2024

Publication d'androidx.privacysandbox.ads:ads-adservices:1.1.0-beta08 et d'androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta08. La version 1.1.0-beta08 contient ces commits.

Nouvelles fonctionnalités

  • Ajout de la prise en charge des signaux d'application protégés.
  • Prise en charge de plusieurs fournisseurs de services cloud pour les enchères de serveurs de mise aux enchères et de mise aux enchères.

Modifications apportées à l'API

  • L'API expérimentale GetAdSelectionDataRequest::seller n'est pas nullable. (I68044)
  • Ajout de l'API expérimentale GetAdSelectionDataRequest::coordinatorOriginUri. (I18c0b)
  • Ajout de l'API updateSignals. (Ia8512)

Version 1.1.0-beta07

14 mai 2024

Publication d'androidx.privacysandbox.ads:ads-adservices:1.1.0-beta07 et d'androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta07. La version 1.1.0-beta07 contient ces commits.

Nouvelles fonctionnalités

  • GetTopics est désormais compatible avec les réponses chiffrées dans GetTopicsResponse.

Modifications apportées à l'API

  • Ajout de EncryptedTopic à la classe GetTopicResponse. (Iab362)

Version 1.1.0-beta06

17 avril 2024

Publication d'androidx.privacysandbox.ads:ads-adservices:1.1.0-beta06 et d'androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta06. La version 1.1.0-beta06 contient ces commits.

Note

  • À partir de la version 1.1.0-beta06 de Jetpack privacysandbox-ads, tous les appareils Android R avec indicateurs activés pourront accéder aux PPAPI. Pour tout cas d'utilisation qui ne doit pas être compatible avec Android R, des protections supplémentaires seront requises dans le code utilisant le code jetpack privacysandbox-ads.

Nouvelles fonctionnalités

  • Prise en charge de la rétrocompatibilité avec Android R.

Version 1.1.0-beta05

3 avril 2024

Publication d'androidx.privacysandbox.ads:ads-adservices:1.1.0-beta05 et d'androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta05. La version 1.1.0-beta05 contient ces commits.

Correction de bugs

  • Ajout d'une détection d'erreurs lorsqu'une définition de classe est introuvable sur les appareils Android S en raison de l'absence de balise uses-library dans le fichier manifeste.

Version 1.1.0-beta04

24 janvier 2024

Publication d'androidx.privacysandbox.ads:ads-adservices:1.1.0-beta04 et d'androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta04. Liste des commits de la version 1.1.0-beta04

Nouvelles fonctionnalités

  • Nouvelle API permettant de créer des rapports sur les événements utilisateur post-enchères
  • Prise en charge du filtrage de la limite de la fréquence d'exposition pour les annonces de remarketing
  • Prise en charge de la délégation de l'audience personnalisée
  • Prise en charge de la troncation de la chaîne de médiation en cascade
  • Compatibilité avec les enchères protégées sur les serveurs d'enchères et de mise aux enchères

Modifications apportées à l'API

  • Introduction de l'API expérimentale AdSelectionManager::selectAds(AdSelectionFromOutcomesConfig). (I86cd2)
  • Introduction de l'API expérimentale ReportEventRequest::inputEvent. (Ib94f3)
  • ReportImpressionRequest::adSelectionConfig a été rendu facultatif (Ief280).
  • Introduction des API expérimentales AdSelectionManager::getAdSelectionData et AdSelectionManager::persistAdSelectionResultUnified (Ie4d0e)
  • Introduction de l'API expérimentale CustomAudienceManager::fetchAndJoinCustomAudience. (I09152)
  • Présentation de l'API expérimentale AdSelectionManager::reportEvent. (I0d7dc)
  • Introduction de l'API expérimentale AdSelectionManager::updateAdCounterHistogram et modification de AdData pour indiquer une série de AdFilters. (I87b83)

Correction de bugs

  • Les URI d'entrée sont désormais mis en correspondance sur un site/une origine partagés au lieu de nécessiter une correspondance exacte du nom d'hôte.
  • Correction d'un échec de test en raison de l'absence de schéma HTTPS (d573058)
  • Correction du schéma HTTPS manquant dans les URL Web (cecdcb8)
  • Ajout d'une annotation de lancement d'exception aux API de mesure (2dba359)

Version 1.1.0-beta03

15 novembre 2023

Publication d'androidx.privacysandbox.ads:ads-adservices:1.1.0-beta03 et d'androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta03. Liste des commits de la version 1.1.0-beta03

Nouvelles fonctionnalités

  • Prise en charge de la rétrocompatibilité avec Android S.

Version 1.1.0-beta02

4 octobre 2023

Publication d'androidx.privacysandbox.ads:ads-adservices:1.1.0-beta02 et d'androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta02. Liste des commits de la version 1.1.0-beta02

Modifications apportées à l'API

  • Suppression de la vérification de la version T+ des classes de requêtes de mesure. Les clients n'ont pas besoin d'effectuer de vérification de la version de la plate-forme T+ de leur côté pour accéder aux classes de requêtes MeasurementManager de privacysandbox. MeasurementManager sera nul avec le nouveau comportement. (Ieb105)

Version 1.1.0-beta01

23 août 2023

Publication d'androidx.privacysandbox.ads:ads-adservices:1.1.0-beta01 et androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta01 sans aucune modification. Liste des commits de la version 1.1.0-beta01

Version 1.1.0-alpha01

9 août 2023

Publication d'androidx.privacysandbox.ads:ads-adservices:1.1.0-alpha01 et d'androidx.privacysandbox.ads:ads-adservices-java:1.1.0-alpha01. Liste des commits de la version 1.1.0-alpha01

Modifications apportées à l'API

  • Introduction de la liste registerSource (Iae92f)
  • Suppression des utilisations de l'API expérimentale isAtLeastU(). (Ie9117, b/289269026)

Correction de bugs

Version 1.0

Version 1.0.0-beta05

7 juin 2023

Publication d'androidx.privacysandbox.ads:ads-adservices:1.0.0-beta05 et d'androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta05. Liste des commits de la version 1.0.0-beta05

Correction de bugs

  • Ajout d'une vérification de l'extension 5 du SDK à TopicsManager
  • Augmente la dépendance des coroutines Kotlin à 1.7.1 pour éviter les erreurs de compilation de classe en double dans Gradle

Version 1.0.0-beta04

10 mai 2023

Publication d'androidx.privacysandbox.ads:ads-adservices:1.0.0-beta04 et d'androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta04. Liste des commits de la version 1.0.0-beta04

Correction de bugs

  • Résolution du problème de blocage lorsque les API de mesure des services publicitaires sont appelées sur le thread principal par l'appelant. (I65361)

Version 1.0.0-beta03

19 avril 2023

Publication d'androidx.privacysandbox.ads:ads-adservices:1.0.0-beta03 et d'androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta03. Liste des commits de la version 1.0.0-beta03

Nouvelles fonctionnalités

  • Activation de l'API Preview pour Topics.

Version 1.0.0-beta02

22 mars 2023

Publication d'androidx.privacysandbox.ads:ads-adservices:1.0.0-beta02 et d'androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta02. Liste des commits de la version 1.0.0-beta02

Correction de bugs

  • Activation des API MeasurementManager pour la version 5 du SDK Extension et les versions ultérieures.
  • Désactivation des API MeasurementManager pour la version 4 de l'extension du SDK et les versions antérieures.

Version 1.0.0-beta01

22 février 2023

Publication d'androidx.privacysandbox.ads:ads-adservices:1.0.0-beta01 et androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta01 sans modification notable. La version 1.0.0-beta01 a été publiée à partir d'une branche interne.

Nouveaux comportements

  • L'API Attribution Reporting a été désactivée et ne peut pas être utilisée dans cette version.

Version 1.0.0-alpha01

11 janvier 2023

Publication d'androidx.privacysandbox.ads:ads-adservices:1.0.0-alpha01 et d'androidx.privacysandbox.ads:ads-adservices-java:1.0.0-alpha01. La version 1.0.0-alpha01 a été publiée à partir d'une branche interne.

  • Il s'agit d'une nouvelle bibliothèque Jetpack qui permet d'intégrer les API de protection de la confidentialité de la Privacy Sandbox (Topics, FLEDGE et Attribution Reporting).
  • Les API de la Privacy Sandbox Jetpack peuvent être utilisées à la place des API de la Privacy Sandbox fournies dans l'extension de SDK 4.