Fournir des publicités pertinentes à l’utilisateur avec l’API de sélection d’annonces

L’API de sélection d’annonces fournit des publicités pertinentes pour l’utilisateur sur votre site, sans utiliser de cookies tiers.

Contenu détaillé :

• Introduction
• Inscription d’attestation et inscription alpha
  • Quand et où la préversion est-elle disponible ?
  • Indicateurs de test
  • Exigences et processus d’inscription et d’attestation
  • Exemple de fichier JSON
    • Champs et valeurs importants
• Déployer les services d’API sélection d’annonces
  • Images pour le déploiement de services
  • Services pour les vendeurs
  • Services pour les acheteurs
  • Fonctions définies par l'utilisateur
    • Fonctions définies par l’utilisateur pour les vendeurs
    • Fonctions définies par l’utilisateur pour les acheteurs
  • Guide de déploiement
• Utiliser l’API de sélection d’annonces sur votre site web
• Fournir des commentaires sur l’essai d’origine
• Conditions d’utilisation
• Addendum à la protection des données
• Voir aussi

Introduction

L’API de sélection d’annonces fournit des publicités pertinentes pour l’utilisateur sur votre site, sans utiliser de cookies tiers.

L’API de sélection d’annonces peut être utilisée par :

• Vendeurs exécutant une plateforme côté offre (SSP), qui peuvent utiliser l’API pour fournir des publicités de meilleure qualité à leurs éditeurs.

• Les acheteurs exécutant une plateforme côté demande (DSP), qui peuvent utiliser l’API pour améliorer l’efficacité des campagnes publicitaires.

Pour commencer à utiliser l’API de sélection d’annonces et tester le flux de bout en bout, inscrivez-vous à la préversion limitée de l’API sélection d’annonces.

En tant que vendeur exploitant une plateforme côté offre ou acheteur exploitant une plateforme côté demande, utilisez ce guide pour :

• Fournissez des publicités pertinentes pour l’utilisateur avec la préversion limitée de l’API sélection d’annonces en vous inscrivant à la version d’évaluation d’origine.
• Terminez l’attestation d’API en publiant votre fichier JSON d’attestations.
• Configurez un environnement d’évaluation avec un fournisseur de cloud pris en charge.
• Consultez la documentation de l’API sélection d’annonces.
• Préparez vos fonctions User-Defined (UDF).
• Déployez vos services sur Azure.
• Testez l’API de sélection d’annonces sur votre site.

Voir aussi :

• Vue d’ensemble de la sélection d’annonces dans le privacy-preserving-ads référentiel.

Inscription d’attestation et inscription alpha

Quand et où la préversion est-elle disponible ?

Les versions de Microsoft Edge à compter de 130.0.2808.0 prennent en charge l’API de sélection d’annonces dans une préversion limitée pour les développeurs en dehors de l’Espace économique européen (EEE) et du Royaume-Uni (Royaume-Uni).

Indicateurs de test

Pour modifier les fonctionnalités de la plateforme de l’API sélection d’annonces sur votre ordinateur de développeur, utilisez les indicateurs de test de l’API sélection d’annonces à l’adresse edge://flags#edge-ad-selection-api:

L’indicateur API Sélection d’annonces active l’API de sélection d’annonces et les fonctionnalités associées telles que :

• Rapports d’attribution.
• Cadres clôturés.
• Stockage partagé.
• Agrégation privée.

Exigences et processus d’inscription et d’attestation

Les développeurs intéressés par les tests alpha peuvent rejoindre la version d’évaluation d’origine pour l’API de sélection d’annonces. Cet essai d’origine permet de tester de bout en bout les fonctionnalités de l’API de sélection d’annonces, couvrant à la fois l’utilisation de l’API et le déploiement d’images conteneur sécurisées.

Pour chaque domaine de niveau supérieur que vous envisagez d’utiliser avec l’API Sélection d’annonces, remplissez le formulaire d’inscription à la version d’évaluation d’Origin pour ce domaine, puis envoyez le formulaire.

Pour vous inscrire à l’essai d’origine de l’API Sélection d’annonces pour un domaine :

1. Tout d’abord, effectuez les étapes décrites dans Tester les API expérimentales et les fonctionnalités à l’aide d’essais d’origine.

2. Ensuite, créez un fichier nommé ad-selection-attestations.jsonet hébergez le fichier dans le domaine de niveau supérieur, dans le /.well-known/ répertoire . Par exemple :

   https://contoso.example/.well-known/ad-selection-attestations.json

   Le ad-selection-attestations.json fichier doit être publié dans les 30 jours suivant la réception du jeton OT. L’hébergement de ce fichier JSON est nécessaire pour terminer votre attestation et permettre à votre code d’accéder à l’API de sélection d’annonces, afin de tester l’API de sélection d’annonces avec les clients Microsoft Edge pris en charge.

Exemple de fichier JSON

Le fichier JSON d’attestations doit être nommé ad-selection-attestations.jsonet doit être conforme aux normes suivantes ci-dessous. Voici un exemple de ad-selection-attestations.json fichier :

{
    "ad_selection_api_attestations": [
        {
            "attestation_parser_version": "2",
            "attestation_version": "2",
            "privacy_policy": [
                "https://contoso.example/privacy/"
            ],
            "ownership_token": "<Your Unique Token Here>",
            "enrollment_site": "https://contoso.example/",
            "platform_attestations": [
                {
                    "platform": "edge",
                    "attestations": {
                        "ad_selection_api": {
                            "ServiceNotUsedForIdentifyingUserAcrossSites": true/false
                        },
                        "attribution_reporting_api": {
                            "ServiceNotUsedForIdentifyingUserAcrossSites": true/false
                        },
                        "shared_storage_api": {
                            "ServiceNotUsedForIdentifyingUserAcrossSites": true/false
                        },
                        "private_aggregation_api": {
                            "ServiceNotUsedForIdentifyingUserAcrossSites": true/false
                        }
                    }
                },
                {
                    "platform": "android",
                    "attestations": {}
                }
            ]
        }
    ]
}

Champs et valeurs importants

• Le ad-selection-attestations.json fichier doit inclure le jeton d’essai d’origine qui vous a été généré et envoyé pour ce domaine de niveau supérieur. "ownership_token": est le jeton d’essai d’origine qui a été généré lors de l’inscription de ce domaine pour la version d’évaluation d’origine de l’API sélection d’annonces.

• Dans la "platform_attestations": section , "platform": doit être "edge" ou "android".

• Le fichier doit inclure une liste d’API (fonctionnalités associées à l’API Ad Services). Dans la "platform_attestations": section, les membres valides de "attestations": sont les suivants :

  • "ad_selection_api": - API principale, pour la logique d’enchère privée.
  • "attribution_reporting_api": - Rapports d’attribution.
  • "shared_storage_api": - Stockage partagé.
  • "private_aggregation_api": - Agrégation privée.
  • Conditions préalables :
    • Chaque "..._api": entrée doit avoir un seul champ, "ServiceNotUsedForIdentifyingUserAcrossSites":, avec une true valeur ou false . true signifie que ce service n’est pas utilisé pour identifier l’utilisateur sur les sites. false signifie que ce service est utilisé pour identifier l’utilisateur sur les sites.

Déployer les services d’API sélection d’annonces

L’API de sélection d’annonces utilise un environnement d’exécution approuvé (TEE) pour fournir un niveau d’assurance pour l’intégrité des données, la confidentialité des données et l’intégrité du code . Consultez Informatique confidentielle : Hardware-Based exécution approuvée pour les applications et les données. Les services fournis par l’API de sélection d’annonces doivent s’exécuter dans un TEE pour sécuriser les données utilisées par ces services.

Les services de sélection d’annonces exécutés dans un TEE doivent être déployés sur une plateforme cloud qui prend en charge les fonctionnalités de sécurité nécessaires. Initialement, les services peuvent être déployés dans Azure à l’aide de conteneurs ACI confidentiels. Consultez Conteneurs confidentiels sur Azure Container Instances.

L’API sélection d’annonces fournit différents services qui doivent être déployés par les vendeurs ou les acheteurs.

Images pour le déploiement de services

Ajoutez vos fonctions User-Defined (UDF) dans les images de services fournies. Le User-Defined Functions peut exécuter une logique métier personnalisée. Les fonctions User-Defined s’exécutent dans des conteneurs privés au sein des services déployés.

Chaque image définit un service. Certaines images ne contiennent pas de fonctions définies par l’utilisateur et se composent entièrement de code prédéfini. Certaines images contiennent des fonctions définies par l’utilisateur, sous forme de fonctions avec un corps vide ou du code de démarrage, qui sont les fonctions User-Defined appropriées pour ce service. Renseignez les corps des fonctions User-Defined dans ces images avec votre propre code personnalisé.

Microsoft fournit une image pour chaque service, qui peut être déployée sur un fournisseur de cloud. Il s’agit des images publiques qui doivent être utilisées pour le déploiement. Seules les images officielles de Microsoft sont en mesure d’exécuter des enchères privées.

Images pour le déploiement :

• Vendeurs
  • Service frontal vendeur de sélection d’annonces
  • Service d’enchères de sélection d’annonces
• Acheteurs
  • Service frontal de l’acheteur de la sélection d’annonces
  • Service d’enchères de sélection d’annonces
  • Sélection d’annonces K-Anonyme Service
• Vendeurs et acheteurs
  • Service de valeur de clé de sélection d’annonces

Services pour les vendeurs

Services pour les acheteurs

Fonctions définies par l’utilisateur

Les vendeurs et les acheteurs doivent fournir leur propre code personnalisé en tant que fonctions User-Defined (UDF) qui s’exécutent dans des conteneurs privés au sein des services déployés. Ces User-Defined Functions peuvent exécuter une logique métier personnalisée.

Chaque acheteur ou vendeur peut déployer plusieurs instances d’un service donné, par exemple :

• SellerFrontEnd et Auction.
• BuyerFrontend, Enchère et K-Anonymat.

Certains de ces services prennent une entrée qui est un worklet JavaScript qui définit User-Defined Functions.

User-Defined Functions pour les vendeurs

User-Defined Functions pour les acheteurs

Guide de déploiement

Pour déployer le service API sélection d’annonces sur Azure :

1. Créez un compte Azure et créez un abonnement sur Microsoft Azure.

2. Choisissez l’option Conteneurs ACO confidentiels .

3. Accédez à Scripts de déploiement Terraform dans une nouvelle fenêtre ou un nouvel onglet, puis téléchargez les scripts de déploiement Terraform et consultez la documentation de déploiement. Note: Assurez-vous que le hachage de l’image que vous avez téléchargée correspond au hachage dans le script que vous téléchargez.

4. Les scripts Terraform incluent déjà des liens vers des images publiques fournies par Microsoft. Choisissez les services requis et déployez-les en suivant les étapes décrites dans le inclus readme.md.

   1. Définissez tous les indicateurs spécifiques pour votre environnement, y compris les emplacements de worklet d’enchères.

   2. Configurez toutes les conditions préalables et préparez tous les outils pour le déploiement.

   3. Créez des ressources Azure et exécutez le script Terraform qui termine le déploiement.

5. Développez des worklets, y compris user-defined-function (UDF) et démarrez les services d’API sélection d’annonces.

Utiliser l’API de sélection d’annonces sur votre site web

Pour commencer à utiliser l’API de sélection d’annonces, les vendeurs et les acheteurs doivent modifier le code JavaScript de leurs sites web exécuté lorsque le navigateur est Microsoft Edge.

• Vendeurs : Pour exécuter des enchères privées, récupérer des groupes d’intérêt et faire des rapports, mettez à jour votre code sur les sites web des éditeurs.

• Acheteurs : Pour créer des groupes d’intérêt et les stocker dans le navigateur, mettez à jour le code sur les sites web de vos partenaires publicitaires. Vous pouvez utiliser le mécanisme de délégation pour restreindre et autoriser la création de groupes d’intérêts sur des domaines tiers.

Pour en savoir plus sur les méthodes d’API disponibles et pour afficher un exemple de code, consultez Détails de l’API sélection d’annonces.

Fournir des commentaires sur l’essai d’origine

Pour fournir des commentaires sur l’essai d’origine de l’API sélection d’annonces, créez un problème sur le dépôt GitHub WICG/privacy-preserveing-ads :

• Pour afficher les problèmes existants, accédez à l’onglet Problèmes du dépôt WICG/privacy-preserveing-ads.

• Pour soumettre un nouveau problème, accédez au nouveau formulaire de problème.

Conditions d’utilisation

Consultez Conditions d’utilisation de l’API de sélection d’annonces.

Addendum à la protection des données

Consultez l’Addendum sur la protection des données pour l’API de sélection d’annonces.

Voir aussi

Essais d’origine :

• Inscription de l’essai d’origine de l’API de sélection d’annonces dans Microsoft Edge
• Tester des API et des fonctionnalités expérimentales à l’aide d’essais d’origine

Documents techniques et de conception :

• Vue d’ensemble de la sélection d’annonces
• Proposition d’API de sélection d’annonces
• Détails de l’API sélection d’annonces

Images pour le déploiement :

• Vendeurs
  • Service frontal vendeur de sélection d’annonces
  • Service d’enchères de sélection d’annonces
• Acheteurs
  • Service frontal de l’acheteur de la sélection d’annonces
  • Service d’enchères de sélection d’annonces
  • Sélection d’annonces K-Anonyme Service
• Vendeurs et acheteurs
  • Service de valeur de clé de sélection d’annonces

Scripts de déploiement :

• Scripts de déploiement Terraform

Environnement d’exécution approuvé (TEE) :

• Informatique confidentielle : Hardware-Based exécution approuvée pour les applications et les données

Azure :

• Microsoft Azure
• Conteneurs confidentiels sur Azure Container Instances