عروض على Protected Audience

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

نظرة عامة

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

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

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

جولة تفصيلية

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

  1. يسجّل المشتري معرّفات الصفقة ومساحة العرض في إعدادات المجموعة ذات الاهتمامات المشتركة قبل بدء المزاد
    • يمكن ضبط أرقام تعريف الصفقات والمقاعد في حقل معرّفات إعداد التقارير القابلة للاختيار (selectableBuyerAndSellerReportingIds).
    • إذا كان معرّف موضع الإعلان هو نفسه لجميع الصفقات، يمكن ضبط معرّف موضع الإعلان هذا في buyerAndSellerReportingId، ويمكن ضبط معرّفات الصفقات في حقل معرّفات التقارير القابلة للاختيار (selectableBuyerAndSellerReportingIds).
  2. أثناء إنشاء عروض الأسعار، يصبح رقم تعريف الصفقة ورقم تعريف موضع الإعلان متاحَين. يختار المشتري رقم تعريف صفقة من selectableBuyerAndSellerReportingIds. ينشئ المشتري عرض سعر يتضمّن معرّف صفقة مرتبطًا بعرض السعر هذا من خلال عرض selectedBuyerAndSellerReportingId. لا يمكن أن يفوز عرض السعر بالمزاد إلا إذا كان معرّف الصفقة الذي تم إرجاعه مجهول الهوية بمقدار k إلى جانب معرّفات إعداد التقارير الأخرى والسمات المحدّدة لمجموعة الاهتمامات.
  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 مجهولة الهوية بشكل مشترك مع 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 (في حال توفّرها) مجهولة الهوية بمقدار k مع مالك المجموعة المهتمة وعنوان 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;
}

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