Fence : méthode setReportEventDataForAutomaticBeacons()
Obsolète
En cours de suppression
Cette fonctionnalité est en cours de suppression des navigateurs. L'utiliser maintenant peut entraîner un dysfonctionnement dans les futures mises à jour.
Following the announcement that Chrome will maintain its current approach to third-party cookies, Chrome decided to withdraw certain Privacy Sandbox features including the <fencedframe> element and related APIs.
La méthode setReportEventDataForAutomaticBeacons() de l'interface Fence définit les données d'évènement qui sont envoyées lorsqu'une navigation a lieu dans un élément HTML <fencedframe>. Ces données sont envoyées avec un signal automatique vers une ou plusieurs URL spécifiques enregistrées avec la méthode registerAdBeacon() de l'API Protected Audience, afin de collecter les données de rapport pour les résultats d'enchères publicitaires.
Note :
reportEvent() permet un envoi similaire de données de rapport, sauf que dans ce cas l'envoi est déclenché par un appel explicite de méthode plutôt que par une navigation.
Syntaxe
setReportEventDataForAutomaticBeacons(event)
Paramètres
event-
Un objet représentant les données à envoyer. Les propriétés possibles sont :
eventType-
Chaîne de caractères représentant le type d'évènement à rapporter. Les valeurs disponibles sont :
reserved.top_navigation_start: Un évènement déclenché au début d'une navigation de niveau supérieur.reserved.top_navigation_commit: Un évènement déclenché à la fin d'une navigation de niveau supérieur.
eventData-
Chaîne de caractères représentant les données à envoyer.
destination-
Tableau contenant une ou plusieurs valeurs énumérées représentant les types de destinataires. Ce sont les parties qui reçoivent les données à leurs URL enregistrées (avec
registerAdBeacon()). Valeurs possibles :"buyer": L'enchérisseur dans l'enchère publicitaire."seller": Le vendeur principal qui gère l'enchère publicitaire."component-seller": Le vendeur d'une enchère composant dans une enchère à plusieurs niveaux."direct-seller": Le vendeur qui a directement géré l'enchère à laquelle l'acheteur a participé. Si la publicité est une enchère à un seul niveau, la valeur utilisée est"seller". Si c'est une enchère à plusieurs niveaux, la valeur est"component-seller"."shared-storage-select-url": Un emplacement de stockage de l'API Shared Storage, tel que défini dans un appel à la méthodeWindow.sharedStorage.selectURL().
onceFacultatif-
Booléen. Si défini à
true, le signal automatique n'est envoyé que pour le prochain évènement, et aucun signal n'est envoyé pour les évènements suivants tant quesetReportEventDataForAutomaticBeacons()n'est pas invoqué à nouveau. Par exemple, utilisé avec un gestionnaire de clic, cela permet d'envoyer des données de signal uniquement pour certaines navigations de niveau supérieur, et non pour toutes. Cette propriété vautfalsepar défaut.
Valeur de retour
Aucune (undefined).
Exemples
window.fence.setReportEventDataForAutomaticBeacons({
eventType: "reserved.top_navigation_start",
eventData: "une chaîne d'exemple",
destination: ["seller", "buyer"],
});
Spécifications
| Spécification |
|---|
| Fenced Frame # dom-fence-setreporteventdataforautomaticbeacons |
Compatibilité des navigateurs
Voir aussi
- Les cadres protégés sur privacysandbox.google.com
- Le bac à sable de la vie privée sur privacysandbox.google.com