Premiers pas avec la Privacy Sandbox pour Android

Le programme bêta de la Privacy Sandbox sur Android fournit des API stables. Nous prévoyant plusieurs versions bêta au cours de l'année 2023. 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 à prendre en charge un petit pourcentage d'appareils et nous augmenterons 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 API mise à jour de l'extension du SDK de niveau 33.

Extensions du SDK Android

Les API stables des versions bêta sont fournies à l'aide des nouvelles extensions du SDK Android. méthode de libération. Cette méthode permet de publier des versions stables d'Android 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

Premiers pas

Pour commencer, procédez comme suit :

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

  • Inscrivez-vous:suivez la procédure d'inscription pour utiliser les API liées aux annonces.
  • Enregistrement : vous devez vous enregistrer 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 Cette étape n'est pas nécessaire si vous devez uniquement tester l'environnement d'exécution du SDK sur l'appareil.

Étape 2 : Configurer votre environnement de développement

Configurez le SDK Privacy Sandbox sur Android dans Android Studio.

Étape 3 : Configurer les autorisations AdServices

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

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

Pour effectuer des tests de bout en bout, vous devez interagir avec un Android 13 compatible appareil ou utilisez une image d'émulateur pour l'extension 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 confidentialité. Sandbox sur Android pour s'exécuter 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 Android 12 et versions antérieures, les développeurs qui intègrent des API de services publicitaires pour les appareils Android 12 et versions antérieures doivent procéder comme suit:

  1. Vérifiez que le fichier manifeste de l'application cliente contient la balise extservices <uses-library>. La balise concernée est la suivante :
<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.

Maintenir votre environnement de développement à jour

Nous vous recommandons vivement de maintenir votre environnement de développement à jour la dernière version. Vous êtes ainsi certain de disposer des fonctionnalités et de sécurité et que votre environnement est compatible avec versions de vos dépendances. Pour être informé des nouveautés, vous inscrire pour recevoir des informations par e-mail.