이 페이지는 Cloud Translation API를 통해 번역되었습니다.

단일 판매자를 대상으로 브라우저 기반 입찰 진행

이 문서에는 단일 판매자의 Protected Audience 데이터(현재의 사용할 수 있습니다 한 명의 판매자가 참여하는 입찰은 여러 판매자가 참여하는 보다 복잡한 입찰의 일부로 실행됩니다. 이 이 경우 단일 판매자 입찰은 '구성요소 입찰'이라고 하며 '최상위 입찰'에 광고 조합을 제공할 수 있음 여러 판매자가 있는 있습니다.

Protected Audience API의 전체 수명 주기는 개발자 가이드를 참고하세요. 자세한 내용은 Protected Audience API 설명을 참고하세요. 판매자를 위한 기기 내 입찰을 실행하는 방법을 다룹니다

Protected Audience API 광고 입찰의 6단계

사용자가 광고가 게재되는 사이트를 방문합니다.
판매자 코드가 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()를 사용합니다. 서버에 보고할 수 있습니다.