از موضوعات با مناقصه برنامه‌ریزی شده در مخاطبین محافظت شده استفاده کنید

نحوه استفاده از علایق موضوعات را به عنوان ورودی به فرآیند مناقصه و حراج مخاطب محافظت شده بیاموزید. مخاطب محافظت شده دارای چندین نقطه است که در آن خریدار و فروشنده ممکن است سیگنال های شخص اول را به فرآیند مناقصه و حراج ارسال کنند. سیگنال‌های ارائه‌شده توسط Topics می‌تواند برای غنی‌سازی داده‌های موجود در طول فرآیند مناقصه و انتخاب آگهی با اطلاعاتی در مورد علایق کاربر فعلی استفاده شود که ارزش بالقوه موجودی آگهی را افزایش می‌دهد.

قبل از خواندن این راهنما، مطمئن شوید که هم با موضوعات و هم با مخاطبان محافظت شده آشنا هستید.

موضوعات را دریافت کنید

هنگام فراخوانی 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
  //...
}