이 문서에는 단일 판매자의 Protected Audience 데이터(현재의 사용할 수 있습니다 한 명의 판매자가 참여하는 입찰은 여러 판매자가 참여하는 보다 복잡한 입찰의 일부로 실행됩니다. 이 이 경우 단일 판매자 입찰은 '구성요소 입찰'이라고 하며 '최상위 입찰'에 광고 조합을 제공할 수 있음 여러 판매자가 있는 있습니다.
Protected Audience API의 전체 수명 주기는 개발자 가이드를 참고하세요. 자세한 내용은 Protected Audience API 설명을 참고하세요. 판매자를 위한 기기 내 입찰을 실행하는 방법을 다룹니다
Protected Audience API 광고 입찰의 6단계
<ph type="x-smartling-placeholder">![Protected Audience API 광고 입찰의 6단계](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/six-stages-a-protected-a-3e1dd6fdeddbe.png?authuser=0000&hl=ko)
- 사용자가 광고가 게재되는 사이트를 방문합니다.
- 판매자 코드가
navigator.runAdAuction()
를 실행합니다. 이것은 입찰할 수 있는 사용자를 나타냅니다. 영업 담당자는 스크립트도 포함해야 합니다.scoreAd()
입니다. - 초대된 구매자의 코드가 실행되어 입찰가, 관련 광고의 URL이 생성됩니다. 광고 소재 및 기타 데이터를 수집합니다. 입찰 스크립트는 실시간 데이터를 쿼리할 수 있습니다. 예를 들어 구매자의 예산에서 키/값 서비스.
- 판매자의 코드가 각 입찰에 점수를 매기고 낙찰자를 선택합니다. 이 로직은 입찰가 및 기타 데이터가 입찰가의 타당성을 반환합니다. 경쟁 우위를 점할 수 없는 광고 최우수 사용자가 거부됩니다. 판매자는 자체 실시간 데이터의 키-값 서비스
- 낙찰된 광고는 불투명 값으로 반환되며 분리된 프레임을 놓칩니다. 판매자와 게시자는 이 값을 볼 수 없습니다.
- 입찰이 판매자 및 낙찰자에게 보고됩니다.
입찰은 게재되는 페이지로 사용자가 이동할 때 진행될 수 있습니다. 광고가 게재될 때 광고 소재가 준비될 수 있도록 입찰을 미리 실행할 수 있습니다. 표시됩니다.
판매자가 광고 입찰을 시작하고 제공된 맞춤 로직을 사용하여 조합 광고의 점수를 매깁니다.
scoreAd()
함수로 제공하고
낙찰받은 구매자뿐 아니라
자신에게 입찰합니다 또한 판매자는
게시자 규칙을 시행하고 scoreAd()
를 사용하여 광고 품질을 필터링합니다.
함수를 사용하세요.
영업 담당자는 다음을 언급할 수 있습니다.
- 웹사이트에서 광고 콘텐츠를 직접 호스팅하는 콘텐츠 게시자
- 광고 게시자와 협력하고 기타 서비스를 제공하는 공급측 플랫폼 (SSP)
- 게시자가 광고 입찰에 참여할 수 있도록 하는 서드 파티 스크립트
입찰 실행을 위한 기본 요건
판매자는 입찰을 실행하려면 두 가지 JavaScript 함수를 정의해야 합니다.
scoreAd()
: 광고 후보 점수를 매깁니다.reportResult()
: 판매자에게 입찰 결과를 직접 보고하는 것을 처리합니다.
이러한 스크립트는 판매자가 소유한 단일 엔드포인트에서 제공해야 합니다.
scoreAd()
판매자는 엔드포인트에서 제공되는 scoreAd()
함수를 정의해야 함
제공할 수 있습니다 엔드포인트는 입찰 구성에서
decisionLogicUrl
입니다. scoreAd()
함수에는 다음과 같은 서명이 있습니다.
scoreAd(
adMetadata,
bid,
auctionConfig,
trustedScoringSignals,
browserSignals,
directFromSellerSignals)
scoreAd()
매개변수는 다음과 같습니다.
adMetaData
: 확인할 수 있습니다 이는 JSON 직렬화 가능 객체로, 판매자와 구매자가 구조를 정의하고 동의해야 합니다.bid
: 입찰가를 나타내는 숫자 값입니다.auctionConfig
: 입찰을 실행하는 데 사용되는 입찰 구성입니다.trustedScoringSignals
: 입찰 시 판매자의 키/값 서버를 사용합니다. 플랫폼은renderUrl
조합 광고를 이 조회의 키로 사용할 수 있습니다.browserSignals
: 브라우저가 알고 있는 정보 및 판매자의 입찰 스크립트에서 있습니다.directFromSellerSignals
는 다음 필드를 포함할 수 있는 객체입니다. **sellerSignals
:auctionConfig.sellerSignals
와 같지만 다음을 사용하여 전달됨directFromSellerSignals
메커니즘. **auctionSignals
:auctionConfig.auctionSignals
와 같지만 다음을 사용하여 전달됨directFromSellerSignals
메커니즘.
다음은 browserSignals
의 예입니다. renderUrl
는
조합 광고는 다음 신호를 통해 제공됩니다.
{ 'topWindowHostname': 'www.example-publisher.com',
'interestGroupOwner': 'https://www.example-buyer.com',
'renderURL': 'https://cdn.com/render_url_of_bid',
'renderSize': {width: 100, height: 200}, /* if specified in the bid */
'adComponents': ['https://cdn.com/ad_component_of_bid',
'https://cdn.com/next_ad_component_of_bid',
...],
'biddingDurationMsec': 12,
'bidCurrency': 'USD', /* bidCurrency returned by generateBid, or '???' if none */
'dataVersion': 1, /* Data-Version value from the trusted scoring signals server's response */
}
reportResult()
판매자는 reportResult()
함수를 정의하고
사용할 수 있습니다 엔드포인트가 입찰 구성에 지정됩니다.
decisionLogicUrl
로 설정합니다. reportResult()
함수에는 다음이 있습니다.
서명:
reportResult(auctionConfig, browserSignals) {
...
return signalsForWinner;
}
reportResult()
매개변수는 다음과 같습니다.
auctionConfig
: 입찰을 실행하는 데 사용되는 입찰 구성입니다.browserSignals
: 브라우저가 알고 있는 정보 및 판매자의 입찰 스크립트에서 있습니다. 이 객체는scoreAds()
함수에 전달되는 것과 동일한 객체입니다.
reportResult()
는 임의의 JSON 객체인 signalsForWinner
를 반환합니다.
낙찰자의 보고 기능에 전달됩니다. 여기에는
구매자가 입찰에 대해 제공할 수 있는 관련 정보
해야 합니다.
Protected Audience API 입찰 실행
판매자가 입찰을 실행하기 위해 거쳐야 하는 네 가지 주요 단계가 있습니다. 이러한 단계에서는 판매자가 필수 JavaScript를 반환하도록 엔드포인트가 설정되어 있다고 가정합니다. 참조하세요.
- 입찰을 구성합니다. 이 단계에는
auctionConfig
객체 생성이 포함됩니다. 이를 통해 판매자가 입찰 중에 관련성이 있을 수 있는 모든 신호를 제공합니다. 영향을 미칩니다. navigator.runAdAuction()
를 호출하고 다음을 전달하여 입찰을 실행합니다. 이전 단계에서 만든 구성을 사용합니다. 이렇게 하면 구매자 체인이 시작되며 입찰 생성 및 점수 산정에 차질이 발생할 수 있습니다. 이 단계의 최종 결과는 광고 조합입니다. 렌더링될 수 있는 광고 단위 수입니다.- 분리 프레임 또는 iframe에서 낙찰된 광고를 렌더링합니다.
- 입찰 결과를 보고합니다. 함수가 있습니다.
navigator.sendReportTo()
를 선택하면 보고가 시작됩니다. 판매자는 항상 입찰 결과 보고서를 받게 됩니다 낙찰을 받은 구매자만 보고서가 전송됩니다 앞에서 설명한 판매자의reportResult()
를 사용합니다. 서버에 보고할 수 있습니다.