عادةً ما يتنوّع الناشرون مصادر طلب الإعلانات لتحسين الأرباح، ويستدعون العديد من الشركات (على سبيل المثال، خوادم إعلانات الناشرين والأنظمة الأساسية لعرض الإعلانات ومنصّات عرض الطلب) لتحديد أفضل إعلان لشريحة إعلانية معيّنة على الصفحة. تسمح ميزة "عرض الأسعار مسبقًا" للناشرين بالحصول على عروض أسعار لشريحة إعلانية من مجموعة متنوعة من مصادر الطلب. عند إعداد مزاد تسلسلي، يمكن استخدام "مكتبة عروض الأسعار في العنوان" لإجراء مزاد يحتوي على بيانات سياقية، في حين تُستخدَم ميزة "الجمهور المحمي" لإجراء مزاد يتضمّن بيانات من مواقع إلكترونية متعددة.
قبل البدء، تعرَّف على أساسيات واجهة برمجة التطبيقات من صفحة Protected Audience وعروض أسعار العناوين من مستندات Prebid.js.
التعريفات
مزادات
| مزاد | التعريف |
|---|---|
| المزاد السياقي | مزاد إعلانات يستخدم البيانات المتاحة في سياق مكان المزاد. قد تكون هناك مزادات متعدّدة ضمن مزاد المحتوى، مثل عروض الأسعار في رأس الصفحة والمزادات من جهة الخادم. |
| مزاد شرائح الجمهور المحمي | مزاد إعلانات يتضمّن عروض أسعار لمجموعة اهتمامات تم إنشاؤها على موقع إلكتروني آخر. |
| مزاد الإعلانات المتعددة البائعين لجمهور محمي | مزاد من مستويَين للجمهور المحمي، يشمل أولاً مزادات متعدّدة لمكوّنات متوازية، ثم ترسل بعد ذلك الإعلان الأعلى نتيجة إلى مزاد المستوى الأعلى النهائي. |
| مزاد من المستوى الأعلى | مزاد الإعلانات النهائي ضمن مزاد متعدد البائعين لجمهور محمي يوفّر النتيجة للفائزين بمزاد المكوّنات من مزادات المكوّنات |
| مزاد المكونات | مزاد متداخل ضمن مزاد متعدد البائعين ضمن "الجمهور المحمي"، يجري كل بائع لمكوّناته مزادات على مكوناته بالتوازي. تنتقل الإعلانات الأعلى تقييمًا من كل مزاد مكوّن إلى مزاد المستوى الأعلى. |
| إعداد المزاد التسلسلي | إعداد مزاد إعلانات يدمج المزادات السياقية مع مزاد جمهور محمي، ويحدِّد الفائز بين المزادات. |
مشارك
| المشارك | التعريف |
|---|---|
| المعلِن | الطرف الذي يرغب في الحصول على موضع إعلان وينشئ تصميم الإعلان. |
| ناشر | الجهة التي توفّر المساحة المتوفّرة للإعلانات للمزاد |
| مشتري | الطرف الذي يقدّم عرض أسعار في مزاد لشراء المساحة الإعلانية من بائع عادةً ما يكون نظامًا أساسيًا في جانب الطلب (DSP). |
| خادم إعلانات الناشر | هي خدمة يستخدمها الناشرون لإدارة الإعلانات واختيار عرضها على الموقع. يمكن أن يجمع "خادم إعلانات الناشرين" بين نتائج المزادات الخاصة به وردود مقدِّمي عروض الأسعار في رأس الصفحة والمستودع الإعلاني الذي يُباع مباشرةً، وغير ذلك، لتحديد الإعلان الذي سيوفر الجزء الأكبر من الأرباح للناشر. قد يوفّر خادم إعلانات الناشرين مكتبة من جهة العميل للتفاعل مع الخادم. |
| بائع مستوى أعلى | الطرف الذي يستدعي (أي ينشئ) المزاد المتعدد البائعين لجمهور محمي ويشارك في مزاد المستوى الأعلى. |
| بائع المكونات | هي الجهة التي تُجري مزادًا للمكوّنات ضمن مزاد Protected Audience API من أجل بيع المساحة الإعلانية الخاصة بالناشر إلى المشترين. عادةً ما يكون هذا هو وسيط عرض إعلانات الموردين (SSP). |
إعداد المزاد التسلسلي
في إعداد المزاد التسلسلي، يتم تنفيذ المزادات السياقية أولاً، ثم يتم تنفيذ مزاد "الجمهور المحمي". يتيح هذا الإعداد للناشرين زيادة أرباحهم إلى أقصى حد عن طريق إجراء مزاد يحتوي على البيانات السياقية المتوفرة على الصفحة، وإجراء مزاد يحتوي على بيانات من مواقع إلكترونية متعددة في بيئة آمنة لحماية خصوصية المستخدمين.
يمكن تنفيذ مكتبة عروض أسعار في العناوين أولاً على الصفحة لجمع عروض الأسعار من أجل المزاد السياقي لخادم إعلانات الناشر. وبعد ذلك، يمكن إدخال سعر عرض السعر الفائز المعدَّل للمزاد السياقي في مزاد "الجمهور المحمي" كحدّ لعرض السعر. خلال خطوة تسجيل النتيجة، يمكن لبائع المستوى الأعلى خفض أسعار عروض أسعار المكوّنات الخاصة بالمزاد إلى ما دون الحدّ الأدنى لعرض السعر من خلال تحديد نتيجة صفرية عند احتساب نتيجة الرغبة. إذا لم يكن هناك عرض سعر لمزاد من مكوّنات جمهور محمي أعلى من الحدّ الأدنى لعرض السعر، سيتم عرض الإعلان الفائز في المزاد السياقي للمستخدم. إذا أرجع مزاد "الجمهور المحمي" إلى نتيجة فائزة، يعني ذلك أنّه أعلى من الحدّ الأدنى لعرض السعر، وسيتم عرض الإعلان الفائز للجمهور المحمي.
في مثال إعداد المزاد التسلسلي هذا، يمكن تنفيذ ثلاثة مزادات رئيسية على الصفحة بالترتيب: 1) المزاد السياقي من خلال مكتبة عروض الأسعار في رأس الصفحة، و2) المزاد السياقي من خلال "خادم إعلانات الناشرين"، و3) مزاد الجمهور المحمي.
وصف مفصل للمخطط الموجز:
- قبل المزاد، تتم إضافة المستخدم إلى مجموعة اهتمامات على موقع المعلن.
- عندما يزور المستخدم صفحة الناشر في وقت لاحق، تُجري Prebid.js مزادًا سياقيًا لجمع الردود على عروض الأسعار من مقدِّمي عروض الأسعار في رأس الصفحة. خلال هذه الخطوة، قد يقدّم المشترون الإشارات وقد يوفّر البائعون إعدادات خاصة بمزاد المكوّنات لاستخدامها في مزاد "الجمهور المحمي" اللاحق. يوفّر Prebid.js وحدة لنشر هذه الإشارات والإعدادات في مزاد "الجمهور المحمي".
- يتم إرسال استجابات عروض الأسعار التي يجمعها موقع Prebid.js إلى "خادم إعلانات الناشر" لإجراء مزاد سياقي من جهة الخادم.
- قد يجمع "خادم إعلانات الناشرين" بين نتائج المزادات ونتائج عروض الأسعار في رأس الصفحة والمستودع الإعلاني الذي يُباع مباشرةً، وغير ذلك، لتحديد الإعلان الذي سيوفر الجزء الأكبر من الأرباح للناشر. يتم إرجاع الإعلان الفائز إلى مكتبة خادم إعلانات الناشر من جهة العميل.
- يمكن إدخال سعر عرض السعر المعدَّل من الفائز في المزاد السياقي، بالإضافة إلى إشارات المشتري (
perBuyerSignals) وإعدادات مزاد مكوّنات البائع التي تم جمعها باستخدام Prebid.js، إلى مزاد "الجمهور المحمي" من خلال مكتبة "خادم إعلانات الناشر" من جهة العميل. - يتم تنفيذ المزاد المتعدد البائعين في "الجمهور المحمي" من خلال البائع ذي المستوى الأعلى. خلال خطوة تسجيل نقاط بائع المستوى الأعلى، يمكن للبائع من المستوى الأعلى مقارنة سعر عرض السعر الفائز بالمزاد لكل مكون مع عرض السعر الفائز في المزاد حسب المحتوى. إذا كان سعر عرض السعر للمكوّن أقل من سعر عرض سعر المزاد السياقي، يعرض البائع من المستوى الأعلى نتيجة الرغبة في
0. وإذا تم تسجيل جميع عروض الأسعار بقيمة0، تعرِض عبارة "runAdAuction()" الاستدعاء رقمnullالذي يشير إلى أنّه يجب عرض الإعلان الفائز بالمزاد السياقي. - تعرِض المكتبة من جهة العميل في "خادم إعلانات الناشر" الإعلان الفائز عن "الجمهور المحمي" أو الإعلان السياقي استنادًا إلى ما تمّ عرضه من خلال مكالمة
runAdAuction(). - ويتمّ عرض الإعلان الفائز للمستخدم.
قبل المزاد
قبل المزاد، عندما يزور المستخدم صفحة أحد المعلنين، يمكن للمشتري والمعلِن تحديد مجموعة الاهتمامات التي ينتمي إليها المستخدم على الموقع الإلكتروني وإضافة بيانات سياقية من موقع المعلِن وبيانات الطرف الأول لاستخدامها كإشارات للمزاد في وقت لاحق.
- ينتقل المستخدِم إلى الموقع الإلكتروني للمعلِن.
- يحمّل موقع المعلن على الويب النص البرمجي من كل مشترٍ يشارك في المزاد في وقت لاحق.
- يتضمّن النص البرمجي للمشتري طلب
joinAdInterestGroup()لإضافة المستخدم إلى مجموعة الاهتمامات التي اختارها المشتري.
المزادات السياقية باستخدام Prebid.js وخادم إعلانات الناشر
في إعداد مزاد تسلسلي، يتم تنفيذ جميع المزادات السياقية قبل إجراء مزاد "الجمهور المحمي". في الإعداد الموضَّح في هذا المستند، نجري مزادًا سياقيًا لعروض الأسعار في رأس الصفحة باستخدام Prebid.js، ويتم بذلك إرسال الخلاصات إلى مزاد من جهة الخادم يُجريه خادم إعلانات الناشر.
يبدأ الناشر أولاً مزادًا سياقيًا لعروض الأسعار في العنوان عن طريق استدعاء Prebid.js مع وضع علامة للإشارة إلى أنّه سيتم تنفيذ مزاد "الجمهور المحمي" بعد ذلك. بعد ذلك، يجمع Prebid.js استجابات عروض الأسعار ويرسلها إلى خادم إعلانات الناشر لإجراء مزاد سياقي من جهة الخادم. أثناء خطوة جمع عروض الأسعار، يمكن للمشترين والبائعين تقديم إعدادات مزاد المكوّنات وإشارات المشترين (perBuyerSignals) لاستخدامها في مزاد "الجمهور المحمي" اللاحق، إذا أرادوا المشاركة. وسيتم نقل ضبط مزاد المكوِّن هذا إلى مزاد "الجمهور المحمي" اللاحق.
- إعداد المزاد السياقي
يزور المستخدم صفحة الناشر. - تعمل صفحة الناشر على تحميل المكتبة من جهة العميل لخادم إعلانات الناشر وتحديد الشرائح الإعلانية.
- تُحمِّل صفحة الناشر إعلان Prebid وتبدأ المزاد السياقي لعروض الأسعار في عنوان الصفحة.
- المزاد السياقي للبائع (أ)
(يتم إجراؤه بالتوازي مع المزاد السياقي للبائع (ب))
يرسل Prebid.js طلب عرض سعر إلى البائع (أ). - يسترد البائع "أ" الردود على عروض الأسعار و
perBuyerSignalsمن المشترين. - ينفذ البائع (أ) مزادًا بحسب السياق.
- ينشئ البائع "أ" تهيئة مزاد المكونات مع تضمين
perBuyerSignals. - يستجيب البائع "أ" إلى Prebid.js بعرض السعر الفائز وتهيئة المزاد لمكوّناته.
- المزاد السياقي للبائع (ب)
(يتم إجراؤه بالتوازي مع المزاد السياقي للبائع (أ))
يرسل Prebid.js طلب عرض سعر إلى البائع (ب). - يسترد البائع "ب" الردود على عروض الأسعار و
perBuyerSignalsمن المشترين. - ينفذ البائع "ب" مزادًا سياقيًا.
- ينشئ البائع "ب" تهيئة مزاد المكونات مع تضمين
perBuyerSignals. - يستجيب البائع "ب" إلى Prebid.js بعرض السعر الفائز وتهيئة المزاد لمكوّناته.
- المزاد السياقي لخادم إعلانات الناشر
يتم إرسال الردود على عروض الأسعار التي يجمعها موقع Prebid.js إلى خادم إعلانات الناشر لأغراض المزاد المستند إلى السياق. - تتم مشاركة إعدادات مزاد المكوّنات التي تتضمّن إشارات المشترين مع المكتبة من جهة العميل في "خادم إعلانات الناشر".
- يُجري خادم إعلانات الناشرين مزادًا سياقيًا لتحديد أفضل إعلان بين الحملات المَبيعة مباشرةً وعروض الأسعار الآلية وعروض أسعار Prebid السياقية والمستودع الإعلاني الآخر.
- يعرض خادم إعلانات الناشر عرض السعر الفائز المعدَّل.
مزاد متعدد البائعين لجمهور محمي
في هذه المرحلة، تنتهي المزادات السياقية، ويمكن للمكتبة من جهة العميل في "خادم إعلانات الناشر" تمرير عرض السعر المعدَّل الذي يفوز بالمزاد السياقي، وإعدادات مزاد المكوّنات، والإشارات من المشترين المشاركين في مزاد "الجمهور المحمي" إلى البائع من المستوى الأعلى. يمكن تمرير سعر عرض سعر المزاد السياقي كحد إلى إعدادات المزاد كإشارة إلى تسجيل النتيجة في مزاد المستوى الأعلى.
يتم تنفيذ المزادات على المكوّنات بالتوازي، وفي كل مزاد مكوّن من مكوّنات، ينشئ المتصفّح عروض أسعار من منطق عروض الأسعار لكل مشترٍ يشارك في مزاد المكوّنات، ويسجّل كل عرض سعر باستخدام منطق النتائج لدى بائع المكوّن، ثم يعرض الإعلان الأعلى نتيجة في مزاد المستوى الأعلى.
- يُحمِّل الموقع الإلكتروني للناشر النص البرمجي للبائع في المستوى الأعلى.
- توفِّر المكتبة التابعة لخادم إعلانات الناشر من جهة العميل سعر عرض سعر المزاد السياقي وإعدادات مزاد المكوّنات مع إشارات من المشترين إلى البائع الأعلى مستوى. يمكن تمرير سعر عرض سعر الإعلان الفائز في المزاد حسب المحتوى إلى إعدادات المزاد كإشارات للبائع (يصبح سعر عرض السعر هذا متاحًا في وظيفة
scoreAd()للبائع في المستوى الأعلى). - يبدأ بائع المستوى الأعلى مزاد "الجمهور المحمي" من خلال الاتصال بالرقم
runAdAuction(). - مزاد "البائع" لمكوّنات البائع
(يتم إجراؤه بالتوازي مع مزاد المكونات التي يجريها البائع "ب")
يقرأ المتصفّح مجموعات اهتمامات المستخدم لجميع المشترين المشاركين في مزاد المكونات التي يجريها البائع "أ". - يجلب المتصفّح النصوص البرمجية لعروض الأسعار وإشارات عروض الأسعار الموثوق بها من المواقع الجغرافية المحدّدة في مجموعات اهتمامات المشترين المشارِكين في مزاد المكوّنات.
- ينشئ المتصفح عروض الأسعار من خلال تنفيذ منطق إنشاء عروض الأسعار لكل مشترٍ.
- يجلب المتصفح النص البرمجي للنتيجة وإشارات النتائج الموثوقة لكل إعلان من البائع (أ).
- ينفِّذ المتصفح منطق النتائج للبائع (أ) لكل عرض سعر.
- يختار المتصفح الإعلان الذي حصل على أعلى نتيجة تم إرسالها بواسطة منطق تقييم البائع (أ).
- مزاد "البائع ب"
(يتم إجراؤه بالتوازي مع مزاد المكونات التي يجريها البائع "أ")
يقرأ المتصفّح مجموعات اهتمامات المستخدم لجميع المشترين المشاركين في مزاد المكونات التي يجريها البائع "ب". - يجلب المتصفّح النصوص البرمجية لعروض الأسعار وإشارات عروض الأسعار الموثوق بها من المواقع الجغرافية المحدّدة في مجموعات اهتمامات المشترين المشارِكين في مزاد المكوّنات.
- ينشئ المتصفح عروض الأسعار من خلال تنفيذ منطق إنشاء عروض الأسعار لكل مشترٍ.
- يجلب المتصفح النص البرمجي للنتيجة وإشارات النتائج الموثوقة لكل إعلان من البائع (ب).
- ينفِّذ المتصفح منطق النتائج للبائع (ب) لكل عرض سعر.
- يختار المتصفح الإعلان الذي حصل على أعلى نتيجة تم إرسالها بواسطة منطق تقييم البائع (ب).
نتيجة المزاد من المستوى الأعلى وعرض الإعلانات
بعد تنفيذ المزادات على المكوّنات من القسم السابق، ينفِّذ المتصفّح منطق نقاط البائع ذي المستوى الأعلى على الإعلان الفائز في كل مزاد مكوّن. في وظيفة scoreAd() للبائع ذو المستوى الأعلى، قد يتوفّر سعر عرض السعر المعدَّل من خلال المزاد حسب المحتوى على أنّه sellerSignals، وقد يقارن منطق الاحتساب سعر عرض سعر المزاد هذا في سعر عرض السعر الفائز في مزاد مكوّن "الجمهور المحمي".
إذا كان سعر عرض السعر الفائز في المزاد السياقي أعلى من سعر عرض السعر الفائز في مزاد المكوِّن، يمكن أن تعرض دالة scoreAd() نتيجة المرغوبة بقيمة 0. إذا لم تكن هناك إعلانات لها نقاط رغبة أعلى من 0، فإنها تدل على أن الإعلان الفائز في المزاد السياقي أعلى قيمة من أي إعلان من الإعلانات الفائزة بمزاد المكوّنات، وتعرض دالة runAdAuction() الخطأ null.
إذا لم يكن لمزاد الجمهور المحمي أي فائز وتم عرض null، يمكن للمكتبة من جهة العميل الخاصة بخادم الإعلانات الخاصة بالناشر أن تعرض الفائز في المزاد السياقي في إطار iframe. إذا كان مزاد "الجمهور المحمي" هو الفائز في مزاد حسب المحتوى ويعرض عنصرًا FencedFrameConfig أو رقم URN غير شفاف، يمكن عرض إعلان مزاد "الجمهور المحمي" الفائز في إطار مضمّن أو إطار iframe.
- نتائج إعلانات المزاد من المستوى الأعلى
يسترجع المتصفّح النص البرمجي للنتيجة من البائع الأعلى مستوى مع إشارات تسجيل النتائج الموثوق بها لكل إعلان. - ينفِّذ المتصفّح منطق نقاط البائع ذي المستوى الأعلى لكل عرض سعر فائز في جميع مزادات المكوّنات. داخل نص
scoreAd()البرمجي لبائع المستوى الأعلى، يمكن للمنطق الوصول إلى سعر عرض السعر الفائز الذي تم تعديل سعره في المزاد حسب المحتوى والذي ربما تم تمريره كـsellerSignalsفي إعدادات المزاد. يمكن للنص البرمجي أن يقارن سعر عرض السعر الفائز في السياق مع سعر عرض سعر الجمهور المحمي المكوِّن، ويعرض النتيجة 0 المرغوبة التي تبلغ 0 إذا كان السعر السياقي أعلى. وبخلاف ذلك، يحسب النص البرمجي نتيجة الرغبة، استنادًا على الأرجح إلى سعر عرض سعر المكون من الجمهور المحمي. - يختار المتصفح الإعلان الذي حصل على أعلى درجة من الرواج والمُرسَلة وفقًا لمنطق نقاط البائع ذي المستوى الأعلى.
- في حال فوز مزاد "الجمهور المحمي"
يعرض مزاد "الجمهور المحمي" عنصرFencedFrameConfigأو رقم URN معتمًا إلى المكتبة التابعة لخادم إعلانات الناشر. - تضبط المكتبة من جهة العميل سمة
configللإطار المحمي على العنصرFencedFrameConfigأو تضبط سمةsrcلإطار iframe على رقم URN المعتم في إعلان الجمهور المحمي الفائز. - يجلب المتصفّح الإعلان الفائز بمزاد الجمهور المحمي من المشتري.
- ويعرض المتصفح الإعلان للمستخدم.
- إذا فاز المزاد السياقي
يعرض مزاد "الجمهور المحمي" القيمةnull. - يضبط المتصفّح سمة
srcلإطار iframe على الإعلان السياقي الفائز. - يجلب المتصفح الإعلان الفائز في المزاد السياقي من المشتري.
- ويعرض المتصفح الإعلان للمستخدم.
التفاعل ومشاركة الملاحظات
ما هي الخطوات التالية؟
نريد المشاركة في محادثات معك للتأكد من أننا ننشئ واجهة برمجة تطبيقات تناسب الجميع.
مناقشة واجهة برمجة التطبيقات
مثل واجهات برمجة التطبيقات الأخرى في "مبادرة حماية الخصوصية"، يتم توثيق واجهة برمجة التطبيقات هذه ومناقشتها بشكل علني.
إجراء التجارب باستخدام واجهة برمجة التطبيقات
يمكنك تجربة الميزة والمشاركة في محادثة حول Protected Audience API.