Protected Audience API 입찰 결과 보고

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>
  }

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

구매자: 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() 및 generateBid()에서 서로 다른 URL 인수를 사용하여 여러 번 호출할 수 있습니다.

Chrome은 입찰이 완료될 때만 디버그 손실/낙찰 보고서를 전송합니다. 입찰이 취소되면 (예: 새로운 탐색으로 인해) 보고서가 생성되지 않습니다.

chrome://flags/#privacy-sandbox-ads-apis가 사용 설정된 경우 기본적으로 Chrome에서 이 메서드를 사용할 수 있습니다. 그러나 명령줄 플래그와 함께 Chrome을 실행하여 Protected Audience API를 사용 설정하는 경우 BiddingAndScoringDebugReportingAPI 플래그를 포함하여 메서드를 명시적으로 사용 설정해야 합니다. 플래그가 사용 설정되지 않은 경우에도 메서드는 계속 사용할 수 있지만 아무 작업도 하지 않습니다.

모든 Protected Audience API 참조

다음과 같은 API 참조 가이드를 이용할 수 있습니다.

Protected Audience API 설명에서는 기능 지원 및 제약조건에 대한 세부정보도 제공합니다.

다음 단계

Google은 누구나 사용할 수 있는 API를 빌드할 수 있도록 개발자 여러분과 대화를 나누고 싶습니다.

API에 관해 논의하기

다른 개인 정보 보호 샌드박스 API와 마찬가지로 이 API는 문서화되고 공개적으로 논의됩니다.

API 실험

Protected Audience API에 관한 대화에 실험하고 참여할 수 있습니다.