Fence: setReportEventDataForAutomaticBeacons() method
Khả dụng hạn chế
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
Phương thức setReportEventDataForAutomaticBeacons() của giao diện
Fence chỉ định dữ liệu sự kiện sẽ được gửi khi điều hướng xảy ra bên trong <fencedframe>. Dữ liệu này sẽ được gửi qua beacon tự động đến một hoặc nhiều URL cụ thể được đăng ký thông qua phương thức registerAdBeacon() của Protected Audience API, nhằm mục đích thu thập dữ liệu báo cáo cho kết quả đấu giá quảng cáo.
Note:
reportEvent() cung cấp việc gửi dữ liệu báo cáo tương tự, ngoại trừ trong trường hợp đó việc gửi được kích hoạt thông qua lệnh gọi phương thức rõ ràng thay vì điều hướng.
Cú pháp
setReportEventDataForAutomaticBeacons(event)
Tham số
event-
Đối tượng đại diện cho dữ liệu cần gửi. Các thuộc tính có thể có như sau:
eventType-
Chuỗi đại diện cho loại sự kiện đang được báo cáo. Các giá trị khả dụng là:
reserved.top_navigation_start: Sự kiện được kích hoạt khi điều hướng cấp cao nhất bắt đầu.reserved.top_navigation_commit: Sự kiện được kích hoạt khi điều hướng cấp cao nhất hoàn tất.
eventData-
Chuỗi đại diện cho dữ liệu cần gửi.
destination-
Mảng chứa một hoặc nhiều giá trị liệt kê đại diện cho các loại đích. Đây là các bên liên quan sẽ nhận dữ liệu đến URL đã đăng ký của họ (thông qua
registerAdBeacon()). Các giá trị có thể là:"buyer": Người đặt giá trong cuộc đấu giá quảng cáo."seller": Người bán cấp cao nhất điều hành cuộc đấu giá quảng cáo."component-seller": Người bán cho cuộc đấu giá thành phần trong cuộc đấu giá nhiều cấp."direct-seller": Người bán đã trực tiếp điều hành cuộc đấu giá mà người mua đã đặt giá. Nếu quảng cáo là cuộc đấu giá một cấp, giá trị được sử dụng sẽ là"seller". Nếu là cuộc đấu giá nhiều cấp, giá trị được sử dụng sẽ là"component-seller"."shared-storage-select-url": Vị trí lưu trữ Shared Storage API, được xác định trong lệnh gọi phương thứcWindow.sharedStorage.selectURL().
onceOptional-
Giá trị boolean. Nếu đặt là
true, beacon tự động chỉ được gửi cho sự kiện tiếp theo, và các beacon sẽ không được gửi cho các sự kiện tiếp theo cho đến khisetReportEventDataForAutomaticBeacons()được gọi lại. Ví dụ, khi được sử dụng với trình xử lýclick, điều này có thể được dùng để chỉ gửi dữ liệu beacon cho các điều hướng cấp cao nhất cụ thể, thay vì cho mọi điều hướng cấp cao nhất. Thuộc tính này mặc định làfalse.
Giá trị trả về
Không có (Undefined).
Ví dụ
window.fence.setReportEventDataForAutomaticBeacons({
eventType: "reserved.top_navigation_start",
eventData: "an example string",
destination: ["seller", "buyer"],
});
Thông số kỹ thuật
| Thông số kỹ thuật |
|---|
| Fenced Frame # dom-fence-setreporteventdataforautomaticbeacons |
Tương thích trình duyệt
Xem thêm
- Fenced frames trên privacysandbox.google.com
- The Privacy Sandbox trên privacysandbox.google.com