Báo cáo phiên đấu giá Protected Audience API

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Đo lường dữ liệu và kết quả phiên đấu giá Protected Audience API

Trong bài viết này, bạn sẽ thấy thông tin tổng quan cấp cao về các cơ chế có sẵn để báo cáo dữ liệu phiên đấu giá Protected Audience API cho máy chủ của mình, cùng với các cơ chế chuyển đổi hiện có để bạn sử dụng trong quá trình di chuyển cho đến khi các giải pháp thay thế sẵn sàng.

Để báo cáo về các chỉ số quan trọng mà bạn thu thập được từ một phiên đấu giá quảng cáo, Protected Audience API hoạt động với:

• Private Aggregation (Tính năng tổng hợp riêng tư) thu thập tín hiệu và kết quả phiên đấu giá để tạo báo cáo tóm tắt.
• Ads Reporting API cho Khung bảo vệ và iframe. Đây là một kênh trong các khung để giao tiếp với các công cụ của Protected Audience API. API này cho phép liên kết dữ liệu ở cấp sự kiện với các tín hiệu đấu giá. Báo cáo ở cấp sự kiện của API Báo cáo quảng cáo là một cơ chế chuyển đổi cho đến khi chúng tôi thiết kế một cơ chế báo cáo riêng tư hơn.
• Báo cáo phân bổ cho phép bạn liên kết dữ liệu lượt chuyển đổi với các tín hiệu đấu giá.
• Shared Storage (Bộ nhớ dùng chung) cho phép bạn ghi các tín hiệu phiên đấu giá vào bộ nhớ trên nhiều nguồn gốc, sau đó cho phép bạn báo cáo dữ liệu đó sau này bằng cách sử dụng Private Aggregation.

Tổng quan về báo cáo Protected Audience API

Có 3 khoảng thời gian chính mà dữ liệu từ quy trình đấu giá Protected Audience API có thể được báo cáo cho máy chủ của bạn: thời gian đấu giá khi phiên đấu giá được thực thi từ trang web của nhà xuất bản, thời gian hiển thị khi quảng cáo được hiển thị trong một khung được bảo vệ hoặc iframe trên trang web của nhà xuất bản và thời gian chuyển đổi khi người dùng thực hiện một số hành động trên một trang web khác có thể được phân bổ cho phiên đấu giá.

Trong thời gian đấu giá, bạn có thể báo cáo dữ liệu đấu giá bằng cách sử dụng các công việc báo cáo. Trong thời gian hiển thị, bạn có thể báo cáo dữ liệu tương tác từ một iframe hoặc khung được phân vùng. Trong thời gian chuyển đổi, bạn có thể báo cáo dữ liệu phân bổ từ trang đích bằng Attribution Reporting API.

Báo cáo vị trí

Trong một phiên đấu giá, người mua có thể báo cáo các tín hiệu có trong các công việc generateBid() và reportWin(), còn người bán có thể báo cáo các tín hiệu có trong scoreAd() và reportResult(). Bên ngoài phiên đấu giá, người mua và người bán có thể báo cáo dữ liệu từ khung hiển thị quảng cáo và từ trang web nơi thực hiện lượt chuyển đổi.

Trong mỗi khoảng thời gian được liệt kê, người mua và người bán sẽ có quyền truy cập vào nhiều API báo cáo để báo cáo dữ liệu như tín hiệu phiên đấu giá, dữ liệu cấp sự kiện và dữ liệu lượt chuyển đổi.

Dữ liệu có trong phiên đấu giá Protected Audience API

Bạn có thể báo cáo dữ liệu sau đây từ một công việc của Protected Audience API trong phiên đấu giá.

Tín hiệu

Tín hiệu là dữ liệu ngữ cảnh của phiên đấu giá, dữ liệu người dùng, dữ liệu theo thời gian thực và dữ liệu trình duyệt mà người mua và người bán có thể sử dụng trong một worklet để tạo giá thầu, tính điểm quảng cáo và báo cáo kết quả của phiên đấu giá.

Đối tượng cấu hình phiên đấu giá là nguồn dữ liệu chính được cung cấp để trở thành tín hiệu trong các worklet. Nhà xuất bản và người bán có thể cung cấp dữ liệu theo bối cảnh và dữ liệu của bên thứ nhất trong cấu hình phiên đấu giá. Các tín hiệu này có thể được làm phong phú bằng dữ liệu nhóm mối quan tâm của bên mua, dữ liệu cấp sự kiện từ khung hiển thị quảng cáo và dữ liệu phân bổ từ trang nhấp chuột. Dữ liệu được báo cáo có thể được dùng cho báo cáo người mua/người bán, thanh toán, lập ngân sách, huấn luyện mô hình học máy, v.v.

Dữ liệu khác có sẵn

• Dữ liệu kết quả liên quan đến dữ liệu chiến thắng và thua trong phiên đấu giá, chẳng hạn như giá thầu chiến thắng và lý do từ chối giá thầu.
• Dữ liệu hiệu suất chứa thông tin về độ trễ, chẳng hạn như thời gian cần thiết để tìm nạp và thực thi công việc đặt giá thầu.

Dữ liệu có sẵn bên ngoài phiên đấu giá Protected Audience API

Ngoài phiên đấu giá Protected Audience API, có hai khoảng thời gian mà bạn có thể báo cáo dữ liệu.

Trong thời gian hiển thị, khi quảng cáo hiển thị trên trang web của nhà xuất bản, dữ liệu ở cấp sự kiện từ bên trong iframe hoặc khung được bảo vệ có thể được liên kết với dữ liệu phiên đấu giá Protected Audience API và được báo cáo cho máy chủ của bạn. Ví dụ về dữ liệu ở cấp sự kiện bao gồm lượt hiển thị quảng cáo, lượt nhấp, lượt di chuột và mọi sự kiện khác xảy ra bên trong khung.

Trong thời gian chuyển đổi, khi người dùng thực hiện một số hành động trên trang đích được phân bổ lại cho phiên đấu giá, dữ liệu ở cấp sự kiện từ trang chuyển đổi có thể được liên kết với dữ liệu phiên đấu giá của Protected Audience API và được báo cáo cho máy chủ của bạn.

Báo cáo cấp sự kiện

Báo cáo cấp sự kiện cung cấp thông tin chi tiết về một hoặc nhiều sự kiện. Sự kiện có thể là một phiên đấu giá thắng thầu, lượt hiển thị quảng cáo hoặc lượt chuyển đổi. Ít nhất là cho đến năm 2026, báo cáo chiến thắng phiên đấu giá ở cấp sự kiện sẽ vẫn được cung cấp, không bắt buộc phải có khung được bảo vệ để hiển thị quảng cáo Protected Audience và bạn có thể sử dụng iframe có quyền truy cập mạng không bị hạn chế để báo cáo ở cấp sự kiện. Ngoài ra, API Báo cáo quảng cáo cũng có trong các khung được bảo vệ và iframe để bạn liên kết dữ liệu phiên đấu giá và lượt chuyển đổi với dữ liệu cấp sự kiện từ khung. Điều này được thiết kế để giúp hệ sinh thái có lộ trình di chuyển dễ dàng hơn, vì bạn có thể tiếp tục sử dụng cơ sở hạ tầng báo cáo hiện có cho đến ít nhất là năm 2026 trong khi di chuyển hệ thống sang Protected Audience.

Báo cáo chiến thắng trong phiên đấu giá ở cấp sự kiện bằng sendReportTo()

Cơ chế có sẵn để báo cáo dữ liệu ở cấp sự kiện bên trong phiên đấu giá Protected Audience là sendReportTo() function trên một phiên đấu giá thắng cuộc. Hàm này có trong các công cụ báo cáo của người mua và người bán, đồng thời trình duyệt sẽ đưa ra yêu cầu GET cho chuỗi URL được cung cấp khi quá trình hiển thị quảng cáo bắt đầu. Bạn có thể mã hoá bất kỳ tín hiệu nào có trong các worklet dưới dạng tham số truy vấn của URL.

Ví dụ: người mua có thể báo cáo số tiền giá thầu chiến thắng từ công việc reportWin() cho mục đích thanh toán:

// Buyer reporting worklet
function reportWin(auctionSignals, perBuyerSignals, sellerSignals, browserSignals, directFromSellerSignals) {
  sendReportTo(`https://buyer-reporting-server.example/reporting?bid=${browserSignals.bid}`);
}

Bạn có thể dùng hàm sendReportTo() để tạo báo cáo chiến thắng cho người bán khi được gọi từ reportResult() và báo cáo chiến thắng cho người mua khi được gọi từ reportWin(). Hàm sendReportTo() sẽ hoạt động ít nhất đến năm 2026,

Báo cáo Mức độ tương tác

Báo cáo lượt tương tác chứa dữ liệu ở cấp sự kiện từ một mẫu quảng cáo, chẳng hạn như dữ liệu lượt hiển thị hoặc lượt nhấp được liên kết với tín hiệu của phiên đấu giá Protected Audience API đã hiển thị quảng cáo. Vì quảng cáo được hiển thị sau khi phiên đấu giá kết thúc, nên các tín hiệu đấu giá không có trong khung hiển thị quảng cáo. Để liên kết những dữ liệu này từ các khoảng thời gian khác nhau, chúng tôi cung cấp cho bạn hai cơ chế chuyển đổi để tạo báo cáo về mức độ tương tác.

Bạn có thể dùng hàm sendReportTo() được mô tả ở trên để liên kết dữ liệu phiên đấu giá với dữ liệu cấp sự kiện từ một iframe, nhưng hàm này không hoạt động đối với khung được bảo vệ vì không thể truyền mã nhận dạng duy nhất từ trình nhúng do hoạt động giao tiếp giữa trình nhúng và khung được bảo vệ bị hạn chế. Để liên kết dữ liệu phiên đấu giá với dữ liệu cấp sự kiện từ quảng cáo khung được khoanh vùng, bạn có thể sử dụng API Báo cáo quảng cáo.

API Báo cáo quảng cáo cho khung được phân vùng và iframe

Ads Reporting API cho khung được bảo vệ và iframe cung cấp một cơ chế để bạn liên kết dữ liệu ở cấp sự kiện của người dùng từ một khung quảng cáo với các tín hiệu trong phiên đấu giá Protected Audience.

Trong một công cụ báo cáo Protected Audience API, bạn có thể đăng ký một beacon quảng cáo bằng hàm registerAdBeacon() và truyền URL báo cáo của bạn với các tín hiệu được thêm vào dưới dạng tham số truy vấn. Bạn cũng chỉ định sự kiện tuỳ chỉnh mà bạn muốn liên kết với URL báo cáo. Sau đó, vào lúc khác khi quảng cáo được hiển thị trong một khung được phân vùng, bạn có thể kích hoạt sự kiện tuỳ chỉnh bằng cách gọi hàm window.fence.reportEvent(). Bạn có thể thêm dữ liệu có sẵn trong khung được phân vùng làm tải trọng.

Hàm registerAdBeacon() chỉ có trong các hàm báo cáo và không có trong logic đặt giá thầu của người mua cũng như logic tính điểm của người bán.

Trong ví dụ sau, mã chiến dịch được liên kết với một tải trọng cấp sự kiện có toạ độ lượt nhấp:

// Protected Audience API buyer win reporting worklet
function reportWin(auctionSignals) {
  const { campaignId } = auctionSignals

  registerAdBeacon({
    click: `https://buyer-server.example/report/click?campaignId=${campaignId}`
  })
}

// Protected Audience API seller reporting worklet
function reportResult(auctionConfig) {
  const { campaignId } = auctionConfig.auctionSignals;

  registerAdBeacon({
    click: `https://seller-server.example/report/click?campaignId=${campaignId}`
  })
}

// Ad frame
window.fence.reportEvent({
  eventType: 'click',
  eventData: JSON.stringify({'clickX': '123', 'clickY': '456'}),
  destination:['buyer', 'seller']
});

API Báo cáo quảng cáo trong khung hình được khoanh vùng cũng sẽ hoạt động ít nhất đến năm 2026 vì các lý do tương tự như báo cáo chiến thắng.

Để tìm hiểu sâu hơn, hãy xem nội dung giải thích.

Quyền truy cập mạng không bị hạn chế

Khung được phân vùng sẽ cho phép tải tài nguyên mạng giống như iframe và bạn có thể gửi dữ liệu cấp sự kiện trong khung được phân vùng đến máy chủ của mình. Sau đó, bạn có thể tạo báo cáo ở cấp sự kiện phía máy chủ bằng cách liên kết dữ liệu ở cấp sự kiện từ một khung được phân vùng với dữ liệu phiên đấu giá được gửi bằng sendReportTo() đã được thảo luận trong phần cơ chế báo cáo ở cấp sự kiện đấu giá ở trên.

Quyền truy cập mạng sẽ bị hạn chế trong tương lai.

Báo cáo phân bổ

Báo cáo phân bổ cho phép bạn liên kết một lượt chuyển đổi trên trang web với một quảng cáo được chọn từ phiên đấu giá Protected Audience API. Ví dụ: người dùng có thể nhấp vào quảng cáo sản phẩm mà bạn phân phát, được chuyển hướng đến trang web của nhà quảng cáo, mua hàng trên trang web đó và bạn muốn phân bổ lượt mua hàng đó cho quảng cáo đã hiển thị. Attribution Reporting API sẽ được tích hợp với Protected Audience API để kết hợp dữ liệu phiên đấu giá từ trang web của nhà xuất bản và dữ liệu lượt chuyển đổi từ trang web của nhà quảng cáo.

Trong khi chúng tôi thiết kế một giải pháp lâu dài hơn, bạn có thể sử dụng API Báo cáo quảng cáo cho các khung được phân vùng làm cơ chế chuyển đổi để tạo báo cáo tổng hợp và cấp sự kiện bằng tính năng Báo cáo phân bổ. Xin lưu ý rằng những báo cáo này dùng để đo lường lượt chuyển đổi và tách biệt với báo cáo tương tác ở cấp sự kiện và báo cáo tương tác tổng hợp được tạo từ phiên đấu giá và khung quảng cáo. Chúng tôi sẽ đăng một bài viết giải thích về giải pháp lâu dài hơn khi đã sẵn sàng.

Cơ chế chuyển đổi

Khi đăng ký một beacon quảng cáo, bạn có thể sử dụng từ khoá reserved.top_navigation. Từ khoá này sẽ tự động thêm tiêu đề Attribution-Reporting-Eligible để beacon đủ điều kiện đăng ký làm nguồn phân bổ.

registerAdBeacon({
 'reserved.top_navigation': 'https://adtech.example/click?buyer_event_id=123',
});

Để đính kèm dữ liệu ở cấp sự kiện vào beacon mà bạn đã đăng ký, bạn có thể gọi setReportEventDataForAutomaticBeacons() từ khung được khoanh vùng bằng tải trọng sự kiện.

window.fence.setReportEventDataForAutomaticBeacons({
  eventType: 'reserved.top_navigation',
  eventData: 'data from the frame',
  destination:['seller', 'buyer']
})

Hãy xem phần Báo cáo phân bổ trong phần giải thích về API Báo cáo quảng cáo để tìm hiểu thêm.

Ví dụ về báo cáo lượt tương tác và lượt chuyển đổi

Trong ví dụ này, chúng ta sẽ xem xét điều này từ góc độ người mua muốn liên kết dữ liệu từ phiên đấu giá, khung quảng cáo và trang web chuyển đổi với nhau.

Trong quy trình công việc này, người mua phối hợp với người bán để gửi một mã nhận dạng duy nhất vào phiên đấu giá. Trong phiên đấu giá, người mua gửi mã nhận dạng duy nhất này cùng với dữ liệu phiên đấu giá. Trong thời gian hiển thị và chuyển đổi, dữ liệu từ khung được bảo vệ hoặc iframe cũng được gửi với cùng một mã nhận dạng duy nhất. Sau đó, mã nhận dạng duy nhất có thể được dùng để liên kết các báo cáo này với nhau.

Quy trình công việc:

1. Trước khi phiên đấu giá bắt đầu, người mua gửi một mã nhận dạng duy nhất cho người bán trong quá trình phản hồi giá thầu bằng tuỳ chọn đặt giá thầu theo thời gian thực ("RTB") có lập trình. Mã nhận dạng có thể được đặt ở dạng một biến như auctionId. Mã nhận dạng được truyền vào dưới dạng perBuyerSignals trong auctionConfig và có trong các công việc nhỏ của người mua.
2. Trong thời gian đấu giá, người mua có thể đăng ký một beacon quảng cáo để được kích hoạt trong thời gian hiển thị quảng cáo và thời gian chuyển đổi (registerAdBeacon()).
   1. Để liên kết các tín hiệu đấu giá cho một sự kiện khung quảng cáo, hãy đặt auctionId làm tham số truy vấn của URL beacon.
   2. Để liên kết các tín hiệu đấu giá cho một sự kiện chuyển đổi, hãy đặt auctionId trong URL của beacon.
3. Trong thời gian hiển thị quảng cáo, các beacon mà bạn đã đăng ký trong thời gian đấu giá có thể được kích hoạt hoặc nâng cao bằng dữ liệu ở cấp sự kiện.
   1. Kích hoạt sự kiện khung bằng reportEvent() và truyền dữ liệu cấp sự kiện.
   2. Thêm tải trọng ở cấp sự kiện vào beacon phân bổ bằng setReportEventDataForAutomaticBeacons()
   3. Đăng ký quảng cáo với Attribution Reporting API bằng cách phản hồi các yêu cầu beacon quảng cáo có tiêu đề Attribution-Reporting-Register-Source.
4. Trong thời gian chuyển đổi, bạn có thể kích hoạt nguồn mà bạn đã đăng ký trong thời gian đấu giá.

Sau quy trình trên, người mua sẽ có báo cáo phiên đấu giá, báo cáo lượt tương tác và báo cáo lượt chuyển đổi. Tất cả các báo cáo này đều được liên kết với nhau bằng một khoá duy nhất có thể dùng để liên kết với nhau.

Quy trình công việc tương tự sẽ áp dụng cho người bán nếu cần quyền truy cập vào dữ liệu phân bổ và người bán cũng có thể sử dụng một mã nhận dạng duy nhất để gửi bằng registerAdBeacon(). Từ khung, lệnh gọi reportEvent() chứa một thuộc tính đích có thể được dùng để gửi báo cáo cho cả người mua và người bán. Xin lưu ý rằng SSP cũng phải xuất hiện trên trang đích để điều kiện kích hoạt được phân bổ cho nguồn.

Tổng hợp dữ liệu Protected Audience

Private Aggregation API là cơ chế dùng để báo cáo dữ liệu Protected Audience nhằm tạo báo cáo tóm tắt. Đây là báo cáo tổng hợp, có nhiều dữ liệu nhiễu được thu thập trong các nhóm. Một bộ chứa được biểu thị bằng một khoá tổng hợp và một số thông tin có thể được mã hoá vào khoá đó.

Ví dụ: một sự kiện hiển thị quảng cáo có thể được tính vào nhiều bộ chứa, trong đó mỗi bộ chứa đại diện cho một chiến dịch quảng cáo. Báo cáo tóm tắt khác với báo cáo ở cấp sự kiện ở chỗ báo cáo này không tiết lộ thông tin về từng sự kiện riêng lẻ. Với báo cáo ở cấp sự kiện, bạn có thể xác định rằng người dùng A, B và C đã xem chiến dịch 123. Với báo cáo tóm tắt, bạn có thể đo lường số người dùng đã xem chiến dịch 123 và thêm độ nhiễu để bảo vệ quyền riêng tư của người dùng.

Hãy xem bài viết Tích hợp riêng tư để biết thêm thông tin về API này.

Tổng hợp tín hiệu đấu giá

Bạn có thể tổng hợp các tín hiệu có sẵn trong các worklet cho máy chủ bằng tính năng Tổng hợp riêng tư. Để tổng hợp tín hiệu, bạn có thể sử dụng phương thức privateAggregation.contributeToHistogram() có trong công việc đặt giá thầu của người mua, công việc tính điểm của người bán và công việc báo cáo của người mua/người bán.

Trong ví dụ này, giá thầu chiến thắng được tổng hợp vào nhóm chủ sở hữu nhóm mối quan tâm:

function convertBuyerToBucket(igOwner) {}
function convertWinningBidToValue(winningBid) {}

function reportResult(auctionConfig, browserSignals) {
  privateAggregation.contributeToHistogram({
    bucket: convertBuyerToBucket(browserSignals.interestGroupOwner),
    value: convertWinningBidToValue(browserSignals.bid)
  });
} 

Đây là cơ chế chung để sử dụng khi các tín hiệu mà bạn muốn tổng hợp không liên kết với dữ liệu cấp sự kiện và không được một sự kiện bên ngoài phiên đấu giá kích hoạt. Để tìm hiểu thêm về việc báo cáo tín hiệu đấu giá, hãy xem nội dung giải thích.

Tổng hợp các tín hiệu đấu giá bằng dữ liệu sự kiện

Bạn có thể tổng hợp các tín hiệu đấu giá với thông tin hạn chế về một sự kiện xảy ra trong khung quảng cáo. Ví dụ: bạn có thể đo lường tổng hợp số lượt nhấp mà một quảng cáo cho một chiến dịch nhận được bằng cách tạo một nhóm đại diện cho chiến dịch đó và sự kiện nhấp. Xin lưu ý rằng từ khung quảng cáo, bạn có thể chỉ định sự kiện đã xảy ra, nhưng không thể đính kèm tải trọng ở cấp sự kiện.

Để tổng hợp các tín hiệu phiên đấu giá theo sự kiện, bạn có thể sử dụng privateAggregation.contributeToHistogramOnEvent(eventType, contribution). Phương thức này sẽ lấy một chuỗi chỉ định loại sự kiện và mức đóng góp cần báo cáo khi sự kiện đó được kích hoạt. Bạn có thể gọi phương thức này bằng một loại sự kiện tuỳ chỉnh, sau đó gọi window.fence.reportEvent(eventType) từ khung quảng cáo để kích hoạt báo cáo được gửi.

Giả sử bạn muốn đo lường số lượt nhấp mà một quảng cáo của chiến dịch nhận được.

// Protected Audience API worklet
function getClickReportBucketForCampaign(campaignId) {
  // return a bucket for the campaign ID and the click event
}

function generateBid(interestGroup) {
  privateAggregation.contributeToHistogramOnEvent('click', {
    bucket: getClickReportBucketForCampaign(interestGroup.ads.metadata.campaignId), 
    value: 1
  });
}

Trong hàm tạo giá thầu, bạn có thể xác định một nhóm là tổ hợp của mã chiến dịch và sự kiện nhấp, sau đó tăng giá trị cho nhóm đó thêm 1 mỗi khi sự kiện được kích hoạt.

// Ad frame
window.fence.reportEvent('click');

Sau đó, vào lúc khác, từ khung quảng cáo, bạn có thể kích hoạt việc gửi báo cáo bằng cách gọi reportEvent(eventType):

Tìm hiểu thêm về cách kích hoạt các nội dung đóng góp cho tính năng Tổng hợp riêng tư từ một khung trong video giải thích.

Báo cáo kết quả và hiệu suất của phiên đấu giá

Bạn cũng có thể tổng hợp kết quả phiên đấu giá khi được kích hoạt bằng một sự kiện thắng hoặc thua phiên đấu giá bằng contributeToHistogramOnEvent(eventType, contribution) khi bạn truyền vào một từ khoá loại sự kiện được đặt trước (reserved.win, reserved.loss và reserved.always).

Tính năng Tổng hợp riêng tư cung cấp danh sách các giá trị cơ sở mà bạn có thể dùng để tính toán nhóm và giá trị đóng góp của mình. Các giá trị cơ sở hiện có cho kết quả phiên đấu giá là giá trị giá thầu của quảng cáo chiến thắng, giá trị giá thầu được tính điểm cao thứ hai và lý do một giá thầu bị từ chối trong phiên đấu giá.

Khi một số giá trị cơ sở được cung cấp, chẳng hạn như số tiền đặt giá thầu chiến thắng, bạn có thể đặt số tiền cần thêm hoặc trừ vào giá trị đó, sau đó báo cáo giá trị cuối cùng. Ví dụ: nếu giá thầu chiến thắng là 5 đô la được cung cấp dưới dạng giá trị cơ sở, bạn có thể trừ đi giá thầu của mình là 2 đô la để tính giá trị thực tế là 3 đô la về mức chênh lệch mà bạn đã thua phiên đấu giá.

Báo cáo kết quả phiên đấu giá

Hãy xem ví dụ về trường hợp bạn đã thua một phiên đấu giá và muốn tìm hiểu giá thầu của mình chênh lệch bao nhiêu so với giá thanh toán của phiên đấu giá.

Để biết mức chênh lệch mà bạn thua phiên đấu giá, bạn có thể trừ giá thầu của mình cho giá thầu giành chiến thắng:

function generateBid() {
  const bid = calculateBidAmount();

  privateAggregation.contributeToHistogramOnEvent('reserved.loss', {
    bucket: getBucketForCampaign(interestGroup.ads.metadata.campaignId),
    value: {
      baseValue: 'winning-bid',
      scale: 1 // Scale the value to minimize noise-to-signal ratio 
      offset: -bid, // Numbers added to browser value after scaling 
    }
  });
}

Khi báo cáo được gửi, giá trị thực tế được báo cáo sẽ là baseValue theo tỷ lệ được dịch chuyển theo giá trị offset. Để tìm hiểu thêm, hãy xem nội dung giải thích.

Báo cáo hiệu suất

Người mua và người bán có thể báo cáo thời gian thực thi tập lệnh và thời gian tìm nạp các tín hiệu đáng tin cậy. Bên bán có thể thu thập thời gian tạo giá thầu và thời gian tín hiệu đặt giá thầu đáng tin cậy của từng người mua khi họ cho phép.

Hãy xem video giải thích để tìm hiểu thêm.

Lưu trữ tín hiệu phiên đấu giá trong Bộ nhớ dùng chung

Bộ nhớ dùng chung là bộ nhớ chưa phân vùng và đa nguồn gốc mà bạn có thể tự do ghi vào, nhưng được bảo vệ bằng các cổng khi đọc và xử lý các giá trị được lưu trữ. Một trong những cổng có sẵn cho Shared Storage API là Private Aggregation. Bạn chỉ có thể đọc các giá trị trong bộ nhớ dùng chung từ bên trong một worklet và bạn có thể báo cáo các giá trị đó bằng cách sử dụng tính năng Tổng hợp riêng tư từ worklet.

Bạn cũng có thể ghi vào bộ nhớ dùng chung từ các công việc đặt giá thầu, tính điểm và báo cáo của Protected Audience API. Sau đó, bạn có thể báo cáo các giá trị đó trong bộ nhớ dùng chung cho máy chủ bằng cách sử dụng tính năng Tổng hợp riêng tư . Bạn cũng có thể sử dụng các giá trị đã lưu trữ cho toán tử Lựa chọn URL.

Từ một công cụ Protected Audience API, bạn có thể ghi bất kỳ khoá và giá trị nào vào bộ nhớ dùng chung:

// Protected Audience API worklet
function generateBid() {
  sharedStorage.set('test-bucket', 123);
}

Sau đó, bạn có thể tải một worklet bộ nhớ dùng chung để đọc và gửi giá trị đó bằng tính năng Tổng hợp riêng tư:

// Shared Storage worklet
class SendReachReport{
  async run() {
    const testBucket = await this.sharedStorage.get('test-bucket');

    privateAggregation.contributeToHistogram({
      bucket: testBucket,
      value: 1
    });
  }
}

register('send-report', SendReachReport);

Để tìm hiểu thêm về Shared Storage, hãy xem phần bộ nhớ dùng chung trong hướng dẫn dành cho nhà phát triển về báo cáo Protected Audience API, video giải thích, bản minh hoạ trực tiếp và mã minh hoạ trên GitHub.

Tiếp theo là gì?

Chúng tôi muốn thảo luận với bạn để đảm bảo việc 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 lại và thảo luận công khai.

Thử nghiệm với API

Bạn có thể thử nghiệm và tham gia cuộc trò chuyện về Protected Audience API.