تقديم عرض سعر في مزاد لشراء خانة إعلانية

بصفتك مشتري إعلانات (منصّات عرض الطلب والمعلِنين)، قد يهمّك المشاركة في مزاد إعلانات Protected Audience على موقع الناشر الإلكتروني لاستهداف مجموعة الاهتمامات التي حدّدتها على موقع المعلِن الإلكتروني. من خلال المشاركة في مزاد Protected Audience API، يمكنك الوصول إلى عملائك المحدّدين على مواقع إلكترونية أخرى بطريقة تحافظ على الخصوصية.

في مزاد Protected Audience، يمكنك تقديم منطق لإنشاء عرض السعر، ويحسب المتصفّح عرض السعر باستخدام هذا المنطق. يختلف ذلك عن بنى المزادات الأخرى التي تُرسِل فيها عرض السعر مباشرةً بدلاً من تقديم منطق العرض.

يمكنك تقديم منطق إنشاء عروض الأسعار في دالة JavaScript 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() عنصرًا يتضمّن السمات التالية: