Premiers pas avec la Privacy Sandbox pour Android

Le programme bêta de la Privacy Sandbox sur Android fournit des API stables. Vous pouvez utiliser les versions bêta du programme pour créer et tester des solutions permettant de réaliser des tests en production limités sur des appareils mobiles Android 13 et versions ultérieures pour toutes les API, et Android 12 et versions ultérieures pour l'API Attribution Reporting (ARA). Nous commencerons par proposer un faible pourcentage d'appareils, puis augmenteront ce nombre au fil du temps. Pour participer, les organisations peuvent demander l'accès à un nombre limité d'appareils et enregistrer toutes les applications qui utilisent les API Privacy Sandbox.

Pour le SDK Runtime, nous proposons une version bêta fermée pour les développeurs afin leur permettre de tester la distribution du SDK compatible avec l'environnement d'exécution pour certaines applications.

Pour utiliser la version bêta, les développeurs doivent compiler leurs solutions avec une mise à jour de l'extension du SDK de niveau d'API 33.

Extensions du SDK Android

Les API stables des versions bêta sont fournies à l'aide de la nouvelle méthode de publication des extensions du SDK Android. Cette méthode permet la sortie de fonctionnalités Android stables entre les versions majeures. Elle comporte un nouveau mécanisme de gestion des versions qui met les nouvelles API à la disposition des applications à plusieurs niveaux d'API à l'aide des mises à jour du système Google Play. L'extension du SDK Privacy Sandbox sur Android est appelée Ad Services Extensions. En savoir plus sur les extensions du SDK Android

Commencer

Pour commencer à utiliser la Privacy Sandbox pour Android, procédez comme suit :

Étape 1 : S'inscrire au programme bêta et s'enregistrer

  • Inscription : suivez le processus d'inscription pour pouvoir utiliser les API liées aux annonces.
  • S'inscrire:vous devez vous register pour participer au programme bêta. L'enregistrement vous permet de :
    • Activez vos propres appareils à des fins de test interne.
    • Spécifiez un nombre limité d'applications publiées sur le Google Play Store et qui peuvent intégrer directement des API protégeant la confidentialité ou intégrer des solutions SDK utilisant ces API.
    • Tester la distribution du SDK compatible avec l'environnement d'exécution à l'aide du Google Play Store Si vous devez uniquement tester l'environnement d'exécution du SDK sur l'appareil, cette étape n'est pas nécessaire.

Étape 2 : Configurer votre environnement de développement

Configurez la Privacy Sandbox sur le SDK Android dans Android Studio.

Étape 3 : Configurer les autorisations AdServices

Déclarez des autorisations spécifiques à l'API et configurez l'accès du SDK aux ressources gérées par l'API ciblée.

Étape 4 : Configurer une image d'appareil ou d'émulateur

Pour effectuer des tests complets, vous devez interagir avec un appareil Android 13 compatible ou utiliser une image d'émulateur pour l'extension de SDK appropriée.

Étape 5 : Configurer des appareils pour utiliser la Privacy Sandbox sur Android

Configurez les paramètres pour activer (ou désactiver) la Privacy Sandbox sur Android afin qu'elle s'exécute sur des appareils.

Résoudre les problèmes connus

Pour éviter les problèmes connus liés à l'intégration de l'API PP sur les appareils équipés d'Android 12 ou version antérieure, les développeurs qui intègrent des API de services publicitaires pour ces appareils doivent procéder comme suit:

  1. Vérifiez que le fichier manifeste de l'application cliente contient la balise extservices <uses-library>. Le tag concerné est:
<uses-library
  android:name="android.ext.adservices"
  android:required="false" />
  1. Si vous utilisez la bibliothèque Jetpack androidx.privacysandbox.ads, assurez-vous d'utiliser la version 1.1.0-beta05 ou une version ultérieure.

Quelles sont les ressources disponibles pour les développeurs ?

Le programme bêta de la Privacy Sandbox sur Android inclut les outils et ressources suivants.

SDK et images système de l'émulateur

Avec Android Studio, vous pouvez télécharger la dernière version d'Ad Services Extension et les images système de l'émulateur via SDK Manager. Découvrez comment configurer votre environnement de développement et comment accéder aux API.

Documentation de référence de l'API

La documentation de référence complète de l'API est disponible.

Assistance et commentaires

Lorsque vous testez et développez des solutions avec la Privacy Sandbox sur Android, consultez les notes de version et utilisez l'outil de suivi des problèmes pour signaler les éventuels problèmes et nous faire part de vos commentaires.

S'assurer que l'environnement de développement reste à jour

Nous vous recommandons vivement de maintenir votre environnement de développement à jour avec la dernière version. Vous disposez ainsi des dernières fonctionnalités et des derniers correctifs de sécurité, et votre environnement est compatible avec les dernières versions de vos dépendances. Pour être informé des nouvelles versions, abonnez-vous aux notifications par e-mail.