استخدام Topics مع عروض الأسعار الآلية في 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
  //...
}