Fence: reportEvent() 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 reportEvent() Methode des
Fence Interfaces löst die Übermittlung von Berichtsdaten über ein Beacon zu einer oder mehreren spezifischen URLs aus, die über die registerAdBeacon() Methode der Protected Audience API registriert sind, um Ergebnisse von Anzeigenauktionen zu sammeln.
Hinweis:
setReportEventDataForAutomaticBeacons() bietet ähnliche Berichtsdatenübermittlungen, außer dass in diesem Fall die Übermittlung durch eine Navigation und nicht durch einen expliziten Methodenaufruf ausgelöst wird.
Syntax
reportEvent(event)
Parameter
event-
Ein Objekt oder String, der die zu sendenden Daten repräsentiert.
- Ein Objektwert definiert ein spezifisches Berichtsevent, das Sie senden möchten. Die erforderlichen Eigenschaften sind wie folgt:
eventType-
Ein String, der den Typ des gemeldeten Ereignisses darstellt — zum Beispiel könnten Sie interessiert sein, wie oft eine Anzeige angeklickt wird. Dieser String kann jeden relevanten Ereignisnamen enthalten (zum Beispiel
click). Dieser muss mit dem Ereignistyp übereinstimmen, der im zugehörigenregisterAdBeacon()Aufruf in einem Protected Audience API Worklet angegeben wurde. eventData-
Ein String, der die zu sendenden Daten darstellt.
destination-
Ein Array, das einen oder mehrere aufgezählte Werte enthält, die Zieltypen repräsentieren. Dies sind die beteiligten Parteien, die die Daten an ihre registrierten URLs erhalten (d.h. über
registerAdBeacon()). Die möglichen Werte sind:"buyer": Der Bieter in der Anzeigenauktion."seller": Der oberste Verkäufer, der die Anzeigenauktion ausführt."component-seller": Der Verkäufer für eine Komponentenausschreibung in einer mehrstufigen Auktion."direct-seller": Der Verkäufer, der direkt die Ausschreibung ausgeführt hat, bei der der Käufer geboten hat. Wenn es sich um eine einstufige Auktion handelte, wird der Wert"seller"verwendet. Wenn es sich um eine mehrstufige Auktion handelte, wird der Wert"component-seller"verwendet."shared-storage-select-url": Ein Speicherort der Shared Storage API, wie in einemWindow.sharedStorage.selectURL()Methodenaufruf definiert.
- Ein Stringwert repräsentiert einen
eventType, zum Beispiel"click"(siehe die frühere Definition voneventType). Wenn eineventTypeString als Wert vonreportEvent()übergeben wird, löst dies alle Private Aggregation Beiträge aus, die an diesen Ereignistyp gebunden waren (zum Beispiel überPrivateAggregation.contributeToHistogramOnEvent()), um gesendet zu werden.
- Ein Objektwert definiert ein spezifisches Berichtsevent, das Sie senden möchten. Die erforderlichen Eigenschaften sind wie folgt:
Rückgabewert
Kein (Undefined).
Beispiele
window.fence.reportEvent({
eventType: "click",
eventData: JSON.stringify({ clickX: "123", clickY: "456" }),
destination: ["buyer", "seller"],
});
Spezifikationen
| Spezifikation |
|---|
| Fenced Frame # dom-fence-reportevent |
Browser-Kompatibilität
Siehe auch
- Fenced frames auf privacysandbox.google.com
- The Privacy Sandbox auf privacysandbox.google.com