استخدام Topics مع عروض الأسعار الآلية في Protected Audience

تعرَّف على كيفية استخدام الاهتمامات من Topics كإدخال في عملية المزادات وعروض أسعار Protected Audience API. تتضمّن Protected Audience عدة نقاط يمكن فيها للمشتري والبائع تمرير إشارات الطرف الأول إلى عملية عروض الأسعار والمزاد. ويمكن استخدام الإشارات المقدَّمة من Topics لإثراء البيانات المتاحة أثناء عملية اختيار عروض الأسعار والإعلانات بمعلومات عن اهتمامات المستخدمين الحاليين، ما يزيد من القيمة المحتملة للمساحة المتوفّرة للإعلانات.

قبل قراءة هذا الدليل، تأكّد من أنّك على دراية بكل من Topics وProtected Audience.

الحصول على المواضيع

عند استدعاء 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
  //...
}