Notes de version de la Privacy Sandbox sur Android

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.

Versions actuelles

Aperçu d'Android VanillaIceCream

API Protected Audience

  • La possibilité de transmettre des annonces contextuelles authentifiées à des enchères protégées a été ajoutée. Cela inclut également le filtrage négatif pour les applications déjà installées sur l'appareil, ainsi que la limitation de la fréquence d'exposition en fonction du nombre de clics, d'impressions, de vues ou de gains. L'implémentation diffère des itérations précédentes, car les annonces contextuelles doivent être signées par la technologie publicitaire. Découvrez comment l'implémenter dans le guide du développeur.
  • ContextualAds renommé en SignedContextualAds, avec les getter et setter associés dans AdSelectionConfig ; getPerBuyerSignedContextualAds, setPerBuyerSignedContextualAds
  • Si une application contextuelle non authentifiée est transmise, elle est supprimée de l'enchère.

API Attribution Reporting

Mise à jour de la version bêta de la Privacy Sandbox sur Android (novembre 2023)

Cette version bêta de la Privacy Sandbox sur Android inclut des mises à jour des API Privacy Sandbox sur les appareils Android 14 publics. Les images du SDK et de l'appareil peuvent être téléchargées à l'aide du SDK Manager d'Android Studio en tant qu'API Android 34, niveau d'extension 10. D'un point de vue fonctionnel, elles sont semblables à la version Preview développeur 9][b25], avec quelques modifications clés.

API Protected Audience

  • Les technologies publicitaires peuvent désormais utiliser la [délégation d'audience personnalisée][b26] pour rejoindre une audience personnalisée au nom d'un acheteur qui n'est pas présent sur l'appareil.
  • Android permet désormais de lancer une enchère sur les services d'enchères et de mise aux enchères.
  • Les enchères Protected Audience sont compatibles avec la facturation CPC.
  • Les enchères et les rapports Protected Audience sont désormais compatibles avec les en-têtes de version de données pour les signaux d'enchères de confiance.
  • Les enchères Protected Audience sont compatibles avec le filtrage de la limite de la fréquence d'exposition sur les événements WIN.
  • Protected Audience est désormais compatible avec l'[intégration à l'API Attribution Reporting][b27].

API Attribution Reporting

  • L'API Attribution Reporting prend désormais en charge l'[intégration à Protected Audience][b28].

SDK Runtime

  • Possibilité pour le SDK de charger d'autres SDK dans le SDK Runtime pour prendre en charge les cas d'utilisation de la médiation

Versions antérieures

Version Preview développeur 10

Date de sortie : 19 décembre 2023

Limites connues

  • Les services Google Play plantent en arrière-plan et informent à plusieurs reprises l'utilisateur :
    • Redémarrer l'appareil peut aider à pallier ce problème.
    • Lors des tests, si vous rencontrez des problèmes avec le délai avant expiration des appels asynchrones, essayez d'ajouter la commande adb suivante afin de prolonger la durée jusqu'à l'expiration du délai :
    • adb shell device_config put adservices fledge_auction_server_overall_timeout_ms 60000;
  • Appareils physiques uniquement : L'ajout d'un compte Google n'est pas pris en charge. Pour afficher l'écran d'accueil de l'appareil, suivez ces étapes :
    • Installez l'image d'aperçu sur le téléphone.
    • Suivez les instructions fournies par l'assistant de configuration sans vous connecter au Wi-Fi ni à un réseau de données mobiles.
    • Une fois sur l'écran d'accueil, connectez-vous au Wi-Fi ou à un réseau de données mobiles.
    • Redémarrez l'appareil.

API Protected Audience

  • Nous lançons de nouvelles fonctionnalités, [Protected App Signals][dp98], pour permettre la diffusion d'annonces pertinentes incitant à installer une application. Avec cette DP, nous lançons des API permettant aux technologies publicitaires d'effectuer les opérations suivantes :
    • Sélectionner des signaux en stockant des événements d'application dans un espace de stockage protégé sur l'appareil. Ces signaux servent à diffuser des annonces pertinentes incitant à installer une application.
    • Lancer des mises aux enchères protégées sur les services d'enchères qui s'exécutent dans des environnements d'exécution sécurisés, où il est possible d'accéder à leurs signaux respectifs pour faciliter la sélection des annonces ainsi que les enchères.

API Attribution Reporting

  • Cette version de l'API Attribution Reporting :
    • Ajout de l'intégration de l'API Protected Audience, qui permet d'utiliser des dimensions d'audience personnalisées dans les rapports récapitulatifs globaux.
    • Compatible avec le fournisseur Google Cloud en tant que TEE pour le service d'agrégation.
    • Intègre désormais le champ shared_debug_key, qui permet le débogage pour l'attribution multiréseaux sans redirections.
    • Intègre désormais des en-têtes de version dans les demandes de rapport de débogage de type verbose

Personnalisation sur l'appareil

  • Version initiale pour les chercheurs et les premiers développements.
  • La personnalisation sur l'appareil offre un moyen innovant de personnaliser les produits et les services, tout en offrant une meilleure protection de la confidentialité des utilisateurs finaux. La personnalisation sur l'appareil fournit un ensemble de services et d'algorithmes qui constituent les éléments de base pour y parvenir, y compris, mais sans s'y limiter :
    • Le calcul fédéré, qui permet d'entraîner, d'évaluer et de personnaliser des modèles à l'aide de l'apprentissage fédéré. L'utilisation du calcul fédéré par la personnalisation sur l'appareil sera basée sur l'entraînement du modèle et (éventuellement si nécessaire) sur l'inférence.
    • Correspondance basée sur un filtre Cuckoo et correspondance croisée entre des données dispersées.
    • Entraînement à confidentialité différentielle (DP) de modèles creux à l'aide de nouvelles techniques telles que la minimisation alternative de DP (pour l'entraînement sur des données disparates) et la personnalisation du modèle avec la DP de Billboard. ### Version Preview développeur 9

Date de publication : 15 août 2023

Limites connues

  • Les données sur les enchères générées en appelant l'API Bidding and Auction ne sont pas supprimées automatiquement dans DP9.
  • L'appel de getAdSelectionData et de persistAdSelectionResult lorsque le consentement est révoqué fait planter le processus.
  • La fonctionnalité de filtrage négatif ne fonctionne pas avec getAdSelectionData et persistAdSelectionResult.

API Protected Audience

  • Les technologies publicitaires peuvent désormais utiliser la délégation d'audience personnalisée pour rejoindre une audience personnalisée à un appelant sur l'appareil.
  • Android permet désormais de lancer des services d'enchères et de mise aux enchères. Les enchères Protected Audience sont compatibles avec la facturation CPC.
  • L'API Report Interactions s'appelle désormais reportEvent.
  • La méthode de limitation de la fréquence d'exposition et les types de compteurs ont été renommés.
  • Les rapports de débogage permettent de savoir pourquoi une enchère a été perdue ou d'identifier les problèmes dans la logique JavaScript.

API Attribution Reporting

  • Cette version améliore les rapports de débogage de l'API Attribution Reporting :
    • Prise en charge des rapports de débogage détaillés compatibles avec le Web.
    • Activation des rapports de débogage de l'attribution multi-applications et Web (nécessite un identifiant publicitaire à la fois pour l'enregistrement du Web et de l'application).
  • Les technologies publicitaires peuvent configurer des paramètres de bruit pour différents scénarios de rapports.
  • Cette version passe à l'attribution basée sur l'origine, ce qui signifie que :
    • L'origine est utilisée pour l'enregistrement.
    • Plusieurs origines sont acceptées au sein d'un même site.
    • Une nouvelle limite de débit d'une origine par appli source ou par inscription est définie.
  • Les technologies publicitaires peuvent désormais désactiver l'inscription pour tester les cas d'utilisation d'Attribution Reporting en local.

SDK Runtime

  • Le SDK ne peut lancer qu'une liste d'autorisation de services ou s'y associer.
  • Le SDK ne peut accéder qu'à un sous-ensemble du système ContentProvider (tel que com.android.providers.settings.SettingsProvider), dans lequel les données obtenues ne comportent pas d'identifiants et ne peuvent pas être utilisées pour créer une empreinte de l'utilisateur. Ces vérifications s'appliquent également à l'accès au ContentProvider à l'aide de ContentResolver.
  • Le SDK ne peut accéder qu'à un sous-ensemble de broadcast receivers protégés (comme android.intent.action.AIRPLANE_MODE).
  • Le SDK peut lancer une activité appartenant à une autre application, mais avec des limites sur ce qui peut être envoyé dans l'intent.

Mise à jour de la version bêta de la Privacy Sandbox sur Android (mars 2023)

La version bêta de mars 2023 de la de la Privacy Sandbox sur Android inclut des mises à jour des API Privacy Sandbox sur les appareils Android 13 publics. Cette version inclut les API Ad Services Extensions 5 et fonctionne de manière semblable à la version Preview développeur 6, avec quelques modifications clés.

Limites connues

  • La tâche de récupération en arrière-plan qui s'exécute régulièrement pour mettre à jour les audiences personnalisées FLEDGE entraîne le plantage du processus. En raison de ce problème, FLEDGE est désactivé par défaut.

Généralités

  • À partir de cette version, vous pouvez utiliser l'API Attribution Reporting. Cette API était auparavant désactivée. Si vous avez utilisé l'API Attribution Reporting dans la version bêta précédente, effacez les données de votre application ou de votre appareil avant d'utiliser cette version bêta en procédant comme suit :
    • Sur un appareil ou un émulateur, accédez aux paramètres et effacez l'espace de stockage (pas seulement le cache) de toute application utilisée pour les tests.
    • Rétablissez la configuration d'usine sur votre appareil physique ou émulé.
    • Pour un appareil émulé, exécutez une fonction Effacer les données.
  • Attribution Reporting permet désormais aux développeurs de recevoir des rapports non modifiés et des rapports sur la confidentialité avancée de la part de l'API Attribution. Les clés de débogage vous permettent de mieux comprendre la structure des rapports pendant la transition vers la Privacy Sandbox.
  • Attribution Reporting a récemment rencontré un bug avec Ad Services causant l'échec de registerSource et registerTrigger, qui généraient des exceptions. Si vous avez rencontré ces problèmes pendant le développement, un correctif a été déployé. Ces problèmes devraient se résoudre au fil du temps.
  • La fonctionnalité d'aperçu de l'API Topics est désormais équivalente à la Privacy Sandbox dans les versions Preview développeur Android. Un appelant de l'API Topics peut prévisualiser des thèmes sans avoir à inclure l'appel de récupération de ces thèmes dans le calcul de la période hebdomadaire et sans affecter la liste des thèmes observés pour l'appelant. Reportez-vous au champ shouldRecordObservation pour en savoir plus.
  • Pour activer les tests dans FLEDGE sur Android, inscrivez-vous au programme bêta et utilisez le compte Google qui vous permet de vous connecter à vos appareils de test. Dans le cas contraire, les tentatives d'appel des API généreront un code IllegalStateException avec le message "Service is not available" (Service non disponible). FLEDGE devrait être rétabli dans la prochaine version bêta.

    En attendant, vous pouvez continuer à effectuer des tests à l'aide des Previews développeur. En outre, FLEDGE peut être activé manuellement sur les appareils en gardant à l'esprit les mises en garde suivantes :

    Vous pouvez activer FLEDGE avec les commandes adb suivantes. Toutefois, cela entraîne le plantage du processus de récupération en arrière-plan, ce qui a un impact négatif sur les métriques d'état du système. Cette solution n'est pas permanente, car ces valeurs peuvent être réinitialisées par la plate-forme.

    adb shell device_config set_sync_disabled_for_tests persistent
    adb shell setprop debug.adservices.fledge_select_ads_kill_switch false
    adb shell setprop debug.adservices.fledge_custom_audience_service_kill_switch false
    adb shell device_config put adservices fledge_background_fetch_enabled true
    

Versions antérieures

Version Preview développeur 8

Date de sortie : 23 mai 2023

Limites connues

  • Bien que des filtres de limite de la fréquence d'exposition de type WIN puissent être ajoutés aux annonces Protected Audience, le type WIN n'est pas encore accepté, et les filtres de ce type sont ignorés.
  • Pour signaler des impressions gagnantes aux acheteurs ayant remporté des enchères Protected Audience, les acheteurs doivent être inscrits à la Privacy Sandbox. Cette exigence ne peut pas être ignorée.
  • Pour accéder aux paramètres de la Privacy Sandbox sur un appareil sur lequel elle est disponible, accédez à Settings > Google > Ads > Privacy Sandbox (Paramètres > Google > Annonces > Privacy Sandbox).
  • Impossible de déployer des projets avec des émulateurs dans Android Studio Giraffe. Les autres versions d'Android Studio devraient fonctionner correctement. Un correctif sera déployé sur Android Studio Giraffe le 26 mai 2023.

API Protected Audience

API Attribution Reporting

  • Ajout de filtres de déclencheur OR. Autrement dit, les filtres se composent désormais d'un ensemble de filtres, lequel est une liste de mappages de filtres. Si aucun de ces mappages dans un ensemble ne correspond aux données de filtre de la source, l'objet event_trigger_data est ignoré.
  • La période d'expiration et la période de référence de l'impression pour les API d'agrégation et au niveau des événements ont été dissociées.
  • Ajout de la prise en charge des clés de déduplication dans les rapports agrégables.
  • Ajout de scheduled_report_time aux rapports sur les événements pour assurer la parité avec la Privacy Sandbox pour le Web.
  • Implémentation de l'attribution multiréseau sans redirection.

SDK Runtime

Version Preview développeur 7

Date de sortie : 26 janvier 2023

API FLEDGE sur Android

  • Le paramètre custom_audience_signals a été renommé dans les méthodes JavaScript suivantes :
    • generateBid() est maintenant appelé custom_audience_bidding_signals.
    • scoreAd() est maintenant appelé custom_audience_scoring_signals.
    • reportWin() est maintenant appelé custom_audience_reporting_signals.
  • Cette version ajoute un nouveau remplacement selectAds qui utilise AdSelectionFromOutcomeConfig pour comparer les résultats de selectAds. Cela permet aux SDK ad tech qui utilisent cette API d'exécuter la médiation en cascade. Pour en savoir plus, consultez le guide du développeur.
  • L'API selectAds() est désormais compatible avec la mise en cache de la logique d'enchères et de notation JavaScript extraite lors du processus de sélection des annonces.
    • Le cache peut être contrôlé avec des en-têtes Cache-Control renvoyés par les serveurs lors de l'appel d'extraction JavaScript. Utilisez no-cache ou no-store pour empêcher la mise en cache des réponses JavaScript et le paramètre max-age de contrôler la durée de mise en cache.
    • L'entrée actuelle de cache max-age est définie sur deux jours par défaut.

API Attribution Reporting sur Android

  • Cette version est compatible avec les redirections en série pour registerSource() et registerTrigger(). L'utilisateur de l'API peut maintenant exploiter une redirection HTTP comme réponse du serveur.

Version bêta initiale, janvier 2023

Date de sortie : 9 janvier 2023

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 cités ci-dessous.

Général

  • 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

  • L'API Attribution Reporting a été désactivée et ne peut pas être utilisée dans cette version. L'accès à cette API devrait être rétabli dans la prochaine version bêta. Nous vous encourageons à poursuivre vos tests avec les Previews développeur.

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.

Version Preview développeur 6

Date de sortie : 31 octobre 2022

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 fixée à 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 de cycle de vie du SDK compatibles avec l'environnement d'exécution, 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 de technologie publicitaire 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 notables.
    • 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. La 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 l'une des métadonnées ou des valeurs AdData est vide 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 de technologie publicitaire 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 de technologie publicitaire 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").