[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/fr/docs/Web/API/HTMLScriptElement/attributionSrc [Back]  [Original]

HTMLScriptElement : proprit attributionSrc - Les API Web | MDN

Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.

View in English Always switch to English

HTMLScriptElement : proprit attributionSrc

Obsolte
En cours de suppression

Cette fonctionnalit est en cours de suppression des navigateurs. L'utiliser maintenant peut entraner 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 scuris: Cette fonctionnalit est uniquement disponible dans des contextes scuriss (HTTPS), pour certains navigateurs qui la prennent en charge.

Non standard: Cette fonctionnalit n'est pas standardise. Nous dconseillons d'utiliser des fonctionnalits non standard en production, car leur prise en charge par les navigateurs est limite, et elles peuvent tre modifies ou supprimes. Toutefois, elles peuvent constituer une alternative approprie dans certains cas o aucune option standard n'existe.

La proprit attributionSrc de l'interface HTMLScriptElement permet d'obtenir et de dfinir l'attribut attributionsrc sur un lment <script> par le biais du code, refltant la valeur de cet attribut. attributionsrc dfinit que vous souhaitez que le navigateur envoie un en-tte Attribution-Reporting-Eligible lors de la requte de la ressource du script.

Ct serveur, cela permet de dclencher l'envoi d'un en-tte Attribution-Reporting-Register-Source ou Attribution-Reporting-Register-Trigger dans la rponse, afin d'enregistrer respectivement une source d'attribution ou un dclencheur d'attribution bas sur JavaScript. L'en-tte de rponse envoyer dpend de la valeur de l'en-tte Attribution-Reporting-Eligible qui a dclench l'enregistrement.

Note : Il est galement possible d'enregistrer des sources ou dclencheurs d'attribution JavaScript en envoyant une requte fetch() contenant l'option attributionReporting (soit directement dans l'appel fetch(), soit sur un objet Request pass fetch()), ou en envoyant un XMLHttpRequest avec setAttributionReporting() invoqu sur l'objet requte.

Pour plus de dtails, consultez la page Attribution Reporting API.

Dans cet article

Valeur

Une chane de caractres. Il existe deux versions de cette proprit que vous pouvez obtenir ou dfinir :

  • Une chane de caractres vide, c'est--dire scriptElem.attributionSrc="". Cela indique que vous souhaitez que l'en-tte Attribution-Reporting-Eligible soit envoy au mme serveur que celui indiqu par l'attribut src. Cela convient lorsque vous grez l'enregistrement de la source ou du dclencheur d'attribution sur le mme serveur. Lors de l'enregistrement d'un dclencheur d'attribution, cette proprit est optionnelle et une valeur vide est utilise si elle est omise.

  • Valeur contenant une ou plusieurs URL, par exemple :

    js
    scriptElem.attributionSrc =
      "https://a.example/register-source https://b.example/register-source";
    

    Ceci est utile lorsque la ressource demande n'est pas sur un serveur que vous contrlez, ou si vous souhaitez grer l'enregistrement de la source d'attribution sur un autre serveur. Dans ce cas, vous pouvez dfinir une ou plusieurs URL comme valeur de attributionSrc. Lors de la requte de la ressource, l'en-tte Attribution-Reporting-Eligible est envoy aux URL dfinies dans attributionSrc en plus de l'origine de la ressource. Ces URL peuvent alors rpondre avec un en-tte Attribution-Reporting-Register-Source ou Attribution-Reporting-Register-Trigger selon le cas pour complter l'enregistrement.

    Note : Dfinir plusieurs URL signifie que plusieurs sources d'attribution peuvent tre enregistres sur une mme fonctionnalit. Par exemple, vous pouvez avoir diffrentes campagnes dont vous souhaitez mesurer le succs, ce qui implique de gnrer diffrents rapports sur diffrentes donnes.

Exemples

Dfinir une valeur attributionSrc vide

html
<script src="advertising-script.js"></script>
js
const scriptElem = document.querySelector("script");
scriptElem.attributionSrc = "";

Dfinir une valeur attributionSrc contenant des URL

html
<script src="advertising-script.js"></script>
js
// Encoder les URL au cas o elles contiendraient des caractres spciaux
// comme '=' qui seraient mal interprts.
const encodedUrlA = encodeURIComponent("https://a.example/register-source");
const encodedUrlB = encodeURIComponent("https://b.example/register-source");

const scriptElem = document.querySelector("script");
scriptElem.attributionSrc = `${encodedUrlA} ${encodedUrlB}`;

Spcifications

Cette fonctionnalit ne semble pas tre dfinie dans une spcification.

Compatibilit des navigateurs

Voir aussi


Web Proxy Viewer  |  New URL  |  Original Page