Hướng dẫn cho nhà phát triển về phiên đấu giá quảng cáo trên thiết bị để phân phát đối tượng tái tiếp thị và đối tượng tuỳ chỉnh mà không cần theo dõi trên nhiều trang web của bên thứ ba.
Đối với những người mới sử dụng Protected Audience API, hãy đọc Tổng quan về Protected Audience API để có phần giải thích tổng quan về API.
Bài đăng này được viết cho các nhà phát triển như một tài liệu tham khảo kỹ thuật cho lần lặp lại gần đây của Protected Audience API thử nghiệm. Bản minh hoạ về một nội dung cơ bản Triển khai Protected Audience API theo mô hình hiện có Tài liệu tham khảo API cho người mua và người bán quảng cáo.
Trạng thái triển khai
- Đề xuất Protected Audience API hiện đang chuyển sang giai đoạn phát hành rộng rãi. Đặt câu hỏi và theo dõi cuộc thảo luận.
- Trạng thái Protected Audience API của các tính năng đang chờ xử lý nêu chi tiết những thay đổi cũng như tính năng nâng cao đối với Protected Audience API và các tính năng.
- Trạng thái nhấp nháy
- Trạng thái nền tảng Chrome Protected Audience API: Chỉ dành cho Protected Audience API trên Chrome.
- Trạng thái nền tảng Chrome của Ads API: Một tập hợp API để hỗ trợ hoạt động quảng cáo: Protected Audience API, Chủ đề, Khung bảo vệ và Báo cáo phân bổ.
Để nhận thông báo về các thay đổi về trạng thái trong API, hãy tham gia danh sách gửi thư dành cho nhà phát triển.
Protected Audience API là gì?
Protected Audience API là một API Hộp cát về quyền riêng tư được thiết kế để phân phát tái tiếp thị và sử dụng đối tượng tuỳ chỉnh các trường hợp, được thiết kế sao cho bên thứ ba không thể sử dụng để theo dõi người dùng hành vi duyệt web trên các trang web. API này bật phiên đấu giá trên thiết bị bằng cách trình duyệt, để chọn quảng cáo có liên quan cho trang web mà người dùng đã truy cập trước đó.
Protected Audience API là thử nghiệm đầu tiên được triển khai trong Chromium Nhóm đề xuất TURTLEDOVE.
Dùng thử Protected Audience API
Tài liệu tham khảo API có sẵn
Tài liệu này đóng vai trò tổng quan về Protected Audience API. Nếu bạn đang tìm các phương thức và tham số API cụ thể:
- Hướng dẫn người mua dành cho
joinAdInterestGroup()vàgenerateBid(). - Hướng dẫn của người bán về Protected Audience API
runAdAuction() - Hướng dẫn cho người mua về
reportWin()và hướng dẫn của người bán vềreportResult() - Khắc phục sự cố về Protected Audience API
Bạn cũng có thể đọc các phương pháp hay nhất về độ trễ của phiên đấu giá quảng cáo Protected Audience API.
Bản minh hoạ Protected Audience API
Hướng dẫn từng bước triển khai Protected Audience API cơ bản giữa nhà quảng cáo và nhà xuất bản các trang web của bạn tại protected-audience-demo.web.app/.
Kiểm thử API này
Bạn có thể kiểm thử Protected Audience API cho một người dùng trong Chrome Beta 101.0.4951.26 trở lên máy tính:
- Bật mọi API quyền riêng tư trong quảng cáo trong
chrome://settings/adPrivacy. - Đặt cờ từ dòng lệnh. Bạn có thể xem danh sách đầy đủ các cờ Protected Audience API hiện có tại Tìm kiếm mã Chromium.
Hiển thị quảng cáo trong iframe hoặc khung được bảo vệ
Quảng cáo có thể hiển thị trong <iframe> hoặc
<fencedframe>, tuỳ thuộc vào
cờ được đặt.
Cách sử dụng <fencedframe> để hiển thị quảng cáo:
--enable-features=InterestGroupStorage,AdInterestGroupAPI,Fledge,FencedFrames
Cách sử dụng <iframe> để hiển thị quảng cáo:
--enable-features=InterestGroupStorage,AdInterestGroupAPI,Fledge,AllowURNsInIframes --disable-features=FencedFrames
Bao gồm cờ BiddingAndScoringDebugReportingAPI để bật
phương thức báo cáo thắng/thua gỡ lỗi tạm thời.
Tính năng được hỗ trợ
Protected Audience API phía sau cờ tính năng trong Chromium là thử nghiệm đầu tiên nhằm kiểm tra các tính năng sau của Protected Audience API:
- Nhóm mối quan tâm: được trình duyệt lưu trữ, cùng với siêu dữ liệu được liên kết với định cấu hình đặt giá thầu và hiển thị quảng cáo.
- Đặt giá thầu trên thiết bị của người mua (DSP hoặc nhà quảng cáo): dựa trên dữ liệu được lưu trữ các nhóm mối quan tâm và tín hiệu từ người bán.
- Lựa chọn quảng cáo trên thiết bị của người bán (SSP hoặc nhà xuất bản): dựa trên giá thầu trong phiên đấu giá và siêu dữ liệu từ người mua.
- Hiển thị quảng cáo trong phiên bản tạm thời thoải mái của Khung bảo vệ: với cho phép truy cập mạng và ghi nhật ký để hiển thị quảng cáo.
Đọc thêm về việc hỗ trợ tính năng và những hạn chế trong Thông báo giải thích về Protected Audience API.
Quyền cho nhóm đối tượng có cùng mối quan tâm
Tuỳ chọn mặc định cho cách triển khai Protected Audience API hiện tại là cho phép gọi
joinAdInterestGroup()
từ bất kỳ vị trí nào trong trang, thậm chí từ iframe trên nhiều miền.
Trong tương lai, khi chủ sở hữu trang web có thời gian cập nhật trên nhiều miền chính sách về quyền của iframe, là không cho phép cuộc gọi từ iframe giữa nhiều miền.
Dịch vụ khoá-giá trị
Để hỗ trợ phiên đấu giá quảng cáo Protected Audience API, trình duyệt có thể truy cập vào một dịch vụ khoá/giá trị để truy xuất thông tin theo thời gian thực hỗ trợ phiên đấu giá quảng cáo Protected Audience API. Chiến dịch này thông tin có thể được sử dụng theo một số cách:
- Người mua có thể muốn tính toán ngân sách còn lại trong chiến dịch quảng cáo.
- Người bán có thể phải kiểm tra mẫu quảng cáo theo chính sách dành cho nhà xuất bản.
Mã dịch vụ khoá/giá trị Protected Audience API hiện có sẵn. Hãy xem bài đăng về thông báo này trên blog để biết thông tin cập nhật về trạng thái.
Đối với thử nghiệm ban đầu, tính năng "Sử dụng máy chủ riêng" được giới thiệu. Về lâu dài, công nghệ quảng cáo sẽ cần sử dụng dịch vụ Khoá/Giá trị Protected Audience API nguồn mở chạy trong phương thức thực thi đáng tin cậy môi trường xung quanh.
Tham khảo bài đăng trên blog về các dịch vụ Protected Audience API để biết thông tin cập nhật về dòng thời gian. Chúng tôi sẽ cung cấp thông báo quan trọng để nhà phát triển bắt đầu thử nghiệm và áp dụng trước khi chuyển đổi này diễn ra.
Phát hiện tính năng hỗ trợ
Trước khi sử dụng API này, hãy kiểm tra xem API đó có được trình duyệt hỗ trợ và có sẵn trong tài liệu:
'joinAdInterestGroup' in navigator &&
document.featurePolicy.allowsFeature('join-ad-interest-group') &&
document.featurePolicy.allowsFeature('run-ad-auction') ?
console.log('navigator.joinAdInterestGroup() is supported on this page') :
console.log('navigator.joinAdInterestGroup() is not supported on this page');
Protected Audience API hoạt động như thế nào?
Trong ví dụ này, người dùng duyệt xem trang web của một nhà sản xuất xe đạp tuỳ chỉnh, sau đó truy cập một trang web tin tức và nhìn thấy quảng cáo về một chiếc xe đạp mới của nhà sản xuất xe đạp.
Các tính năng của Protected Audience API sẽ được bổ sung theo thời gian trong quá trình triển khai.
1. Người dùng truy cập vào trang web của nhà quảng cáo
Giả sử một người dùng truy cập vào trang web của một nhà sản xuất xe đạp tuỳ chỉnh (nhà quảng cáo) trong ví dụ này) và dành thời gian trên trang sản phẩm cho một loại thép thủ công xe đạp. Điều này mang lại cho nhà sản xuất xe đạp cơ hội tái tiếp thị.
2. Trình duyệt của người dùng được yêu cầu thêm nhóm mối quan tâm
Nền tảng bên cầu (DSP) của nhà quảng cáo (hoặc chính nhà quảng cáo) gọi
navigator.joinAdInterestGroup() để yêu cầu trình duyệt thêm một nhóm mối quan tâm
vào danh sách các nhóm chứa trình duyệt.
Trong ví dụ này, nhóm có tên là custom-bikes và chủ sở hữu là dsp.example. Chủ sở hữu nhóm mối quan tâm (trong trường hợp này là DSP) sẽ là người mua
trong phiên đấu giá quảng cáo Protected Audience API. Thành viên của nhóm đối tượng có cùng mối quan tâm được trình duyệt lưu trữ,
trên thiết bị của người dùng và không được chia sẻ với nhà cung cấp trình duyệt hay bất kỳ ai khác.
- Đọc nội dung giải thích về Protected Audience API: Trình duyệt ghi lại các nhóm đối tượng có cùng mối quan tâm.
- Đọc hướng dẫn về API: người mua và DSP, tìm hiểu cách
joinAdInterestGroup()và tạo giá thầu.
Chỉ định quảng cáo cho nhóm sở thích
Các đối tượng ads và adComponents bao gồm URL của mẫu quảng cáo, và
(không bắt buộc) siêu dữ liệu tuỳ ý có thể dùng khi đặt giá thầu. Ví dụ:
{
renderUrl: 'https://cdn.example/.../bikeAd1.html',
metadata: bikeAd1metadata // optional
}
Người mua đặt giá thầu như thế nào?
generateBid() được gọi cho mỗi nhóm mối quan tâm mà trình duyệt là thành viên
nếu chủ sở hữu của nhóm mối quan tâm được mời đặt giá thầu.
Đọc tài liệu dành cho nhà phát triển generatedBid().
3. Người dùng truy cập vào trang web bán không gian quảng cáo
Sau đó, người dùng truy cập vào trang web bán không gian quảng cáo, trong ví dụ này là tin tức của bạn. Trang web có khoảng không quảng cáo và bán theo hình thức có lập trình đặt giá thầu theo thời gian thực.
4. Một phiên đấu giá quảng cáo sẽ chạy trong trình duyệt
Phiên đấu giá quảng cáo có thể sẽ do nhà cung cấp bên cung của nhà xuất bản tiến hành (SSP) hoặc chính nhà xuất bản. Mục đích của phiên đấu giá là để chọn quảng cáo thích hợp nhất cho một vùng quảng cáo có sẵn trên trang hiện tại. Chiến lược phát hành đĩa đơn phiên đấu giá xem xét các nhóm đối tượng có cùng mối quan tâm mà trình duyệt là thành viên, cùng với dữ liệu từ người mua không gian quảng cáo và người bán từ Dịch vụ khoá/giá trị.
- Đọc giải thích về Protected Audience API: Người bán chạy phiên đấu giá trên thiết bị
- Đọc hướng dẫn về API: người bán có thể tìm hiểu thêm về
runAdAuction()và các phương pháp hay nhất về độ trễ trong phiên đấu giá quảng cáo.
5. Người bán và người mua tham gia yêu cầu dữ liệu theo thời gian thực từ dịch vụ Khoá/Giá trị
Trong phiên đấu giá quảng cáo, người bán có thể yêu cầu dữ liệu theo thời gian thực về một quảng cáo cụ thể
mẫu quảng cáo bằng cách gửi yêu cầu đến dịch vụ Khoá/Giá trị của họ.
Người bán có thể yêu cầu thông tin này trong thời gian
runAdAuction() của thuộc tính trustedScoringSignalsUrl,
cùng với các khoá từ thuộc tính renderUrl của tất cả mục nhập trong ads
và adComponents trường của tất cả nhóm quan tâm trong phiên đấu giá.
Người mua có thể yêu cầu dữ liệu theo thời gian thực từ dịch vụ Khoá/Giá trị của họ bằng cách sử dụng
các thuộc tính trustedBiddingSignalsUrl và trustedBiddingSignalsKeys của
đối số nhóm mối quan tâm được chuyển đến navigator.joinAdInterestGroup().
Khi runAdAuction() được gọi, trình duyệt sẽ tạo một yêu cầu cho mỗi quảng cáo
máy chủ đáng tin cậy của người mua. URL cho yêu cầu có thể có dạng như sau:
https://kv-service.example/getvalues?hostname=publisher.example&keys=key1,key2
- URL cơ sở đến từ
trustedBiddingSignalsUrl. hostnamedo trình duyệt cung cấp.- Giá trị
keysđược lấy từtrustedBiddingSignalsKeys.
Phản hồi cho yêu cầu này là một đối tượng JSON cung cấp các giá trị cho mỗi thuộc tính khoá.
- Đọc tài liệu giải thích về Protected Audience API: Tìm nạp dữ liệu theo thời gian thực từ dịch vụ Khoá/giá trị Protected Audience API.
- Hãy đọc bài viết tìm nguồn mở cho dịch vụ Khoá/giá trị Protected Audience API.
6. Quảng cáo thắng thầu sẽ xuất hiện
Lời hứa do runAdAuction() trả về sẽ phân giải thành đối tượng cấu hình khung được bảo vệ (FencedFrameConfig) khi cờ resolveToConfig được đặt thành true trong cấu hình phiên đấu giá. Cấu hình khung được một khung được bảo vệ sử dụng để điều hướng khung đến quảng cáo giành chiến thắng, nhưng URL của quảng cáo không hiển thị cho trình nhúng khung.
Đối tượng cấu hình khung bảo vệ có từ M114. Để biết thêm thông tin về đối tượng FencedFrameConfig, hãy xem bài viết trên blog của Chrome.
- Đọc tài liệu giải thích về Protected Audience API: các trình duyệt hiển thị quảng cáo thắng cuộc
7. Kết quả phiên đấu giá đã được báo cáo
Kế hoạch dài hạn là để cho phép trình duyệt báo cáo kết quả phiên đấu giá cho người bán và người mua bằng API Tổng hợp riêng tư.
Là một cơ chế báo cáo tạm thời ở cấp sự kiện, đoạn mã triển khai
reportResult() cho người bán và reportWin() cho bên đặt giá thầu giành chiến thắng, có thể
gọi hàm sendReportTo(). Phương thức này sẽ lấy một đối số duy nhất: một chuỗi
đại diện cho một URL được tìm nạp sau khi phiên đấu giá hoàn tất, mã này mã hoá
thông tin cấp sự kiện cần báo cáo.
- Đọc hướng dẫn về API: tìm hiểu về báo cáo người bán và người mua
8. Một lượt nhấp vào quảng cáo được báo cáo
Hệ thống sẽ báo cáo một lượt nhấp vào quảng cáo hiển thị trong khung bảo vệ. Để tìm hiểu thêm về cách hoạt động của tính năng này, hãy xem Báo cáo quảng cáo khung bảo vệ.
Sự khác biệt giữa Protected Audience API và TURTLEDOVE là gì?
Protected Audience API là thử nghiệm đầu tiên được triển khai trong Chromium Nhóm đề xuất TURTLEDOVE.
Protected Audience API tuân thủ các nguyên tắc cấp cao của TURTLEDOVE. Một số quảng cáo trực tuyến có dựa trên việc hiển thị quảng cáo cho một người có thể quan tâm đến đã tương tác trước đó với nhà quảng cáo hoặc mạng quảng cáo. Trước đây, việc này hoạt động do nhà quảng cáo nhận ra một người cụ thể khi họ duyệt qua các trang web, một vấn đề cốt lõi về quyền riêng tư của web ngày nay.
Nỗ lực của TURTLEDOVE nhằm cung cấp một API mới để giải quyết trường hợp sử dụng này đồng thời cung cấp một số tiến bộ quan trọng về quyền riêng tư:
- Trình duyệt, không phải nhà quảng cáo, giữ thông tin về những gì nhà quảng cáo nghĩ rằng một người quan tâm đến.
- Nhà quảng cáo có thể phân phát quảng cáo dựa trên sở thích, nhưng không thể kết hợp sở thích đó sự quan tâm đến thông tin khác về một người, cụ thể là người mà họ quan tâm hoặc trang nào họ đang truy cập.
Protected Audience API phát triển từ TURTLEDOVE và một tập hợp các đề xuất có liên quan cho các sửa đổi để phục vụ tốt hơn cho những nhà phát triển sẽ sử dụng API:
- Trong SPARROW: Criteo đã đề xuất việc thêm của mô hình dịch vụ ("Gatekeeper") chạy trong môi trường thực thi đáng tin cậy (TEE). Protected Audience API sử dụng các TEE hạn chế nhiều hơn để tra cứu dữ liệu theo thời gian thực và báo cáo tổng hợp.
- TERN của NextRoll và PARRROT của Magnite đề xuất mô tả vai trò khác nhau của người mua và người bán trong phiên đấu giá trên thiết bị. Quy trình tính điểm/đặt giá thầu quảng cáo của Protected Audience API dựa trên hoạt động này.
- Dựa trên kết quả của RTB House và Cấp sản phẩm Các nội dung sửa đổi TURTLEDOVE giúp cải thiện mô hình ẩn danh và hoạt động cá nhân hoá khả năng của phiên đấu giá trên thiết bị
- PARAKEET là Đề xuất của Microsoft về một dịch vụ quảng cáo giống TURTLEDOVE dựa vào proxy máy chủ đang chạy trong TEE giữa trình duyệt và nhà cung cấp công nghệ quảng cáo để ẩn danh yêu cầu quảng cáo và thực thi quyền riêng tư các thuộc tính. Protected Audience API chưa áp dụng mô hình proxy này. Chúng tôi mang đến các API JavaScript dành cho paraKEET và Protected Audience API phù hợp với nhau, nhằm hỗ trợ công việc trong tương lai để kết hợp thêm các đặc điểm tốt nhất của cả hai đề xuất.
Protected Audience API chưa ngăn mạng quảng cáo của trang web tìm hiểu những quảng cáo mà một người nhìn thấy. Chúng tôi dự kiến sẽ sửa đổi để API trở nên riêng tư hơn theo thời gian.
Có thể sử dụng Topics API với Protected Audience API không?
Có. Một chủ đề đã ghi nhận được cho người dùng hiện tại (do Topics API cung cấp) có thể được dùng làm thông tin theo bối cảnh của người bán hoặc bên đặt giá thầu. Có thể bao gồm một chủ đề trong các thuộc tính sau:
auctionSignals, thuộc tính của đối tượng cấu hình đấu giá được truyền đếnnavigator.runAdAuction()userBiddingSignals, một thuộc tính của cấu hình nhóm mối quan tâm đã truyền đối tượng đếnnavigator.joinAdInterestGroup()
Cấu hình trình duyệt hiện có
Người dùng có thể điều chỉnh việc họ tham gia dùng thử Hộp cát về quyền riêng tư trong Chrome bằng cách
bật hoặc tắt cài đặt cấp cao nhất trong
chrome://settings/adPrivacy.
Trong quá trình thử nghiệm ban đầu, mọi người sẽ có thể sử dụng Quyền riêng tư cấp cao này Chế độ cài đặt hộp cát để chọn không sử dụng Protected Audience API. Chrome dự định cho phép người dùng xem và quản lý danh sách các nhóm mối quan tâm mà họ đã được thêm vào trên web các trang web mà họ đã truy cập. Cũng như với công nghệ Hộp cát về quyền riêng tư, chế độ cài đặt của người dùng có thể phát triển dựa trên ý kiến phản hồi của người dùng, cơ quan quản lý và những bên khác.
Chúng tôi sẽ tiếp tục cập nhật các chế độ cài đặt hiện có trong Chrome dựa trên các thử nghiệm và ý kiến phản hồi. Trong tương lai, chúng tôi dự định cung cấp các chế độ cài đặt chi tiết hơn để quản lý Protected Audience API và dữ liệu liên quan.
Người gọi API không thể truy cập vào tư cách thành viên nhóm khi người dùng duyệt web ở Chế độ ẩn danh, và tư cách thành viên sẽ bị xoá khi người dùng xoá dữ liệu trang web của họ.
Các công việc của Protected Audience có được trình duyệt lưu vào bộ nhớ đệm không?
Các tài nguyên chứa các công việc của Protected Audience (công việc tạo giá thầu và báo cáo của người mua, cũng như các công việc báo cáo và tính điểm quảng cáo của người bán) được trình duyệt lưu vào bộ nhớ đệm. Bạn có thể sử dụng tiêu đề Cache-Control để kiểm soát hoạt động lưu vào bộ nhớ đệm.
Thu hút và chia sẻ ý kiến phản hồi
Yêu cầu hỗ trợ
Để đặt câu hỏi và được hỗ trợ về việc triển khai, bản minh hoạ hoặc tài liệu:
- GitHub: Đọc giải thích, đặt câu hỏi và theo dõi nội dung thảo luận.
- Bản minh hoạ: Đưa ra vấn đề về kho lưu trữ mã minh hoạ.
- Hỗ trợ nhà phát triển: Đặt câu hỏi và tham gia thảo luận trên Hỗ trợ nhà phát triển Hộp cát về quyền riêng tư kho lưu trữ. Chọn mẫu vấn đề cho Protected Audience API.
- Triển khai Chrome: đối với các lỗi hoặc sự cố xảy ra với việc triển khai của Chrome Protected Audience API, bạn có thể xem các vấn đề hiện có hoặc nêu ra vấn đề mới.
Nếu bạn có thêm câu hỏi chung về việc đáp ứng nhu cầu của mình bằng Protected Audience API, báo cáo vấn đề về kho lưu trữ API. Bạn cũng có thể thảo luận về các trường hợp sử dụng trong ngành trong Cải thiện Nhóm doanh nghiệp quảng cáo trên web.
Sử dụng biểu mẫu phản hồi Hộp cát về quyền riêng tư để chia sẻ phản hồi riêng tư với nhóm Chrome bên ngoài các diễn đàn công khai.
Chọn không sử dụng
Bạn muốn chọn không sử dụng Protected Audience API? Tìm hiểu cách chặn quyền truy cập vào Protected Audience API, với tư cách là chủ sở hữu trang web hoặc người dùng cá nhân.
Nhận thông báo cập nhật
- Để nhận được thông báo về việc thay đổi trạng thái API, hãy tham gia danh sách gửi thư cho nhà phát triển.
- Để theo dõi chặt chẽ tất cả các cuộc thảo luận đang diễn ra về API này, hãy nhấp vào nút Xem trên trang API trên GitHub. Để thực hiện việc này, bạn cần có hoặc tạo một kho lưu trữ GitHub tài khoản.
- Để nhận thông tin cập nhật tổng thể về Hộp cát về quyền riêng tư, hãy đăng ký nhận nguồn cấp dữ liệu RSS [Tiến trình trong Hộp cát về quyền riêng tư].
- Tham gia các lệnh gọi theo lịch cho Protected Audience API (mỗi tuần thứ hai). Tất cả mọi người đều có thể tham gia, thì trước tiên, hãy nhớ tham gia WICG. Bạn có thể tích cực tham gia hoặc chỉ lắng nghe!