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