HTMLScriptElement: thuộc tính attributionSrc
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
Thuộc tính attributionSrc của giao diện HTMLScriptElement lấy và đặt thuộc tính attributionsrc trên phần tử <script> theo chương trình, phản ánh giá trị của thuộc tính đó. attributionsrc chỉ định rằng bạn muốn trình duyệt gửi tiêu đề Attribution-Reporting-Eligible cùng với yêu cầu tài nguyên tập lệnh.
Ở phía máy chủ, tiêu đề này được dùng để kích hoạt việc gửi tiêu đề Attribution-Reporting-Register-Source hoặc Attribution-Reporting-Register-Trigger trong phản hồi, để đăng ký nguồn phân bổ hoặc kích hoạt phân bổ dựa trên JavaScript. Tiêu đề phản hồi nào cần gửi lại phụ thuộc vào giá trị của tiêu đề Attribution-Reporting-Eligible đã kích hoạt việc đăng ký.
Note:
Ngoài ra, nguồn phân bổ hoặc kích hoạt phân bổ dựa trên JavaScript cũng có thể được đăng ký bằng cách gửi yêu cầu fetch() có chứa tùy chọn attributionReporting (đặt trực tiếp trên lệnh gọi fetch() hoặc trên đối tượng Request được truyền vào lệnh gọi fetch()), hoặc bằng cách gửi XMLHttpRequest với setAttributionReporting() được gọi trên đối tượng yêu cầu.
Xem Attribution Reporting API để biết thêm chi tiết.
Giá trị
Một chuỗi. Có hai phiên bản của thuộc tính này mà bạn có thể lấy và đặt:
-
Chuỗi rỗng, tức là
scriptElem.attributionSrc="". Điều này chỉ định rằng bạn muốn gửi tiêu đềAttribution-Reporting-Eligibleđến cùng máy chủ mà thuộc tínhsrctrỏ tới. Điều này ổn khi bạn xử lý việc đăng ký nguồn phân bổ hoặc kích hoạt phân bổ trên cùng một máy chủ. Khi đăng ký kích hoạt phân bổ, thuộc tính này là tùy chọn, và giá trị chuỗi rỗng sẽ được sử dụng nếu bị bỏ qua. -
Giá trị chứa một hoặc nhiều URL, ví dụ:
jsscriptElem.attributionSrc = "https://a.example/register-source https://b.example/register-source";Điều này hữu ích trong các trường hợp tài nguyên được yêu cầu không nằm trên máy chủ bạn kiểm soát, hoặc bạn chỉ muốn xử lý việc đăng ký nguồn phân bổ trên một máy chủ khác. Trong trường hợp này, bạn có thể chỉ định một hoặc nhiều URL làm giá trị của
attributionSrc. Khi yêu cầu tài nguyên xảy ra, tiêu đềAttribution-Reporting-Eligiblesẽ được gửi đến (các) URL được chỉ định trongattributionSrccùng với origin của tài nguyên. Các URL đó có thể phản hồi với tiêu đềAttribution-Reporting-Register-SourcehoặcAttribution-Reporting-Register-Triggerđể hoàn tất việc đăng ký.Note: Việc chỉ định nhiều URL có nghĩa là nhiều nguồn phân bổ có thể được đăng ký trên cùng một tính năng. Ví dụ, bạn có thể có nhiều chiến dịch khác nhau mà bạn đang cố đo lường mức độ thành công, liên quan đến việc tạo các báo cáo khác nhau về các dữ liệu khác nhau.
Ví dụ
Đặt attributionSrc rỗng
<script src="advertising-script.js"></script>
const scriptElem = document.querySelector("script");
scriptElem.attributionSrc = "";
Đặt attributionSrc chứa URL
<script src="advertising-script.js"></script>
// mã hóa các URL phòng trường hợp chúng chứa ký tự đặc biệt
// như '=' mà có thể bị phân tích cú pháp không đúng.
const encodedUrlA = encodeURIComponent("https://a.example/register-source");
const encodedUrlB = encodeURIComponent("https://b.example/register-source");
const scriptElem = document.querySelector("script");
scriptElem.attributionSrc = `${encodedUrlA} ${encodedUrlB}`;
Thông số kỹ thuật
| Specification |
|---|
| Attribution Reporting # dom-htmlattributionsrcelementutils-attributionsrc |