مواصفات OpenRTB في "مساحة العرض والفيديو 360"

يجب أن تكون مواصفات OpenRTB 2.6 متاحة أثناء الرجوع إلى هذه الصفحة.

لا تتوافق "مساحة العرض والفيديو 360" مع كل حقل في مواصفات OpenRTB، وقد تنطبق بعض الفروق الدقيقة. تحتوي أقسام هذا المستند على معلومات واقتراحات خاصة بعملية التنفيذ في "مساحة العرض والفيديو 360". عليك أيضًا اتّباع الإرشادات الواردة في مواصفات OpenRTB ما لم يُطلب منك خلاف ذلك.

بعض الحقول غير متوافقة، ولكن لا يزال يتم تحليلها. يجب تنسيق هذه الحقول بشكل صحيح، ولكنّها لن تؤثر في نتيجة عروض الأسعار.

مواصفات طلب عرض السعر

طلب عرض السعر هو طلب HTTP Post يتضمّن نص لكائن طلب عرض السعر. يتم تحديد تنسيق النص في العنوان Content-Type.

تكون الاستجابة المقابلة إما HTTP 204 بدون نص لعدم تقديم عرض، أو HTTP 200 مع نص الاستجابة لعرض السعر.

في حال كان طلب عرض السعر غير صالح، قد يتم عرض رمز HTTP 200 مع نص ردّ عرض السعر يتضمّن الحقل nbr.

يتم التحكّم في تنسيق الردّ من خلال العنوان Accept.

تنسيق JSON

يتم استخدام التنسيق التلقائي في حال عدم توفير أي نوع MIME مقبول.

تتّبع طلبات JSON واستجاباته مواصفات OpenRTB 2.6 الصادرة عن مكتب IAB. توضّح المستندات التالية الإضافات والحقول المتوافقة.

يشير العنوان Content-Type: application/json إلى طلب عروض أسعار بتنسيق JSON، ويشير العنوان Accept: application/json إلى أنّ استجابات عروض الأسعار يجب أن تكون بتنسيق JSON.

تنسيق Protobuf

ملاحظة: تتوفّر ميزة التوافق مع Protobuf في إصدار تجريبي، يُرجى التواصل مع "مساحة العرض والفيديو 360" إذا كنت مهتمًا بها.

تتّبع طلبات واستجابات JSON مواصفات OpenRTB 2.6 Protobuf الصادرة عن مكتب IAB.

يتوفّر دعم محدود للإضافات، يُرجى التواصل مع "مساحة العرض والفيديو 360" إذا كنت مهتمًا بذلك.

أرسِل العنوان Content-Type: application/x-protobuf للإشارة إلى طلب عرض أسعار بتنسيق Protobuf، واضبط Accept: application/x-protobuf لتلقّي ردود عروض الأسعار بتنسيق Protobuf.

عنصر طلب عرض السعر

الحقل النوع التفاصيل
id سلسلة الحقل مطلوب.
المعرّف الفريد لطلب عروض الأسعار. ويمكن استخدامها لتحديد الطلبات الفردية لفترة محدودة جدًا بعد عرضها.
imp مصفوفة مرات الظهور يجب توفير عنصر imp واحد على الأقل.

بالنسبة إلى وحدات الصوت، يمكن استخدام أكثر من عنصر imp واحد.
في حالات الاستخدام الأخرى (مثل الخانات المستقلة المتعددة على الصفحة)، يتم استخدام الكائن الأول imp، ويتم تجاهل الباقي.
site الموقع الإلكتروني مطلوب للطلبات المتعلّقة بالمواقع الإلكترونية.
site وapp يستبعد كلّ منهما الآخر.
app التطبيق هذا الحقل مطلوب لطلبات التطبيقات.
app وsite يستبعد كلّ منهما الآخر.
device الجهاز الحقل مطلوب.
user المستخدم الحقل مطلوب.
test عدد صحيح غير متاح
at عدد صحيح ‫1: مزاد السعر الأول حيث يتم تحصيل مبلغ عرض السعر من المعلِن.
2 (الإعداد التلقائي): مزاد السعر الثاني حيث يتم تحصيل رسوم من المعلِن بمبلغ أعلى قليلاً من عرض السعر الثاني الأعلى.
3: السعر الأدنى مضمّن في الطلب، ولا صلة له بعروض الأسعار المنافسة.
tmax عدد صحيح اختياري، والقيمة التلقائية هي مخصّصة لكل عملية دمج.
wseat مصفوفة السلاسل النصية قائمة بمقاعد المشترين المسموح بها
يُنصح باستخدامها ما لم يُسمح لجميع المعلنين بتقديم عروض أسعار.
يشير عدم الضبط إلى عدم وجود أي قيود.
bseat مصفوفة السلاسل النصية قائمة بمقاعد المشترين التي يجب حظر عروض أسعارها. سيتم حظر المشترين المدرَجين من تقديم عروض أسعار على الصفقات والمزاد المفتوح.
allimps عدد صحيح غير متاح
cur مصفوفة السلاسل النصية

اختيارية، ولكن ننصح بها بشدة القيمة التلقائية هي لكل عملية دمج.

يجب أن تتطابق العملة في طلب عروض الأسعار مع إحدى العملات المسجّلة أثناء عملية الدمج.

ننصح بشدة بإتاحة عملة واحدة لكل عملية تبادل.
wlang مصفوفة السلاسل النصية غير متاح
bcat مصفوفة السلاسل النصية فئات المعلِنين المحظورة باستخدام فئات المحتوى التي يحدّدها "مكتب الإعلانات التفاعلية" (IAB)
Unset is no blocked categories.
badv مصفوفة السلاسل النصية حدِّد المعلِن المحظور استنادًا إلى النطاق الذي يقدّمه المعلِن.
عدم التحديد يعني عدم حظر أي معلِنين.
bapp مصفوفة السلاسل النصية غير متاح
source المصدر مطلوب بشكل جزئي لـ schain
regs اللوائح التنظيمية اختياريّ.
ext إضافات طلبات عروض الأسعار اختياريّ.

عنصر إضافات طلب عرض السعر

الحقل النوع التفاصيل
schain سلسلة الإمداد يجب أن تستخدم عمليات الدمج الجديدة الحقل BidRequest.source.schain في المصدر بدلاً من ذلك.
purch عدد صحيح مَعلمة "الزيارات المدفوعة" هي الزيارات التي تتم إعادة توجيهها من مواقع أخرى غير المواقع التي يملكها الناشر أو المواقع المكتسَبة أو المواقع التي تم تحفيز المستخدِم لإجرائه بطريقة أخرى.
يتم ذلك وفقًا لمواصفات 2.0 الجديدة الخاصة بمجلس تقييم الوسائط (MRC) بشأن حركة المرور غير الصالحة.

سيُطلق على هذا الحقل اسم مصدر زيارات الناشر في التقارير المخصّصة للمشترين، وسيتضمّن إحدى القيم التالية :
0 (القيمة التلقائية): غير محدّد - لم يتم إرسال القيمة في طلبات عروض الأسعار. تعذُّر تسجيل القيمة؛
1: تم الشراء - تتم إعادة توجيه الزيارات من مواقع أخرى غير المواقع المملوكة (النشاط المكتسب أو النشاط الذي تم تحفيز المستخدم لإجرائه بطريقة أخرى).
2: مصدر الزيارات المجانية - إدخال عنوان URL مباشر أو البحث في الموقع أو تنزيل التطبيق

gdemsignals سلسلة وحدة بيانات إشارة SCAR API من حزمة تطوير البرامج "SDK لإعلانات Google على الأجهزة الجوّالة"
يُنصح باستخدامها إذا كانت الزيارات من "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة"، ويُحظر استخدامها في ما عدا ذلك.
disable_gma_format int اختيارية في حال توفير gdemsignals، ومحظورة في الحالات الأخرى
‫0 (القيمة التلقائية): عندما يتم تعبئة gdemsignals، يكون adm الاستجابة لعرض السعر عبارة عن كائن ثنائي كبير الحجم بتنسيق JSON.
1: سيتم أيضًا توفير علامة إعلان بدلاً من مجموعة json.

العنصر المصدر

الحقل النوع التفاصيل
fd عدد صحيح الجهة المسؤولة عن قرار بيع مرّة الظهور النهائي
0 (القيمة التلقائية): يقرّرها Ad Exchange.
1: يحدّد مصدر أولي ما إذا كان سيتم عرض الإعلان.
tid سلسلة غير متاح
pchain سلسلة غير متاح
schain سلسلة الإمداد مطلوبة في جميع الحالات تقريبًا.

يُفضّل استخدام هذا الحقل بدلاً من توفير schain من خلال إضافات طلب عروض الأسعار أو إضافات المصدر.

ext إضافات المصدر اختياريّ.

عنصر إضافات المصدر

ننصح بشدة باستخدام هذه الإضافة لأنّها تؤثّر في طريقة عرض مقاييس إمكانية المشاهدة للعميل في DV3. إذا لم يكن اسم شريك OMID مدرَجًا في شهادة اعتماد IAB، يطلب منّا مجلس تقييم الوسائط (MRC) تسجيل مقاييس إمكانية العرض بشكل منفصل عن المقاييس المعتمَدة من مجلس تقييم الوسائط. مزيد من المعلومات

الحقل النوع التفاصيل
omidpn سلسلة معرّف عملية دمج حزمة OM SDK وهي مماثلة للمَعلمة "name" الخاصة بكائن OMID Partner.
omidpv سلسلة إصدار عملية دمج حزمة OM SDK وهي مماثلة للمَعلمة "versionString" الخاصة بكائن OMID Partner.
schain سلسلة الإمداد يجب أن تستخدم عمليات الدمج الجديدة الحقل schain في المصدر بدلاً من ذلك.

Regs object

الحقل النوع التفاصيل
coppa عدد صحيح 0 (القيمة التلقائية): لا ينطبق قانون COPPA على هذا الطلب.‫
1: ينطبق قانون COPPA على هذا الطلب.
gdpr سلسلة علم يشير إلى ما إذا كان الطلب يخضع للوائح "اللائحة العامة لحماية البيانات" أم لا، 0 = لا، 1 = نعم، يشير الحذف إلى أنّ الحالة غير معروفة. لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات اللائحة العامة لحماية البيانات في "مساحة العرض والفيديو 360". يجب استخدام إحدى السمتين regs.gdpr أو regs.ext.gdpr فقط.
us_privacy سلسلة تنقل هذه السمة إشارات بشأن خصوصية المستهلك بموجب لائحة الخصوصية الأمريكية. مواصفات سلسلة الخصوصية في الولايات المتحدة عندما نتلقّى السلسلة us_privacy في طلب عرض السعر وتشير سلسلة IAB إلى أنّ المستخدم قد أوقف الإعلانات المخصّصة، تعتبر "مساحة العرض والفيديو 360 الطلب غير مؤهَّل لعروض الأسعار المخصّصة. ولا ننشر إشارة IAB بعد ذلك لموردين آخرين.

يجب توفير قيمة واحدة فقط من regs.us_privacy أو user.us_privacy أو user.ext.us_privacy.
gpp سلسلة يحتوي على سلسلة الموافقة الخاصة بإطار عمل Global Privacy Protocol. لا تقبل "مساحة العرض والفيديو 360" سوى بعض أقسام إطار عمل GPP، بما في ذلك السلاسل الوطنية الأمريكية وسلاسل كاليفورنيا وغيرها. لا يتم قبول أقسام إطار الشفافية والموافقة الصادر عن مكتب IAB في أوروبا، لذا يُرجى استخدام user.consent أو user.ext.consent بدلاً من ذلك.
gpp_sid صفيف الأعداد الصحيحة مصفوفة الأقسام التي يجب تطبيقها من سلسلة الموافقة في إطار عمل Global Privacy Protocol على هذه المعاملة.
ext إضافات اللوائح التنظيمية اختياريّ.

Regs extensions object

الحقل النوع التفاصيل
gdpr عدد صحيح علامة تشير إلى ما إذا كان الطلب يخضع للوائح التنظيمية العامة لحماية البيانات (GDPR)، كما هو موضّح في regs.gdpr أعلاه. يجب استخدام إحدى السمتين regs.gdpr وregs.ext.gdpr فقط.
us_privacy سلسلة يُرجى الاطّلاع على مستندات regs.us_privacy. يجب توفير قيمة واحدة فقط من regs.us_privacy أو regs.ext.us_privacy أو user.ext.us_privacy.

عنصر Imp

الحقل النوع التفاصيل
id سلسلة معرّف فريد لهذا الانطباع ضمن سياق طلب عروض الأسعار (تبدأ القيمة عادةً بالرقم 1 وتزداد حتى n لعدد n من مرّات الظهور).
metric عنصر غير متاح
banner البانر مطلوب لفرص عرض إعلانات البانر.
video الفيديو مطلوب للاستفادة من فرص عرض إعلانات الفيديو.
audio الصوت مطلوب للاستفادة من فرص عرض الإعلانات الصوتية.
native الإعلان المدمجة مع المحتوى مطلوبة للاستفادة من فرص عرض "الإعلانات المدمجة مع المحتوى".
pmp Pmp صفقات "السوق الخاص" السارية لمرّة الظهور هذه
displaymanager سلسلة اسم شريك وسيط الإعلانات أو تكنولوجيا حزمة تطوير البرامج (SDK) أو مشغّل الفيديو المسؤول عن عرض الإعلان (عادةً ما يكون فيديو أو إعلانًا على الأجهزة الجوّالة) تستخدم بعض خوادم الإعلانات هذه السمة لتخصيص رمز الإعلان حسب الشريك. يُنصح به للفيديوهات و/أو التطبيقات.
displaymanagerver سلسلة إصدار شريك التوسّط في عرض الإعلانات أو تكنولوجيا حزمة تطوير البرامج (SDK) أو مشغّل الفيديو المسؤول عن عرض الإعلان (عادةً ما يكون فيديو أو إعلانًا على الأجهزة الجوّالة) تستخدم بعض خوادم الإعلانات هذه السمة لتخصيص رمز الإعلان حسب الشريك. يُنصح به للفيديوهات و/أو التطبيقات.
instl عدد صحيح ‫0 (تلقائي): ليس إعلانًا بينيًا.
1: الإعلان هو إعلان بيني أو إعلان بملء الشاشة.
tagid سلسلة معرّف لموضع إعلان أو علامة إعلان معيّنَين تم استخدامهما لبدء المزاد. ويمكن أن يكون ذلك مفيدًا لتصحيح أي مشاكل أو لتحسين الأداء من قِبل المشتري.
bidfloor عدد عائم الحدّ الأدنى لعرض السعر لمرّة الظهور هذه، ويتم التعبير عنه بالتكلفة لكلّ ألف ظهور.
bidfloorcur سلسلة

العملة المحدّدة باستخدام رموز ألفا ISO-4217

clickbrowser عدد صحيح

توضّح هذه السمة نوع المتصفّح الذي يتم فتحه عند النقر على تصميم الإعلان في أحد التطبيقات.
0 (القيمة التلقائية): مضمّن
1: أصلي

يُرجى العِلم أنّ Safari View Controller في أجهزة iOS 9.x يُعدّ متصفّحًا أصليًا لأغراض هذا الحقل.

secure عدد صحيح ما إذا كان هذا الانطباع يتطلّب عنوان URL آمنًا يستخدم بروتوكول HTTPS أو عنوان URL يستخدم HTTP غير آمن
0 (تلقائي):غير آمن
1: آمن
iframebuster مصفوفة السلاسل النصية
exp عدد صحيح يتم تحديد تاريخ انتهاء صلاحية عرض السعر من خلال "مساحة العرض والفيديو 360" بدون مراعاة القيمة التي يرسلها الشريك في هذا الحقل. يتم تجاهل أحداث مرّ عليها وقت طويل (عادةً ساعة واحدة) بعد تلقّيها، ولا يعتبرها مساحة العرض والفيديو 360 قابلة للفوترة.
rwdd عدد صحيح تشير إلى ما إذا كان المستخدم سيحصل على مكافأة مقابل مشاهدة الإعلان.
0 (القيمة التلقائية): لم تتم مكافأته
1: تمت مكافأته

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

عنصر إضافة Imp

الحقل النوع التفاصيل
bcrid سلسلة قائمة بأرقام تعريف تصاميم الإعلانات التي يجب حظرها.
الحقل النوع التفاصيل
format مصفوفة التنسيق قائمة بالتنسيقات المتوافقة
w عدد صحيح

يتم دمج h وw في الحقل format.

ننصح باستخدام format بدلاً من ذلك.
h عدد صحيح

يتم دمج h وw في الحقل format.

ننصح باستخدام format بدلاً من ذلك.
wmax عدد صحيح غير متاح
hmax عدد صحيح غير متاح
wmin عدد صحيح غير متاح
hmin عدد صحيح غير متاح
btype صفيف الأعداد الصحيحة في ما يلي قائمة بأنواع "إعلانات البانر" المدرَجة في القائمة المحظورة:

‫1: إعلانات نصية بتنسيق HTML
‫2: إعلانات بانر بتنسيق HTML
‫3: إعلانات Javascript
‫4: إعلانات IFrame

battr صفيف الأعداد الصحيحة يمكن استخدام القيم التالية:

‫1: التشغيل التلقائي للصوت
‫2: الصوت الذي يبدأه المستخدم
‫3: التوسيع التلقائي
‫4: التوسيع عند النقر
‫5: التوسيع عند التمرير
‫6: التشغيل التلقائي للفيديو في البانر
‫7: الفيديو الذي يبدأه المستخدم في البانر
‫8: النوافذ المنبثقة(فوق/تحت/عند الخروج)
‫9: الإعلانات الاستفزازية أو الموحية
‫10: الإعلانات "المزعجة"، مثل الإعلانات المهتزة أو الوامضة أو المتلألئة أو التي تتضمّن رسومات متحركة مفرطة أو وجوه مبتسمة
‫11: الاستطلاعات
‫12: الإعلانات النصية فقط
‫13: الإعلانات التفاعلية (الألعاب)
‫14: الإعلانات التي تظهر على شكل مربّع حوار أو تنبيه في نظام التشغيل Windows
‫15: الإعلانات التي تتضمّن زرًا لتشغيل الصوت أو إيقافه
‫16: الإعلانات التي يمكن تخطّيها
‫17: الفلاش

pos عدد صحيح موضع الإعلان:

‫0 (القيمة التلقائية): غير معروف
1: الجزء المرئي من الصفحة
2: غير متاح: من المحتمل أن يكون الجزء السفلي غير المرئي من الصفحة
3: الجزء السفلي غير المرئي من الصفحة
4: رأس الصفحة
5: تذييل
6: الشريط الجانبي
7: ملء الشاشة
mimes مصفوفة السلاسل النصية غير متاح

ستستخدِم "مساحة العرض والفيديو 360" النص/html لجميع تصاميم إعلانات البانر.

topframe عدد صحيح ‫0 (الإعداد التلقائي): يتم عرض البانر في إطار iframe.
1: غير متاح: يتم عرض البانر في الإطار العلوي.
expdir صفيف الأعداد الصحيحة ‫1: لليسار
‫2: لليمين
‫3: للأعلى
‫4: للأسفل
‫5: ملء الشاشة القابل للتوسيع
api صفيف الأعداد الصحيحة أُطر عمل واجهات برمجة التطبيقات المتوافقة

‫1: لليسار
2: لليمين
3: للأعلى
4: للأسفل
5: ملء الشاشة القابل للتوسيع

id سلسلة معرّف لعنصر البانر يجب أن يكون فريدًا في مرّة الظهور.

يُنصح باستخدامها عند استخدام كائنات banner مع كائن فيديو.

vcm عدد صحيح

هذه السمة ذات صلة فقط banner مستخدَمة مع كائن فيديو.

‫0: يظهر البانر في الوقت نفسه مع تصميم إعلان الفيديو.
1: البانر هو بطاقة نهاية تظهر بعد الفيديو.

تنسيق العنصر

الحقل النوع التفاصيل
w عدد صحيح العرض بوحدات بكسل مستقلة عن الجهاز (DIPS)
h عدد صحيح الارتفاع بوحدات البكسل المستقلة عن الجهاز (DIPS).
wratio عدد صحيح غير متاح
hratio عدد صحيح غير متاح
wmin عدد صحيح غير متاح

كائن الفيديو

ننصحك بشدة بتحديد موضع الفيديو في طلب عرض السعر. يتم تصنيف حقل موضع إعلان مفقود على أنّه موضع إعلان غير معروف. يمكنك الاطّلاع على المقالة حول استهداف المواضع لمزيد من التفاصيل.

الحقل النوع التفاصيل
mimes مصفوفة السلاسل النصية يجب توفير نوع MIME واحد على الأقل.

video/flv أو video/x-f4v
video/mp4 أو video/x-mp4 أو application/mp4
video/webm أو video/x-webm
video/x-ms-wmv
video/3gpp
video/ogg أو application/ogg
application/javascript أو application/x-javascript

minduration عدد صحيح الحدّ الأدنى لمدة الفيديو بالثواني، والقيمة التلقائية هي عدم وجود حدّ أدنى
maxduration عدد صحيح تمثّل هذه السمة الحد الأقصى لمدّة الفيديو بالثواني، والقيمة التلقائية هي عدم وجود حد أقصى.
protocols صفيف الأعداد الصحيحة يجب توفير بروتوكول واحد على الأقل متوافق.

‫1: VAST 1.0
‫2: VAST 2.0
‫3: VAST 3.0
‫4: VAST 1.0 Wrapper
‫5: VAST 2.0 Wrapper
‫6: VAST 3.0 Wrapper
‫7: VAST 4.0
‫8: VAST 4.0 Wrapper
‫9: DAAST 1.0
‫10: DAAST 1.0 Wrapper

w عدد صحيح عرض مشغّل الفيديو بوحدات بكسل مستقلة عن الجهاز (DIPS)
h عدد صحيح تمثّل هذه السمة ارتفاع مشغّل الفيديو بوحدات البكسل المستقلة عن الجهاز (DIPS).
startdelay عدد صحيح تأخير بدء عرض الإعلان بالثواني في مواضع الإعلانات قبل التشغيل أو أثناء التشغيل أو بعد التشغيل.
placement عدد صحيح يُنصح بشدة بتحديد موضع الإعلان (و/أو) موضع الفيديو في طلب عرض السعر. سيتم تصنيف عدم توفّر كلا الحقلين على أنّه موضع إعلان غير معروف.

‫0 (القيمة التلقائية): غير معروف
‫1: داخل الفيديو
‫2: في البانر
‫3: داخل المقالة
‫4: في الخلاصة
‫5: عائم

ملاحظة: لكي يتم تصنيف مواضع/مرات ظهور الفيديو على أنّها "أثناء عرض الفيديو" (الموضع أو نوع الموضع 1)، يجب ضبط مواضع/مرات ظهور الفيديو على "تشغيل الصوت" والإشارة إليها بشكل صحيح في "طريقة التشغيل" (جميع القيم 1 و3 و4 و5 مؤهَّلة).
plcmt عدد صحيح يُنصح بشدة بتحديد موضع الإعلان (و/أو) موضع الفيديو في طلب عرض السعر. سيتم تصنيف عدم توفّر كلا الحقلين على أنّه موضع إعلان غير معروف.

0 (الإعداد التلقائي): غير معروف
1: أثناء عرض الفيديو
2: المحتوى المصاحب
3: إعلان بيني
4: بدون محتوى/مستقل

ملاحظة: لكي يتم تصنيف مواضع/مرات ظهور الفيديو على أنّها "أثناء عرض الفيديو" (الموضع أو نوع الموضع 1)، يجب ضبط مواضع/مرات ظهور الفيديو على "تشغيل الصوت" والإشارة إليها بشكل صحيح في "طريقة التشغيل" (جميع القيم 1 و3 و4 و5 مؤهَّلة).

ملاحظة: في حال توفير كلّ من plcmt وplacement، ستكون plcmt هي الأولوية. راجِع دليل IAB بشأن نقل البيانات إلى plcmt.

ملاحظة: يتم اعتبار plcmt: Accompanying Content (2) placement: In Article (3)
ويتم اعتبار plcmt: No Content/Standalone (4) placement: In feed (4)
ولا يتضمّن placement: In Banner أي ربط في plcmt
linearity عدد صحيح غير متاح
skip عدد صحيح تُستخدَم لتحديد ما إذا كان مشغّل الفيديو سيسمح بتخطّي الإعلان.

0 (الخيار التلقائي): غير قابل للتخطي
1: قابل للتخطي
skipmin عدد صحيح غير متاح
skipafter عدد صحيح غير متاح
sequence عدد صحيح إذا تم تقديم عدّة مرّات ظهور للإعلان في طلب عرض السعر نفسه، سيسمح الرقم التسلسلي بعرض عدّة مواد إبداعية بشكل منسّق.
battr صفيف الأعداد الصحيحة سمات تصاميم الإعلانات المحظورة
maxextended عدد صحيح الحدّ الأقصى لمدّة "إعلان الفيديو الموسّع"، إذا كان التوسيع مسموحًا به

‫0 (القيمة التلقائية): لا يُسمح بتمديد مدة التشغيل
‫-1: يُسمح بتمديد مدة التشغيل بدون فرض أي حد زمني
‫>0: عدد ثواني مدة التشغيل الممدّدة المسموح بها بعد قيمة maxduration

minbitrate عدد صحيح الحد الأدنى لمعدل نقل البيانات بالكيلوبت في الثانية
maxbitrate عدد صحيح الحد الأقصى لمعدّل نقل البيانات بالكيلوبت في الثانية
boxingallowed عدد صحيح تشير هذه السمة إلى ما إذا كان مسموحًا بعرض المحتوى بنسبة عرض إلى ارتفاع 4:3 في نافذة بنسبة عرض إلى ارتفاع 16:9.

‫0: غير مسموح به
1 (تلقائي): مسموح به
playbackmethod صفيف الأعداد الصحيحة طُرق التشغيل التي قد تكون قيد الاستخدام إذا لم يتم تحديد أي طريقة، يمكن استخدام أي طريقة.

‫0 (الإعداد التلقائي): غير معروف
‫1: التشغيل التلقائي مع تفعيل الصوت
‫2: التشغيل التلقائي مع إيقاف الصوت
‫3: النقر للتشغيل
‫4: التمرير بالماوس
‫5: بدء التشغيل عند الدخول إلى إطار العرض مع تفعيل الصوت
‫6: بدء التشغيل عند الدخول إلى إطار العرض مع إيقاف الصوت

ملاحظة: يجب أن تشير جميع مرّات الظهور التي يكون فيها "الصوت غير مفعّل تلقائيًا" (طريقة التشغيل 2 أو 6 أو 0) إلى موضع إعلان خارج البث من النوع 2 أو 3 أو 4 أو 5 (oRTB 2.5) أو نوع فرعي للموضع 2 أو 3 أو 4.
playbackend عدد صحيح الحدث الذي يؤدي إلى انتهاء التشغيل

1: اكتمال الفيديو أو إنهاء المستخدم
2: مغادرة إطار العرض أو إنهاء المستخدم
3: عند مغادرة إطار العرض، يستمر الفيديو كنافذة عائمة إلى أن يكتمل أو ينهيه المستخدم
delivery صفيف الأعداد الصحيحة طرق التسليم المتوافقة في حال عدم تحديد أي منها، يُفترض أنّ جميعها متوافقة.

‫1: البث
2: التحميل التدريجي
pos عدد صحيح موضع عرض الإعلان على الشاشة

‫0 (القيمة التلقائية): غير معروف
1: الجزء المرئي من الصفحة
2: غير متاح: من المحتمل أن يكون الجزء السفلي غير المرئي من الصفحة
3: الجزء السفلي غير المرئي من الصفحة
4: رأس الصفحة
5: تذييل
6: الشريط الجانبي
7: ملء الشاشة
companionad مصفوفة البانر الإعلانات المصاحبة، إذا كانت متاحة
api صفيف الأعداد الصحيحة

‫0 (القيمة التلقائية): غير معروف
‫1: VPAID 1
‫2: VPAID 2
‫3: MRAID 1
‫4: ORMMA
‫5: MRAID 2
‫6: MRAID 3
‫7: OMID 1: يجب تفعيل القياس باستخدام OMID في "العرض النشط".‫
8: SIMID 1
companiontype صفيف الأعداد الصحيحة غير متاح
maxseq عدد صحيح الحدّ الأقصى لعدد الإعلانات التي سيتم عرضها في لوحة فيديو ديناميكية
poddur صفيف الأعداد الصحيحة الحد الأقصى لمدّة مجموعة الفيديو الديناميكية بالثواني.

الامتداد المتوافق لكائن الفيديو

الحقل النوع التفاصيل
rewarded عدد صحيح يُستخدَم هذا الحقل للإشارة إلى ما إذا كانت الطلبات تتضمّن مكافآت أم لا. يجب إرسال هذا الرقم كعدد صحيح.

‫0 (القيمة التلقائية): لم تتم مكافأته
1: تمت مكافأته

كائن الصوت

الحقل النوع التفاصيل
mimes مصفوفة السلاسل النصية يجب توفير نوع MIME واحد على الأقل.

‫audio/m4a أو audio/mp4 أو audio/x-m4a
audio/mpeg أو audio/mp3
audio/ogg أو audio/x-ogg

minduration عدد صحيح الحد الأدنى لمدة الإعلان بالثواني.
maxduration عدد صحيح الحدّ الأقصى لمدّة الإعلان بالثواني.
protocols صفيف الأعداد الصحيحة

‫3: VAST 3.0
6: VAST 3.0 Wrapper
7: VAST 4.0
8: VAST 4.0 Wrapper
startdelay عدد صحيح تمثّل هذه السمة مدة التأخير بالثواني في مواضع إعلانات ما قبل التشغيل أو إعلانات أثناء التشغيل أو إعلانات ما بعد التشغيل.

-2: إعلان ما بعد التشغيل
-1: إعلان أثناء التشغيل
0: إعلان ما قبل التشغيل
>0: إعلان أثناء التشغيل

sequence عدد صحيح غير متاح
battr صفيف الأعداد الصحيحة غير متاح
maxextended عدد صحيح غير متاح
minbitrate عدد صحيح الحد الأدنى لمعدل نقل البيانات بالكيلوبت في الثانية
maxbitrate عدد صحيح الحد الأقصى لمعدّل نقل البيانات بالكيلوبت في الثانية
delivery صفيف الأعداد الصحيحة غير متاح
companionad مصفوفة عناصر البانر أيّ مساحات إعلانية لتصاميم الإعلانات المصاحبة للبانر
api صفيف الأعداد الصحيحة قائمة بأُطر عمل واجهة برمجة التطبيقات المتوافقة مع هذا الانطباع.

7: Omid V1

companiontype صفيف الأعداد الصحيحة غير متاح
maxseq صفيف الأعداد الصحيحة غير متاح
feed عدد صحيح نوع خلاصة الصوت

‫1: خدمة الموسيقى
2: البث
3: البودكاست

stitched عدد صحيح غير متاح
nvol عدد صحيح غير متاح

العنصر الأصلي

يمكنك الاطّلاع على مواصفات الإعلانات المدمجة مع المحتوى في "مساحة العرض والفيديو 360" للحصول على مزيد من التفاصيل.

الحقل النوع التفاصيل
request سلسلة السلسلة المرمّزة لكائن JSON الأصلي
ver سلسلة 1.0: غير متاح
1.1: غير متاح
1.2
api صفيف الأعداد الصحيحة قائمة بأُطر عمل واجهة برمجة التطبيقات المتوافقة مع هذا الانطباع.

7: Omid V1

battr صفيف الأعداد الصحيحة غير متاح

عنصر PMP

الحقل النوع التفاصيل
private_auction عدد صحيح 0 (الإعداد التلقائي): يُسمح بجميع عروض الأسعار
1: الصفقات فقط
deals مصفوفة عناصر الصفقات تمثّل هذه السمة الصفقات المطلوب تضمينها.

عنصر الصفقة

الحقل النوع التفاصيل
id سلسلة يجب ألا يحتوي عنصر PMP على أكثر من عنصر صفقة واحد لكلّ معرّف.
bidfloor مزدوجة الحدّ الأدنى لعرض السعر لمرّة الظهور هذه بالتكلفة لكلّ ألف ظهور

مطلوب إذا كان at=3.

bidfloorcur سلسلة العملة المحدّدة باستخدام رموز ألفا ISO-4217

يتم ضبط القيمة تلقائيًا على عملة طلب عرض السعر في حال عدم تحديدها.

at عدد صحيح تكون المطابقات التلقائية bid_request.at في حال عدم تحديدها.

‫1: السعر الأول
‫2: السعر الثاني
‫3: السعر الثابت

wseat مصفوفة السلاسل النصية معرّفات الشركاء المؤهّلين للصفقة.

عدم توفّر مقاعد يعني عدم وجود قيود على عدد المقاعد.

wadomain مصفوفة السلاسل النصية نطاقات المعلِنين المسموح لها بتقديم عروض أسعار على هذه الصفقة

يعني عدم توفّر مقاعد عدم وجود قيود على النطاق.

guar عدد صحيح يُستخدَم هذا الحقل للإشارة إلى ما إذا كانت الصفقة صفقة مضمونة. يجب إرسال هذا الرقم كعدد صحيح.

يجب إدراج إحدى البورصات في القائمة المسموح بها كي تقبل "مساحة العرض والفيديو 360" الصفقات المضمونة، لذا يُرجى التواصل معنا لطلب ذلك.

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

0 (القيمة التلقائية): غير مضمونة
1: مضمونة

ext إضافات الصفقات اختياريّ.

الامتداد المتوافق مع عنصر الصفقة

الحقل النوع التفاصيل
guaranteed عدد صحيح يُستخدَم هذا الحقل للإشارة إلى ما إذا كانت الصفقة صفقة مضمونة. يجب إرسال هذا الرقم كعدد صحيح.

يجب إدراج إحدى البورصات في القائمة المسموح بها كي تقبل "مساحة العرض والفيديو 360" الصفقات المضمونة، لذا يُرجى التواصل معنا لطلب ذلك.

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

0 (القيمة التلقائية): غير مضمونة
1: مضمونة

ننصحك باستخدام deal.guar بدلاً من هذا الحقل.

عنصر الموقع الإلكتروني

الحقل النوع التفاصيل
id سلسلة رقم تعريف الموقع الإلكتروني على شبكة التبادل
name سلسلة غير متاح
domain سلسلة تمثّل هذه السمة نطاق الموقع الإلكتروني.

يُنصح بإرسال عنوان URL كامل في site.page بدلاً من ملء site.domain فقط.

cat مصفوفة السلاسل النصية غير متاح
sectioncat مصفوفة السلاسل النصية غير متاح
pagecat مصفوفة السلاسل النصية غير متاح
page سلسلة عنوان URL الكامل الذي سيتم عرض مرّة الظهور فيه.

ننصحك بإرسال عنوان URL الكامل لأغراض الاستهداف.

ref سلسلة عنوان URL للمُحيل الذي أدّى إلى الانتقال إلى الصفحة الحالية.
search سلسلة غير متاح
mobile عدد صحيح غير متاح
privacypolicy عدد صحيح غير متاح
publisher عنصر الناشر تقدّم هذه السمة تفاصيل حول ناشر الموقع الإلكتروني.
content عنصر المحتوى تفاصيل حول المحتوى داخل موقع إلكتروني
keywords سلسلة (تنسيق CSV) غير متاح
ext إضافات الموقع إضافات لكائن الموقع الإلكتروني

عنصر إضافة الموقع

الحقل النوع التفاصيل
inventorypartnerdomain سلسلة تُستخدَم لمشاركة المساحات الإعلانية على التلفزيون المتّصل (CTV)، يُرجى الاطّلاع على شرح حول إضافات تطبيقات الفيديو على التلفزيون المتّصل الصادر عن مكتب IAB.

عنصر التطبيق

الحقل النوع التفاصيل
id سلسلة معرّف التطبيق على شبكة التبادل.
name سلسلة أسماء التطبيقات التي يمكن أن يتم تغييرها بناءً على طلب الناشرين

يمكن للناشر تقديم أسماء التطبيقات لطلبات الإعلانات التي لا تستخدم حِزم تطوير البرامج (SDK) (معظمها أجهزة تلفزيون متصلة) مباشرةً في الطلب.

bundle سلسلة الحقل مطلوب.

بالنسبة إلى نظام التشغيل iOS، يجب أن يكون رقم تعريف متجر التطبيقات رقميًا. لا نقبل معرّف الحزمة بنظام أسماء النطاقات العكسي.

بالنسبة إلى تطبيق التلفزيون المتّصل، ننصحك بتمرير معرّف التطبيق الذي يحدّده المتجر. يُرجى الالتزام بإرشادات معرّف المتجر المخصّص من IAB لمنصات OTT/CTV التي تم نشرها مؤخرًا.

domain سلسلة النطاق، مثل mygame.foo.com
storeurl سلسلة مطلوب للتحقّق من ملف app-ads.txt والتحقّق من صحة متجر تطبيقات بث تلفزيوني للتلفزيون المتّصل
cat مصفوفة السلاسل النصية غير متاح
sectioncat مصفوفة السلاسل النصية غير متاح
pagecat مصفوفة السلاسل النصية غير متاح
ver سلسلة غير متاح
privacypolicy عدد صحيح غير متاح
paid عدد صحيح غير متاح
publisher عنصر الناشر معلومات عن ناشر التطبيق
content عنصر المحتوى معلومات عن محتوى التطبيق
keywords سلسلة (تنسيق csv) غير متاح
ext إضافات التطبيقات إضافات لكائن التطبيق

عنصر إضافة التطبيق

الحقل النوع التفاصيل
inventorypartnerdomain سلسلة تُستخدَم لمشاركة المساحات الإعلانية على التلفزيون المتّصل (CTV)، يُرجى الاطّلاع على شرح حول إضافات تطبيقات الفيديو على التلفزيون المتّصل الصادر عن مكتب IAB.

عنصر المحتوى

ننصحك بتمرير هذه السمات حيثما كان ذلك متاحًا.

الحقل النوع التفاصيل
id سلسلة معرّف يحدّد المحتوى بشكل فريد.
episode عدد صحيح رقم حلقة المحتوى (عادةً لمحتوى الفيديو)
title سلسلة يُنصح باستخدامه لطلبات أجهزة التلفزيون المتّصلة بالفيديو والصوت.
series سلسلة يُنصح باستخدامه لطلبات أجهزة التلفزيون المتّصلة بالفيديو والصوت.
season سلسلة تمثّل هذه السمة تصنيفًا لموسم المحتوى.
artist سلسلة الفنان الذي تمّت الإشارة إليه في المحتوى
genre سلسلة نوع المحتوى الذي يصف المحتوى بأفضل شكل تنصح "مساحة العرض والفيديو 360" بتقديم هذه الإشارة لطلبات التلفزيون المتّصل والفيديو والصوت.
تتيح "مساحة العرض والفيديو 360" بعض التصنيفات لقيم أنواع الفيديو في هذا الحقل:
  • قائمة الأنواع من Google (تنزيل)
  • قائمة Google بأنواع المحتوى الصوتي (تنزيل)
  • فئات IAB الخاصة بالتلفزيون والأفلام والرياضة (تنزيل)
  • تصنيف أنواع الفيديوهات في Gracenote من Nielsen
album سلسلة تمثّل هذه السمة الألبوم الذي ينتمي إليه المحتوى، وعادةً ما يكون ذلك للمحتوى الصوتي.
isrc سلسلة تمثّل هذه السمة رمز تسجيل المعايير الدولية المتوافق مع معيار ISO-3901.
producer عنصر المنتج تفاصيل حول منتج المحتوى
url سلسلة عنوان URL للمحتوى
cat مصفوفة السلاسل النصية فئات المحتوى التابعة لمكتب IAB التي تصف المحتوى
prodq عدد صحيح جودة الإنتاج:

0 (القيمة التلقائية): غير معروف
1: احترافي
2: شبه احترافي
3: من إنشاء المستخدمين

videoquality عدد صحيح غير متاح
context عدد صحيح نوع المحتوى:

‫1: فيديو
‫2: لعبة
‫3: موسيقى
‫4: تطبيق
‫5: نص
‫6: غير ذلك
‫7: غير معروف

contentrating سلسلة يُنصح باستخدامها مع "الصوت والفيديو"/"التلفزيون المتّصل"، لأنّنا سنبدأ باتّخاذ القرارات استنادًا إلى هذه السمة.
userrating سلسلة عدد النجوم والإعجابات وما إلى ذلك
qagmediarating عدد صحيح تصنيف الوسائط وفقًا [لإرشادات QAG](http://www.iab.net/ne_guidelines)

‫1: جميع شرائح الجمهور
2: 12 عامًا فأكثر
3: المحتوى المناسب للبالغين

keywords سلسلة (تنسيق csv) غير متاح
livestream عدد صحيح تُستخدَم لتحديد ما إذا كان المحتوى عبارة عن بث مباشر.

‫0: ليس بثًا مباشرًا
‫1: المحتوى بث مباشر

sourcerelationship عدد صحيح

‫0: غير مباشر
1: مباشر

len عدد صحيح تمثّل هذه السمة مدة المحتوى بالثواني.

يُنصح به لطلبات أجهزة التلفزيون المتّصلة بالإنترنت والفيديو والصوت.

language سلسلة (ISO-639-1-alpha-2) تمثّل هذه السمة لغة المحتوى.
embeddable عدد صحيح مؤشر يوضح ما إذا كان المحتوى قابلاً للتضمين (مثل مشغّل فيديو قابل للتضمين)

0: غير قابل للتضمين
1: قابل للتضمين

data مصفوفة عناصر البيانات بيانات إضافية

عنصر المنتج

الحقل النوع التفاصيل
id سلسلة غير متاح
name سلسلة غير متاح
cat مصفوفة السلاسل النصية غير متاح
domain سلسلة نطاق المستوى الأعلى الخاص بالمنتج

كائن البيانات

الحقل النوع التفاصيل
id سلسلة معرّف مزوّد البيانات
name سلسلة تمثّل هذه السمة اسم البورصة لمقدّم البيانات.
segment مصفوفة عناصر Segment قيم البيانات الفعلية
ext إضافات البيانات إضافات لكائن البيانات

الإضافات المتوافقة مع عنصر البيانات

الحقل النوع التفاصيل
segtax عدد صحيح معرّف التصنيف، يمكنك الاطّلاع على تصنيفات الشرائح لمزيد من التفاصيل.
segclass سلسلة إصدار المصنّف الذي أنتج أرقام تعريف الشرائح ضمن التصنيف

عنصر الشريحة

الحقل النوع التفاصيل
id سلسلة معرّف لشريحة البيانات خاص بموفّر البيانات.
name سلسلة تمثّل هذه السمة اسم شريحة البيانات.
value سلسلة قيمة شريحة البيانات.

عنصر الناشر

الحقل النوع التفاصيل
id سلسلة الحقل مطلوب.
name سلسلة غير متاح
cat مصفوفة السلاسل النصية غير متاح
domain سلسلة غير متاح

عنصر الجهاز

الحقل النوع التفاصيل
ua سلسلة الحقل مطلوب.
sua عنصر UserAgent معلومات منظَّمة عن وكيل المستخدم
geo Geo object تمثّل هذه السمة الموقع الجغرافي للجهاز.
dnt عدد صحيح علامة "Do Not Track" كما تم ضبطها في عنوان المتصفّح

‫0: التتبُّع غير مقيّد
‫1: عدم التتبُّع

lmt عدد صحيح إشارة "تقييد تتبُّع الإعلانات" التي تمّت الموافقة عليها تجاريًا

0: لا توجد قيود على التتبُّع
1: يجب أن يكون التتبُّع محدودًا وفقًا للإرشادات التجارية

ip سلسلة مطلوبة إذا كان الإصدار الرابع من بروتوكول الإنترنت (IPv4).

في حال تم اقتطاع عنوان IP، يجب الإفصاح عن ذلك في device.ext.truncated_ip.

ipv6 سلسلة مطلوبة إذا كان بروتوكول الإنترنت هو الإصدار 6.

في حال تم اقتطاع عنوان IP، يجب الإفصاح عن ذلك في device.ext.truncated_ip.

devicetype عدد صحيح ننصح بشدة باستخدامها لكل أنواع المستودعات. يُستخدَم لتحسين التعرّف على نوع الجهاز.
make سلسلة
model سلسلة
os سلسلة نظام تشغيل الجهاز.

‫ios: في طلب تطبيق، يحدّد هذا المعلمة عدد الزيارات على نظام التشغيل iOS.
android: يحدّد جهاز Android في حال لم يحدّده ua أو sua.
[anything else]: تُستخدَم في بيانات التشخيص لعزل المشاكل.

هذا الحقل غير حسّاس لحالة الأحرف.

osv سلسلة غير متاح
hwv سلسلة يشير إلى إصدار معدّات الجهاز.
h عدد صحيح تمثّل هذه السمة الارتفاع الفعلي للشاشة بالبكسل.
w عدد صحيح تمثّل هذه السمة العرض الفعلي للشاشة بالبكسل.
ppi عدد صحيح غير متاح
pxratio مزدوجة نسبة وحدات البكسل الفعلية إلى وحدات البكسل المستقلة عن الجهاز
js عدد صحيح غير متاح
geofetch عدد صحيح غير متاح
flashver سلسلة غير متاح
language سلسلة (ISO-639-1-alpha-2) لغة الجهاز
carrier سلسلة غير متاح
mccmnc سلسلة غير متاح
connectiontype عدد صحيح نوع اتصال الشبكة
ifa سلسلة معرّف مسموح للمعلِن باستخدامه بشكل واضح.
didsha1 سلسلة غير متاح
didmd5 سلسلة غير متاح
dpidsha1 سلسلة غير متاح
dpidmd5 سلسلة غير متاح
macsha1 سلسلة غير متاح
macmd5 سلسلة غير متاح
ext إضافات الأجهزة إضافات لكائن الجهاز

الامتداد المتوافق مع عنصر الجهاز

في حال تغيير ip أو اقتطاعه، ننصحك بشدة بإرسال الإضافات التالية لتجنُّب تصنيف الزيارات على أنّها زيارات غير صالحة.

الحقل النوع التفاصيل
truncated_ip عدد صحيح تُستخدَم لتحديد ما إذا كان عنوان IP في الحقل device.ip من طلب عرض السعر قد تم اقتطاعه.

0: لم يتم الاقتطاع
1: تم الاقتطاع

القيمة التلقائية هي عدم الاقتطاع، وهي مطلوبة في حال تم اقتطاع عنوان IP.

في حال عدم الإفصاح عن ذلك، قد يتم تصنيف طلب عرض السعر على أنّه زيارات غير صالحة.

ifa_type سلسلة يجب الإشارة إلى مصدر حقل device.ifa، سواء تم توفيره من الجهاز نفسه أو تم إنشاؤه بواسطة الناشر أو وسيط عرض المبيعات (SSP) في سلسلة الإمداد.

‫aaid: Android TV
rida: Roku
afai: Amazon Fire
idfa: Apple tvOS
msai: Xbox/Microsoft
dpid: معرّف عام لمنصة الجهاز
ppid: معرّف مقدَّم من الناشر
sspid: معرّف مقدَّم من وسيط عرض المبيعات (SSP)
sessionid: معرّف جلسة قصير الأمد (يُستخدم فقط في تحديد عدد مرات الظهور)

attestation_token سلسلة (ترميز base64) رمز مميّز لإثبات صحة الجهاز في عمليات التبادل التي تتيح هذا المستوى من التحقّق من صحة الجهاز
atts عدد صحيح (نظام التشغيل iOS فقط) عدد صحيح يتم تمريره لتمثيل حالة إذن تتبُّع التطبيق.

0: لم يتم تحديدها
1: محظورة
2: مرفوضة
3: مسموح بها

cdep سلسلة ملصق الإيقاف النهائي لملفات تعريف الارتباط التابعة لجهات خارجية في Chrome

اطّلِع على الاختبار الذي يسهّله Chrome و مواصفات IAB Community.

كائن UserAgent

الحقل النوع التفاصيل
browsers مصفوفة من عناصر BrandVersion يحدّد كل عنصر BrandVersion متصفّحًا أو برنامجًا مشابهًا.
platform BrandVersion object تحدّد هذه السمة المنصة.
mobile عدد صحيح ‫0 (القيمة التلقائية): يفضّل الوكيل المحتوى "المناسب لأجهزة الكمبيوتر" أو "الكامل".
1: يفضّل الوكيل المحتوى "المناسب للأجهزة الجوّالة".
architecture سلسلة بنية الجهاز، مثل "x86" أو "arm"
bitness سلسلة عدد البتات في الجهاز، مثلاً "64" لبنية 64 بت
model سلسلة طراز الجهاز
source عدد صحيح مصدر البيانات المستخدَم لإنشاء هذا العنصر، راجِع القائمة: مصدر User-Agent. يُنصح باستخدامها عند تمرير عنصر UserAgent.

عنصر BrandVersion

الحقل النوع التفاصيل
brand سلسلة معرّف العلامة التجارية، مثل "Chrome" أو "Windows". الحقل مطلوب.
version مصفوفة السلاسل النصية تسلسل لمكوّنات الإصدار، بترتيب هرمي تنازلي (الإصدار الرئيسي والثانوي والمصغّر وما إلى ذلك)

العنصر الجغرافي

الحقل النوع التفاصيل
lat مزدوجة غير متاح
lon مزدوجة غير متاح
type عدد صحيح غير متاح
accuracy عدد صحيح غير متاح
lastfix عدد صحيح غير متاح
ipservice عدد صحيح غير متاح
country سلسلة غير متاح
region سلسلة غير متاح
regionfips104 سلسلة غير متاح
metro سلسلة غير متاح
city سلسلة غير متاح
zip سلسلة غير متاح
utcoffset عدد صحيح غير متاح

كائن المستخدم

الحقل النوع التفاصيل
id سلسلة تكون هذه الميزة متاحة إذا كانت Google تستضيف جدول مطابقة المعرّفات.
buyeruid سلسلة تكون هذه الميزة متاحة إذا كان مضيف وسيط عرض المبيعات يستضيف جدول مطابقة المعرّفات.
yob عدد صحيح يُنصح به لاستهداف الفئات الديمغرافية.
gender سلسلة يُنصح به لاستهداف الفئات الديمغرافية.
keywords سلسلة (CSV) غير متاح
customdata سلسلة غير متاح
geo Geo object غير متاح
data مصفوفة عناصر البيانات بيانات إضافية
eids مصفوفة من عناصر المعرّف الموسّع مثيلات المعرّف الموسّع التي يقدّمها التبادل
ext إضافات المستخدم إضافات لكائن المستخدم

الإضافات المتوافقة مع عنصر المستخدم

الحقل النوع التفاصيل
eids مصفوفة من عناصر المعرّف الموسّع مثيلات المعرّف الموسّع التي يقدّمها التبادل
consented_providers_settings.consented_providers عنصر خارجي (consented_providers_settings) يضمّ مصفوفة أعداد صحيحة داخلية (consented_providers). عند جمع الموافقة بموجب "اللائحة العامة لحماية البيانات" من خلال "إطار الشفافية والموافقة"، يعرض هذا الحقل مزوّدي تكنولوجيا الإعلان الذين وافق المستخدمون على استخدامهم ولا يشاركون في "إطار الشفافية والموافقة". يُرجى الاطّلاع على المواصفات الفنية لـ "الموافقة الإضافية" من Google.
us_privacy سلسلة يُرجى الاطّلاع على مستندات regs.us_privacy. يجب توفير قيمة واحدة فقط من regs.us_privacy أو regs.ext.us_privacy أو user.ext.us_privacy.

عنصر المعرّف الموسّع

الحقل النوع التفاصيل
source سلسلة موفِّر المعرّف
uids مصفوفة من عناصر Extended ID UID المعرّفات الفعلية

عنصر Extended ID UID

الحقل النوع التفاصيل
id سلسلة المعرّف نفسه
atype عدد صحيح نوع وكيل المستخدم المرتبط بهذا المعرّف.

عنصر سلسلة الإمداد

الحقل النوع التفاصيل
complete عدد صحيح ‫0 (الإعداد التلقائي): سلسلة الإمداد غير مكتملة.‫
1: سلسلة الإمداد مكتملة وصولاً إلى الناشر.
ver سلسلة الحقل مطلوب.
يتم تنسيق القيمة على النحو "الإصدار الرئيسي.الإصدار الثانوي"، مثلاً، الإصدار 1.0 هو السلسلة "1.0".
nodes مصفوفة عقدة سلسلة الإمداد الحقل مطلوب.

في سلسلة الإمداد الكاملة، تمثّل العقدة الأولى نظام الإعلان الأوّلي ومعرّف البائع المعنيّين بالمعاملة، أي مالك الموقع الإلكتروني أو التطبيق أو الوسيط الآخر.

في سلسلة الإمداد غير المكتملة، يمثّل هذا الحقل العقدة الأولى المعروفة. تمثّل العقدة الأخيرة الجهة التي ترسل طلب عرض السعر هذا.

عنصر عقدة سلسلة الإمداد

الحقل النوع التفاصيل
asi سلسلة اسم النطاق الأساسي لنظام منصة عرض الطلب (SSP) أو Exchange أو Header Wrapper أو غير ذلك، والذي يتصل به مقدّمو العروض. قد يمثل ذلك النطاق التشغيلي للنظام، إذا كان مختلفًا عن نطاق الشركة الرئيسي، لتسهيل عمليات البحث عن عناوين IP العكسية وWHOIS لترسيخ ملكية واضحة للنظام المفوض.

يجب أن تكون هذه القيمة هي نفسها المستخدَمة لتحديد البائعين في ملف ads.txt، إذا كان متوفّرًا.

sid سلسلة المعرّف المرتبط بحساب البائع أو المورّد ضمن نظام الإعلانات يجب أن يحتوي هذا الحقل على القيمة نفسها المستخدَمة في المعاملات (أي طلبات عروض أسعار OpenRTB) في الحقل الذي يحدّده وسيط عرض المبيعات أو تبادل الإعلانات.

ويمثل ذلك عادةً في OpenRTB حقل publisher.id. بالنسبة إلى OpenDirect، يمثل ذلك عادةً رقم تعريف مؤسسة الناشر.

يجب ألا يزيد عدد الأحرف عن 64 حرفًا.

rid سلسلة تمثّل هذه السمة RequestId في OpenRTB للطلب الذي أصدره هذا البائع.
name سلسلة اسم الشركة (الجهة القانونية) التي يتم الدفع لها مقابل المستودع الإعلاني الذي تمّت معاملته بموجب seller_id المحدّد

هذه القيمة اختيارية ويجب عدم تضمينها إذا كانت متوفّرة في ملف sellers.json الخاص بنظام الإعلان.

domain سلسلة اسم نطاق النشاط التجاري الخاص بالكيان الذي تمثّله هذه العقدة

هذه القيمة اختيارية ويجب عدم تضمينها إذا كانت متوفّرة في ملف sellers.json الخاص بنظام الإعلان.

hp عدد صحيح تحدّد هذه السمة ما إذا كانت هذه العقدة ستشارك في عملية الدفع مقابل المساحة الإعلانية.

‫1: يدفع نظام الإعلان في الحقل asi للبائع في الحقل sid، وهو المسؤول عن الدفع للعقدة السابقة في السلسلة.‫
0: لا تشارك هذه العقدة في عملية الدفع مقابل المساحة الإعلانية.

بالنسبة إلى الإصدار 1.0 من SupplyChain، يجب أن تكون قيمة هذه السمة دائمًا 1. يجب تضمينها بشكل صريح لأنّه من المتوقّع أن تتضمّن الإصدارات المستقبلية من المواصفات عقدًا لا يتعامل مع الدفع.

على الجهات المنفِّذة التأكّد من أنّها تتيح هذا الحقل وتنقله إلى الأمام عند إنشاء عناصر SupplyChain في طلبات عروض الأسعار التي يتم إرسالها إلى نظام إعلاني لاحق.

مواصفات الاستجابة لعرض السعر

عنصر BidResponse

السمة متاح تفاصيل التنفيذ تمت الموافقة دائمًا
id في حال حدوث خطأ في التحليل، قد تكون القيمة هي "0" بدلاً من معرّف طلب عروض الأسعار. نعم
seatbid
bidid
cur في حال حدوث خطأ في التحليل، لن يتم تمرير هذا الخطأ. يتم دائمًا توفير عملة لطلبات عروض الأسعار الصالحة. نعم
customdata
nbr يتم تضمين هذا العنصر فقط في حال رصد مشكلة في طلب عرض السعر. تشمل القيم المحتملة ما يلي:
2: طلب غير صالح
12: انتهاك إذن ads.txt
16: SupplyChain غير مكتملة
17: عقدة SupplyChain محظورة
ملاحظة: عند رصد انتهاك محدّد لملف (app-)ads.txt أو SupplyChain، سيتم ملء أحد الرموز 12 أو 16 أو 17 في جزء (1%) من الردود. سيتم ملء الرمز 2 لجميع الطلبات الأخرى غير الصالحة.
ستبدو الطلبات التي تتضمّن NBR على النحو التالي: 
{
  "id": "0",
  "nbr": 2,
  "ext": {
    "err": "Bid request body was empty.",
    "errHelp": "https://.../ortb-spec"
  }
}
ext في حال حدوث مشكلة في طلب عروض الأسعار، قد يحتوي الحقل ext على معلومات للمساعدة في تشخيص الخطأ، حيثما كان ذلك متاحًا.

الإضافات المتوافقة مع عنصر BidResponse

السمة تفاصيل التنفيذ
err

وصف يمكن لشخص عادي قراءته للخطأ في طلب عرض السعر تشمل حالات الرد ما يلي:

  • كان نص طلب عرض السعر فارغًا.
  • لم يكن طلب عرض السعر بعملة مدرَجة في القائمة المسموح بها في بورصة معيّنة.
  • لم يتضمّن طلب عرض السعر نوع MIME مقبولاً.
errHelp رابط يؤدي إلى هذه الصفحة

عنصر Seatbid

السمة متاح تفاصيل التنفيذ تمت الموافقة دائمًا
عرض السعر نعم
مقعد نعم
مجموعة

عنصر عرض السعر

السمة متاح تفاصيل التنفيذ تمت الموافقة دائمًا
id نعم
impid نعم
price نعم
nurl
عقدة
lurl
adm
adid
adomain
مجموعة
iurl
cid نعم
crid نعم
الأسلوب
هرّ
attr
api
البروتوكول
qagmediarating
language
dealid
w
ساعة
wratio
hratio
exp

الإضافات المتوافقة مع عنصر عروض الأسعار

السمة تفاصيل التنفيذ
apis سترسل "مساحة العرض والفيديو 360" القيمة seatbid.bid.apis إذا كان كلّ من OMID وMRAID متوافقَين. ستضبط "مساحة العرض والفيديو 360" كلاً من OMID_1 وMRAID كمصفوفة أعداد صحيحة.

خيارات عرض الإعلانات

في القسم 4.3 من مواصفات OpenRTB، يتوفّر خياران مختلفان لعرض الإعلانات:

  • الترميز المعروض في إشعار الفوز
  • الترميز الذي تم عرضه في عرض السعر

تتيح "مساحة العرض والفيديو 360" استخدام الخيارَين.

  • بالنسبة إلى "إعلان البانر"، تعرض "مساحة العرض والفيديو 360" دائمًا الترميز في الحقل adm. يُرجى العِلم أنّ الترميز المعروض في إشعار الفوز اختياري.
  • بالنسبة إلى إعلان الفيديو/الصوت الذي يستخدم بروتوكول VAST، تتيح "مساحة العرض والفيديو 360" عرض ملف XML الخاص ببروتوكول VAST في الحقل adm أو في استجابة إشعار الفوز استنادًا إلى متطلبات شركاء التبادل.

راجِع مواصفات OpenRTB للتعرّف على مزايا وعيوب هذين الخيارَين.

أفضل الممارسات

ننصح بشدة باستخدام رقم تعريف الشريك في "مساحة العرض والفيديو 360" كمعرّف للمقعد. لا يُنصح باستخدام رقم تعريف مقعد خاص بتبادل معيّن.

تأكَّد من أنّ الناشرين لديهم ملفات ads.txt أو تطبيقات مرتبطة بملفات app-ads.txt، وأنّهم يدرجونك في الملف كبائع أو موزع معتمَد. مزيد من المعلومات

احرص أيضًا على تمرير معلومات متّسقة في طلبات عروض الأسعار. على سبيل المثال، يجب أن يكون app.bundle متوافقًا مع معلومات الجهاز الجوّال وapp.storeurl.

التلفزيون المتّصل

الالتزام بإرشادات IAB OTT IFA عند تمرير device.ifa وdevice.lmt عليك أيضًا تنفيذ device.ext.ifa_type للالتزام بالإرشادات. ستتطلّب جميع إمكاناتنا المتعلّقة بتحديد عدد مرّات الظهور واستهداف الجمهور على التلفزيون المتّصل توفُّر معرّف الإعلان على الأجهزة الجوّالة.

يجب أيضًا الالتزام بإرشادات رقم التعريف المخصّص من متجر IAB OTT/CTV المنشورة مؤخرًا، والتي تحدّد كيفية تمرير app.bundle لتطبيقات التلفزيون المتّصل، وذلك بشكل كبير باستخدام رقم التعريف المحدّد من متجر التطبيقات.

قياس نسبة العرض النشط

"العرض النشط" هي تكنولوجيا من Google تُستخدَم لقياس ما إذا كان ظهور الإعلان قابلاً للعرض ومدة عرضه. تستخدم ميزة "العرض النشط" واجهة OMID لكلّ من الإعلانات الصورية وإعلانات الفيديو. لتفعيل القياس باستخدام OMID، يجب أن تضيف البورصات الحقول التالية في طلبات OpenRTB لكي يعرف "مساحة العرض والفيديو 360" ما إذا كان العميل يتيح استخدام OMID.

  • مطلوب: أضِف إطار عمل لواجهة برمجة التطبيقات (Video.api=7 لـ Web Video OMSDK أو Native.api=7 لـ Native App OMSDK أو Banner.api=7 أو Audio.api=7) إلى طلبات عروض الأسعار. هذه الخطوة إلزامية لكي يتمكّن "العرض النشط" من تفعيل القياس باستخدام OMID.
  • ننصحك بشدة بإضافة omidpn وomidpv إلى Source.Ext، لأنّ ذلك سيؤثّر في طريقة عرض مقاييس إمكانية المشاهدة في "مساحة العرض والفيديو 360" للعميل. إذا كان اسم شريك OMID غير مدرَج في شهادة اعتماد IAB، يجب أن نقدّم تقريرًا عن مقاييس إمكانية العرض بشكل منفصل عن المقاييس المعتمَدة من MRC. مزيد من المعلومات
قياس نسبة العرض النشط للإعلانات المدمجة مع المحتوى

لتفعيل قياس "العرض النشط" للإعلانات المدمجة، تتطلّب "مساحة العرض والفيديو 360" من الناشرين والشبكات اتّخاذ خطوات إضافية.

  • الإعلانات الصورية المدمجة مع المحتوى: تضيف "مساحة العرض والفيديو 360" eventtrackers التالية في الاستجابة لعرض السعر ضمن العنصر adm.native:

    "eventtrackers": [
  {
    "event": 555,
    "method": 2,
    "url": "https://pagead2.googlesyndication.com/pagead/managed/js/activeview/current/rx_omid.js",
    "ext": {
      "vendorKey": "doubleclickbygoogle.com-omid-dsp",
      "verification_parameters": ""
    }
  }
]

    على منصّات التبادل تمرير أدوات تتبُّع الأحداث الإضافية إلى الناشرين، وعلى الناشرين اتّخاذ الخطوات التالية:

    1. ثبِّت OMSDK.
    2. تحميل OMSDK عند عرض الإعلانات المدمجة مع المحتوى
    3. نفِّذ JavaScript في eventtrackers.url باستخدام المَعلمات المحدّدة.

  • إعلانات الفيديو المدمجة مع المحتوى: تتيح "مساحة العرض والفيديو 360" قياس إمكانية العرض من خلال إضافة الإضافة العادية AdVerifications ضمن VAST XML:

    <Extension type="AdVerifications">
  <AdVerifications>
    <Verification vendor="doubleclickbygoogle.com-omid-video">
      <JavaScriptResource apiFramework="omid" browserOptional="true">
        <![CDATA[ https://www.googletagservices.com/activeview/js/current/rx_omid_video.js ]]>
      </JavaScriptResource>
      <VerificationParameters>
        <![CDATA[ {"activeview_flags":"...","activeview_metadata":"...", ...} ]]>
      </VerificationParameters>
      <TrackingEvents>
        <Tracking event="verificationNotExecuted">
          <![CDATA[ https://ade.googlesyndication.com/ddm/activity/... ]]>
        </Tracking>
      </TrackingEvents>
    </Verification>
  </AdVerifications>
</Extension>

    ليس على الناشرين الذين يتيحون قياس مدى إمكانية مشاهدة إعلانات الفيديو اتّخاذ أي إجراء إضافي. وفي ما عدا ذلك، على الناشرين إما التعامل مع الامتداد الجديد في مشغّل الفيديو أو تجاهله.

الأسئلة الشائعة

هل تتيح "مساحة العرض والفيديو 360" استخدام إضافات مخصّصة لتبادل الإعلانات؟
نعم، بالإضافة إلى الإضافات المدرَجة في هذه المواصفات، قد تتيح &quot;مساحة العرض والفيديو 360&quot; أيضًا إضافات مخصّصة على أساس كل حالة على حدة. يُنصح بتحديد الإضافة المخصّصة واختبارها خلال فترة الدمج.
هل تتيح "مساحة العرض والفيديو 360" عرض إعلانات الفيديو مقابل مكافآت؟
نعم، أرسِل إلينا إضافة "الفيديو مقابل مكافأة".
يظهر الكثير من مستودعي الإعلاني على أنّه خصائص ديمغرافية غير معروفة، كيف يمكنني تحسين تغطية الخصائص الديمغرافية؟
املأ الحقلَين user.yob وuser.gender في طلبات عروض الأسعار التي يتم إرسالها إلى "مساحة العرض والفيديو 360" لزيادة مدى الوصول.
هل تتضمّن "مساحة العرض والفيديو 360" نقاط نهاية لكل منطقة؟
لا، نحن نستخدم نقطة نهاية واحدة على مستوى العالم، ونوجّه الطلبات تلقائيًا إلى أقرب مركز بيانات، لذا لا تتوفّر لدينا نقطة نهاية خاصة بمنطقة معيّنة يمكننا تقديمها.
ما هي متطلبات طلبات الخادم إلى الخادم (s2s)؟
تواصَل معنا لطلب إضافة نطاقك إلى القائمة المسموح بها. يجب إعادة توجيه وكيل المستخدم الخاص بالعميل والتأكّد من إيقاف ملفات تعريف الارتباط أو تجاهلها في الردّ على عملية جلب VAST من الخادم إلى الخادم.
هل تتوافق "مساحة العرض والفيديو 360" مع معيار OMID؟
يمكننا قياس إمكانية العرض باستخدام OMID طالما تم الإفصاح عن أنّه متوافق مع OMID في وقت طلب عرض السعر. يمكنك الاطّلاع على ملخّص حول هذا الموضوع في الصفحتين 24 و25.
ما هو إصدار Native الذي يتوافق معه تطبيقك؟ هل لديك أي متطلبات خاصة بـ Native؟
لا تتوافق هذه الميزة إلا مع الإصدار 1.2 من Native. مواصفات الإعلانات المدمَجة مع المحتوى:
هل تتيح "مساحة العرض والفيديو 360" طلبات عروض الأسعار المُرسَلة بتنسيق GZIP؟
يمكن أن تتلقّى "منصة العرض والفيديو 360" طلبات عروض أسعار مضغوطة بتنسيق gzip، وستردّ بإجابات مضغوطة بتنسيق gzip إذا كان عنوان Accept-Encoding يشير إلى أنّ هذا التنسيق متوافق.
هل تتيح "مساحة العرض والفيديو 360" استخدام DBURL؟
لا يمكن ذلك حاليًا.
هل تتيح "مساحة العرض والفيديو 360" تلقّي إشعارات بشأن عروض الأسعار الفائزة والخاسرة؟
لا يمكن ذلك حاليًا. إذا كنت تعتقد أنّ توفير هذه الميزة سيكون مفيدًا، يُرجى التواصل معنا وتقديم المزيد من التفاصيل.
هل تتطلّب "مساحة العرض والفيديو 360" توفّر App.name للاستهداف؟
لا، تستخدم "مساحة العرض والفيديو 360" App.name كمرجع، ولكنّه ليس مطلوبًا للاستهداف، App.bundle ويتم استخدام
للاستهداف.
هل يمكن أن تتيح "مساحة العرض والفيديو 360" أحجام إعلانات متعدّدة يتم إرسالها في طلب عرض أسعار واحد؟
نعم، سنأخذ في الاعتبار جميع أحجام تصاميم الإعلانات المؤهّلة في banner.format.
هل تتيح "مساحة العرض والفيديو 360" استخدام تنسيقات متعدّدة في طلب عروض الأسعار نفسه؟
تتوفّر لدينا إمكانية محدودة لتلقّي طلبات عروض الأسعار بتنسيقات متعدّدة، ولكنّنا نعمل على تحسينها. نسمح باستخدام أشكال الإعلانات الصورية وإعلانات الفيديو للإعلانات البينية، ولكن لا نسمح حاليًا باستخدام الإعلانات الصورية والمدمجة مع المحتوى. إذا كنت ترسل طلبات عروض أسعار متعددة التنسيقات، يُرجى التواصل معنا لطلب إجراء اختبار.
هل تتيح "مساحة العرض والفيديو 360" استخدام أنواع مرات ظهور مختلطة في الطلب نفسه؟
نسمح حاليًا فقط بالإعلانات البينية على شكل فيديو أو بانر. نعمل على إتاحة الإعلانات المدمجة/إعلانات البانر والفيديو/إعلانات البانر. إذا كانت هناك مجموعات أخرى، يُرجى التواصل مع فريقنا.
هل يمكن أن ترسل مقاعد متعدّدة عروض أسعار متعددة بشأن فرصة ظهور واحدة أو أكثر من فرص الظهور هذه في الطلب نفسه؟
نعم.
هل لدى "مساحة العرض والفيديو 360" حلّ أو حاجة معيّنة بشأن الحدّ الأقصى لعدد مرات الظهور أو عرض المعلِن نفسه لفرص ظهور متعدّدة من هذا النوع في الطلب نفسه؟
تفرض "مساحة العرض والفيديو 360" أنّه يمكن للمعلِن تقديم عروض أسعار لما يصل إلى فرصة ظهور واحدة لكل طلب. نتوقّع من منصّات العرض من جهة الخادم تجميع عناصر imp بشكل منطقي، مثلاً، جميعها في الصفحة نفسها أو في التطبيق نفسه، وما إلى ذلك.
هل يتيح DV360 مرات ظهور متعدّدة في طلب عروض الأسعار نفسه؟
تتيح "منصة العرض والفيديو 360" حاليًا استخدام عناصر صوتية متعددة خاصة مرّات الظهور. ومع ذلك، علينا اختبار/تفعيل كل شبكة تبادل تريد استخدام هذه الميزة. يمكنك الاطّلاع على مواصفات طلب عروض الأسعار لمزيد من المعلومات. نعمل على توسيع نطاق هذه الميزة لتشمل أشكالاً أخرى: 
{
id: "2bbdc94f-7289-4fe2-9a5f-e2a530e06b38",
seatbid {
bid {
  id: "0",
  impid: "234232",
  price: 41.373926619828261,
  adid: "123",
  adm: "...",
  adomain: "xxx.com",
  cid: "0",
  crid: "123",
  dealid: "sample-deal-id-1",
  language: "xx",
},
bid {
  id: "1",
  impid: "234255",
  price: 2.34192037470726,
  adid: "234",
  adm: "...",
  adomain: "xyz.com",
  cid: "0",
  crid: "234",
  dealid: "sample-deal-id-2",
  language: "xx",
},
seat: "123456"
},
cur: "EUR"
}

التواصل معنا

إذا كانت لديك أي أسئلة أو مشاكل، يُرجى التواصل مع فريق دعم البورصة.