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

Topics'teki ilgi alanlarını Protected Audience teklifi ve açık artırma sürecinde girdi olarak nasıl kullanacağınızı öğrenin. Korunan Kitle, alıcının ve satıcının teklif verme ve açık artırma sürecine birinci taraf sinyallerini iletebileceği çeşitli noktalara sahiptir. Topics tarafından sağlanan sinyaller, teklif verme ve reklam seçimi sırasında kullanılabilen verileri, reklam envanterinin potansiyel değerini artıran mevcut kullanıcı ilgi alanları hakkındaki bilgilerle zenginleştirmek amacıyla kullanılabilir.

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

Konuları alma

Topics API'yi çağırırken arayan kişi, ilgili tarayıcı için 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 durumda konu: 310 "Spor/Bisiklet" ile eşleşir.

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

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

Ortaya çıkan konu, bir kullanıcıyı 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 bölümüne 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ını ekleme

Satıcının gördüğü mevcut konular (veya bunlardan işlenen veriler), açık artırma yapılandırılırken auctionSignals, sellerSignals veya perBuyerSignals 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 veriler gibi) teklif vermeye yardımcı olmak için kullanılabilir. Örneğin, teklif veren "Spor/Bisiklet" bu custom-bikes ilgi alanı grubuyla daha yüksek teklif verebilirsiniz.

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 verdikten sonra, kaydedilen konular açık artırma yapılandırmasından iletilen diğer tüm veriler gibi kullanılabilir. Örneğin satıcı, algılanan konularla eşleşen reklamlar için daha yüksek teklifler vermek 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
  //...
}