برای خرید جایگاه آگهی در یک حراج پیشنهاد دهید

به عنوان یک خریدار آگهی (DSPها و تبلیغ‌کنندگان)، ممکن است علاقه‌مند به شرکت در حراج تبلیغاتی مخاطبان محافظت‌شده در سایت ناشر باشید تا تبلیغی را به گروه مورد علاقه‌ای که در سایت تبلیغ‌کننده تعریف کرده‌اید، هدف قرار دهید. با شرکت در حراج مخاطبان محافظت‌شده، می‌توانید به مشتریان شناسایی‌شده خود در سایت‌های دیگر به روشی با حفظ حریم خصوصی دسترسی پیدا کنید.

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

شما منطق تولید پیشنهاد خود را در تابع جاوا اسکریپت generateBid() ارائه می‌دهید و فایل روی سرور شما میزبانی می‌شود. وقتی کاربری را به یک گروه علاقه‌مندی اضافه می‌کنید ، مکان این فایل به عنوان biddingLogicUrl به پیکربندی گروه علاقه‌مندی ارسال می‌شود.

در طول حراج، مرورگر منطق پیشنهاد قیمت شما را که در فیلد biddingLogicUrl مشخص شده است، دریافت می‌کند و تابع generateBid() شما را برای هر گروه ذینفع در یک محیط ایزوله امن که ارتباط آن با زمینه خارجی محدود است، اجرا می‌کند. هنگام اجرای generateBid() ، مرورگر سیگنال‌هایی را به عنوان آرگومان به تابع ارسال می‌کند. این سیگنال‌ها حاوی اطلاعات مختلفی از منابع مختلف، مانند داده‌های شخص اول ناشر، داده‌های فروشنده، داده‌های بلادرنگ و موارد دیگر هستند. می‌توانید از این سیگنال‌ها برای محاسبه پیشنهاد قیمت استفاده کنید و مقدار از فراخوانی generateBid() بازگردانده می‌شود. پس از ارسال پیشنهادها، مرورگر منطق امتیازدهی فروشنده را برای هر پیشنهاد اجرا می‌کند تا امتیاز مطلوبیت فروشنده محاسبه شود.

generateBid()

موارد زیر آرگومان‌های تابع generateBid() و ساختار پیشنهاد برگشتی از تابع را شرح می‌دهد:

generateBid(interestGroup, auctionSignals, perBuyerSignals,
    trustedBiddingSignals, browserSignals, directFromSellerSignals) {
  return {
    ad: adObject,
    adCost: optionalAdCost,
    bid: bidValue,
    bidCurrency: 'USD',
    render: {
      url: renderURL,
      width: renderWidth,
      height: renderHeight
    },
    adComponents: [
      {url: adComponent1, width: componentWidth1, height: componentHeight1},
      {url: adComponent2, width: componentWidth2, height: componentHeight2},
      // ...
    ],
    allowComponentAuction: false,
    modelingSignals: 123 // 0-4095 integer (12-bits)
  };
}

استدلال‌ها

generateBid() آرگومان‌های زیر را دریافت می‌کند:

سیگنال‌های مرورگر

شیء browserSignals دارای ویژگی‌های زیر است:

{
  topWindowHostname: 'publisher.example',
  seller: 'https://ssp.example',
  topLevelSeller: 'https://www.top-level-ssp.com',
  requestedSize: {width: 100, height: 200},  /* if specified in auction config */
  joinCount: 3,
  recency: 3600000,
  bidCount: 17,
  prevWinsMs: [[timeDeltaMs1,ad1],[timeDeltaMs2,ad2],...],
  wasmHelper: ...
  dataVersion: 1,
  adComponentsLimit: 40
}

محاسبه پیشنهاد قیمت

برای محاسبه‌ی مقدار پیشنهاد، کد موجود در generateBid() می‌تواند از ویژگی‌های پارامترهای تابع استفاده کند.

برای مثال:

function generateBid(interestGroup, auctionSignals, perBuyerSignals,
    trustedBiddingSignals, browserSignals) {
  return {
   //  ...
    bid: auctionSignals.is_above_the_fold ? perBuyerSignals.atf_value : perBuyerSignals.btf_value,
    // ...
  }
}

پیشنهاد قیمت را برگردانید

generateBid() یک شیء با ویژگی‌های زیر برمی‌گرداند: