XMLHttpRequest : méthode setAttributionReporting()
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 attribution reporting API.
Contexte sécurisé: Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.
Non standard: Cette fonctionnalité n'est pas standardisée. Nous déconseillons d'utiliser des fonctionnalités non standard en production, car leur prise en charge par les navigateurs est limitée, et elles peuvent être modifiées ou supprimées. Toutefois, elles peuvent constituer une alternative appropriée dans certains cas où aucune option standard n'existe.
La méthode setAttributionReporting() de l'interface XMLHttpRequest indique que vous souhaitez que la réponse de la requête puisse enregistrer une source d'attribution ou un déclencheur d'attribution basé sur JavaScript.
Voir l'API Attribution Reporting pour plus de détails.
Syntaxe
setAttributionReporting(options)
Paramètres
options-
Un objet fournissant des options de rapport d'attribution, qui comprend les propriétés suivantes :
eventSourceEligible-
Un booléen. Si défini sur
true, la réponse de la requête est éligible pour enregistrer une source d'attribution. Si défini surfalse, elle ne l'est pas. triggerEligible-
Un booléen. Si défini sur
true, la réponse de la requête est éligible pour enregistrer un déclencheur d'attribution. Si défini surfalse, elle ne l'est pas.
Valeur de retour
Aucune (undefined).
Exceptions
InvalidStateErrorDOMException-
Levée si l'objet
XMLHttpRequestassocié n'a pas encore été ouvert, ou a déjà été envoyé. TypeErrorDOMException-
Levée si l'utilisation de l'API Attribution Reporting est bloquée par un en-tête
Permissions-Policyattribution-reporting.
Exemples
const rapportAttribution = {
eventSourceEligible: true,
triggerEligible: false,
};
function declencherSourceInteraction() {
const req = new XMLHttpRequest();
req.open("GET", "https://shop.example/endpoint");
// Vérifie la disponibilité de setAttributionReporting() avant de l'appeler
if (typeof req.setAttributionReporting === "function") {
req.setAttributionReporting(rapportAttribution);
req.send();
} else {
throw new Error("Attribution reporting not available");
// Inclut le code de récupération ici si nécessaire
}
}
// Associe le déclencheur d'interaction avec l'élément
// et l'évènement qui ont du sens pour votre code
elem.addEventListener("click", declencherSourceInteraction);