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
  //...
}