HTMLAnchorElement: 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 HTMLAnchorElement lấy và đặt thuộc tính attributionsrc trên một phần tử <a> một cách lập 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 một tiêu đề Attribution-Reporting-Eligible. Ở phía máy chủ, điều này được dùng để kích hoạt việc gửi tiêu đề Attribution-Reporting-Register-Source trong phản hồi, nhằm đăng ký một nguồn quy kết dựa trên điều hướng.
Trình duyệt lưu trữ dữ liệu nguồn liên quan đến nguồn quy kết dựa trên điều hướng (được cung cấp trong tiêu đề phản hồi Attribution-Reporting-Register-Source) khi nhận được phản hồi điều hướng.
Xem Attribution Reporting API để biết thêm chi tiết.
Note:
Các phần tử <a> không thể được sử dụng làm trình kích hoạt quy kết, chỉ có thể là nguồn.
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à
aElem.attributionSrc="". Điều này chỉ định rằng bạn muốn tiêu đềAttribution-Reporting-Eligibleđược gửi đến cùng máy chủ mà thuộc tínhhreftrỏ đến. Điều này phù hợp khi bạn đang xử lý việc đăng ký nguồn quy kết trên cùng một máy chủ. -
Giá trị chứa một hoặc nhiều URL, ví dụ:
jsaElem.attributionSrc = "https://a.example/register-source https://b.example/register-source";Điều này hữu ích trong 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 quy kết 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 trongattributionSrcngoài nguồn gốc tài nguyên. Các URL này sau đó có thể phản hồi bằng mộtAttribution-Reporting-Register-Sourceđể đăng ký nguồn.Note: Việc chỉ định nhiều URL có nghĩa là nhiều nguồn quy kết có thể được đăng ký trên cùng một tính năng. Bạn có thể có các chiến dịch khác nhau mà bạn đang cố gắng đ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 trên các dữ liệu khác nhau.
Ví dụ
Đặt một attributionSrc rỗng
<a href="https://shop.example"> Nhấp để ghé thăm cửa hàng của chúng tôi </a>
const aElem = document.querySelector("a");
aElem.attributionSrc = "";
Đặt attributionSrc chứa các URL
<a href="https://ourshop.example"> Nhấp để ghé thăm cửa hàng của chúng tôi </a>
// mã hóa các URL trong trường hợp chúng chứa ký tự đặc biệt
// chẳng hạn như '=' sẽ bị phân tích cú pháp không chính xác.
const encodedUrlA = encodeURIComponent("https://a.example/register-source");
const encodedUrlB = encodeURIComponent("https://b.example/register-source");
const aElem = document.querySelector("a");
aElem.attributionSrc = `${encodedUrlA} ${encodedUrlB}`;
Đặc tả kỹ thuật
| Thông số kỹ thuật |
|---|
| Attribution Reporting # dom-htmlattributionsrcelementutils-attributionsrc |