שימוש ב-Topics עם בידינג פרוגרמטי ב-Protected Audience

תלמדו על האופן שבו ניתן להשתמש בתחומי עניין מ-Topics כקלט לבידינג ולתהליך המכרז של Protected Audience API. Protected Audience API כולל כמה נקודות שבהן הקונה ואתר המכירה יכולים להעביר אותות מאינטראקציה ישירה לתהליך הבידינג והמכרז. ניתן להשתמש באותות שמסופקים על ידי Topics כדי להעשיר את הנתונים הזמינים בתהליך הבידינג ובחירת המודעות, בעזרת מידע על תחומי העניין הנוכחיים של המשתמשים שמגדילה את הערך הפוטנציאלי של מלאי שטחי הפרסום.

לפני שתקראו את המדריך הזה, חשוב שתכירו את Topics ואת Protected Audience API.

אחזור של נושאים

במהלך הקריאה ל-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
  //...
}