عروض على Protected Audience

تنفيذ الصفقات، المعروفة أيضًا باسم "السوق الخاص" (PMP)، في مزاد يستخدم Protected Audience API

نظرة عامة

تقدّم الصفقات، التي تُعرف أيضًا باسم "السوق الإعلاني الخاص"، إمكانية وصول منظَّمة أو أسعارًا مفضّلة للمشترين على مجموعة فرعية من المستودع الإعلاني. لتسهيل الصفقات الآلية، يتم استخدام معرّفات المقاعد وأرقام تعريف الصفقات:

  • تنشأ رقم تعريف المقعد من المشتري، وهو المعرّف الذي يمثّل عميل المشتري. قد يكون لرقم تعريف المقعد آثار على الفوترة، على سبيل المثال، إذا كان هناك خصم لدى بائع معيّن.
  • ينشئ رقم تعريف الصفقة إما المشتري أو البائع، وهو معرّف يمثّل اتفاقية بين المشتري والبائع. قد يحتوي رقم تعريف الصفقة على خصائص مثل التكلفة/السعر، والالتزام بالعدد، ومعلومات الجمهور، والحقوق الحصرية، والمزيد.

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

جولة تفصيلية

في ما يلي خطوات تسهيل الصفقات في مزاد Protected Audience API:

  1. يسجّل المشتري معرّفات الصفقة والمقاعد في إعدادات مجموعة الاهتمامات قبل بدء المزاد.
    • يمكن ضبط أرقام تعريف الصفقات والمقاعد في الحقل أرقام تعريف إعداد التقارير القابلة للاختيار (selectableBuyerAndSellerReportingIds).
    • إذا كان رقم تعريف المقعد هو نفسه لجميع الصفقات، يمكن ضبط رقم تعريف المقعد هذا في buyerAndSellerReportingId، ويمكن إعداد أرقام تعريف الصفقات في حقل أرقام تعريف التقارير القابلة للاختيار (selectableBuyerAndSellerReportingIds).
  2. أثناء إنشاء عروض الأسعار، تصبح أرقام تعريف الصفقات والمقاعد متاحة. يختار المشتري رقم تعريف صفقة من selectableBuyerAndSellerReportingIds. ينشئ المشتري عرض سعر يشتمل على معرّف صفقة مرتبط بعرض السعر هذا عن طريق إرجاع selectedBuyerAndSellerReportingId. لا يمكن أن يفوز عرض السعر بالمزاد إلا إذا كان رقم تعريف الصفقة المعروضة مجهولاً إلى جانب أرقام تعريف أخرى لإعداد التقارير واختر مواقع لمجموعة الاهتمامات.
  3. أثناء نتيجة الإعلان، تصبح أرقام تعريف الصفقات والمقاعد المحدّدة متاحة للبائع.
  4. تصبح أرقام تعريف الصفقات والمقاعد متاحة في وظائف إعداد التقارير لدى البائع.
  5. تصبح أرقام تعريف الصفقات والمقاعد متاحة في وظائف الإبلاغ للمشتري.

1. تسجيل معرّفات الصفقة والمقاعد

يسجِّل المشتري أرقام تعريف الصفقات والمقاعد في إعدادات مجموعة الاهتمامات قبل إجراء المزاد. يتم ضبط أرقام تعريف الصفقات والمقاعد في selectableBuyerAndSellerReportingIds كمصفوفة من السلاسل. إذا كان رقم تعريف المقعد هو نفسه لجميع الصفقات، ولا يلزم تكراره، يمكن إضافة رقم تعريف المقعد في الحقل buyerAndSellerReportingId الذي يقبل سلسلة:

const interestGroupConfig = {
  owner: 'https://buyer.example',
  name: 'example-ig',
  ad: [
    {
      renderURL: 'https://buyer.example/ad.html',
      selectableBuyerAndSellerReportingIds: ['deal123', 'deal456', 'deal789'], // Deal IDs
      buyerAndSellerReportingId: 'seat123', // Seat ID

      // Though it is not used to facilitate deals, the buyer
      // reporting ID can be defined with other reporting IDs
      buyerAndReportingId: 'brid123'
    },
  ],
};

navigator.joinAdInterestGroup(interestGroupConfig);

إذا كان رقم تعريف المقعد مختلفًا عن الصفقات، يمكن استخدام الإعداد التالي:

const interestGroupConfig = {
  owner: 'https://buyer.example',
  name: 'example-ig',
  ad: [
    {
      renderURL: 'https://buyer.example/ad.html',
      selectableBuyerAndSellerReportingIds: [
        'deal123seat123',
        'deal456seat456',
        'deal789seat456'
      ], // Deal and Seat IDs
    },
  ],
};

navigator.joinAdInterestGroup(interestGroupConfig);

2. أرقام تعريف الصفقات والمقاعد للمشترين أثناء إنشاء عروض الأسعار

أثناء إنشاء عروض الأسعار، يقرِّر المشتري ما إذا كان يريد تقديم عرض سعر لمعرّف الصفقة. في generateBid()، يمكن للمشتري اختيار معرّف صفقة من selectableBuyerAndSellerReportingIds وعرض القيمة على أنّها selectedBuyerAndSellerReportingId. تم رفض عرض السعر إذا لم يكن رقم تعريف الصفقة المحدّد في مصفوفة selectableBuyerAndSellerReportingIds.

function generateBid(..., browserSignals, ...) {
  const {
    buyerAndSellerReportingId, // 'seat123'
    selectableBuyerAndSellerReportingIds // ['deal123', 'deal456', 'deal789']
    buyerAndReportingId // 'brid123' - Not used for deals, but the value is available
  } = browserSignals;

  // ...

  return {
    bid: 1,
    render: 'https://buyer.example/ad.html',
    selectedBuyerAndSellerReportingId: 'deal456', // Buyer selects a deal ID
  };
}

لا يمكن لعرض سعر يتضمّن قيمة معروضة بقيمة selectedbuyerAndSellerReportingId في المزاد إلا إذا كانت قيمة selectedbuyerAndSellerReportingId مجهولة الهوية بشكل مشترَك مع buyerAndSellerReportingId (في حال توفّرها) وbuyerReportingId (في حال توفّرها) مالك مجموعة الاهتمامات وعنوان URL للنص البرمجي لعرض الأسعار وعنوان URL للعرض وحجم الإعلان (يتم استبعاد حجم الإعلان من عملية التحقّق هذه حتى الربع الأول من عام 2025 على الأقل).

حتى إذا تمّ تحديد selectablebuyerAndSellerReportingIds في إعدادات مجموعة الاهتمامات، سيظلّ من الصالح أن تعرِض generateBid() عرض سعر لا يتضمّن selectedbuyerAndSellerReportingId. وفي هذه الحالة، ستتّبع أرقام تعريف إعداد التقارير المقدَّمة لدوالّ إعداد التقارير في حال فوز عرض السعر هذا سلوك رقم تعريف إعداد التقارير غير القابل للاختيار.

في الحالات التي تتم فيها إعادة تشغيل generateBid() لأنّ الاستدعاء الأوّلي لم ينتج عنه أي عروض أسعار تتضمّن الإعلانات التي اجتازت عمليات التحقّق من الكشف عن الهوية التصنيفية، لن تكون selectableBuyerAndSellerReportingIds التي لا تجتاز فحص الكشف عن الهوية التصنيفية موجودة في مجموعة الاهتمام ضمن إعادة العرض.

3- أرقام تعريف الصفقات والمقاعد للبائعين خلال نتائج الإعلانات

يمكن لـ scoreAd() الوصول إلى رقم تعريف الصفقة المحدّد، بالإضافة إلى رقم تعريف المقعد في حال توفّره. ويوفر البائع نتيجة الرغبة في عرض السعر الفائز مع مراعاة رقم تعريف الصفقة وأي بنود خاصة. وإذا لم يعتقد البائع أن معرّف الصفقة الذي اختاره المشتري ينطبق، سيرفض البائع عرض السعر من خلال إعطائه درجة صفرية أو درجة سالبة من الرغبة.

function scoreAd(..., browserSignals, ...) {
  const {
    buyerAndSellerReportingId, // 'seat123'
    selectedBuyerAndSellerReportingIds, // 'deal456'
  } = browserSignals;

  // ...
}

4. أرقام تعريف الصفقات والمقاعد لإعداد تقارير البائعين

تذكَّر أنّه لا يجوز أن يفوز عرض السعر بالمزاد إلا إذا كان selectedBuyerAndSellerReportingId وbuyerAndSellerReportingId (في حال توفّره) وbuyerReportingId (في حال توفّره) غير مجهولتين لدى مالك مجموعة الاهتمامات، وعنوان URL للنص البرمجي لعروض الأسعار، وعنوان URL للعرض، وحجم الإعلان (يتم استبعاد حجم الإعلان من عملية التحقّق هذه حتى الربع الأول من عام 2025 على الأقل). وبناءً على ذلك، ستظل قيم أرقام تعريف إعداد التقارير التي تتضمّن selectedBuyerAndSellerReportingId متاحة دائمًا في reportResult(). تجدر الإشارة إلى أنّه على الرغم من التحقّق من buyerReportingId للتأكّد من إخفاء الهوية k، لا تتوفر القيمة إلا لوظيفة إعداد تقارير المشترين، وليس لوظيفة إعداد تقارير البائعين هنا.

function reportResult(..., browserSignals, ...) {
  const {
    buyerAndSellerReportingId, // 'seat123'
    selectedBuyerAndSellerReportingIds // 'deal456'
  } = browserSignals;

  // ...
}

5- أرقام تعريف الصفقات والمقاعد لإعداد تقارير المشترين

وينطبق المفهوم نفسه في تقارير البائعين على تقارير المشترين. تذكَّر أنّه لا يجوز أن يفوز عرض السعر بالمزاد إلا إذا كان selectedBuyerAndSellerReportingId وbuyerAndSellerReportingId (في حال توفّره) وbuyerReportingId (في حال توفّره) غير مجهولتين لدى مالك مجموعة الاهتمامات، وعنوان URL للنص البرمجي لعروض الأسعار، وعنوان URL للعرض، وحجم الإعلان (يتم استبعاد حجم الإعلان من عملية التحقّق هذه حتى الربع الأول من عام 2025 على الأقل). وبناءً على ذلك، ستظل قيم أرقام تعريف إعداد التقارير التي تتضمّن selectedBuyerAndSellerReportingId متاحة دائمًا في reportWin().

function reportWin(..., browserSignals, ...) {
  const {
    buyerAndSellerReportingId, // 'seat123'
    selectedBuyerAndSellerReportingId // 'deal456'
    buyerAndReportingId // 'brid123' - Not used for deals, but the value is available
  } = browserSignals;
}

التفاعل مع الملاحظات ومشاركتها