Bật tính năng đo lường lượt chuyển đổi

Việc đo lường mô hình phân bổ lượt chuyển đổi có thể bao gồm nhiều bên, từ nhà xuất bản, nhà quảng cáo, công nghệ quảng cáo phân phát (thực thể phân phối quảng cáo), nhà cung cấp dịch vụ đo lường và các bên khác. Trong tài liệu này, chúng tôi minh hoạ các trường hợp đo lường lượt chuyển đổi phổ biến, nhưng nhìn chung, bất kỳ bên nào muốn nhận báo cáo phân bổ từ Attribution Reporting API (ARA) đều phải đảm bảo tuân thủ các bước tích hợp được mô tả trong tài liệu này.

Ví dụ: thông thường một nhà xuất bản sẽ có một hoặc nhiều công nghệ quảng cáo chịu trách nhiệm phân phát quảng cáo — các bên chịu trách nhiệm cung cấp mã đánh dấu cho mẫu quảng cáo, các bên cung cấp pixel hiển thị hoặc pixel theo dõi trên mẫu quảng cáo và các bên cung cấp SDK hoặc thẻ cho vùng quảng cáo trên trang nhà xuất bản. Những công nghệ quảng cáo này có thể hoặc không muốn nhận báo cáo phân bổ từ ARA, nhưng được bố trí để đảm bảo các công nghệ quảng cáo thứ cấp có thể nhận được báo cáo phân bổ.

Ngoài ra, nhà quảng cáo cũng có thể sử dụng nhà cung cấp dịch vụ đo lường lượt chuyển đổi bên thứ ba để phân bổ trên nhiều mạng cũng như các tính năng báo cáo khác. Nhà quảng cáo sử dụng dữ liệu đó để hiểu lợi tức đầu tư quảng cáo trên nhiều nhà xuất bản và kênh riêng biệt. Vì vậy, DSP hoặc máy chủ quảng cáo cần phải hiểu cách bật Attribution Reporting API để hỗ trợ những trường hợp sử dụng này. Những nhà quảng cáo muốn sử dụng bên thứ ba có thể tiếp tục làm như vậy bằng cách sử dụng nhà cung cấp dịch vụ đo lường bên thứ ba hoặc thiết lập một máy chủ nội bộ để đăng ký và nhận báo cáo từ API.

Attribution Reporting API cho phép nhiều công nghệ quảng cáo đăng ký các nguồn phân bổ và điều kiện kích hoạt cho cùng một lượt hiển thị hoặc lượt chuyển đổi, đồng thời nhận các báo cáo riêng biệt từ API. Ví dụ: DSP có thể nhận báo cáo phân bổ riêng từ Attribution Reporting API, cũng như cho phép báo cáo riêng cho nhà cung cấp dịch vụ đo lường bên thứ ba của nhà quảng cáo. Một công nghệ quảng cáo phải đăng ký cả nguồn phân bổ và điều kiện kích hoạt để nhận báo cáo từ API. Việc phân bổ sẽ được thực hiện giữa các nguồn phân bổ và điều kiện kích hoạt mà công nghệ quảng cáo đã đăng ký riêng với API.

Các trường hợp phổ biến khi đo lường lượt chuyển đổi

Trong phần này, chúng ta sẽ tìm hiểu hai trường hợp phổ biến để đo lường lượt chuyển đổi.

Trường hợp 1: Cả nhà cung cấp dịch vụ đo lường bên thứ ba và việc phân phát công nghệ quảng cáo đều cần nhận được báo cáo từ Attribution Reporting API

Một nhà quảng cáo muốn phân bổ lượt chuyển đổi trên khoảng không quảng cáo thông qua nhà cung cấp dịch vụ đo lường bên thứ ba, và công nghệ quảng cáo lưu trữ mẫu quảng cáo muốn phân bổ các lượt chuyển đổi trên khoảng không quảng cáo. Điều này phổ biến đối với các DSP hoặc máy chủ quảng cáo của nhà quảng cáo (máy chủ quảng cáo của bên thứ ba — 3PAS) mà cung cấp mã đánh dấu cho mẫu quảng cáo, thực hiện báo cáo phân bổ của riêng họ và làm việc với các nhà quảng cáo tích hợp với nhà cung cấp dịch vụ đo lường hoặc phân tích của bên thứ ba.

Trong trường hợp này, công nghệ quảng cáo phân phát cũng là bên chịu trách nhiệm kích hoạt các sự kiện lượt nhấp và lượt hiển thị trong chế độ thiết lập hiện tại. Công nghệ quảng cáo phân phát phải đặt attributionsrc mới ở các vị trí thích hợp và đảm bảo các lệnh chuyển hướng được định cấu hình chính xác. Ngoài ra, cả công nghệ quảng cáo phân phát và nhà cung cấp dịch vụ đo lường bên thứ ba phải đảm bảo họ đã đăng ký và máy chủ của họ sẵn sàng nhận cũng như phản hồi các yêu cầu của Attribution Reporting API.

Một chế độ thiết lập chiến dịch điển hình có thể có dạng như sau:

  1. Máy chủ quảng cáo của nhà quảng cáo (3PAS) cung cấp mã đánh dấu cho mẫu quảng cáo cho DSP, bao gồm cả pixel theo dõi lượt hiển thị và lượt nhấp của nhà cung cấp dịch vụ đo lường bên thứ ba. Máy chủ quảng cáo phải đảm bảo attributionsrc được đưa vào mã đánh dấu mẫu quảng cáo.

  2. DSP này cung cấp khả năng thêm pixel theo dõi lượt nhấp và lượt hiển thị đo lường bổ sung, đồng thời phải đảm bảo attributionsrc được đưa vào mã đánh dấu mẫu quảng cáo cuối cùng mà họ đang đặt giá thầu.

Trường hợp 2: Chỉ nhà cung cấp dịch vụ đo lường bên thứ ba cần nhận báo cáo từ Attribution Reporting API

Một nhà quảng cáo muốn phân bổ lượt chuyển đổi trên khoảng không quảng cáo thông qua nhà cung cấp dịch vụ đo lường bên thứ ba, nhưng công nghệ quảng cáo lưu trữ mẫu quảng cáo không có yêu cầu về việc đo lường hoạt động phân bổ. Điều này phổ biến đối với những nhà xuất bản, SSP hoặc máy chủ quảng cáo của nhà xuất bản lưu trữ mẫu quảng cáo và không có ý định sử dụng tính năng báo cáo phân bổ, nhưng muốn bật Attribution Reporting API cho các đối tác DSP của họ hoặc cho các công ty gắn thẻ đo lường như máy chủ quảng cáo bên thứ ba, nhà cung cấp dịch vụ đo lường hoặc phân tích.

Trong trường hợp này, bên chịu trách nhiệm kích hoạt các sự kiện lượt nhấp và lượt hiển thị trong chế độ thiết lập hiện tại cần thêm thuộc tính attributionsrc mới vào mẫu quảng cáo và đảm bảo các lệnh chuyển hướng hoạt động như dự kiến. Điều này phụ thuộc rất lớn vào việc tích hợp của từng nhà xuất bản, nhưng đối với các sự kiện nhấp chuột, đó có thể là SSP, công nghệ quảng cáo phân phát hoặc chính nhà xuất bản. Đối với sự kiện hiển thị, đây thường là nhà cung cấp dịch vụ đo lường bên thứ ba.

Trong ví dụ điển hình về việc thiết lập chiến dịch ở Tình huống 1, máy chủ quảng cáo của nhà xuất bản, SSP hoặc nhà xuất bản có thể chỉ cần đảm bảo rằng thuộc tính attributionsrc do DSP cung cấp sẽ xuất hiện trên trang của nhà xuất bản.

Chi tiết triển khai

Bảng sau đây mô tả các bước triển khai Attribution Reporting API ở cấp tổng thể:

Các bước Trách nhiệm trong công việc Ví dụ
Bước 1: Bật nguồn phân bổ cho mẫu quảng cáo và mã đo lường hiện có Thực thể chịu trách nhiệm kích hoạt sự kiện hiển thị hoặc xử lý sự kiện nhấp chuột sẽ thêm thuộc tính attributionsrc. Đối với các sự kiện nhấp chuột, thường thì người mua (DSP/máy chủ quảng cáo của nhà quảng cáo) hiển thị mẫu quảng cáo sẽ thêm thuộc tính này.

Đối với các sự kiện hiển thị, nền tảng bên cầu (DSP), nền tảng bên cung (SSP), nhà xuất bản, máy chủ quảng cáo hoặc nhà cung cấp dịch vụ đo lường sẽ thêm thuộc tính và thuộc tính này phụ thuộc vào chế độ thiết lập của nhà xuất bản.

Đối với quảng cáo dạng video sử dụng định dạng VAST, nhà xuất bản và SDK video sẽ thêm thuộc tính này.
Bước 2: Bật Báo cáo phân bổ cho các nguồn gốc của bên thứ ba Cách này hoạt động ngay lập tức nếu bạn sử dụng đường dẫn chuyển hướng hiện có với lệnh chuyển hướng 302.

Nếu không thể sử dụng lệnh chuyển hướng 302, thì bạn có thể dùng thuộc tính attributionsrc để liệt kê nhiều máy chủ công nghệ quảng cáo.

 Nói chung, miễn là thuộc tính attributionsrc được thêm vào mẫu quảng cáo, thì các lệnh chuyển hướng của bên thứ ba sẽ nhận được lệnh gọi Attribution Reporting API.
Bước 3: Thiết lập tính năng phản hồi cho các yêu cầu Attribution Reporting API Mọi pháp nhân muốn nhận báo cáo từ Attribution Reporting API DSP và nhà cung cấp dịch vụ đo lường của bên thứ ba mà nhà quảng cáo sử dụng

Xin lưu ý rằng thông tin cụ thể của từng bước phụ thuộc vào cách mẫu quảng cáo được hiển thị và phân phát trên trang nhà xuất bản, cũng như thực thể công nghệ quảng cáo nào nhận được báo cáo do Attribution Reporting API gửi.

Bước 1: Bật nguồn phân bổ cho mẫu quảng cáo và mã đo lường hiện có

Trong bước đầu tiên, bạn cần bật các nguồn phân bổ.

Cách hoạt động của thuộc tính attributionsrc

Thuộc tính attributionsrc mới xác định nơi các yêu cầu Attribution Reporting API sẽ được gửi đến. Pháp nhân chịu trách nhiệm kích hoạt các sự kiện nhấp chuột và hiển thị phải cập nhật mẫu quảng cáo bằng thuộc tính attributionsrc. Bạn phải thêm attributionsrc vào các sự kiện lượt nhấp và lượt hiển thị hiện có và có thể để trống hoặc không được để trống.

Đối với các sự kiện nhấp chuột sử dụng lệnh chuyển hướng, bạn phải thêm thuộc tính attributionsrc vào thành phần điều hướng. Mọi lệnh chuyển hướng 302 sau khi điều hướng không cần thêm thuộc tính attributionsrc và sẽ đủ điều kiện cho ARA, miễn là quá trình điều hướng ban đầu đã thêm attributionsrc.

Khi attributionsrc trống, các yêu cầu ARA sẽ được gửi đến URL được xác định trong thuộc tính href của thẻ ký tự liên kết (URL lượt nhấp). Khi thuộc tính attributionsrc được xác định, yêu cầu ARA sẽ được gửi đến URL được xác định trong thuộc tính attributionsrc. URL nhấp qua cũng đủ điều kiện để đăng ký nguồn.

Thông thường, hãy sử dụng thuộc tính attributionsrc trống nếu máy chủ lưu trữ URL của trang đích khi nhấp có thể nhận và phản hồi các yêu cầu của Attribution Reporting API. Hãy xác định URL attributionsrc của riêng bạn nếu bạn muốn các yêu cầu của Attribution Reporting API chuyển đến một máy chủ khác.

Ví dụ về một thuộc tính attributionsrc trống:

Chế độ thiết lập hiện tại của bạn Có tích hợp ARA
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>

Khi thuộc tính attributionsrc trống, yêu cầu Attribution Reporting API sẽ được gửi đến URL được xác định bằng thuộc tính href của thẻ ký tự liên kết.

Ví dụ về thuộc tính Attributionsrc không trống:

Chế độ thiết lập hiện tại của bạn Có tích hợp ARA
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc="[ATTRIBUTION_SRC_URL]">...</a>

Khi attributionsrc không trống, các yêu cầu Attribution Reporting API sẽ được gửi đến URL do thẻ attributionsrc xác định. URL nhấp qua cũng đủ điều kiện để đăng ký nguồn.

Thêm attributionsrc cho các sự kiện nhấp chuột và hiển thị

  • Sự kiện nhấp:
    • Thực thể chịu trách nhiệm thêm attributionsrc thường là công nghệ quảng cáo phân phát.
    • Bạn phải thêm thuộc tính attributionsrc cho thẻ ký tự liên kết có sự kiện nhấp chuột.
    • Các lượt nhấp sử dụng window.open phải sử dụng đối số windowFeatures của lệnh gọi window.open để chỉ định nguồn phân bổ.
  • Sự kiện hiển thị:
    • Thực thể chịu trách nhiệm thêm attributionsrc thường là công nghệ quảng cáo phân phát và(các) nhà cung cấp dịch vụ đo lường.
    • Sự kiện hiển thị được kích hoạt từ thẻ <img> hoặc thẻ <script> phải bao gồm thuộc tính attributionsrc.
    • Sự kiện hiển thị sử dụng API Tìm nạp phải bao gồm một đối tượng attributionReporting trong đối số options được truyền đến lệnh gọi API tìm nạp.

Hãy xem bảng sau để biết thông tin tóm tắt về các nội dung sửa đổi cần thiết cho các sự kiện lượt nhấp và lượt hiển thị:

Sự kiện Gắn thẻ Chế độ thiết lập hiện tại của bạn Sau khi tích hợp ARA
Nhấp HTML <a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>
JavaScript window.open("[CLICKTHROUGH_URL]", "_blank"); window.open("[CLICKTHROUGH_URL]", "_blank", "attributionsrc");
Hiển thị Thẻ HTML <img> <img src="[IMPRESSION_URL]"> <img src="[IMPRESSION_URL]" attributionsrc>
Thẻ HTML <script> <script src="[IMPRESSION_URL]"></script> <script src="[IMPRESSION_URL]" attributionsrc></script>
JavaScript const options = {...}
window.fetch("[IMPRESSION_URL]", options); 		const options = {
  attributionReporting: {
    eventSourceEligible: true,
    triggerEligible: false,
  },
  ...
};
window.fetch("[IMPRESSION_URL]", options);

Bật tính năng đăng ký nguồn phân bổ trong phiên đấu giá sử dụng Protected Audience API

Để đo lường lượt chuyển đổi trong phiên đấu giá sử dụng Protected Audience API, thay vì sử dụng attributionsrc, bạn có thể sử dụng registerAdBeacon/registerAdMacro và setReportEventDataForAutomaticBeacons/reportEvent để bật tính năng đăng ký nguồn phân bổ.

Để báo cáo tín hiệu Đối tượng được bảo vệ, hàm registerAdBeacon có trong các tệp công việc báo cáo và registerAdMacro có sẵn trong worklet báo cáo giành chiến thắng của người mua. Sau đó, bạn có thể thêm dữ liệu sự kiện bên trong khung quảng cáo vào beacon và macro đã đăng ký bằng hàm reportEvent và setReportEventDataForAutomaticBeacons của API Báo cáo quảng cáo khung bảo vệ. Điều này cho phép liên kết các tín hiệu của các công việc báo cáo Protected Audience và tải trọng sự kiện khung mẫu quảng cáo với nhau.

Tiêu đề HTTP Attribution-Reporting-Eligible được thêm vào yêu cầu khi beacon và macro được kích hoạt bởi lệnh gọi reportEvent từ một khung, hoặc beacon tự động được trình duyệt kích hoạt. Bạn có thể sử dụng phản hồi của beacon để đăng ký nguồn phân bổ. Các yêu cầu beacon có thể được chuyển hướng để cho phép dịch vụ đo lường của bên thứ ba.

Để tìm hiểu sâu hơn, hãy xem phần Hỗ trợ báo cáo phân bổ của tài liệu giải thích về API Báo cáo quảng cáo theo khung bảo vệ.

Bật tính năng báo cáo phân bổ cho các định dạng VAST

VAST là một định dạng phổ biến để phân phát và đo lường khoảng không quảng cáo dạng video. Nhiều sự kiện được xác định trong tiêu chuẩn đó nên được coi là các sự kiện nguồn tiềm năng đủ điều kiện để đăng ký bằng Attribution Reporting API. Phụ lục VAST cho hỗ trợ báo cáo phân bổ trình bày chi tiết điều này, nhưng tóm lại, tất cả các sự kiện <Tracking>, <Impression>, <*ClickThrough> và <*ClickTracking> đều là sự kiện nguồn phân bổ tiềm năng. Tất cả phương thức triển khai VAST phải đáp ứng điều kiện đăng ký cho những sự kiện này.

Phụ lục VAST xác định các thuộc tính mới cho các phần tử này để cho phép đặt URL phụ dành riêng cho việc đăng ký phân bổ. Khi một sự kiện chứa attributiontype="DOUBLE_PING" và attributionsrc="[URL]", mã kích hoạt sự kiện đó sẽ sử dụng [URL] làm giá trị của thuộc tính attributionsrc khi bật Attribution Reporting API. Phụ lục VAST có chứa ví dụ cho từng trường hợp.

Để đảm bảo mức độ phù hợp tối đa, việc triển khai VAST phải làm cho tất cả các sự kiện được liệt kê đều đủ điều kiện đăng ký theo mặc định khi kích hoạt ping sự kiện. Ví dụ: khi kích hoạt một URL sự kiện <Impression>, bạn phải sử dụng thuộc tính attributionsrc (trống) trên phần tử <img> dùng để gửi yêu cầu (hoặc thuộc tính tương đương trên lệnh gọi tìm nạp), để luôn cho phép bên nhận có thể đăng ký sự kiện đó bằng Attribution Reporting API.

Bước 2: Bật Báo cáo phân bổ cho các nguồn gốc của bên thứ ba

Để cho phép bên thứ ba sử dụng Attribution Reporting API, bạn có thể sử dụng các lệnh chuyển hướng hiện có hoặc thêm danh sách bên thứ ba vào thuộc tính attributionsrc. Trong hầu hết các trường hợp, mỗi công nghệ quảng cáo đều có trình theo dõi lượt hiển thị độc lập riêng. Do đó, hoạt động chuyển hướng sẽ phù hợp hơn đối với trình theo dõi lượt nhấp.

Xử lý các nguồn gốc của bên thứ ba trong một chuỗi chuyển hướng hiện có

Trong một lượt nhấp vào quảng cáo thông thường, nhiều trình theo dõi lượt nhấp có thể xuất hiện dưới dạng một chuỗi lượt chuyển hướng 302 được thực hiện trong quá trình điều hướng đến trang đích cuối cùng. Mọi yêu cầu trong chuỗi chuyển hướng đều đủ điều kiện đăng ký bằng Attribution Reporting API nếu mục tiêu lượt nhấp ban đầu được chú thích bằng attributionsrc hoặc đã đăng ký bằng registerAdBeacon/registerAdMacro trong Protected Audience API. Bạn cũng phải đăng ký công nghệ quảng cáo trong chuỗi chuyển hướng.

Lưu ý rằng nội dung của yêu cầu ban đầu không được gửi trong các lệnh chuyển hướng. Đối với các phiên đấu giá sử dụng Protected Audience API, nếu cần sử dụng eventData được truyền vào reportEvent và setReportEventDataForAutomaticBeacons như một phần của lệnh chuyển hướng, thì dữ liệu này phải được chuyển một cách rõ ràng trong URL chuyển hướng.

Trong ví dụ sau, chúng ta sẽ sử dụng một công nghệ quảng cáo phân phát (serving-adtech.example) và một nhà cung cấp dịch vụ đo lường của bên thứ ba (3p-measurement.example) làm hai thực thể riêng biệt đang tìm cách tạo và nhận báo cáo phân bổ. Công nghệ quảng cáo phân phát trong ví dụ này có thể là một DSP hiển thị mẫu quảng cáo trên trang web của nhà xuất bản và có sản phẩm báo cáo riêng. Nhà cung cấp dịch vụ đo lường bên thứ ba có thể là một pháp nhân mà nhà quảng cáo sử dụng để báo cáo lượt chuyển đổi.

Sơ đồ mô tả cách bên thứ nhất đăng ký nguồn, sau đó bên thứ ba đăng ký

Tại thời điểm đăng ký nguồn, các bước sau đây sẽ diễn ra:

  1. serving-adtech.example đặt thuộc tính attributionsrc trong mẫu quảng cáo.Người dùng truy cập vào trang của nhà xuất bản và trình duyệt gửi yêu cầu đến serving-adtech.example.
  2. serving-adtech.example phản hồi bằng tiêu đề Attribution-Reporting-Register-Source và tiêu đề Location.
    1. serving-adtech.example sử dụng tiêu đề Attribution-Reporting-Register-Source để phản hồi bằng siêu dữ liệu về nguồn sẽ được đăng ký.
    2. serving-adtech.example sử dụng tiêu đề Location để bao gồm lệnh chuyển hướng đến 3p-measurement.example. Xin lưu ý rằng có thể tiêu đề Location đã được sử dụng trong các quy trình theo dõi lượt nhấp hiện có để hỗ trợ 302 chuyển hướng đến một bên thứ ba.
  3. Trình duyệt nhận phản hồi từ serving-adtech.example và phân tích cú pháp tiêu đề Attribution-Reporting-Register-Source. Trình duyệt sẽ lưu trữ sự kiện nguồn, sử dụng serving-adtech.example làm nguồn gốc báo cáo.
  4. Vì yêu cầu này là một lệnh chuyển hướng nên trình duyệt cũng tạo một yêu cầu mới đến 3p-measurement.example.
  5. 3p-measurement.example phản hồi bằng phản hồi có chứa tiêu đề Attribution-Reporting-Register-Source.
  6. Trình duyệt nhận phản hồi này từ 3p-measurement.example và đọc Attribution-Reporting-Register-Source. Trình duyệt sẽ lưu trữ sự kiện nguồn, sử dụng 3p-measurement.example làm nguồn gốc báo cáo.

Sử dụng attributionsrc cho các nguồn gốc bên thứ ba không nằm trong chuỗi chuyển hướng

Nếu nhiều nguồn gốc trình báo cáo muốn đăng ký nguồn trên một sự kiện điều hướng, nhưng không thể xuất hiện trong chuỗi chuyển hướng vì bất kỳ lý do nào, thì bạn có thể liệt kê nhiều trang web làm nguồn phân bổ trong attributionsrc làm giải pháp thay thế.

Chế độ thiết lập hiện tại của bạn Có sửa đổi ARA
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc="[REPORTING_URL_1] [REPORTING_URL_2]">...</a>

Trong ví dụ này, các yêu cầu đủ điều kiện để sử dụng Attribution Reporting API sẽ được gửi đến cả REPORTING_URL_1 và REPORTING_URL_2. Yêu cầu điều hướng gửi đến URL của trang đích khi nhấp cũng đủ điều kiện để đăng ký các nguồn phân bổ.

Bước 3: Thiết lập tính năng phản hồi cho các yêu cầu Attribution Reporting API

Đối với mọi nguồn gốc nhận được yêu cầu Attribution Reporting API, hãy đảm bảo rằng máy chủ phản hồi bằng tiêu đề Attribution-Reporting-Register-Source thích hợp. Xem hướng dẫn về Đăng ký nguồn và trình giải thích để tìm hiểu cách tạo phản hồi.

Đăng ký nhiều điều kiện kích hoạt

Bạn có thể đăng ký nhiều điều kiện kích hoạt phân bổ bằng cách thêm nhiều phần tử pixel ở phía chuyển đổi (một phần tử cho mỗi điều kiện kích hoạt). Không bắt buộc phải sử dụng phần tử attributionsrc để đăng ký điều kiện kích hoạt.

Bạn cũng có thể đăng ký nhiều điều kiện kích hoạt từ một phần tử pixel bằng cách sử dụng yêu cầu chuyển hướng hoặc liệt kê nhiều URL trong phần tử attributionsrc theo cách tương tự như khi đăng ký nguồn. Sự kiện nguồn và sự kiện điều kiện kích hoạt đã được tạo bởi cùng một nguồn gốc sẽ được so khớp.