HTMLAnchorElement : propriété attributionSrc
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Contexte sécurisé: Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.
Expérimental: Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.
La propriété attributionSrc
de l'interface HTMLAnchorElement
permet d'obtenir et de définir l'attribut attributionsrc
sur un élément HTML <a>
de façon programmatique, reflétant la valeur de cet attribut. attributionsrc
indique que vous souhaitez que le navigateur envoie un en-tête Attribution-Reporting-Eligible
. Côté serveur, cela sert à déclencher l'envoi d'un en-tête Attribution-Reporting-Register-Source
dans la réponse, afin d'enregistrer une source d'attribution basée sur la navigation.
Le navigateur stocke les données de la source associée à la source d'attribution basée sur la navigation (telles que fournies dans l'en-tête de réponse Attribution-Reporting-Register-Source
) lorsqu'il reçoit la réponse de navigation.
Voir l'API Attribution Reporting pour plus de détails.
Note :
Les éléments <a>
ne peuvent pas être utilisés comme déclencheurs d'attribution, uniquement comme sources.
Valeur
Une chaîne de caractères. Il existe deux versions de cette propriété que vous pouvez obtenir et définir :
-
Chaîne vide, c'est-à-dire
aElem.attributionSrc=""
. Cela indique que vous souhaitez que l'en-têteAttribution-Reporting-Eligible
soit envoyé au même serveur que celui indiqué par l'attributhref
. Cela convient lorsque vous gérez l'enregistrement de la source d'attribution sur le même serveur. -
Valeur contenant une ou plusieurs URL, par exemple :
jsaElem.attributionSrc = "https://a.exemple/register-source https://b.exemple/register-source";
Ceci est utile dans les cas où la ressource demandée n'est pas sur un serveur que vous contrôlez, ou si vous souhaitez simplement gérer l'enregistrement de la source d'attribution sur un autre serveur. Dans ce cas, vous pouvez définir une ou plusieurs URL comme valeur de
attributionSrc
. Lorsque la requête de ressource a lieu, l'en-têteAttribution-Reporting-Eligible
sera envoyé à l'(aux) URL(s) spécifiée(s) dansattributionSrc
en plus de l'origine de la ressource. Ces URL peuvent alors répondre avecAttribution-Reporting-Register-Source
pour compléter l'enregistrement.Note : Définir plusieurs URL signifie que plusieurs sources d'attribution peuvent être enregistrées sur la même fonctionnalité. Par exemple, vous pouvez avoir différentes campagnes dont vous souhaitez mesurer le succès, ce qui implique de générer différents rapports sur différentes données.
Exemples
>Définir un attribut attributionSrc
vide
<a href="https://shop.example">Cliquez pour visiter notre boutique</a>
const aElem = document.querySelector("a");
aElem.attributionSrc = "";
Définir un attribut attributionSrc
contenant des URL
<a href="https://ourshop.example">Cliquez pour visiter notre boutique</a>
// encoder les URL au cas où elles contiendraient des caractères spéciaux
// comme '=' qui seraient mal interprétés.
const encodedUrlA = encodeURIComponent("https://a.exemple/register-source");
const encodedUrlB = encodeURIComponent("https://b.exemple/register-source");
const aElem = document.querySelector("a");
aElem.attributionSrc = `${encodedUrlA} ${encodedUrlB}`;
Spécifications
Specification |
---|
Attribution Reporting> # dom-htmlattributionsrcelementutils-attributionsrc> |
Compatibilité des navigateurs
Loading…