Protected Audience에서 프로그래매틱 입찰과 함께 Topics 사용

Topics의 관심분야를 Protected Audience 입찰 및 입찰 프로세스에 대한 입력 정보로 사용하는 방법을 알아봅니다. Protected Audience에는 구매자와 판매자가 퍼스트 파티 신호를 입찰 및 입찰 프로세스에 전달할 수 있는 여러 지점이 있습니다. Topics에서 제공하는 신호는 광고 인벤토리의 잠재적 가치를 높이는 현재 사용자 관심분야에 대한 정보로 입찰 및 광고 선택 프로세스 중에 사용 가능한 데이터를 강화하는 데 사용할 수 있습니다.

이 가이드를 읽기 전에 Topics와 Protected Audience를 모두 숙지해야 합니다.

주제 가져오기

Topics API를 호출하면 호출자는 이전에 해당 브라우저에서 관찰한 일부 주제를 보게 됩니다.

const currentTopics = await document.browsingTopics();
// Example result
[
  {
    "configVersion": "chrome.2",
    "modelVersion": "4",
    "taxonomyVersion": "2",
    "topic": 310,
    "version": "chrome.2:2:4"
  }
]

이 경우 주제는 310 '스포츠/사이클'에 매핑됩니다.

이 예에서는 직접 사용되는 주제 값을 보여주지만, 전체 구현에서는 값을 처리하거나 다른 데이터와 결합할 수 있습니다.

주제를 사용하여 조건부로 관심분야 그룹 정의

이렇게 생성된 주제는 사용자를 관심분야 그룹에 추가하는 데 직접 사용될 수 있습니다.

if (currentTopics[0].topic === 310) { // Interest in "Sports/Cycling"
  const interestGroup = {
  owner: 'https://dsp.example',
  name: 'custom-bikes',
  }
}

관심분야 그룹에 구매자 주제 제공

현재 주제 (또는 주제에서 처리된 데이터)는 관심분야 그룹을 만들 때 userBiddingSignals에 포함될 수 있습니다. 이렇게 하면 구매자가 입찰 시 주제를 사용할 수 있습니다.

const interestGroup = {
  owner: 'https://dsp.example',
  name: 'custom-bikes',
  userBiddingSignals: {
    topics: currentTopics,
    ....
  },
  ...
};

navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);

입찰에 판매자 주제 제공

판매자에게 표시되는 현재 주제 (또는 여기에서 처리된 데이터)는 입찰을 구성할 때 auctionSignals, sellerSignals 또는 perBuyerSignals의 조합에 포함될 수 있습니다. 이렇게 하면 구매자는 입찰을 할 때 주제를 사용할 수 있고 판매자는 입찰가를 채점할 때 주제를 사용할 수 있습니다.

const myAuctionConfig = {
  seller: 'https://ssp.example',
  auctionSignals: {
    topics: currentTopics,
  },
  sellerSignals: {
    topics: currentTopics,
  },
  perBuyerSignals: {
    'https://dsp.example': {
      topics: currentTopics,
      // ...
    },
    // ...
  },
  // ...
};
const result = await navigator.runAdAuction(myAuctionConfig);

입찰할 때 주제 사용

그런 다음 구매자의 generateBid() 함수가 호출되면 전달된 기록된 주제를 사용하여 입찰에 도움을 줄 수 있습니다 (신호에 제공된 다른 데이터와 마찬가지로). 예를 들어 입찰자가 '스포츠/사이클'이라는 이름을 사용할 수 있습니다. custom-bikes 관심분야 그룹으로 입찰가를 높이세요.

generateBid(interestGroup, auctionSignals, perBuyerSignals,
    trustedBiddingSignals, browserSignals) {
  const topics = interestGroup.userBiddingSignals.topics;
  // Use the topic values in the bidding logic.
}

입찰 점수 산정 시 주제 사용

판매자의 scoreAd() 함수가 호출될 때 입찰 후 기록된 주제는 입찰 구성에서 전달된 다른 데이터처럼 사용할 수 있습니다. 예를 들어 판매자는 감지된 주제와 일치하는 광고의 입찰가에 더 높은 가중치를 부여하기를 원할 수 있습니다.

scoreAd(adMetadata, bid, auctionConfig, trustedScoringSignals, browserSignals, directFromSellerSignals) {
  const sellerTopics = actionConfig.auctionSignals.topics;
  // or corresponding key in sellerSignals
  // use the topics values to score the ads
  //...
}