Notes de version

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

La Privacy Sandbox sur Android propose des programmes bêta et Preview développeur. Au fil du temps, nous ajouterons de nouvelles API et fonctionnalités dans la version Preview développeur, et nous mettrons en avant les API stabilisées dans le programme bêta. Vos commentaires sont les bienvenus.

Si la Privacy Sandbox sur Android ne vous est pas familière, commencez par consulter la présentation des programmes. Pour commencer à intégrer la Privacy Sandbox dans votre projet, configurez votre environnement de développement et installez la Privacy Sandbox sur Android sur votre appareil de test ou dans un émulateur.

Version actuelle

Version bêta 1 de la Privacy Sandbox sur Android

La version bêta 1 de la Privacy Sandbox sur Android représente la première mise à disposition des API Privacy Sandbox sur les appareils publics et apporte des améliorations dans les domaines indiqués ci-dessous.

Généralités

  • Du point de vue fonctionnel, la version bêta 1 de la Privacy Sandbox sur Android est l'équivalent de la version Preview développeur 5, avec quelques fonctionnalités et limites supplémentaires spécifiées ci-dessous.
  • Les développeurs doivent suivre un processus d'inscription pour pouvoir utiliser les API liées aux annonces (y compris Topics, FLEDGE et Attribution Reporting). Le processus d'inscription vérifie leur identité et collecte des données spécifiques requises par les API.
  • Avec la version bêta 1 de la Privacy Sandbox sur Android, les développeurs qui se sont inscrits et ont envoyé les informations nécessaires à la liste d'autorisation peuvent effectuer des tests sur leurs propres appareils physiques. Pour développer des applications avec des API stables dans la version finale, téléchargez le nouveau SDK Ad Services Extensions 4.

API Topics

API Attribution Reporting

  • Des clés de débogage sont ajoutées pour permettre aux développeurs de recevoir des rapports non modifiés en plus des rapports sur la confidentialité avancée à partir de l'API Attribution Reporting. Ces clés de débogage offrent une meilleure visibilité de la structure des rapports lors de la transition avec la Privacy Sandbox.

SDK Runtime

Les limites suivantes devraient être corrigées dans la prochaine version majeure de la plate-forme Android :

  • Actuellement, le rendu des annonces dans une vue déroulante comme RecyclerView ne fonctionne pas comme prévu. Vous risquez de rencontrer des à-coups si l'élément est redimensionné. Les événements de défilement tactile ne sont pas correctement transmis à l'environnement d'exécution.
  • Le rendu WebView n'est pas disponible dans le processus du SDK Runtime.
  • Le stockage par SDK n'est pas disponible.
  • La prise en charge des API getAdId et getAppSetId n'est pas encore activée.

Versions antérieures

Version Preview développeur 6

La version Preview développeur 6 de la Privacy Sandbox sur Android propose des améliorations dans les domaines suivants :

Généralités

  • En vue du déploiement en production, la version Preview développeur 6 inclut un indicateur permettant de désactiver par défaut l'accès aux API protégeant la confidentialité. À des fins de test, exécutez la commande suivante afin d'activer l'accès à ces API dans la version Preview développeur :
adb shell device_config put adservices global_kill_switch false
  • Les API AdIdManager et AppSetIdManager nécessitent la version 22.36.16 ou ultérieure des services Google Play.
    • Sur un appareil Android, vérifiez que vous utilisez la version appropriée sous Settings > Apps > Google Play services (Paramètres > Applications > Services Google Play).
    • Pour installer la version appropriée des services Google Play, connectez-vous à votre émulateur ou à votre appareil de test Android avec un compte Google. Accédez ensuite à Google Play Store > profile icon > Settings > About (Google Play Store > icône de profil > Paramètres > À propos). Sous le titre Play Store version (Version du Play Store), appuyez sur Update Play Store (Mettre à jour le Play Store).
    • Cette étape ne s'applique qu'au développement et aux tests. Elle ne sera pas nécessaire après le déploiement de la Privacy Sandbox après des utilisateurs publics.

API Topics

  • Ajout d'une API Preview permettant d'activer ou de désactiver l'enregistrement de getTopics en tant qu'observateur.
  • Modifications mineures du code d'initialisation pour la classe GetTopicsRequest.
  • Lancement du guide d'intégration de Topics.

API FLEDGE sur Android

  • Si vous effectuez des tests sur des serveurs réels, cette API est désormais activée par défaut. Veuillez suivre ces étapes pour configurer votre appareil. Vous pouvez toutefois les ignorer si vous utilisez les forçages à distance présents dans l'application exemple.
  • Modifications majeures :
    • Remplacement d'Url dans les paramètres par Uri. Ce changement s'applique à toutes les API FLEDGE et à JavaScript personnalisé pour la logique d'enchères et d'évaluation.
    • Suppression du champ owner des entrées de l'API Custom Audience.
  • Les audiences personnalisées incomplètes peuvent maintenant être actualisées immédiatement en arrière-plan.
  • La limite de mémoire JavaScript est désormais définie sur 10 Mo. Ce changement s'applique à la logique d'enchères et d'évaluation.

API Attribution Reporting

  • Les technologies publicitaires doivent s'inscrire avant de pouvoir utiliser l'API Attribution Reporting dans la version Preview développeur 6. Pour en savoir plus, consultez la section Créer un compte Privacy Sandbox.
  • Cette version inclut des clés de débogage qui permettent aux développeurs de recevoir des rapports non modifiés en plus des rapports sur la confidentialité avancée à partir de l'API Attribution Reporting. Ces clés de débogage offrent une meilleure visibilité de la structure des rapports lors de la transition avec la Privacy Sandbox.

Version Preview développeur 5

Généralités

  • Avant de pouvoir accéder aux API Privacy Sandbox dans la version Preview développeur 5, vous devez activer les API et configurer les autorisations spécifiques qui leur sont associées.
    • Les conceptions de la Privacy Sandbox sur Android permettent aux utilisateurs de contrôler si les API de protection de la confidentialité et l'environnement d'exécution de SDK sont actifs sur leur appareil. Ces paramètres sont désactivés par défaut dans la version Preview développeur 5. Vous pouvez activer l'accès aux API à l'aide d'une commande adb.
    • L'application appelante doit spécifier des autorisations spécifiques aux API dans le fichier manifeste et les configurations AdServices associées qui contrôlent l'accès aux SDK intégrés.
  • Les applications doivent appeler les API de protection de la confidentialité lorsqu'elles sont exécutées au premier plan.
  • À ce stade, AdIdManager et AppSetIdManager ne sont pas opérationnels. Ils seront activés dans une prochaine version.

SDK Runtime

  • sendData() sera abandonné dans une prochaine version.
  • loadSdk() renvoie désormais un objet IBinder pour faciliter la communication bidirectionnelle entre le SDK compatible avec l'environnement d'exécution et les applications définies dans AIDL.
  • Les applications ont accès à d'autres événements du cycle de vie des SDK compatibles, tels que la fin du processus SDK.

API Attribution Reporting

Cette version présente des fonctionnalités supplémentaires de l'API Attribution Reporting :

  • Prise en charge du chiffrement des rapports d'agrégation
  • Prise en charge des mesures entre applications et Web
  • En-têtes consolidés dans les réponses d'enregistrement de la source et du déclencheur :
    • Source : Attribution-Reporting-Register-Aggregatable-Source fait désormais partie de Attribution-Reporting-Register-Source.
    • Déclencheur : nous avons regroupé Attribution-Reporting-Register-Event-Trigger, Attribution-Reporting-Register-Aggregatable-Trigger-Data et Attribution-Reporting-Register-Aggregatable-Values dans un seul en-tête nommé Attribution-Reporting-Register-Event-Trigger.
    • Attribution-Reporting-Redirects reste un en-tête distinct.

API FLEDGE sur Android

Cette version inclut plusieurs nouvelles fonctionnalités et améliorations, ainsi que des modifications majeures :

  • Modifications majeures :
    • runAdSelection() est maintenant appelé selectAds().
    • Le paramètre AdSelectionConfig.Builder.setAdSelectionSignals() a été remplacé par AdSelectionSignals, qui représente un objet JSON.
    • L'utilisation de String pour représenter un acheteur/vendeur AdTech a été remplacée par l'objet AdTechIdentifier.
    • Les classes TestCustomAudienceManager et TestAdSelectionManager pour remplacer le processus d'extraction JavaScript à distance ont été ajoutées.
    • Le propriétaire d'une audience personnalisée doit correspondre au nom de package de l'application appelante.
  • Les API FLEDGE valident désormais l'application appelante par rapport à un ensemble de restrictions et de limites décrites dans le guide du développeur. Voici quelques exemples notoires.
    • selectAds et reportImpression ont désormais des limites de temps d'exécution, après lesquelles l'appel est arrêté.
    • selectAds et reportImpression limitent désormais la mémoire consommée lors de l'exécution de JavaScript. Les API génèrent une erreur si la consommation de mémoire dépasse les limites configurées.
    • selectAds et reportImpression valident maintenant l'objet AdSelectionConfig pour s'assurer que les champs sont corrects d'un point de vue syntaxique et que les URL se trouvent sous l'eTLD+1 utilisé dans le champ du vendeur.
    • AdServices valide désormais les audiences personnalisées au moment de la création. Une partie de cette validation consiste à s'assurer que le délai d'expiration est correct et à limiter le nombre d'audiences personnalisées qu'une application peut créer, ainsi que la taille totale des annonces fournies dans l'appel joinCustomAudience. Cette validation garantit également que les URI fournis pour la récupération des signaux et de la logique d'enchères ainsi que pour l'extraction en arrière-plan appartiennent tous au domaine de l'acheteur.
  • Les métadonnées d'audience personnalisée sont mises à jour quotidiennement via un processus d'extraction en arrière-plan.
  • Les audiences personnalisées sont supprimées lorsque l'application "propriétaire" est désinstallée.
  • Il est désormais possible de spécifier des signaux d'évaluation et des données d'enchères de confiance lors de la sélection des annonces. Consultez un exemple de code pour vous familiariser avec le format de réponse.
  • Les API FLEDGE pour Android dépendent de WebView 105.0.5195.58 ou version ultérieure. Pour en savoir plus, consultez les informations de configuration du guide du développeur.
  • Problèmes connus :

    • Lorsque vous rejoignez une audience personnalisée, la plate-forme n'effectue pas immédiatement de mises à jour en arrière-plan si des métadonnées ou des valeurs AdData sont vides ou null. L'audience personnalisée n'est éligible à la sélection d'annonces qu'une fois qu'elle a été mise à jour un jour plus tard. Dans une prochaine version, les audiences personnalisées incomplètes seront immédiatement éligibles aux mises à jour d'extraction en arrière-plan. La limite de mémoire par défaut actuelle pour JavaScript est trop faible et peut entraîner le plantage de JavascriptEngine par les charges de travail standards sur les appareils. Votre exécution JavaScript peut s'arrêter de manière inattendue avec le message d'erreur "Fatal javascript OOM in CALL_AND_RETRY_LAST".

      Vous pouvez résoudre ce problème manuellement en configurant le seuil de mémoire approprié à l'aide de la commande suivante :

      adb shell "device_config put adservices fledge_js_isolate_enforce_max_heap_size 10485760"
      
    • Les annonces d'audience personnalisée qui ne correspondent pas à la structure JSON requise sont mises à jour lors de l'extraction en arrière-plan.

API Topics

Mises à jour des outils

Android Studio Canary permet de créer des APK SDK avec un nouveau type de module. Le guide du développeur du SDK Runtime a été mis à jour, et les applications exemples de la Privacy Sandbox sur GitHub ont été ajustées en conséquence.

Version Preview développeur 4

Date de sortie : 14 juillet 2022

La version Preview développeur 4 de la Privacy Sandbox sur Android propose des améliorations dans les domaines suivants :

SDK Runtime

  • Il suffit désormais d'ajouter sendData() pour que les applications puissent communiquer avec les SDK compatibles avec l'environnement d'exécution (RE-SDK).
  • Le stockage local est maintenant disponible dans le processus de l'environnement d'exécution de SDK.
  • Un SDK peut également afficher des annonces ou du contenu vidéo autonomes dans l'environnement d'exécution de SDK.
  • Ces clarifications ont été ajoutées concernant l'utilisation possible de la réflexion si le contenu ne se trouve pas dans un autre SDK compatible avec l'environnement d'exécution (RE-SDK).

API Attribution Reporting

Cette version inclut des modifications visant à clarifier l'utilisation de l'API Attribution Reporting, par exemple :

  • Modifications apportées au format des rapports agrégés pour améliorer la lisibilité
  • Mise à jour des champs d'en-tête pour les fonctionnalités de filtrage des conversions et de définition d'enchères
  • Ajout de clarifications dans la documentation de référence de l'API WebApp pour expliquer l'enregistrement de la source et du déclencheur, ainsi que la disponibilité de l'API de protection de la confidentialité et de consentement

API FLEDGE sur Android

Cette version inclut de nouvelles fonctionnalités de test et de débogage, ainsi que des améliorations internes :

  • Ajout de la possibilité de remplacer les URL distantes pour récupérer la logique JavaScript lors du développement
  • Amélioration des rapports d'erreurs lors de la sélection des annonces
  • Filtrage des audiences personnalisées inactives lors de la sélection des annonces

API Topics

Cette version inclut plusieurs modifications importantes apportées à l'API Topics :

  • Le type renvoyé de l'API getTopics() a été remplacé par le nouveau type d'objet Topic qui encapsule les ID d'entiers correspondant aux thèmes de la taxonomie, ainsi que des informations sur les versions du classificateur et de la taxonomie. Vous devez mettre à jour toutes les applications existantes qui utilisent cette API.
  • L'API Topics nécessite désormais une nouvelle autorisation normale.
  • Un système de classification sur l'appareil a été créé pour attribuer des thèmes de manière dynamique en fonction des informations sur les applications accessibles au public.

Problèmes connus

  • La version initiale de ces images d'appareil (révision 6) ne se charge pas dans la version 31.2.10 d'Android Emulator. Des images d'appareils mises à jour permettant de résoudre ce problème sont disponibles depuis le 27 juillet 2022.

Version Preview développeur 3

Date de sortie : 9 juin 2022

La version Preview développeur 3 de la Privacy Sandbox sur Android inclut de nouvelles fonctionnalités pour l'API Attribution Reporting et FLEDGE sur Android.

API Attribution Reporting

L'API Attribution Reporting améliore la confidentialité des utilisateurs en supprimant la dépendance aux identifiants utilisateur multipartites, et pour prendre en charge des cas d'utilisation clés liés à l'attribution et à la mesure des conversions dans les applications.

Cette version inclut des ressources pour les développeurs qui vous aideront à tester les fonctionnalités suivantes de l'API Attribution Reporting :

  • Enregistrer la source d'attribution et les événements déclencheurs
  • Exercer une attribution prioritaire en fonction de la source et après installation
  • Recevoir des rapports sur les événements
  • Recevoir des rapports cumulables qui sont déchiffrés dans cette version

Une application exemple et un serveur AdTech de référence sont fournis pour faciliter les tests.

Problèmes connus :

FLEDGE sur Android

FLEDGE sur Android fournit un nouveau moyen de diffuser des annonces en fonction des "audiences personnalisées" définies par les développeurs d'applications et des interactions au sein de leur application. Cette solution stockera ces informations et les annonces associées localement, et fournira un framework permettant d'orchestrer les workflows de sélection des annonces.

Cette version inclut des ressources pour les développeurs qui vous aideront à tester les fonctionnalités suivantes de FLEDGE sur Android :

  • Rejoindre ou quitter une audience personnalisée et observer l'impact des valeurs de paramètre sur les résultats des enchères
  • Extraire le code d'enchère JavaScript à partir de points de terminaison distants
  • Configurer et lancer des enchères publicitaires sur l'appareil
  • Gérer les rapports sur les impressions
  • Une application exemple et une configuration de serveur fictive sont fournies pour faciliter les tests.

Problèmes connus :

Version Preview développeur 2

Date de sortie : 17 mai 2022

La version Preview développeur 2 inclut une preview anticipée des API de création de rapports sur l'attribution MeasurementManager.

  • Vous pouvez appeler registerSource() et registerTrigger() pour enregistrer des événements d'annonce pour une application et recevoir des données de rapport pour une attribution d'une application à une autre. Notre implémentation actuelle utilise l'attribution au dernier contact. L'envoi des rapports est programmé selon les périodes de référence. Pour en savoir plus, consultez la documentation de référence de l'API MeasurementManager.
  • L'importation des rapports s'effectue à la fin d'intervalles fixes, plutôt qu'à l'heure exacte prévue. Par défaut, l'intervalle d'importation des rapports est de quatre heures, mais vous pouvez le remplacer à l'aide de la commande adb suivante :

    adb shell device_config put adservices measurement_main_reporting_job_period_ms <duration in milliseconds>
    
  • Une application exemple et un serveur AdTech de référence pour tester les API seront fournis dans une prochaine version.

  • D'autres fonctionnalités d'API de création de rapports sur l'attribution MeasurementManager, telles que les rapports agrégés, l'attribution après installation et les redirections, seront disponibles dans une prochaine version.

Version Preview développeur 1

Date de sortie : 28 avril 2022

La version Preview développeur 1 inclut une preview anticipée de l'API Topics et de l'environnement d'exécution de SDK. Les fonctionnalités pour les API FLEDGE sur Android et Attribution Reporting seront disponibles dans une prochaine version.

  • API Topics
    • L'API getTopics() renvoie actuellement des valeurs de test basées sur la classification hors connexion d'un ensemble limité d'applications. Les classifications sur l'appareil ne sont pas encore implémentées.
    • Vous pouvez utiliser les commandes adb pour remplacer les intervalles epoch et forcer leur calcul.
    • Pour en savoir plus, consultez le guide du développeur de l'API Topics.
  • Environnement d'exécution de SDK
    • Vous pouvez empaqueter et créer des SDK compatibles avec l'environnement d'exécution à l'aide du nouvel élément <sdk-library> dans le fichier manifeste de votre application SDK. Installez les SDK compatibles sur un appareil de test ou dans un émulateur pris en charge, comme vous le feriez normalement pour une application pendant le développement.
    • Vous pouvez intégrer une application à l'aide de SDK compatibles, les charger dans l'environnement d'exécution de SDK et tester l'impact d'un accès limité sur le code du SDK (autorisations, mémoire et communications entre les applications et le SDK). Les API de stockage pour les SDK compatibles avec l'environnement d'exécution ne sont pas encore implémentées et seront disponibles dans une prochaine version.
    • Un SDK peut afficher des bannières ou du contenu basés sur WebView dans l'environnement d'exécution de SDK.
    • Pour en savoir plus, consultez le guide du développeur d'e l'environnement d'exécution de SDK.
  • Vérifications lint Android
    • Les vérifications lint Android peuvent afficher à tort des avertissements dans les projets compilés avec le niveau d'API TiramisuPrivacySandbox. Par exemple, le message d'avertissement "L'appel nécessite le niveau d'API 33" peut apparaître. Vous pouvez résoudre ce problème temporairement via l'annotation @SuppressLint("NewApi").