يقدِّم هذا الدليل نظرة عامة على مفاهيم عروض الأسعار في الوقت الفعلي (RTB) اللازمة لكتابة تطبيقات عروض الأسعار التي يمكنها المشاركة في ميزة "الشراة المعتمَدون" لعروض الأسعار في الوقت الفعلي.
الأساسيات
يمكن لتطبيق نظام عروض الأسعار التواصل مع "الشراة المعتمَدون" باستخدام أحد بروتوكولات عرض الأسعار في الوقت الفعلي (RTB) المتوافقة. يوفّر طلب عرض السعر المُرسل إلى أحد التطبيقات سياقًا حول فرصة إعلان واحدة على الأقل حتى يتمكن نظام عروض الأسعار من تحديد مبلغ تصميم الإعلان وعرض السعر الأمثل (إن وُجد) لكل مرة ظهور. يمكن لنظام عروض الأسعار أن يردّ على عرض السعر لتقديم عرض سعر واحد على الأقل وتحديد تصميم الإعلان لفرص الإعلان المُرسَلة في الطلب.
![الرسم التخطيطي للهندسة](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/overview.jpg?authuser=7&hl=ar)
السيناريو التالي هو أحد التفاعلات المُحتمَلة بين مقدِّم عروض الأسعار وبرنامج "الشراة المعتمَدون":
- ترسل Google إلى تطبيق مقدّم عرض السعر طلب عرض سعر يصف
مرة ظهور تتم تسويقها في المزاد. تمّ ضبط حساب مقدّم عرض السعر على استخدام
بروتوكول عرض الأسعار في الوقت الفعلي (RTB)
PROTOCOL_ADX
(يُشار إليه في ما يلي باسم "بروتوكول Google")، وبالتالي يصل الطلب على شكلBidRequest
متسلسل كما هو موضّح في realtime-bidding.proto. لمعرفة كيف يجب أن يفسّر تطبيقك طلب عرض السعر، اطّلِع على المقالة معالجة الطلب. -
يحلّل تطبيق مقدِّم عروض الأسعار الطلب ويطبّق منطق عروض الأسعار لإنشاء
BidResponse
يتضمّن عرض سعر وتصميم إعلان لفرصة الإعلان. يُنشئ التطبيق بعد ذلك الاستجابة لعرض السعر ويرسلها إلى Google. لمعرفة الطريقة التي يجب أن ينشئ بها تطبيقك استجابة لعرض السعر، يمكنك الاطّلاع على إنشاء الاستجابة. -
يتم تلقي استجابة عرض السعر ويدخل عرض سعره في المزاد المفتوح، حيث يفوز بمرة الظهور لأنه أعلى عرض سعر. نتيجةً لذلك، يتم وضع تصميم الإعلان المحدد في الردّ.
اختيار بروتوكول
يحدّد بروتوكول عروض الأسعار في الوقت الفعلي الإشارات التي يمكن لتطبيقك استخدامها لتقييم كل مرة ظهور يتم إرسالها في الطلب وتقديم عرض سعر لها، بالإضافة إلى كيفية إنشاء استجابة. هناك طريقتان لتعديل البروتوكول المرتبط بتطبيق مقدِّم عرض السعر:
- يُرجى التواصل مع المدير التقني للحسابات لتغييرها يدويًا.
- استخدِم واجهة برمجة تطبيقات REST الخاصة بالشراة المعتمَدين لتغييرها آليًا.
البروتوكولات المتوافقة
يتيح "الشراة المعتمَدون" حاليًا استخدام ثلاثة بروتوكولات لعرض الأسعار في الوقت الفعلي (RTB):
- OpenRTB (Protobuf)
تنفيذ لمواصفات OpenRTB باستخدام Protobuf.
- OpenRTB (JSON)
تمثّل هذه السمة تنفيذ مواصفات OpenRTB باستخدام تنسيق JSON.
- بروتوكول Google
- تم إيقاف هذا البروتوكول نهائيًا الآن. استخدِم بروتوكول OpenRTB Protobuf أو بروتوكول JSON بدلاً من ذلك.
لمحة عن المخازن المؤقتة للبروتوكولات
يتضمّن كل من بروتوكول OpenRTB وبروتوكول عرض الأسعار في الوقت الفعلي (RTB) الذي تم إيقافه من Google تم تنفيذ مخزن البروتوكول المؤقت. Protobuf هو تنسيق مفتوح المصدر لتمثيل المعلومات المنظَّمة وتسلسلها.
لاستخدام أي من البروتوكولات، يجب تثبيت محول البرنامج البرمجي
ووقت تشغيل Protobuf للغة التي اخترتها. ويمكنك بعد ذلك تنزيل ملفات النموذج الأوّلي التي تنوي استخدامها وتشغيل برنامج التجميع لإنشاء مكتبة يمكنها إنشاء تسلسل أو إنهاء تسلسل للرسائل المحددة في النموذج الأولي، مثل BidRequest
أو BidResponse
. يوضح مرجع Protobuf هذا كيفية إجراء ذلك بعدة لغات.
تحديثات البروتوكول
سيتم تعديل بروتوكولات عرض الأسعار في الوقت الفعلي (RTB) مع إضافة Google لميزات جديدة وإيقاف أخرى. سيتم الإعلان عن التغييرات قبل سريانها بفترة طويلة، مما يمنحك الوقت الكافي لإزالة أي اعتماديات قد يمتلكها تطبيقك في الحقول التي تمت جدولة إيقافها نهائيًا. لمزيد من المعلومات عن التعامل مع الحقول التي تم إيقافها نهائيًا، راجِع التكيّف مع إيقاف حقول BidRequest.
الخطوات التالية
يقدِّم المحتوى التالي مزيدًا من التفاصيل عن مفاهيم عروض الأسعار في الوقت الفعلي:
- معالجة الطلب: كيفية تحليل وتفسير الإشارات الواردة في معظم طلبات عروض الأسعار.
- إنشاء الردّ: كيفية إنشاء استجابة عرض السعر، والحقول المحدّدة عادةً في الردّ.
- دليل OpenRTB: مرجع لتنفيذ "الشراة المعتمَدون" لمواصفات OpenRTB، بالإضافة إلى الإضافات الخاصة بالشراة المعتمَدين. تعرض هذه السمة تفاصيل الحالات الحدّية والقيود الخاصة بعملية التنفيذ هذه، بالإضافة إلى تحديد الحقول المكافئة في بروتوكول Google.
- دليل بروتوكول Google (متوقف): مرجع لبروتوكول Google الذي يصف جميع الرسائل المحددة في البروتوكول وسماتها، بالإضافة إلى تفاصيل حول الاستخدام المقصود منها.
- متطلبات عرض إعلانات الجهات الخارجية: تحدد السياسات التي يجب أن يلتزم بها مقدّمو عروض الأسعار لاستخدام أشكال الإعلانات المختلفة، بالإضافة إلى المواصفات الفنية لتلك الأشكال.
- الاستهداف المسبَق: كيفية ضبط تطبيق مقدّم عروض الأسعار لتلقّي مرّات الظهور المطابقة لمعايير الاستهداف فقط.
- مطابقة ملفات تعريف الارتباط: مرجع لخدمة مطابقة ملفات تعريف الارتباط والخدمات الأخرى ذات الصلة التي يتم استخدامها في تجديد النشاط التسويقي.
- قيود وقت الاستجابة وتبادل المعلومات بين الشبكات: تفاصيل حول مواقع التداول وكيفية تقليل وقت الاستجابة، مثل تبادل المعلومات بين الشبكات
- اختبار تطبيقك وإصداره: تفاصيل حول كيفية بدء اختبار تطبيق مقدِّم عروض الأسعار مع الزيارات التي ترسلها Google على نطاق واسع.