Fence: setReportEventDataForAutomaticBeacons() Methode
Deprecated
To be removed
This feature is pending removal from browsers. Using it now may lead to broken functionality in future updates.
Following the announcement that Chrome will maintain its current approach to third-party cookies, Chrome decided to withdraw certain Privacy Sandbox features including the <fencedframe> element and related APIs.
Die setReportEventDataForAutomaticBeacons() Methode der Fence Schnittstelle spezifiziert Ereignisdaten, die gesendet werden, wenn eine Navigation innerhalb eines <fencedframe> stattfindet. Diese Daten werden über ein automatisches Beacon an eine oder mehrere spezifische URLs gesendet, die über die registerAdBeacon() Methode der Protected Audience API registriert wurden, um Berichtsdaten für Auktionsergebnisse von Werbung zu sammeln.
Hinweis:
reportEvent() bietet eine ähnliche Datenübermittlung für Berichte, wobei die Übermittlung in diesem Fall durch einen expliziten Methodenaufruf und nicht durch eine Navigation ausgelöst wird.
Syntax
setReportEventDataForAutomaticBeacons(event)
Parameter
event-
ein Objekt, das die zu sendenden Daten darstellt. Die möglichen Eigenschaften sind wie folgt:
eventType-
Ein String, der den Typ des gemeldeten Ereignisses darstellt. Die verfügbaren Werte sind:
reserved.top_navigation_start: Ein Ereignis, das ausgelöst wird, wenn eine Top-Level-Navigation beginnt.reserved.top_navigation_commit: Ein Ereignis, das ausgelöst wird, wenn eine Top-Level-Navigation abgeschlossen wird.
eventData-
Ein String, der die zu sendenden Daten darstellt.
destination-
Ein Array, das einen oder mehrere aufgezählte Werte enthält, die den Zieltyp repräsentieren. Dies sind die beteiligten Parteien, die die Daten auf ihre registrierten URLs erhalten (z. B. über
registerAdBeacon()). Die möglichen Werte sind:"buyer": Der Bieter in der Werbeauktion."seller": Der Top-Level-Verkäufer, der die Werbeauktion durchführt."component-seller": Der Verkäufer für eine Komponentenauktion in einer mehrstufigen Auktion."direct-seller": Der Verkäufer, der direkt die Auktion durchgeführt hat, auf die der Käufer geboten hat. Wenn die Werbung eine einstufige Auktion war, wird der Wert"seller"verwendet. Wenn die Werbung eine mehrstufige Auktion war, wird der Wert"component-seller"verwendet."shared-storage-select-url": Ein Shared Storage API Speicherort, wie in einemWindow.sharedStorage.selectURL()Methodenaufruf definiert.
onceOptional-
Ein boolescher Wert. Wenn auf
truegesetzt, wird das automatische Beacon nur für das nächste Ereignis gesendet, und Beacons werden nicht für nachfolgende Ereignisse gesendet, bissetReportEventDataForAutomaticBeacons()erneut aufgerufen wird. Zum Beispiel kann, wenn in einemclick-Handler verwendet, dies genutzt werden, um Beacon-Daten nur für spezifische Top-Level-Navigationen zu senden, anstatt für jede Top-Level-Navigation. Diese Eigenschaft ist standardmäßig auffalsegesetzt.
Rückgabewert
Kein (Undefined).
Beispiele
window.fence.setReportEventDataForAutomaticBeacons({
eventType: "reserved.top_navigation_start",
eventData: "an example string",
destination: ["seller", "buyer"],
});
Spezifikationen
| Spezifikation |
|---|
| Fenced Frame # dom-fence-setreporteventdataforautomaticbeacons |
Browser-Kompatibilität
Siehe auch
- Fenced frames auf privacysandbox.google.com
- Die Privacy Sandbox auf privacysandbox.google.com