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

Hoạt động đo lường mô hình phân bổ lượt chuyển đổi có thể liên quan đến 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.v. 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 nói 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 rằng các bước tích hợp được mô tả trong tài liệu này được tuân thủ.

Ví dụ: nhà xuất bản thường 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. Điều này có thể bao gồm 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 lượt 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 của nhà xuất bản. Những công nghệ quảng cáo này có thể muốn hoặc không muốn nhận báo cáo phân bổ từ ARA, nhưng được đặt ở vị trí để đảm bảo các công nghệ quảng cáo hạ nguồn có thể nhận báo cáo phân bổ.

Ngoài ra, nhà quảng cáo cũng có thể đang sử dụng một nhà cung cấp dịch vụ đo lường lượt chuyển đổi bên thứ ba cho mô hình phân bổ trên nhiều mạng cũng như các chức năng báo cáo khác. Nhà quảng cáo sử dụng dữ liệu đó để hiểu được 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, điều quan trọng là DSP hoặc máy chủ quảng cáo 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 bằng cách 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ý 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 và nhận các báo cáo riêng biệt từ API. Ví dụ: một DSP có thể nhận báo cáo phân bổ của riêng mình 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, còn 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 đo lường lượt chuyển đổi phổ biến

Trong phần này, chúng ta sẽ xem xét 2 trường hợp phổ biến để đo lường lượt chuyển đổi.

Tình huống 1: 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 đều 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 bằng cách sử dụng nhà cung cấp dịch vụ đo lường bên thứ ba, đồng thời công nghệ quảng cáo lưu trữ mẫu quảng cáo đó cũng muốn phân bổ lượt chuyển đổi trên khoảng không quảng cáo. Điều này thường xảy ra đố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 bên thứ ba – 3PAS) 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 những 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 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 ở vị trí thích hợp và xác minh rằng 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 đều phải xác minh rằng họ đã đăng ký và máy chủ của họ đã sẵn sàng nhận và phản hồi các yêu cầu Attribution Reporting API.

Một chế độ thiết lập chiến dịch điển hình có thể trô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 rằng attributionsrc có trong mã đánh dấu mẫu quảng cáo.

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

Tình huống 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

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 bằng cách sử dụng 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 đo lường việc phân bổ. Điều này thường xảy ra đố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 tự sử dụng báo cáo phân bổ, nhưng muốn bật Attribution Reporting API cho các đối tác DSP hoặc cho các công ty gắn thẻ đo lường (chẳng hạn như máy chủ quảng cáo, nhà cung cấp dịch vụ đo lường hoặc phân tích bên thứ ba).

Trong trường hợp này, bên chịu trách nhiệm kích hoạt 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à xác minh rằng các lệnh chuyển hướng đang hoạt động như dự kiến. Điều này phụ thuộc rất nhiều vào hoạt động tích hợp của từng nhà xuất bản, nhưng đối với 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 các 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ụ về thiết lập chiến dịch thông thường trong Tình huống 1, máy chủ quảng cáo của nhà xuất bản, SSP hoặc chính nhà xuất bản có thể chỉ cần xác minh rằng thuộc tính attributionsrc do DSP cung cấp xuất hiện trên trang của nhà xuất bản.

Thông tin chi tiết về việc triển khai

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

Các bước Trách nhiệm 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 sẽ thêm thuộc tính attributionsrc. Đối với 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 này 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 Attribution Reporting cho nguồn gốc bên thứ ba Điều này sẽ hoạt động ngay 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, bạn có thể sử dụng thuộc tính attributionsrc để liệt kê nhiều máy chủ công nghệ quảng cáo.

 Nhìn chung, miễn là bạn thêm thuộc tính attributionsrc vào mẫu quảng cáo, 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 các phản hồi cho yêu cầu Attribution Reporting API Mọi thực thể muốn nhận báo cáo từ Attribution Reporting API DSP và nhà cung cấp dịch vụ đo lường 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 của nhà xuất bản, cũng như những 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, các nguồn phân bổ sẽ được bật.

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

Thuộc tính attributionsrc mới chỉ định nơi các yêu cầu Attribution Reporting API sẽ được gửi đến. Thực thể chịu trách nhiệm kích hoạt sự kiện lượt hiển thị và lượt nhấp phải cập nhật mẫu quảng cáo bằng thuộc tính attributionsrc. Bạn nên thêm attributionsrc vào các sự kiện lượt nhấp và lượt hiển thị hiện có, đồng thời có thể để trống hoặc không để 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 nên 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 thao tác đ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à thao tác đ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ẻ liên kết (URL của trang đích khi nhấp). Khi thuộc tính attributionsrc được xác định, các yêu cầu ARA sẽ được gửi đến URL được xác định trong thuộc tính attributionsrc. URL lượt nhấp cũng đủ điều kiện để đăng ký nguồn.

Nhìn chung, 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 sau khi nhấp có thể nhận và phản hồi các yêu cầu Attribution Reporting API. Xác định URL attributionsrc của riêng bạn nếu bạn muốn các yêu cầu Attribution Reporting API chuyển đến một máy chủ khác.

Ví dụ về 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, các yêu cầu Attribution Reporting API sẽ được gửi đến URL do thuộc tính href của thẻ ký tự liên kết xác định.

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 lượt nhấp cũng đủ điều kiện để đăng ký nguồn.

Thêm attributionsrc cho sự kiện lượt nhấp và lượt hiển thị

  • Sự kiện nhấp chuột:
    • Thường thì công nghệ quảng cáo phân phát là thực thể chịu trách nhiệm thêm attributionsrc.
    • Bạn nên thêm thuộc tính attributionsrc vào thẻ liên kết có sự kiện nhấp chuột.
    • 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ường thì thực thể chịu trách nhiệm thêm attributionsrc 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.
    • Các sự kiện hiển thị được kích hoạt từ thẻ <img> hoặc thẻ <script> phải có thuộc tính attributionsrc.
    • Các sự kiện hiển thị sử dụng Fetch API phải bao gồm một đối tượng attributionReporting trong đối số options được truyền đến lệnh gọi Fetch API.

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

Sự kiện Thẻ Chế độ thiết lập hiện tại của bạn Sau khi tích hợp ARA
Nhấp chuột 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ẻ <img> HTML <img src="[IMPRESSION_URL]"> <img src="[IMPRESSION_URL]" attributionsrc>
Thẻ <script> HTML <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á Protected Audience, thay vì sử dụng attributionsrc, bạn có thể sử dụng registerAdBeacon/registerAdMacro và setReportEventDataForAutomaticBeacons/reportEvent để cho phép đăng ký các nguồn phân bổ.

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

Tiêu đề HTTP Attribution-Reporting-Eligible được thêm vào yêu cầu khi các beacon và macro được kích hoạt bằng lệnh gọi reportEvent từ một khung hình hoặc các beacon tự động được kích hoạt bằng trình duyệt. Bạn có thể sử dụng phản hồi của beacon để đăng ký một nguồn phân bổ. Các yêu cầu về beacon có thể được chuyển hướng để cho phép giải pháp đ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ổ trong tài liệu giải thích về Fenced Frame Ad Reporting API.

Bật 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 để hỗ trợ Báo cáo phân bổ đề cập chi tiết đến vấn đề này, nhưng tóm lại, tất cả các sự kiện <Tracking>, <Impression>, <*ClickThrough> và <*ClickTracking> đều là các sự kiện nguồn phân bổ tiềm năng. Tất cả các hoạt động triển khai VAST đều phải cung cấp phạm vi đủ điều kiện đăng ký cho những sự kiện này.

Bản bổ sung VAST xác định các thuộc tính mới cho những phần tử này để cho phép đặt mộ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 đó phải 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ó các ví dụ cho từng trường hợp.

Để có phạm vi tối đa, theo mặc định, các hoạt động triển khai VAST phải giúp tất cả sự kiện được liệt kê đủ điều kiện đăng ký khi các ping sự kiện được kích hoạt. Ví dụ: khi kích hoạt URL sự kiện <Impression>, bạn nên 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 tương đương trên lệnh gọi tìm nạp), để bên nhận luôn có thể đăng ký sự kiện đó bằng Attribution Reporting API.

Bước 2: Bật Attribution Reporting cho nguồn gốc bên thứ ba

Để cho phép các 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 các 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 của riêng mình, vì vậy, các lệnh chuyển hướng sẽ phù hợp hơn với trình theo dõi lượt nhấp.

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

Trong một lượt nhấp qua quảng cáo thông thường, có thể có nhiều trình theo dõi lượt nhấp dưới dạng một chuỗi các lượt chuyển hướng 302 được thực hiện trong quá trình chuyển đế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 nhấp ban đầu được chú thích bằng attributionsrc hoặc được đăng ký bằng registerAdBeacon/registerAdMacro trong Protected Audience API. Công nghệ quảng cáo trong chuỗi chuyển hướng cũng phải được đăng ký.

Xin lưu ý rằng nội dung yêu cầu ban đầu sẽ không được gửi khi chuyển hướng. Đối với phiên đấu giá sử dụng Protected Audience API, nếu eventData được truyền vào reportEvent và setReportEventDataForAutomaticBeacons cần được dùng trong quá trình chuyển hướng, thì bạn phải truyền rõ ràng eventData dưới dạng một phần của 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 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.

Một sơ đồ mô tả cách bên thứ nhất đăng ký nguồn.
Ví dụ về cách hoạt động của tính năng đo lường lượt chuyển đổi với bên thứ ba.

Tại thời điểm đăng ký nguồn, các bước sau 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 sẽ gửi một 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 cần đăng ký.
    2. serving-adtech.example sử dụng tiêu đề Location để thêm một lệnh chuyển hướng đến 3p-measurement.example. Xin lưu ý rằng có thể tiêu đề Location đã được dùng trong các quy trình theo dõi lượt nhấp hiện có để hỗ trợ lệnh chuyển hướng 302 đến bên thứ ba.
  3. Trình duyệt nhận được 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 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 sẽ đưa ra một yêu cầu mới đến 3p-measurement.example.
  5. 3p-measurement.example phản hồi bằng một phản hồi chứa tiêu đề Attribution-Reporting-Register-Source.
  6. Trình duyệt nhận được phản hồi này từ 3p-measurement.example và đọc Attribution-Reporting-Register-Source. Trình duyệt 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 báo cáo muốn đăng ký một 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, bạn có thể liệt kê nhiều trang web làm nguồn phân bổ trong attributionsrc như một 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 được gửi đến URL nhấp qua cũng đủ điều kiện để đăng ký nguồn phân bổ.

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

Đối với tất cả các nguồn nhận được yêu cầu Attribution Reporting API, hãy xác minh rằng máy chủ phản hồi bằng tiêu đề Attribution-Reporting-Register-Source thích hợp. Hãy xem hướng dẫn Đăng ký nguồn và 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 lượt chuyển đổi (mỗi điều kiện kích hoạt một phần tử). Phần tử attributionsrc là phần tử không bắt buộc đối với trigger registration.

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 duy nhất bằng cách sử dụng các 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. Các sự kiện nguồn và sự kiện kích hoạt do cùng một nguồn gốc tạo ra sẽ được so khớp.