Naar de inhoud
Gratis naslagwerk over HTML
HTML leren en naslaan
Naslag / Attribuut

attributionsrc HTML attribuut

3 elementen kennen dit attribuut. Klik op een tag voor de volledige uitleg van dat element.

Wat doet het attributionsrc attribuut?

Experimenteel, alleen door Chromium-browsers ondersteund attribuut dat onderdeel is van de Attribution Reporting API (Privacy Sandbox). Het markeert het element zodat de browser een Attribution-Reporting-Eligible header meestuurt met het verzoek, waarmee advertentieconversies privacyvriendelijk gemeten kunnen worden zonder cross-site cookies.

HTML
<img src="pixel.gif" attributionsrc="https://advertentie.voorbeeld.nl/registreer">

Welke HTML-elementen kennen attributionsrc?

<a> Verouderd Niet-standaard

Het <a>-HTML-element (of anker-element), maakt met zijn href-attribuut een hyperlink naar webpagina's, bestanden, e-mailadressen, locaties o...

Geeft aan dat u wilt dat de browser een Attribution-Reporting-Eligible-header verstuurt. Aan de serverkant wordt dit gebruikt om het verzenden van een Attribution-Reporting-Register-Source-header in de respons te activeren, om een navigatiegebaseerde attributiebron te registreren.

De browser slaat de brongegevens op die zijn geassocieerd met de navigatiegebaseerde attributiebron (zoals opgegeven in de responsheader Attribution-Reporting-Register-Source) wanneer de gebruiker op de link klikt. Zie de Attribution Reporting API voor meer details.

Er zijn twee versies van dit attribuut die u kunt instellen:

  • Booleaans, d.w.z. alleen de naam attributionsrc. Dit geeft aan dat u wilt dat de Attribution-Reporting-Eligible-header naar dezelfde server wordt verzonden waar het href-attribuut naar verwijst. Dit is prima wanneer u de registratie van de attributiebron op dezelfde server afhandelt.

  • Een waarde die een of meer URL's bevat, bijvoorbeeld:

    HTML
    attributionsrc="https://a.example/register-source
    https://b.example/register-source"

    Dit is nuttig in gevallen waarin de aangevraagde resource zich niet op een server bevindt die u beheert, of als u de registratie van de attributiebron gewoon op een andere server wilt afhandelen. In dit geval kunt u één of meer URL's opgeven als de waarde van attributionsrc. Wanneer de resourceaanvraag plaatsvindt, wordt de Attribution-Reporting-Eligible-header verzonden naar de URL('s) die zijn opgegeven in attributionsrc, naast de resource-oorsprong. Deze URL's kunnen vervolgens antwoorden met de Attribution-Reporting-Register-Source om de registratie te voltooien.

    Opmerking

    Het opgeven van meerdere URL's betekent dat meerdere attributiebronnen op dezelfde functionaliteit kunnen worden geregistreerd. U kunt bijvoorbeeld verschillende campagnes hebben waarvan u het succes probeert te meten, waarbij verschillende rapporten over verschillende gegevens worden gegenereerd.

<a>-elementen kunnen niet worden gebruikt als attributietriggers, alleen als bronnen.

Alles over <a> →

<img> Verouderd Niet-standaard

Het <img>-element van HTML bettet een afbeelding in het document in.

Geeft aan dat je wilt dat de browser een Attribution-Reporting-Eligible-header meestuurt met het afbeeldingsverzoek.

Aan de serverzijde wordt dit gebruikt om het verzenden van een Attribution-Reporting-Register-Source- of Attribution-Reporting-Register-Trigger-header in het antwoord te activeren, om respectievelijk een op afbeeldingen gebaseerde attributiebron of attributietrigger te registreren. Welke response-header teruggestuurd moet worden, hangt af van de waarde van de Attribution-Reporting-Eligible-header die de registratie activeerde.

Het bijbehorende bron- of triggerevent wordt geactiveerd zodra de browser het antwoord met het afbeeldingsbestand ontvangt.

Opmerking

Zie de Attribution Reporting API voor meer details.

Er zijn twee versies van dit attribuut die je kunt instellen:

  • Boolean, dat wil zeggen alleen de naam attributionsrc. Dit geeft aan dat je wilt dat de Attribution-Reporting-Eligible-header wordt verzonden naar dezelfde server waar het src-attribuut naar verwijst. Dit is prima wanneer je de registratie van de attributiebron of -trigger op dezelfde server afhandelt. Bij het registreren van een attributietrigger is deze eigenschap optioneel, en wordt een boolean-waarde gebruikt als deze wordt weggelaten.
  • Een waarde die een of meer URL's bevat, bijvoorbeeld:
HTML
<img
  src="image-file.png"
  alt="My image file description"
  attributionsrc="https://a.example/register-source
                     https://b.example/register-source" />

Dit is nuttig in gevallen waarin de opgevraagde bron zich niet op een server bevindt die je beheert, of wanneer je gewoon de registratie van de attributiebron op een andere server wilt afhandelen. In dat geval kun je een of meer URL's opgeven als waarde van attributionsrc. Wanneer het bronverzoek plaatsvindt, wordt de Attribution-Reporting-Eligible-header verzonden naar de URL('s) die zijn opgegeven in attributionSrc, naast de bronoorsprong zelf. Deze URL's kunnen vervolgens naar behoefte reageren met een Attribution-Reporting-Register-Source- of Attribution-Reporting-Register-Trigger-header om de registratie te voltooien.

Opmerking

Het opgeven van meerdere URL's betekent dat er meerdere attributiebronnen voor dezelfde functie geregistreerd kunnen worden. Je zou bijvoorbeeld verschillende campagnes kunnen hebben waarvan je het succes probeert te meten, waarbij verschillende rapporten op basis van verschillende gegevens worden gegenereerd.

Alles over <img> →

<script> Verouderd Niet-standaard

Het <script>-element van HTML wordt gebruikt om uitvoerbare code of gegevens in te sluiten; dit wordt doorgaans gebruikt om JavaScript-code...

Geeft aan dat u wilt dat de browser een Attribution-Reporting-Eligible-header meestuurt met het verzoek om de scriptbron. Aan de serverzijde wordt dit gebruikt om het verzenden van een Attribution-Reporting-Register-Source- of Attribution-Reporting-Register-Trigger-header in het antwoord te triggeren, om respectievelijk een op JavaScript gebaseerde attributiebron of attributietrigger te registreren. Welke antwoordheader teruggestuurd moet worden, hangt af van de waarde van de Attribution-Reporting-Eligible-header die de registratie geactiveerd heeft.

Opmerking

Als alternatief kunnen op JavaScript gebaseerde attributiebronnen of -triggers geregistreerd worden door een fetch()-verzoek te sturen met de attributionReporting-optie (rechtstreeks ingesteld op de fetch()-aanroep of op een Request-object dat aan de fetch()-aanroep meegegeven wordt), of door een XMLHttpRequest te sturen waarop setAttributionReporting() op het requestobject aangeroepen is.

Er zijn twee versies van dit attribuut die u kunt instellen:

  • Booleaans, dat wil zeggen alleen de naam attributionsrc. Dit geeft aan dat u wilt dat de header Attribution-Reporting-Eligible naar dezelfde server gestuurd wordt waar het src-attribuut naar verwijst. Dit is prima wanneer u de registratie van de attributiebron of -trigger op dezelfde server afhandelt. Bij het registreren van een attributietrigger is deze eigenschap optioneel, en wordt een lege stringwaarde gebruikt als deze weggelaten wordt.

  • Een waarde die een of meer URL's bevat, bijvoorbeeld:

    HTML
    <script
      src="myscript.js"
      attributionsrc="https://a.example/register-source https://b.example/register-source"></script>

    Dit is nuttig in gevallen waarin de opgevraagde bron zich niet op een server bevindt die u beheert, of wanneer u de registratie van de attributiebron gewoon op een andere server wilt afhandelen. In dit geval kunt u een of meer URL's opgeven als waarde van attributionsrc. Wanneer het bronverzoek plaatsvindt, wordt de header Attribution-Reporting-Eligible naast de bronorigin ook naar de URL('s) gestuurd die opgegeven zijn in attributionSrc. Deze URL's kunnen vervolgens naar behoefte antwoorden met een header Attribution-Reporting-Register-Source of Attribution-Reporting-Register-Trigger om de registratie te voltooien.

    Opmerking

    Het opgeven van meerdere URL's betekent dat er meerdere attributiebronnen voor dezelfde functionaliteit geregistreerd kunnen worden. U zou bijvoorbeeld verschillende campagnes kunnen hebben waarvan u het succes probeert te meten, waarbij verschillende rapporten over verschillende gegevens gegenereerd worden.

Zie de Attribution Reporting API voor meer informatie.

Alles over <script> →

Andere attributen van deze elementen