عروض على Protected Audience

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

نظرة عامة

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

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

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

جولة تفصيلية

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

  1. يسجّل المشتري معرّفات الصفقة والمقاعد في إعدادات مجموعة الاهتمامات قبل بدء المزاد.
    • يمكن ضبط أرقام تعريف الصفقات والمقاعد في الحقل أرقام تعريف إعداد التقارير القابلة للاختيار (selectableBuyerAndSellerReportingIds).
    • إذا كان رقم تعريف المقعد هو نفسه لجميع الصفقات، يمكن ضبط رقم تعريف المقعد هذا في buyerAndSellerReportingId، ويمكن إعداد أرقام تعريف الصفقات في حقل أرقام تعريف التقارير القابلة للاختيار (selectableBuyerAndSellerReportingIds).
  2. أثناء إنشاء عروض الأسعار، تصبح معرّفات الصفقة والمقاعد متاحة. يختار المشتري رقم تعريف صفقة من selectableBuyerAndSellerReportingIds. ينشئ المشتري عرض سعر يشتمل على معرّف صفقة مرتبط بعرض السعر هذا عن طريق إرجاع selectedBuyerAndSellerReportingId. لا يمكن لتقديم عروض أسعار الفوز بالمزاد إلا إذا كان معرّف الصفقة المعروض هو معرّف k-anonymous إلى جانب معرّفات أخرى لإعداد التقارير ومواقع محدّدة لمجموعة الاهتمامات.
  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
      buyerReportingId: '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(interestGroup, ...) {
  const [{
    buyerAndSellerReportingId, // 'seat123'
    selectableBuyerAndSellerReportingIds // ['deal123', 'deal456', 'deal789']
    buyerReportingId // 'brid123' - Not used for deals, but the value is available
  }] = interestGroup.ads;

  // ...

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

لا يمكن لتقديم عروض أسعار تتضمّن قيمة معروضة لسمة selectedbuyerAndSellerReportingId الفوز بالمزاد إلا إذا كانت قيمة selectedbuyerAndSellerReportingId مجهولة الهوية بشكل جماعي باستخدام خوارزمية k-anonymity مع 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 (في حال توفّرها) مجهولة الهوية وفقًا لدالة k مع مالك مجموعة الاهتمامات وعنوان URL لنصّ عروض الأسعار وعنوان URL لعرض الإعلان وحجم الإعلان (يتم استبعاد حجم الإعلان من هذا التحقّق حتى الربع الأول من عام 2025 على الأقل). ولذلك، ستكون قيم معرّفات إعداد التقارير التي تتضمّن selectedBuyerAndSellerReportingId متاحة دائمًا داخل reportWin().

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

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