Protected Audience API 입찰 결과 보고

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

이 도움말은 현재 실험용 Protected Audience API의 반복에서 사용되는 Protected Audience API 입찰 승리에 대한 보고서를 생성하기 위한 기술 참고 자료입니다.

Protected Audience API의 전체 수명 주기는 개발자 가이드를 참고하고 이벤트 수준 보고 (임시)에 관한 자세한 내용은 Protected Audience API 설명서를 참고하세요.

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

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

사용 가능한 Protected Audience 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://settings/adPrivacy에서 모든 Ad Privacy API를 사용 설정하면 Chrome에서 기본적으로 사용할 수 있습니다. Protected Audience API를 사용 설정하는 명령줄 플래그를 사용하여 Chrome을 실행하는 경우 BiddingAndScoringDebugReportingAPI 플래그를 포함하여 메서드를 명시적으로 사용 설정해야 합니다. 플래그가 사용 설정되지 않은 경우 메서드는 계속 사용할 수 있지만 아무 작업도 실행하지 않습니다.

모든 Protected Audience API API 참조

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

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

다음 단계

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

API에 관해 논의하기

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

API 실험

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