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ể 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át 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 tình huống đo lường lượt chuyển đổi phổ biến. Tuy nhiên, 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, nhà xuất bản 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 này có thể bao gồm bên chịu trách nhiệm cung cấp mã đánh dấu cho mẫu quảng cáo, 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à bên cung cấp SDK hoặc thẻ cho vị trí quảng cáo trên trang của nhà xuất bản. Các 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 để đả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 để 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 đượ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ợ các trường hợp sử dụng này. 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á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 báo cáo riêng biệt từ API. Ví dụ: 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 hai tình huống 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

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 và công nghệ quảng cáo lưu trữ mẫu quảng cáo 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 với 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). Những nền tảng này 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 mình 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 sự kiện 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 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 đảm bảo rằng chúng đã được đăng ký và máy chủ của chúng đã sẵn sàng nhận và phản hồi các yêu cầu của API Báo cáo phân bổ.

Cấu hình chiến dịch thông thường 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 nhấp và lượt hiển thị 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ó trong mã đánh dấu mẫu quảng cáo.

  2. DSP cung cấp các tính năng để thêm các 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ó trong mã đánh dấu mẫu quảng cáo cuối cùng mà họ đang đặt giá thầu.

Tình huống 2: Chỉ nhà cung cấp dịch vụ đo lường bên thứ ba mới cần nhận báo cáo từ API Báo cáo phân bổ

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 về việc đo lường phân bổ. Điều này thường xảy ra với các 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ó kế hoạch tự sử dụng báo cáo phân bổ, nhưng muốn bật API Báo cáo phân bổ 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 của 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à đảm bảo lệnh chuyển hướng hoạt động như dự kiến. Điều này phụ thuộc nhiều vào cách 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 sự kiện hiển thị, thông thường, đây là nhà cung cấp dịch vụ đo lường bên thứ ba.

Trong ví dụ về cách 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 đảm bảo thuộc tính attributionsrc do DSP cung cấp được đưa vào trang của nhà xuất bản.

Thông tin chi tiết về cách 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, thường thì bên 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 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 tính năng Báo cáo phân bổ cho nguồn gốc của bên thứ ba Tính năng 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ó bằng 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, 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 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 bên thứ ba mà nhà quảng cáo sử dụng

Xin lưu ý rằng thông tin chi tiết về 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 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ổ đượ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 gửi các yêu cầu Attribution Reporting API. 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ó. Bạn có thể để trống hoặc không để trống attributionsrc.

Đối với các sự kiện nhấp 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 đều không cần thêm thuộc tính attributionsrc và sẽ đủ điều kiện để sử dụng 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ẻ neo (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 của 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 nhấp qua có thể nhận và phản hồi các yêu cầu của 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ẻ 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 của lượt nhấp cũng đủ điều kiện để đăng ký nguồn.

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

  • Sự kiện nhấp chuột:
    • Pháp nhân 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 vào các thẻ neo có sự kiện nhấp.
    • 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ị:
    • Pháp nhân 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 Fetch API phải bao gồm đố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ề những nội dung sửa đổi cần thiết cho 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á Protected Audience

Để đ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 để bật tính năng đăng ký nguồn phân bổ.

Để báo cáo tín hiệu Protected Audience, hàm registerAdBeacon có sẵn bên trong các worklet báo cáo và registerAdMacro có sẵn bên trong worklet báo cáo 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 các beacon và macro đã đăng ký bằng các hàm reportEvent và setReportEventDataForAutomaticBeacons của Fenced Frame Ads Reporting API (API Báo cáo quảng cáo trong khung được phân vùng). Điều này cho phép các tín hiệu của công cụ báo cáo Protected Audience 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 beacon và macro được kích hoạt bằng lệnh gọi reportEvent từ một khung hoặ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ý nguồn phân bổ. Các yêu cầu beacon có thể được chuyển hướng để cho 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 phần giải thích về API Báo cáo quảng cáo trong khung hình có hàng rào.

Bật tính năng báo cáo phân bổ cho đị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 đó phải được coi là sự kiện nguồn tiềm năng đủ điều kiện để đăng ký bằng Attribution Reporting API. Tài liệu bổ sung về VAST để hỗ trợ báo cáo phân bổ trình bày chi tiết về vấn đề này. Tóm lại, tất 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ả các phương thức triển khai VAST đều phải cung cấp thông tin về đ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 đó 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 chứa các ví dụ cho từng trường hợp.

Để đảm bảo phạm vi áp dụng tối đa, việc triển khai VAST phải đảm bảo tất 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 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) để 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 tính năng Báo cáo phân bổ cho 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 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, vì vậy, 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 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ý với Attribution Reporting API nếu mục tiêu lượt 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 của yêu cầu ban đầu sẽ không được gửi khi chuyển hướng. Đối với phiên đấu giá Protected Audience, nếu eventData được truyền vào reportEvent và setReportEventDataForAutomaticBeacons cần được sử dụng trong lệnh chuyển hướng, thì bạn phải truyền rõ ràng eventData 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 bên thứ ba (3p-measurement.example) làm hai thực thể riêng biệt muốn 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 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 cần đăng ký.
    2. serving-adtech.example sử dụng tiêu đề Location để đưa lệnh chuyển hướng đến 3p-measurement.example. Xin lưu ý rằng tiêu đề Location có thể đã được sử dụng trong các luồng theo dõi lượt nhấp hiện tại của bạn để hỗ trợ lệnh chuyển hướng 302 đến một 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 báo cáo.
  4. Vì yêu cầu này là một yêu cầu 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 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 báo cáo.

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

Nếu nhiều nguồn gốc của trình 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 gì, thì bạn có thể liệt kê nhiều trang web làm nguồn phân bổ trong attributionsrc dưới dạng 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 cho 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 phản hồi cho các yêu cầu Attribution Reporting API

Đối với tất cả các 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. Hãy xem hướng dẫn Đăng ký nguồn và nội dung 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ột phần tử cho mỗi điều kiện kích hoạt). Phần tử attributionsrc là phần tử không bắt buộc đối với lượt đă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 kích hoạt do cùng một nguồn gốc tạo ra sẽ được so khớp.