Protected Audience API 입찰 결과 보고

Protected Audience API 입찰 보고서를 생성하는 판매자 및 구매자 가이드

이 도움말은 Protected Audience API 입찰이 낙찰됨(실험의 현재 반복에서 사용됨) Protected Audience API

전체 기간 동안 개발자 가이드를 참고하세요. 하고, Protected Audience API 설명에서 이벤트 수준 보고 (임시).

개발자가 아니신가요? Protected Audience API 개요를 참고하세요.

Protected Audience API는 무엇을 보고하나요?

Protected Audience API 보고서에는 두 가지가 있습니다.

  • 판매자 보고서: 판매자에게 광고 입찰 낙찰자를 알립니다.
  • 구매자 보고서: 낙찰자에게만 제공되며, 입찰에서 낙찰되었음을 알 수 있습니다.

장기적인 계획은 브라우저가 Private Aggregation API API를 사용하여 판매자와 구매자를 구분합니다. 임시 이벤트 수준 보고 메커니즘으로서 판매자의 경우 reportResult(), 낙찰자에게는 reportWin()가 sendReportTo() 함수를 호출합니다. 단일 인수(문자열)를 사용합니다. 입찰이 완료된 후 가져오는 URL을 나타내며, 보고해야 합니다.

API 함수

판매자: reportResult()

decisionLogicUrl에 제공된 판매자의 JavaScript( scoreAd())에는 입찰을 보고하기 위한 reportResult() 함수를 포함할 수 있습니다. 있습니다.

reportResult(auctionConfig, browserSignals) {
  ...
  return signalsForWinner;
}

이 함수에 전달되는 인수는 다음과 같습니다.

auctionConfig

navigator.runAdAuction()에 전달된 입찰 구성 객체입니다.

browserSignals

브라우저에 의해 생성되는 객체로서 입찰에 대한 정보를 제공합니다. 예를 들면 다음과 같습니다.

  {
    'topWindowHostname': 'publisher.example',
    'interestGroupOwner': 'https://dsp.example',
    'renderUrl': 'https://cdn.example/url-of-winning-creative.wbn',
    'bid': <bidValue>,
    'desirability': <winningAdScore>
  }

이 함수의 반환 값은 다음에 대한 sellerSignals 인수로 사용됩니다. 낙찰자의 reportWin() 함수

구매자: reportWin()

낙찰자의 JavaScript (generateBid()도 제공함)는 다음을 수행할 수 있습니다. 입찰 결과를 보고하는 reportWin() 함수를 포함합니다.

reportWin(auctionSignals, perBuyerSignals, sellerSignals, browserSignals) {
  ...
}
드림

이 함수에 전달되는 인수는 다음과 같습니다.

auctionSignals 및 perBuyerSignals

낙찰된 항목의 generateBid()에 동일한 값 전달 있습니다.

sellerSignals

reportResult()의 반환 값으로, 판매자에게 구매자에게 정보를 전달할 수 있는 기회를 제공합니다.

browserSignals

브라우저에 의해 생성되는 객체로서 입찰에 대한 정보를 제공합니다. 예를 들면 다음과 같습니다.

{
  'topWindowHostname': 'publisher.example',
  'seller': 'https://ssp.example',
  'interestGroupOwner': 'https://dsp.example',
  'interestGroupName': 'custom-bikes',
  'renderUrl': 'https://cdn.example/winning-creative.wbn',
  'bid': <bidValue>
}

임시 보고 구현

일시적으로 Chrome에서 입찰 보고를 위해 다음 두 가지 방법을 사용할 수 있습니다.

  • forDebuggingOnly.reportAdAuctionLoss()
  • forDebuggingOnly.reportAdAuctionWin()

이러한 메서드는 각각 입찰이 실행된 후 가져올 URL인 단일 인수를 사용합니다. 완료되었습니다. scoreAd() 및 둘 다에서 여러 번 호출될 수 있습니다. URL 인수가 다른 generateBid()

Chrome은 입찰이 완료될 때까지만 디버그 손실/낙찰 보고서를 전송합니다. 만약 새 탐색 등으로 인해 입찰이 취소되면 있습니다.

이러한 메서드는 chrome://settings/adPrivacy에서 모든 광고 개인 정보 보호 API를 사용 설정하면 Chrome에서 기본적으로 사용할 수 있습니다. 다음을 실행하는 경우: 명령줄 플래그가 포함된 Chrome에서 Protected Audience API를 사용 설정하는 경우 BiddingAndScoringDebugReportingAPI 플래그를 포함하여 메서드를 명시적으로 사용 설정해야 합니다. 플래그가 사용 설정되지 않은 경우 메서드는 계속 사용할 수 있지만 아무것도 하지 않습니다.

모든 Protected Audience API 참조

API reference guides are available:

The Protected Audience API explainer also provides detail about feature support and constraints.

What's next?

We want to engage in conversations with you to ensure we build an API that works for everyone.

Discuss the API

Like other Privacy Sandbox APIs, this API is documented and discussed publicly.

Experiment with the API

You can experiment and participate in conversation about the Protected Audience API.