Protected Audience'ta programatik teklif verme ile Topics'i kullanma

Konular'daki ilgi alanlarını, Protected Audience teklif ve açık artırma süreci için giriş olarak nasıl kullanacağınızı öğrenin. Korunan Kitlede, alıcı ve satıcının teklif verme ve açık artırma sürecine birinci taraf sinyalleri iletebileceği birkaç nokta bulunur. Topics'in sağladığı sinyaller, reklam envanterinin potansiyel değerini artıran mevcut kullanıcı ilgi alanları hakkındaki bilgilerle teklif verme ve reklam seçimi sürecinde mevcut verileri zenginleştirmek için kullanılabilir.

Bu kılavuzu okumadan önce hem Topics hem de Protected Audience (Korunan Kitle) hakkında bilgi sahibi olduğunuzdan emin olun.

Konuları alma

Topics API'yi çağıran kullanıcı, söz konusu tarayıcıda daha önce gözlemlediği konuların bir seçkisini görür.

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

Bu örnekte: 310 konusu "Spor/Bisiklet" ile eşlenir.

Bu örneklerde, doğrudan kullanılan konu değerleri gösterilmektedir ancak uygulama, bunları işlemeyi veya diğer verilerle birleştirmeyi tercih edebilir.

Bir ilgi alanı grubunu koşullu olarak tanımlamak için konuları kullanma

Oluşturulan konu, kullanıcıları bir ilgi alanı grubuna eklemeyi seçmek için doğrudan kullanılabilir.

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

Bir ilgi alanı grubuna alıcı konuları sağlama

Mevcut konular (veya bunlardan işlenen veriler), ilgi alanı grubu oluşturulurken userBiddingSignals kapsamına dahil edilebilir. Bu, alıcının teklif verirken konuları kullanmasına olanak tanır.

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

navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);

Açık artırmaya satıcı konuları sağlama

Satıcının görebildiği mevcut konular (veya bunlardan işlenen veriler), açık artırma yapılandırılırken auctionSignals, sellerSignals ya da perBuyerSignals öğelerinin bir kombinasyonuna dahil edilebilir. Bu, hem alıcının teklif verirken konuları kullanmasına hem de satıcının teklifleri puanlarken konuları kullanmasına olanak tanır.

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

Teklif verirken konuları kullanın

Daha sonra, alıcının generateBid() işlevi çağrıldığında, iletilen kayıtlı konular (sinyallerde sağlanan diğer tüm veriler gibi) teklif vermeye yardımcı olmak için kullanılabilir. Örneğin, teklif veren bu custom-bikes ilgi alanı grubuyla daha yüksek teklif vermek için "Spor/Bisiklet" konusunun varlığını kullanabilir.

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

Teklifleri puanlarken konuları kullanın

Satıcının scoreAd() işlevi çağrıldığında teklif verildikten sonra, kaydedilen konular, açık artırma yapılandırmasından iletilen diğer veriler gibi kullanılabilir. Örneğin, satıcı, tespit edilen konularla eşleşen reklamlar için tekliflerin daha yüksek ağırlığını artırmak isteyebilir.

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