Guide d'intégration de Protected Audience (anciennement FLEDGE) pour les fournisseurs de solutions de mesure

Dans le cadre de la Privacy Sandbox, Chrome a proposé Protected Audience API : une API intégrée à un navigateur permettant aux annonceurs et aux entreprises de technologie publicitaire de diffuser des annonces ciblées par groupes d'intérêt sans utiliser de cookies tiers, tout en protégeant les utilisateurs contre les attaques intersites le suivi.

Dans l'API Protected Audience, lorsqu'une annonce de remarketing remporte l'enchère, l'affichage L'URL de l'annonce sera envoyée vers un Cadre pour le rendu. Un cadre cloisonné est un élément HTML proposé pour le contenu intégré, comme un iFrame. Contrairement aux iFrames, un cadre cloisonné restreint la communication. avec son contexte d'intégration pour permettre à la trame d'accéder à des données intersites en le partageant dans le contexte de la représentation vectorielle continue. Pour en savoir plus, consultez les Cas d'utilisation des cadres cloisonnés explicative.

Display & Video 360 accepte une liste Macros pour la mesure à utiliser pour le suivi des impressions et des clics. Seul un petit sous-ensemble peuvent être remplacées dans le cadre de l'affichage de la création, en raison de l'absence de contexte et les signaux d'enchères. Par exemple, ${PUBLISHER_ID} ne fonctionnera pas sans modification. aux balises des fournisseurs de mesure.

Ce guide s'adresse aux partenaires de mesure des performances des événements pour les annonceurs utilisent le Réseau Display et Video 360.

Inscription

À partir d'août 2023, les fournisseurs de solutions de mesure devront peut-être suivre la procédure ci-dessous pour s'inscrire et utiliser les API Fenced Frame Reporting dans API Audience.

Des informations détaillées expliquant comment et qui devra enregistrer

Intégration

Tags d'impression du fournisseur de mesure

Instructions de configuration:

Tags de script Exemple 
<script src='https://tracking.com/a.js'>xxx</script>
 Responsabilité:les fournisseurs de mesure doivent mettre à jour les balises de script à utiliser. API reportEvent pour le suivi des impressions (voir les conseils) ci-dessous).
Tags d'image Exemple 
<img src='https://tracking.com/'>
 Responsabilité:diffusion et Pour mettre à jour les balises img src afin de les utiliser, Video 360 L'API reportEvent pour le suivi des impressions

API reportEvent

L'utilisation de l'API a été proposée pour suivi post-affichage uniquement. L'API se compose de deux parties: registerAdMacro et reportEvent

  • Display & Video 360 est propriétaire de la fonction registerAdMacro dans reportWin. La enregistre les paires clé/valeur des macros dans le navigateur avant que le rendu de l'appel.
  • Selon le type de tag, Video 360 ou les fournisseurs de solutions de mesure possèdent modifications apportées aux tags 3PAT pour utiliser l'API reportEvent.

reportEvent n'accepte qu'une seule entrée "destinationURL". Les points vers les serveurs des fournisseurs de mesure. Il peut contenir n'importe quelle macro Affichage et Aide Video 360 d'accessibilité. Exemple :

window.fence.reportEvent({
  'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
});

Lorsque Chrome déclenche le ping d'URL dans la fonction, il recherche les données enregistrées et remplacez-les par les valeurs avant d'envoyer une requête HTTP GET à https://adtech.example

Procédure de mise à jour des tags de script

Les tags de création existants ne seront pas modifiés. Display & Image vidéo 360 fixe affiche les tags des fournisseurs de mesure sans les modifier dans la création. charge utile. Lorsque les fournisseurs de solutions de mesure reçoivent des pings d'impression de la part Contexte de l'API Audience : ils doivent suivre les étapes ci-dessous suivi:

  1. Préparez une URL d'impression du fournisseur de mesure pour accepter les pings d'impression. Exemple :

    https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123

  2. Ajout de reportEvent JS lors d'une réponse à un script à partir de l'API Protected. l'API Audience. Exemple :

    window.fence.reportEvent({
  'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
});

  3. Consigner les impressions lors de la réception de pings depuis l'URL d'impression configurée dans Étape 1.

Tags de clic du fournisseur de mesure

Le tag de clic du fournisseur de mesure existant continuera de fonctionner pour les impressions Protected Audience. Display & Video 360 utilisera l'API Fenced Frames Ads Reporting reserved.top_navigation balise pour enregistrer les clics et enchaîner les les outils de suivi des clics du fournisseur de mesure en tant que redirections. Pour en savoir plus, consultez Documentation de Chrome sur les rapports sur les annonces à cadre cloisonné API.