Tổng quan cấp cao về các dịch vụ được kết nối cho Báo cáo phân bổ, dành cho người ra quyết định về mặt kỹ thuật.
Attribution Reporting API cho phép các công nghệ quảng cáo và nhà quảng cáo đo lường thời điểm lượt nhấp hoặc lượt xem quảng cáo dẫn đến một lượt chuyển đổi, chẳng hạn như mua hàng. API này dựa trên kết hợp phía máy khách và phía máy chủ, tuỳ thuộc vào nhu cầu kinh doanh của họ.
Trước khi tiếp tục, hãy nhớ đọc hướng dẫn Tổng quan về Báo cáo phân bổ. Việc này sẽ giúp bạn nắm được mục đích của API và quy trình của các báo cáo đầu ra khác nhau (báo cáo ở cấp sự kiện và báo cáo tóm tắt). Nếu bạn gặp những thuật ngữ lạ, hãy tham khảo Bảng chú giải thuật ngữ Hộp cát về quyền riêng tư.
Bài viết này dành cho đối tượng nào?
Bạn nên đọc bài viết này nếu:
- Bạn là người đưa ra quyết định về mặt kỹ thuật hoặc của nhà quảng cáo trong lĩnh vực công nghệ quảng cáo. Bạn có thể làm việc trong các lĩnh vực vận hành, vận hành nhà phát triển, khoa học dữ liệu, CNTT, tiếp thị hoặc một vai trò khác mà bạn đưa ra các quyết định triển khai kỹ thuật. Bạn thắc mắc cách các API hoạt động cho việc đo lường bảo đảm quyền riêng tư.
- Bạn là chuyên viên kỹ thuật (chẳng hạn như nhà phát triển, nhà vận hành hệ thống, kiến trúc sư hệ thống hoặc nhà khoa học dữ liệu) sẽ thiết lập các thử nghiệm với API này và môi trường Dịch vụ tổng hợp.
Trong bài viết này, bạn sẽ đọc phần giải thích toàn diện về cách đều hoạt động với Attribution Reporting API. Nếu bạn là chuyên viên kỹ thuật bạn có thể thử nghiệm với API này cục bộ.
Tổng quan
Attribution Reporting API bao gồm nhiều dịch vụ yêu cầu các dịch vụ cụ thể thiết lập, định cấu hình phía máy khách và triển khai máy chủ. Để xác định điều gì mà bạn cần, trước tiên:
- Đưa ra quyết định về thiết kế. Xác định thông tin bạn muốn thu thập, xác định những lượt chuyển đổi mà bạn mong đợi từ một chiến dịch nhất định và xác định loại báo cáo cần thu thập. Kết quả cuối cùng là một hoặc cả hai loại báo cáo: báo cáo cấp sự kiện và báo cáo tóm tắt.
Luôn có hai (và đôi khi là ba) thành phần hoạt động cùng nhau để hỗ trợ báo cáo:
- Giao tiếp giữa trang web với trình duyệt. Trong
hệ thống dựa trên cookie, thông tin cho các lượt chuyển đổi và lượt tương tác với quảng cáo sẽ được
được đính kèm với mã nhận dạng để cho phép bạn hoặc một dịch vụ phân tích tham gia
các sự kiện này sau đó. Với API này, trình duyệt liên kết lượt chuyển đổi với
số lượt nhấp/lượt xem quảng cáo, dựa trên hướng dẫn của bạn, trước khi quảng cáo được phân phối cho
bản phân tích. Do đó, mã hiển thị quảng cáo và tính năng theo dõi lượt chuyển đổi của bạn phải:
- Cho trình duyệt biết lượt chuyển đổi nào sẽ được phân bổ cho quảng cáo nào số nhấp chuột hoặc số lần hiển thị.
- Tín hiệu mọi dữ liệu khác để đưa vào báo cáo cuối cùng.
- Thu thập dữ liệu. Bạn cần có một điểm cuối của trình thu thập để nhận các báo cáo, được tạo trong trình duyệt. Kết quả từ trình duyệt có thể là một trong hai báo cáo phù hợp: báo cáo cấp sự kiện và báo cáo tổng hợp báo cáo (được mã hoá, dùng để tạo báo cáo tóm tắt).
Nếu đã thu thập các báo cáo tổng hợp, bạn sẽ cần một thành phần thứ ba:
- Tạo báo cáo tóm tắt. Lô các báo cáo tổng hợp và sử dụng Dịch vụ tổng hợp để xử lý các báo cáo để tạo báo cáo tóm tắt.
Quyết định thiết kế
Nguyên tắc chính của Báo cáo phân bổ là quyết định thiết kế sớm. Bạn quyết định dữ liệu nào cần thu thập trong các danh mục và tần suất xử lý dữ liệu đó . Các báo cáo đầu ra cung cấp thông tin chi tiết về chiến dịch hoặc doanh nghiệp của bạn.
Báo cáo đầu ra có thể là:
- Báo cáo ở cấp sự kiện liên kết một lượt nhấp hoặc chế độ xem quảng cáo cụ thể (ở phía quảng cáo) với dữ liệu ở phía lượt chuyển đổi. Để bảo vệ quyền riêng tư của người dùng bằng cách hạn chế việc kết hợp danh tính người dùng trên các trang web, dữ liệu bên chuyển đổi rất hạn chế và dữ liệu bị nhiễu (tức là trong một số ít trường hợp, dữ liệu ngẫu nhiên được gửi thay vì báo cáo thực).
- Báo cáo tóm tắt không gắn liền với một sự kiện cụ thể ở phía quảng cáo. Những báo cáo này cung cấp dữ liệu lượt chuyển đổi chi tiết hơn và tính linh hoạt để kết hợp dữ liệu lượt nhấp và lượt xem với dữ liệu lượt chuyển đổi.
Lựa chọn báo cáo của bạn xác định dữ liệu bạn cần thu thập.
Bạn cũng có thể coi kết quả cuối cùng là dữ liệu đầu vào cho các công cụ mà bạn sử dụng để đưa ra quyết định. Ví dụ: nếu bạn tạo báo cáo tóm tắt để xác định cách nhiều lượt chuyển đổi dẫn đến tổng giá trị chi tiêu, điều này có thể giúp nhóm của bạn quyết định chiến dịch quảng cáo tiếp theo của bạn nên nhắm đến điều gì để tạo ra tổng mức chi tiêu cao hơn.
Sau khi quyết định chỉ số cần đo lường, bạn có thể thiết lập phía máy khách cho Attribution Reporting API.
Hoạt động giao tiếp giữa các trang web với trình duyệt
![Các nguồn phân bổ trên trang web của nhà xuất bản kết nối với trình kích hoạt trên trang web của nhà quảng cáo.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/attribution-sources-a-pu-b04d5ed143672.png?authuser=9&hl=vi)
Quy trình của sự kiện phân bổ
Hãy tưởng tượng một trang web của nhà xuất bản hiển thị quảng cáo. Mỗi nhà quảng cáo hoặc nhà cung cấp công nghệ quảng cáo đều muốn tìm hiểu về các lượt tương tác với quảng cáo của họ và phân bổ lượt chuyển đổi cho đúng quảng cáo. Các báo cáo (cả cấp sự kiện và tổng hợp) sẽ được tạo như sau:
Trên trang web của nhà xuất bản, một phần tử quảng cáo (thẻ
<a>
hoặc<img>
) được định cấu hình bằng thuộc tính đặc biệtattributionsrc
. Giá trị của thuộc tính này là một URL, ví dụ:https://adtech.example/register-source/ad_id=...
.Dưới đây là ví dụ về đường liên kết sẽ đăng ký nguồn sau khi được nhấp vào:
<a href="https://shoes.example/landing" attributionsrc="http://adtech.example/register-source?..." target="_blank"> Click me</a>
Sau đây là ví dụ về một hình ảnh sẽ dẫn đến việc đăng ký nguồn khi được xem:
<img href="https://advertiser.example/landing" attributionsrc="https://adtech.example/register-source?..."/>
Ngoài ra, thay vì các phần tử HTML, bạn có thể sử dụng lệnh gọi JavaScript.
Dưới đây là ví dụ về JavaScript sử dụng
window.open()
. Xin lưu ý rằng URL này được mã hoá bằng URL để tránh các vấn đề với ký tự đặc biệt.const encodedUrl = encodeURIComponent( 'https://adtech.example/attribution_source?ad_id=...'); window.open( "https://shoes.example/landing", "_blank", attributionsrc=${encodedUrl});
- Khi người dùng nhấp hoặc xem quảng cáo, trình duyệt sẽ gửi yêu cầu
GET
đếnattributionsrc
– thường là điểm cuối của nhà quảng cáo hoặc nhà cung cấp công nghệ quảng cáo. Sau khi nhận được yêu cầu này, nhà quảng cáo hoặc nhà cung cấp công nghệ quảng cáo quyết định hướng dẫn trình duyệt đăng ký sự kiện nguồn cho các lượt tương tác với quảng cáo để lượt chuyển đổi sau đó có thể được phân bổ cho quảng cáo này. Để làm như vậy, nhà quảng cáo hoặc nhà cung cấp công nghệ quảng cáo phải đưa một tiêu đề HTTP đặc biệt vào phản hồi. Nó đính kèm vào dữ liệu tuỳ chỉnh của tiêu đề này, vốn cung cấp thông tin về sự kiện nguồn (lượt nhấp hoặc lượt xem quảng cáo). Nếu một lượt chuyển đổi diễn ra cho quảng cáo này, thì dữ liệu tuỳ chỉnh này sẽ xuất hiện trong báo cáo phân bổ.
Sau đó, người dùng này truy cập vào trang web của nhà quảng cáo.
Trên mỗi trang liên quan trên trang web của nhà quảng cáo (ví dụ: trang xác nhận mua hàng hoặc trang sản phẩm), một pixel chuyển đổi (phần tử
<img>
) hoặc lệnh gọi JavaScript sẽ gửi yêu cầu đếnhttps://adtech.example/conversion?param1=...¶m2=...
.Dịch vụ tại URL này (thường là nhà quảng cáo hoặc nhà cung cấp công nghệ quảng cáo) sẽ nhận được yêu cầu. Phương pháp này quyết định phân loại đây là lượt chuyển đổi, vì vậy, tính năng này cần hướng dẫn trình duyệt ghi lại lượt chuyển đổi, tức là kích hoạt một lượt phân bổ. Để làm như vậy, nhà quảng cáo hoặc nhà cung cấp công nghệ quảng cáo phải đưa vào phản hồi của mình đối với pixel yêu cầu một tiêu đề HTTP đặc biệt bao gồm dữ liệu tuỳ chỉnh về lượt chuyển đổi.
Trình duyệt (trên thiết bị cục bộ của người dùng) sẽ nhận được phản hồi này và so khớp dữ liệu lượt chuyển đổi với sự kiện nguồn ban đầu (lượt xem hoặc lượt nhấp vào quảng cáo). Tìm hiểu thêm trong bài viết So khớp nguồn với điều kiện kích hoạt
Trình duyệt lên lịch gửi báo cáo cho
attributionsrc
. Báo cáo này bao gồm:- Dữ liệu về cấu hình phân bổ tuỳ chỉnh mà nhà cung cấp công nghệ quảng cáo hoặc nhà quảng cáo đã đính kèm vào sự kiện nguồn ở Bước 3.
- Tập dữ liệu lượt chuyển đổi tuỳ chỉnh ở Bước 6.
Sau đó, trình duyệt sẽ gửi các báo cáo đến điểm cuối được xác định trong
attributionsrc
, kèm theo độ trễ và độ nhiễu. Báo cáo tổng hợp được mã hoá, còn báo cáo cấp sự kiện thì không.
Điều kiện kích hoạt phân bổ (trang web của nhà quảng cáo)
Trình kích hoạt phân bổ là sự kiện yêu cầu trình duyệt ghi nhận các lượt chuyển đổi.
Bạn nên thu thập các lượt chuyển đổi quan trọng nhất đối với của nhà quảng cáo, chẳng hạn như mua hàng. Có thể có nhiều loại chuyển đổi và siêu dữ liệu được thu thập trong báo cáo tóm tắt.
Điều này đảm bảo kết quả tổng hợp là chi tiết và chính xác cho các sự kiện này.
So khớp nguồn với điều kiện kích hoạt
Khi trình duyệt nhận được phản hồi của điều kiện kích hoạt phân bổ, trình duyệt sẽ truy cập bộ nhớ cục bộ để tìm một nguồn khớp với cả và URL của trang đó eTLD+1.
Ví dụ: khi trình duyệt nhận được điều kiện kích hoạt phân bổ từ
adtech.example
trên shoes.example/shoes123
, trình duyệt sẽ tìm nguồn trong
cục bộ khớp với cả adtech.example
và shoes.example
.
Bạn có thể đặt Bộ lọc (hoặc quy tắc tuỳ chỉnh) để xác định thời điểm so khớp một điều kiện kích hoạt đến một nguồn cụ thể. Ví dụ: đặt một bộ lọc để chỉ tính các lượt chuyển đổi cho danh mục sản phẩm cụ thể và bỏ qua tất cả các danh mục khác. Bộ lọc và mô hình ưu tiên cho phép báo cáo phân bổ nâng cao hơn.
Nếu tìm thấy nhiều nguồn phân bổ trong bộ nhớ cục bộ, trình duyệt sẽ chọn tệp được lưu trữ gần đây nhất. Trong một số trường hợp, nguồn phân bổ được gán mức độ ưu tiên, thì trình duyệt sẽ chọn nguồn có mức độ ưu tiên cao nhất mức độ ưu tiên.
Thu thập dữ liệu
Một điều kiện kích hoạt phân bổ khớp với một nguồn tương ứng sẽ được gửi dưới dạng một báo cáo của trình duyệt cho một điểm cuối báo cáo trên máy chủ do công nghệ quảng cáo sở hữu (đôi khi được gọi là điểm cuối thu thập hoặc dịch vụ thu thập). Các có thể là báo cáo cấp sự kiện hoặc báo cáo tổng hợp.
Báo cáo tổng hợp được dùng để tạo các báo cáo tóm tắt. Báo cáo tổng hợp là một tổ hợp dữ liệu được thu thập từ quảng cáo (trên trang web của nhà xuất bản) và dữ liệu chuyển đổi (từ trang web của nhà quảng cáo) do trình duyệt tạo và mã hoá trên thiết bị của người dùng trước khi công nghệ quảng cáo thu thập thông tin đó.
Các báo cáo ở cấp sự kiện sẽ bị trễ từ 2 đến 30 ngày. Các báo cáo tổng hợp là được gửi với độ trễ ngẫu nhiên trong vòng một giờ và sự kiện phải nằm trong phạm vi ngân sách đóng góp. Những lựa chọn này giúp bảo vệ quyền riêng tư và ngăn chặn hành vi lợi dụng bất kỳ hành động nào của người dùng.
Nếu bạn chỉ quan tâm đến báo cáo cấp sự kiện, đây là phần cuối cùng cơ sở hạ tầng mình cần. Tuy nhiên, nếu muốn tạo báo cáo tóm tắt, bạn sẽ phải xử lý các báo cáo tổng hợp bằng một dịch vụ bổ sung.
Tạo báo cáo tóm tắt
Để tạo báo cáo tóm tắt, bạn sẽ sử dụng Dịch vụ tổng hợp (do công nghệ quảng cáo điều hành) để xử lý các báo cáo tổng hợp. Tổng hợp Dịch vụ sẽ tăng độ nhiễu để bảo vệ quyền riêng tư của người dùng và trả về báo cáo tóm tắt cuối cùng.
![Các báo cáo tổng hợp được thu thập, phân theo lô và gửi đến môi trường công nghệ quảng cáo.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/aggregatable-reports-are-a0830fd543e6f.png?authuser=9&hl=vi)
Sau khi phân lô các báo cáo tổng hợp đã thu thập, lô sẽ được xử lý thông qua Dịch vụ tổng hợp. Đáp điều phối viên chỉ cung cấp khoá giải mã cho các phiên bản đã được chứng thực của công cụ Tổng hợp Dịch vụ. Sau đó, Dịch vụ tổng hợp sẽ giải mã dữ liệu, tổng hợp và gây nhiễu trước khi trả về kết quả dưới dạng báo cáo tóm tắt.
Các báo cáo tổng hợp theo lô
Các báo cáo tổng hợp phải được xử lý theo lô. Một lô bao gồm các báo cáo tổng hợp được nhóm theo chiến lược. Chiến lược của bạn sẽ mang lại nhiều lợi ích nhất có thể phản ánh một khoảng thời gian cụ thể (chẳng hạn như hằng ngày hoặc hằng tuần). Chiến dịch này có thể diễn ra trên cùng một máy chủ đóng vai trò là điểm cuối báo cáo của bạn.
Các lô phải chứa nhiều báo cáo để đảm bảo tỷ lệ tín hiệu so với độ nhiễu cao.
![Khoảng thời gian lớn hơn giúp giảm độ nhiễu.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/larger-periods-lead-les-4d4edffb3d2d6.png?authuser=9&hl=vi)
Khoảng thời gian của lô có thể thay đổi bất cứ lúc nào để đảm bảo bạn nắm bắt được các sự kiện cụ thể nơi bạn mong đợi số lượng lớn hơn, chẳng hạn như giảm giá hằng năm. Giai đoạn phân lô có thể thay đổi mà không cần thay đổi nguồn phân bổ hoặc trình kích hoạt.
Dịch vụ tổng hợp
Dịch vụ tổng hợp chịu trách nhiệm xử lý các báo cáo tổng hợp để tạo một báo cáo tóm tắt. Các báo cáo tổng hợp đã được mã hoá và chỉ có thể là được đọc bằng Dịch vụ tổng hợp. Dịch vụ này chạy trên một môi trường thực thi đáng tin cậy (TEE).
Dịch vụ tổng hợp yêu cầu khoá giải mã từ trình điều phối để giải mã và tổng hợp dữ liệu. Sau khi giải mã và tổng hợp, kết quả được nhiễu để bảo vệ quyền riêng tư và được trả về dưới dạng báo cáo tóm tắt.
Chuyên viên có thể tạo báo cáo văn bản thô tổng hợp để kiểm thử Dịch vụ tổng hợp trên thiết bị. Hoặc bạn có thể kiểm thử bằng các báo cáo đã mã hoá trên AWS với Nitro Enclaves.
Tiếp theo là gì?
Chúng tôi muốn trao đổi với bạn để đảm bảo rằng chúng tôi xây dựng một API phù hợp với tất cả mọi người.
Thảo luận về API
Giống như các API Hộp cát về quyền riêng tư khác, API này được ghi chép và được thảo luận công khai.
Thử nghiệm với API
Bạn có thể thử nghiệm và tham gia trao đổi về Attribution Reporting API.