게시자 페이지에서 광고 입찰 설정

Protected Audience API 입찰을 구성하는 방법을 알아보세요.

판매자가 실행하는 기기 내 입찰

기기 내 Protected Audience 입찰은 광고 공간을 판매하는 사이트에서 실행됩니다. 입찰을 실행하는 당사자를 판매자로 지칭합니다. 많은 당사자가 판매자: 사이트에서 자체적으로 광고 입찰을 실행할 수도 있고 또는 SSP를 사용하여 입찰을 실행할 수도 있고, 기기 내 입찰을 다른 서버 측 광고 입찰 활동과 함께 사용할 수 있습니다. 판매자: 세 가지 기본 작업이 있다고 가정해 보겠습니다.

  1. 판매자가 (a) 참여할 수 있는 구매자 및 (b) 해당 구매자의 입찰에 참여할 수 있습니다. 이를 통해 판매자는 Google 디스플레이 네트워크의 있습니다.
  2. 판매자는 입찰의 비즈니스 로직(JavaScript)에 대한 책임이 있습니다. 자동으로 처리하여 각 입찰의 가격과 메타데이터를 고려하고 '호감도' 있습니다. 호감도 점수가 가장 높은 입찰가가 입찰에서 입찰할 수 있습니다.
  3. 판매자는 다음과 같은 정보를 포함하여 입찰 결과에 대한 보고를 수행합니다. 모든 지불금이 있습니다. 낙찰에 성공한 구매자와 낙찰에 실패한 구매자도 직접 보고할 수 있습니다

이 문서에서는 기기 내 입찰을 구성하고 시작하는 방법을 설명합니다.

Protected Audience API 광고 입찰 구성

Protected Audience API 광고 입찰을 실행하기 위한 첫 번째 단계는 입찰을 구성합니다. auctionConfig 객체를 만들면 됩니다. 다음은 이러한 구성의 예입니다.

const auctionConfig = {
  seller: 'https://seller.example',
  decisionLogicUrl: ...,
  trustedScoringSignalsUrl: ...,
  interestGroupBuyers: ['https://buyer-1.example', 'https://buyer-2.example', ...],
  auctionSignals: {...},
  sellerSignals: {...},
  sellerTimeout: 100,
  perBuyerSignals: {
    'https://buyer-1.example': {...},
    'https://buyer-2.example': {...},
    ...
  },
  perBuyerTimeouts: {
    'https://buyer-1.example': 50,
    'https://buyer-2.example': 200,
    '*': 150,
    ...
  },
  componentAuctions: [
    {
      'seller': 'https://component-seller.example',
      'decisionLogicUrl': ...,
      ...
    },
    ...
  ],
  resolveToConfig: [true|false],
};

숙박 시설 AuctionConfig개

필수 속성

auctionConfigs에 필요한 유일한 속성은 seller입니다. decisionLogicUrl, interestGroupBuyers

속성 예 역할
판매자 https://seller.example 판매자의 출발지입니다.
decisionLogicUrl https://seller.example/decision-logic.js 입찰 JavaScript 결정 로직 Worklet의 URL입니다. 이 필드의 출처는 판매자 필드와 동일해야 합니다.
interestGroupBuyers [https://buyer-1.example,
https://buyer-2.example,
...]		 입찰에 참여하도록 요청한 모든 관심분야 그룹 소유자의 출처

선택 속성

auctionConfigs의 나머지 속성은 선택사항입니다.

속성 예 역할
trustedScoringSignalsUrl https://seller.example/scoring-signals 판매자 키/값 서버의 URL입니다. 이는 광고 소재의 렌더링 URL을 키로 사용하여 광고 채점 과정 중에 쿼리됩니다. 이 필드의 출처는 판매자 필드와 동일해야 합니다.
auctionSignals {"category":"news"} 입찰에 참여하는 모든 구매자 및 판매자에게 제공되는 신호를 나타내는 JSON 직렬화 가능한 객체입니다.
sellerSignals {...} 판매자에게만 제공되는 신호를 나타내는 JSON 직렬화 가능한 객체입니다.
perBuyerSignals {https://dsp.example: {...},
https://another-buyer.example: {...},
... }		 특정 구매자가 사용할 수 있는 신호입니다. 신호는 판매자 또는 구매자 자체에서 가져올 수 있습니다.
perBuyerTimeouts {https://www.example-dsp.com: 50,
https://www.another-buyer.com: 200,
*: 150,
...}님, 안녕하세요.		 특정 구매자의 generateBid() 스크립트의 최대 런타임(밀리초)입니다. 특정 제한시간이 정의되지 않은 모든 구매자에게는 와일드 카드 기호가 적용됩니다.
sellerTimeout 100 판매자의 scoreAd() 스크립트의 최대 런타임(밀리초)입니다.
componentAuctions [{seller: https://www.some-other-ssp.com, decisionLogicUrl: ..., ...}, ...] 구성요소 입찰을 위한 추가 구성
resolveToConfig 참|거짓 runAdAuction()에서 반환된 프라미스를 전달하여 true인 경우 FencedFrameConfig (<fensedframe>에 사용)로, false인 경우 불투명 urn:uuid URL (<iframe>에서 사용)을 전달하는 불리언입니다. 기본값은 false입니다.

비동기식으로 신호 제공

일부 신호의 값 (auctionSignals에서 구성된 신호 값, sellerSignals, perBuyerSignals, perBuyerTimeouts 필드)는 선택사항으로 구체적인 값이 아니라 프로미스로 제공되어야 합니다. 이를 통해 입찰의 일부 부분(예: 스크립트 로드 및 신뢰할 수 있는 신호 로드) 컴퓨팅 (또는 네트워크)과 중첩되는 격리된 워크렛 프로세스의 시작 검색)으로 변환할 수 있습니다. worklet 스크립트는 값 해당 프라미스가 거부되면 이미 실패하거나 다른 방식으로 낙태될 수 있었습니다.

여러 판매자를 대상으로 입찰 구성

경우에 따라 여러 판매자가 입찰에 참여하고 싶을 수 있습니다. 낙찰자가 다른 입찰로 넘어가고, 있습니다. 이렇게 전달된 개별 입찰을 구성요소 입찰이라고 합니다. 이러한 구성요소 입찰을 용이하게 하기 위해 componentAuctions 객체에는 각 판매자의 구성요소 입찰에 대한 추가적인 입찰 구성 이 각 구성요소 입찰의 낙찰가는 '최상위' 입찰의 최종 결정을 내립니다. 이 구성요소 입찰의 auctionConfig에 자체 입찰이 없을 수 있습니다. componentAuctions입니다. componentAuctions가 비어 있지 않은 경우 interestGroupBuyers은(는) 비어 있어야 합니다. 즉, 특정 '보호' 항목, 잠재고객 입찰: 단일 판매자가 있고 구성요소 입찰이 없는 경우 그렇지 않은 경우에는 모든 입찰가가 구성요소 입찰에서 발생하며, 최상위 입찰에서는 구성요소 입찰 중에서 있습니다.

입찰 실행

판매자는 다음과 같은 방법으로 사용자의 브라우저에 광고 입찰을 시작하도록 요청합니다. navigator.runAdAuction()를 호출합니다.

try {
  const auctionResultPromise = navigator.runAdAuction(auctionConfig);
} catch (error) {
  // Handle error.
}

runAdAuction() 호출은 광고로 확인되는 프로미스를 반환합니다. 그렇지 않습니다. 게시자 페이지의 코드가 낙찰된 광고를 검사하거나 그렇지 않으면 runAdAuction()의 결과에서 콘텐츠에 관해 학습합니다. 만약 AuctionConfig에서 resolveToConfig 플래그가 true로 설정되었습니다. 분리 모드에서만 렌더링될 수 있는 FencedFrameConfig 객체가 반환됩니다. 있습니다. 플래그가 false로 설정되면 불투명 URN이 반환되며 이는 렌더링되지 않습니다. runAdAuction이 null 값을 반환할 수 있습니다. - 광고가 선택되지 않았음을 나타냅니다. 이 경우 판매자는 문맥 타겟팅 광고 렌더링