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.
<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 deAttribution-Reporting-Eligible-header naar dezelfde server wordt verzonden waar hethref-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:
HTMLattributionsrc="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 deAttribution-Reporting-Eligible-header verzonden naar de URL('s) die zijn opgegeven inattributionsrc, naast de resource-oorsprong. Deze URL's kunnen vervolgens antwoorden met deAttribution-Reporting-Register-Sourceom de registratie te voltooien.OpmerkingHet 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.
<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.
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 deAttribution-Reporting-Eligible-header wordt verzonden naar dezelfde server waar hetsrc-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:
<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.
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.
<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.
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 headerAttribution-Reporting-Eligiblenaar dezelfde server gestuurd wordt waar hetsrc-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 headerAttribution-Reporting-Eligiblenaast de bronorigin ook naar de URL('s) gestuurd die opgegeven zijn inattributionSrc. Deze URL's kunnen vervolgens naar behoefte antwoorden met een headerAttribution-Reporting-Register-SourceofAttribution-Reporting-Register-Triggerom de registratie te voltooien.OpmerkingHet 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.