Используйте темы с программным назначением ставок в Защищенной аудитории

Узнайте, как использовать интересы из тем в качестве входных данных для торгов и аукционов защищенной аудитории. В Защищенной аудитории есть несколько точек, где покупатель и продавец могут передавать собственные сигналы в процесс торгов и аукциона. Сигналы, предоставляемые 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 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
  //...
}