Tổng quan về Protected Audience API

Phiên đấu giá quảng cáo trên thiết bị để phân phát quảng cáo tái tiếp thị và quảng cáo nhắm đến đối tượng tuỳ chỉnh mà không cần theo dõi bên thứ ba trên nhiều trang web.

Tài liệu này dành cho ai?

Tài liệu này trình bày những thông tin cơ bản về Protected Audience API và giải thích một số khái niệm cơ bản, nhưng không đi sâu vào chi tiết kỹ thuật.

Hãy tham khảo bảng chú giải thuật ngữ để biết các thuật ngữ được dùng trong tài liệu về Đối tượng được bảo vệ. Ở cuối tài liệu này, bạn có thể tìm hiểu cách tương tác và chia sẻ ý kiến phản hồi.

Protected Audience API là gì?

Protected Audience API là một công nghệ Hộp cát về quyền riêng tư để phân phát các trường hợp sử dụng có đối tượng tuỳ chỉnh và hoạt động tái tiếp thị, được thiết kế sao cho các bên thứ ba không thể theo dõi hành vi duyệt web của người dùng trên các trang web.

Protected Audience API cho phép trình duyệt tổ chức các phiên đấu giá trên thiết bị để chọn quảng cáo phù hợp từ những 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 trong nhóm đề xuất TURTLEDOVE. Sự khác biệt giữa Protected Audience và TURTLEDOVE chủ yếu liên quan đến việc tách riêng vai trò trên thiết bị của người mua và người bán quảng cáo. Các phần sau đây giải thích cách hoạt động của Protected Audience API.

Protected Audience API trong một phút

Để biết thông tin tổng quan chi tiết hơn về Protected Audience API, hãy đọc hướng dẫn cho nhà phát triển về Protected Audience API.

Thông tin tổng quan về từng giai đoạn trong vòng đời của Protected Audience API
Vòng đời của Protected Audience API.

Protected Audience API sử dụng nhóm mối quan tâm để cho phép các trang web hiển thị quảng cáo phù hợp với người dùng.

Ví dụ: khi người dùng truy cập vào một trang web muốn quảng cáo sản phẩm của mình, chủ sở hữu nhóm đối tượng có cùng mối quan tâm (chẳng hạn như nền tảng bên cầu (DSP)) có thể yêu cầu trình duyệt của người dùng bổ sung tư cách thành viên cho nhóm đối tượng có cùng mối quan tâm đó. Nếu yêu cầu thành công, trình duyệt sẽ ghi lại:

  • Tên của nhóm đối tượng có cùng mối quan tâm: ví dụ: "xe đạp tuỳ chỉnh".
  • Chủ sở hữu của nhóm đối tượng có cùng mối quan tâm: ví dụ: "https://dsp.example".
  • Thông tin cấu hình của nhóm lợi ích để cho phép trình duyệt truy cập vào mã đặt giá thầu, mã quảng cáo và dữ liệu theo thời gian thực, nếu chủ sở hữu nhóm được mời đặt giá thầu trong một phiên đấu giá quảng cáo.

Sau đó, khi người dùng truy cập vào một trang web có không gian quảng cáo, bên bán không gian quảng cáo (nhà cung cấp bên bán (SSP) hoặc chính trang web đó) có thể sử dụng Protected Audience để chạy phiên đấu giá quảng cáo nhằm chọn quảng cáo phù hợp nhất để hiển thị cho người dùng. Người bán gọi hàm navigator.runAdAuction(). Hàm này cung cấp danh sách những chủ sở hữu nhóm đối tượng có cùng mối quan tâm được mời đặt giá thầu.

Chỉ những nhóm lợi ích mà trình duyệt là thành viên mới có thể cung cấp giá thầu và chủ sở hữu của những nhóm này đã được mời đặt giá thầu.

Mã đặt giá thầu được truy xuất từ một URL có trong cấu hình của nhóm lợi ích. Mã này cung cấp dữ liệu về nhóm đối tượng có cùng mối quan tâm và thông tin từ người bán, cùng với dữ liệu theo bối cảnh về trang và từ trình duyệt.

Mỗi nhóm lợi ích cung cấp giá thầu được gọi là người mua.

Khi trình duyệt gọi hàm để chạy phiên đấu giá quảng cáo, mã của mỗi người mua sẽ tạo một giá thầu với sự trợ giúp của dữ liệu theo thời gian thực do dịch vụ khoá/giá trị Protected Audience cung cấp. Sau đó, người bán nhận được những giá thầu này cũng như dữ liệu theo thời gian thực và điểm số thuộc sở hữu của người bán cho từng giá thầu. Giá thầu có điểm số cao nhất sẽ thắng phiên đấu giá.

Quảng cáo thắng thầu sẽ xuất hiện trong một khung có rào chắn. URL của mẫu quảng cáo được chỉ định trong giá thầu và nguồn gốc phải khớp với một URL trong danh sách do cấu hình của nhóm lợi ích cung cấp.

Người bán có thể báo cáo kết quả đấu giá (reportResult()) và người mua có thể báo cáo các giao dịch thắng của họ (reportWin()).

Tìm hiểu về Báo cáo phiên đấu giá Protected Audience.

Tại sao chúng ta cần Protected Audience API?

Việc hiểu rõ mối quan tâm của người dùng có thể giúp bạn phân phối quảng cáo phù hợp hơn so với việc chỉ chọn quảng cáo dựa trên nội dung trang web (nhắm mục tiêu theo bối cảnh) hoặc bằng cách sử dụng thông tin do người dùng cung cấp cho trang web mà quảng cáo xuất hiện (nhắm mục tiêu dựa trên dữ liệu của bên thứ nhất).

Theo truyền thống, các nền tảng quảng cáo đã tìm hiểu về mối quan tâm của người dùng bằng cách theo dõi hành vi của họ trên các trang web. Các trình duyệt cần có cách để cho phép các nền tảng quảng cáo chọn quảng cáo phù hợp, nhờ đó, nhà xuất bản nội dung có thể nhận được doanh thu từ quảng cáo mà không cần theo dõi trên nhiều trang web.

Protected Audience API hướng đến việc đưa nền tảng web đến gần hơn với trạng thái mà trình duyệt của người dùng trên thiết bị của họ (chứ không phải nhà quảng cáo hoặc nền tảng công nghệ quảng cáo) lưu giữ thông tin về những điều mà người đó quan tâm.

Làm cách nào để dùng thử Protected Audience API?

  • Hướng dẫn cho nhà phát triển về Protected Audience API mô tả cách sử dụng API và cách kiểm thử cục bộ.

  • protected-audience-demo.web.app cung cấp hướng dẫn về việc triển khai Protected Audience cơ bản trên các trang web của nhà quảng cáo và nhà xuất bản. Video minh hoạ Protected Audience giải thích cách hoạt động của mã này và xem trước cách sử dụng Công cụ của Chrome cho nhà phát triển để gỡ lỗi.

Có những cấu hình trình duyệt nào?

Người dùng có thể điều chỉnh mức độ tham gia các quy trình 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 chế độ cài đặt cấp cao nhất trong chrome://settings/adPrivacy. Trong giai đoạn thử nghiệm ban đầu, người dùng có thể chọn không sử dụng Protected Audience API thông qua phần cài đặt Hộp cát về quyền riêng tư.

Chrome dự định cho phép người dùng xem và quản lý danh sách các nhóm đối tượng có cùng mối quan tâm mà họ đã được thêm vào trên các trang web mà họ đã truy cập. Giống như các công nghệ Hộp cát về quyền riêng tư, chế độ cài đặt người dùng có thể thay đổi theo ý kiến phản hồi của người dùng, cơ quan quản lý và những người khác.

Chúng tôi sẽ cập nhật các chế độ cài đặt hiện có trong Chrome khi Protected Audience API tiến triển, dựa trên các thử nghiệm và ý kiến phản hồi. Trong tương lai, chúng tôi sẽ cung cấp các chế độ cài đặt chi tiết hơn để quản lý Đối tượng được bảo vệ và dữ liệu liên quan.

Các đối tượng gọi API không thể truy cập vào tư cách thành viên của 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ọ.

Tôi có thể chọn không sử dụng Protected Audience API không?

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.

Khái niệm chính

Bạn đang tìm thêm thông tin về thuật ngữ Protected Audience? Tham khảo bảng chú giải về Hộp cát về quyền riêng tư.

Nhóm đối tượng có cùng mối quan tâm là gì?

Nhóm mối quan tâm Protected Audience API đại diện cho một nhóm người có cùng mối quan tâm, tương ứng với một danh sách tái tiếp thị.

Mỗi nhóm đối tượng có cùng mối quan tâm trong Protected Audience API đều có một chủ sở hữu. Các loại chủ sở hữu khác nhau sẽ tạo ra các loại nhóm lợi ích khác nhau với các trường hợp sử dụng khác nhau.

Chủ sở hữu yêu cầu trình duyệt của người dùng thêm tư cách thành viên của nhóm đối tượng có cùng mối quan tâm bằng cách gọi hàm JavaScript navigator.joinAdInterestGroup(), cung cấp thông tin như dữ liệu về quảng cáo có liên quan đến nhóm đối tượng có cùng mối quan tâm và một URL cho JavaScript được dùng trong hoạt động đặt giá thầu. Bạn có thể cập nhật dữ liệu nhóm đối tượng có cùng mối quan tâm (chẳng hạn như quảng cáo) và có thể bật một nhóm đối tượng có cùng mối quan tâm trong tối đa 30 ngày.

Các loại nhóm đối tượng có cùng mối quan tâm

Bảng sau đây cung cấp ví dụ về các loại nhóm quan tâm và chủ sở hữu Protected Audience API.

Chủ sở hữu Ví dụ: Quan tâm Ví dụ: Trường hợp sử dụng
Nhà quảng cáo Nhà sản xuất xe đạp Sản phẩm Những người đã xem trang sản phẩm cho một danh mục xe đạp cụ thể. Tái tiếp thị cho những người đã từng tương tác với thương hiệu.
Nhà xuất bản Trang web tin tức Nội dung Những người đọc về xe đạp. Nhà xuất bản có thể sử dụng dữ liệu của bên thứ nhất để cho phép nhà quảng cáo mua những quảng cáo phù hợp với độc giả trên trang web của họ. Nhóm đối tượng có cùng mối quan tâm thuộc sở hữu của nhà xuất bản có thể cho phép nhà xuất bản làm điều tương tự ngay cả khi những người đó đang duyệt xem các trang web khác. Nhà xuất bản có thể tính phí để có thể hiển thị quảng cáo cho một số phân khúc cụ thể trong đối tượng của họ.
Công nghệ quảng cáo DSP (Bộ xử lý tín hiệu kỹ thuật số) Danh mục sản phẩm Những người thể hiện sự quan tâm đến đồ dùng cho xe đạp. Một công ty công nghệ quảng cáo có thể tạo và quản lý một nhóm lợi ích gồm những người mà họ tin rằng đang có nhu cầu mua một số danh mục mặt hàng. Sau đó, nhóm mối quan tâm này có thể được dùng để quảng cáo sản phẩm trên những trang web bán hàng thuộc danh mục đó (và hợp tác với công ty công nghệ quảng cáo).

Chrome cho phép tối đa 1.000 nhóm đối tượng có cùng mối quan tâm cho mỗi chủ sở hữu và tối đa 1.000 chủ sở hữu nhóm đối tượng có cùng mối quan tâm. Các giới hạn này được đặt ra để làm rào chắn, chứ không phải để đạt được trong quá trình hoạt động bình thường.

Người mua là gì?

Trong Protected Audience API, người mua là bên sở hữu một nhóm đối tượng có cùng mối quan tâm và đặt giá thầu trong một phiên đấu giá quảng cáo.

Ví dụ:

  • Nhà quảng cáo: tự hành động.
  • Nền tảng bên cầu (DSP): hoạt động cho nhà quảng cáo.
  • Chủ sở hữu nhóm đối tượng có cùng mối quan tâm: làm việc cho nhiều nhà quảng cáo.

Người mua có 3 việc cần làm:

  • Chọn tham gia hay không tham gia một phiên đấu giá.
  • Chọn quảng cáo và tính toán giá thầu.
  • Báo cáo kết quả đấu giá.

Các công việc này được thực hiện theo phương thức có lập trình, trong mã do người mua cung cấp và được chạy trong phiên đấu giá quảng cáo Protected Audience API.

Khi người mua yêu cầu trình duyệt của người dùng thêm một nhóm đối tượng có cùng mối quan tâm vào các nhóm mà trình duyệt đó là thành viên (bằng cách gọi hàm JavaScript navigator.joinAdInterestGroup()), người mua sẽ cung cấp cho trình duyệt:

  • URL cho mã đặt giá thầu, sẽ được dùng khi người bán chạy một phiên đấu giá quảng cáo.
  • Có thể là URL cho mẫu quảng cáo của nhóm mối quan tâm. (Bạn có thể thêm URL quảng cáo sau này bằng một bản cập nhật.)
  • Danh sách khoá dữ liệu cần truy vấn và URL của dịch vụ Khoá/giá trị của người mua để cho phép mã đặt giá thầu nhận dữ liệu theo thời gian thực trong phiên đấu giá.

Mã của người mua cũng có thể bao gồm một hàm reportWin() để báo cáo kết quả của phiên đấu giá.

Ai chạy phiên đấu giá quảng cáo?

Có nhiều bên có thể chạy phiên đấu giá để bán khoảng không quảng cáo.

Ví dụ:

  • Nhà xuất bản nội dung: tự mình hành động để lưu trữ nội dung quảng cáo trên trang web của mình.
  • Nền tảng bên cung (SSP): làm việc với nhà xuất bản và cung cấp các dịch vụ khác.
  • Tập lệnh của bên thứ ba: thay mặt cho nhà xuất bản, để cho phép tham gia đấu giá quảng cáo.

Với Protected Audience API, người bán không gian quảng cáo có 3 việc cần làm:

  • Thực thi các quy tắc của nhà xuất bản: nêu rõ những người mua và giá thầu nào đủ điều kiện.
  • Chạy logic đấu giá: JavaScript chạy trong worklet để tính điểm mức độ phù hợp cho từng giá thầu.
  • Báo cáo kết quả đấu giá.

Các công việc này được thực hiện theo phương thức lập trình, trong mã do người bán cung cấp khi người bán bắt đầu một phiên đấu giá quảng cáo bằng cách gọi hàm JavaScript navigator.runAdAuction().

Phiên đấu giá quảng cáo Protected Audience API hoạt động như thế nào?

Sơ đồ sau đây trình bày từng giai đoạn của phiên đấu giá quảng cáo Protected Audience API:

Sáu giai đoạn trong phiên đấu giá quảng cáo Protected Audience API
Các giai đoạn của phiên đấu giá quảng cáo Protected Audience.

Trong Protected Audience API, phiên đấu giá quảng cáo là một tập hợp các chương trình JavaScript nhỏ mà trình duyệt chạy trên thiết bị của người dùng để chọn quảng cáo. Để bảo vệ quyền riêng tư, tất cả mã đấu giá quảng cáo của người bán và người mua đều chạy trong worklet JavaScript riêng biệt không thể giao tiếp với thế giới bên ngoài.

Người bán (nhà xuất bản hoặc nền tảng bên cung) bắt đầu phiên đấu giá quảng cáo Protected Audience trên một trang web bán không gian quảng cáo (chẳng hạn như một trang web tin tức). Người bán chọn người mua tham gia phiên đấu giá, cho biết không gian nào được bán và cung cấp thêm tiêu chí cho quảng cáo. Mỗi người mua là chủ sở hữu của một nhóm mối quan tâm.

Người bán cung cấp cho trình duyệt mã để tính điểm giá thầu, bao gồm giá trị của từng giá thầu, URL mẫu quảng cáo và các dữ liệu khác do mỗi người mua trả về. Trong phiên đấu giá, mã đặt giá thầu của người mua và mã tính điểm giá thầu của người bán có thể nhận dữ liệu từ dịch vụ Khoá/Giá trị của họ. Sau khi một quảng cáo được chọn và hiển thị (trong khung được phân vùng để duy trì quyền riêng tư), người bán và người mua thắng cuộc có thể báo cáo kết quả đấu giá.

  1. Một người dùng truy cập vào một trang web hiển thị quảng cáo.
  2. Mã của người bán bắt đầu một phiên đấu giá. Người bán chỉ định không gian quảng cáo nào được bán và ai có thể đặt giá thầu, cũng như phương pháp tính điểm cho những giá thầu đó.
  3. Mã của người mua được mời sẽ thực thi để tạo giá thầu, URL cho mẫu quảng cáo có liên quan và các dữ liệu khác. Tập lệnh đặt giá thầu có thể truy vấn dữ liệu theo thời gian thực (chẳng hạn như ngân sách còn lại của chiến dịch quảng cáo) từ dịch vụ Khoá/Giá trị của người mua.
  4. Mã của người bán tính điểm cho từng giá thầu và chọn ra giá thầu chiến thắng. Logic này sử dụng giá trị giá thầu và các dữ liệu khác để trả về mức độ phù hợp của giá thầu và từ chối quảng cáo không thể đánh bại quảng cáo chiến thắng theo bối cảnh. Người bán có thể sử dụng dịch vụ Khoá/Giá trị của riêng mình cho dữ liệu theo thời gian thực. Trước khi phiên đấu giá bắt đầu, người bán sẽ tìm quảng cáo theo bối cảnh phù hợp nhất cho vùng quảng cáo có sẵn.
  5. Quảng cáo chiến thắng được trả về dưới dạng một đối tượng cấu hình khung được phân vùng khi cờ resolveToConfig được đặt trong cấu hình phiên đấu giá. Cấu hình này được dùng để điều hướng khung được phân vùng đến mẫu quảng cáo và URL của mẫu quảng cáo sẽ bị ẩn đối với cả người bán và nhà xuất bản. Nếu cờ resolveToConfig được đặt thành false hoặc không được truyền vào, thì quảng cáo thắng thầu sẽ được trả về dưới dạng một URN mờ có thể dùng để hiển thị quảng cáo trong iframe. Đối tượng cấu hình khung được phân vùng có sẵn từ M114.
  6. Phiên đấu giá được báo cáo cho người bán và người mua chiến thắng.

Cơ chế báo cáo cho người mua bị mất đang được thảo luận.

Dịch vụ khoá/giá trị Protected Audience API là gì?

Dịch vụ khoá/giá trị Protected Audience API cho phép các công nghệ quảng cáo truy vấn dữ liệu theo thời gian thực khi người mua đặt giá thầu và cho phép người bán tính điểm quảng cáo trong khi vẫn đảm bảo quyền riêng tư. Bạn có thể đọc về dịch vụ Khoá/Giá trị Protected Audience API và các dịch vụ khác trong phần Các dịch vụ Protected Audience API.

Dịch vụ Khoá/Giá trị được triển khai cho cơ sở hạ tầng đám mây riêng của công nghệ quảng cáo và dịch vụ này chạy trong một môi trường thực thi đáng tin cậy. Yêu cầu đối với dịch vụ Khoá/Giá trị không được dẫn đến việc ghi nhật ký ở cấp sự kiện hoặc có các tác dụng phụ khác. Dịch vụ Khoá/Giá trị cũng sẽ hỗ trợ các hàm do người dùng xác định (UDF) cho phép các công nghệ quảng cáo thực thi logic tuỳ chỉnh của riêng chúng trong dịch vụ Khoá/Giá trị.

Người mua hoặc người bán cung cấp danh sách "khoá" để chỉ định dữ liệu mà họ yêu cầu từ dịch vụ Khoá/Giá trị của Protected Audience API. Dịch vụ Khoá/Giá trị sẽ trả về một giá trị cho mỗi khoá.

Giờ đây, mã dịch vụ Khoá/Giá trị của Protected Audience API có trong kho lưu trữ GitHub của Hộp cát về quyền riêng tư. Nhà phát triển Chrome và Android có thể sử dụng dịch vụ này.

Tìm hiểu thêm về dịch vụ Khoá/Giá trị Protected Audience API trong tài liệu giải thích về APItài liệu giải thích về mô hình tin cậy.

Dữ liệu theo thời gian thực được kết hợp vào phiên đấu giá như thế nào?

Người mua hoặc người bán trong phiên đấu giá quảng cáo có thể cần truy cập vào dữ liệu theo thời gian thực. Ví dụ: người mua có thể muốn tính toán ngân sách còn lại trong một chiến dịch quảng cáo hoặc người bán có thể phải kiểm tra mẫu quảng cáo dựa trên chính sách của nhà xuất bản.

Để đáp ứng các yêu cầu về quyền riêng tư của Protected Audience API, dịch vụ Khoá/Giá trị sẽ cung cấp dữ liệu theo thời gian thực cần thiết trong phiên đấu giá quảng cáo. Khi mỗi người mua gọi navigator.joinAdInterestGroup(), người mua sẽ chỉ định một URL dịch vụ Khoá/Giá trị và chỉ định các khoá sẽ được truy vấn đến dịch vụ trong một phiên đấu giá. Tương tự, khi người bán chạy một phiên đấu giá quảng cáo bằng cách gọi navigator.runAdAuction(), người bán sẽ cung cấp một URL cho dịch vụ Khoá/Giá trị của mình. Dịch vụ Khoá/Giá trị của người bán sẽ được truy vấn bằng URL hiển thị của mẫu quảng cáo.

Đối với thử nghiệm ban đầu, mô hình "Sử dụng máy chủ riêng" sẽ được dùng. Về lâu dài, các công nghệ quảng cáo sẽ cần sử dụng các dịch vụ Khoá/Giá trị Protected Audience API nguồn mở chạy trong môi trường thực thi đáng tin cậy để truy xuất dữ liệu theo thời gian thực.

Để đảm bảo hệ sinh thái có đủ thời gian thử nghiệm, chúng tôi dự kiến sẽ không yêu cầu sử dụng các dịch vụ Khoá/Giá trị nguồn mở hoặc môi trường thực thi đáng tin cậy cho đến một thời điểm nào đó sau khi ngừng sử dụng cookie của bên thứ ba. Chúng tôi sẽ thông báo trước cho nhà phát triển để họ bắt đầu kiểm thử và áp dụng trước khi quá trình chuyển đổi này diễn ra.

Dữ liệu của bên thứ nhất được sử dụng như thế nào trong phiên đấu giá Protected Audience API?

Dữ liệu của bên thứ nhất là dữ liệu thuộc sở hữu của trang web về người dùng của họ. Ví dụ: nếu người dùng đã chỉ định màu sắc yêu thích của họ trên trang web của nhà quảng cáo hoặc nhà xuất bản, thì màu sắc đó được coi là dữ liệu của bên thứ nhất.

Trong phiên đấu giá Protected Audience, nhà quảng cáo có thể sử dụng dữ liệu của bên thứ nhất để xác định tư cách thành viên nhóm mối quan tâm của quảng cáo, đồng thời cũng có thể truyền dữ liệu vào nhóm mối quan tâm dưới dạng userBiddingSignals. Dữ liệu của bên thứ nhất từ nhà quảng cáo sẽ chỉ có sẵn cho người mua trong bước tạo giá thầu và không có sẵn cho người bán.

Ví dụ: nếu nhà quảng cáo biết màu sắc yêu thích của người dùng, thì giá trị có thể được đặt trong cấu hình nhóm đối tượng có cùng mối quan tâm là userBiddingSignals khi người dùng được thêm vào một nhóm đối tượng có cùng mối quan tâm:

const interestGroup = {
  owner: 'https://example-buyer.com',
  name: 'running-shoes',
  userBiddingSignals: {
    favoriteColor: 'blue' // First-party data
  },
  // ...other interest group settings
};

navigator.joinAdInterestGroup(interestGroup, 3600);

Nhà xuất bản cũng có thể truyền dữ liệu của bên thứ nhất bằng cách đặt tín hiệu trong cấu hình phiên đấu giá khi bắt đầu phiên đấu giá và có thể kiểm soát những người nhận được dữ liệu của bên thứ nhất. Khi nhà xuất bản truyền dữ liệu của bên thứ nhất dưới dạng auctionSignals, cả người mua và người bán đều có thể sử dụng dữ liệu này. Khi dữ liệu được truyền vào dưới dạng sellerSignals, chỉ người bán mới có thể sử dụng dữ liệu đó. Khi dữ liệu được truyền vào dưới dạng perBuyerSignals, chỉ những người mua được chỉ định mới có thể sử dụng dữ liệu đó. Nhà xuất bản cũng có thể truyền dữ liệu của bên thứ nhất vào các phiên đấu giá thành phần. Nhà xuất bản và những người tham gia đấu giá phải thoả thuận trước về những dữ liệu của bên thứ nhất cần được chia sẻ và cách định dạng dữ liệu.

Ví dụ sau đây mô tả cách nhà xuất bản có thể truyền dữ liệu của bên thứ nhất cho nhiều bên tham gia đấu giá:

const auctionConfig = {
  seller: 'https://example-seller.com',
  auctionSignals: {
    favoriteColor: 'blue', // Both buyer and seller will receive this signal
  },
  sellerSignals: {
    favoriteIceCreamFlavor: 'chocolate', // Only the seller will receive this signal
  },
  perBuyerSignals: {
    'https://example-buyer.com': {
      favoriteDrink: 'tea', // Only a specific buyer will receive this signal
    },
  },
  // The same pattern applies to the component auction
  componentAuctions: [{
    seller: 'https://example-component-seller.com',
    auctionSignals: { ... },
    sellerSignals: { ... },
    perBuyerSignals { ... }
  }],
  // ...other auction settings
};

navigator.runAdAuction(auctionConfig);

Tìm hiểu thêm

Để biết thông tin tổng quan chi tiết hơn về Protected Audience API, hãy đọc hướng dẫn cho nhà phát triển về Protected Audience API.

Nhà phát triển

Nếu bạn đã sẵn sàng bắt đầu sử dụng Protected Audience API, hãy đọc phần thử nghiệm và tham gia.

Chúng tôi đã viết một hướng dẫn cho nhà phát triển API và tạo một bản minh hoạ Protected Audience API, trong đó hướng dẫn cách triển khai Protected Audience API cơ bản. Video minh hoạ Protected Audience API giải thích cách hoạt động của mã minh hoạ và cho thấy cách sử dụng Chrome DevTools để gỡ lỗi Protected Audience API.

Tương tác và chia sẻ ý kiến phản hồi