مواصفات 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)
القيمة "غير محدَّد" تعني عدم حظر أي فئات.
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، يكون ردّ عرض السعر هو كائن 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".
schain سلسلة الإمداد يجب أن تستخدم عمليات الدمج الجديدة الحقل schain في المصدر بدلاً من ذلك.

Regs object

الحقل النوع التفاصيل
coppa عدد صحيح ‫0 (القيمة التلقائية): لا ينطبق قانون COPPA على هذا الطلب.‫
1: ينطبق قانون COPPA على هذا الطلب.
ext إضافات اللوائح التنظيمية اختياريّ.

Regs extensions object

الحقل النوع التفاصيل
gdpr عدد صحيح تُستخدَم لتحديد ما إذا كان طلب عرض السعر واردًا من المنطقة الاقتصادية الأوروبية.
0 (القيمة التلقائية): منطقة خارج المنطقة الاقتصادية الأوروبية
1: منطقة المنطقة الاقتصادية الأوروبية
يمكنك الاطّلاع على حلّ مقدّم الخدمة الذي يوافق على اللائحة العامة لحماية البيانات للحصول على مزيد من التفاصيل.
us_privacy سلسلة يُرجى اتّباع المواصفات الفنية التي يقدّمها مختبر IAB التقني لتنفيذ السلسلة us_privacy.

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

عنصر 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" بدون مراعاة القيمة التي يرسلها الشريك في هذا الحقل. يتم تجاهل أحداث مرّ عليها وقت طويل (عادةً ساعة واحدة) بعد فترة انتهاء صلاحية مرّات الظهور، ولا يعتبرها DV360 قابلة للفوترة.
rwdd عدد صحيح تشير إلى ما إذا كان المستخدم سيحصل على مكافأة مقابل مشاهدة الإعلان.
0 (القيمة التلقائية): لم تتم مكافأته
1: تمت مكافأته

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

Imp extension object

الحقل النوع التفاصيل
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: 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 سلسلة تُستخدَم لمشاركة المستودع الإعلاني على التلفزيون المتّصل، راجِع شرحًا حول إضافة تطبيقات التلفزيون المتّصل الصادر عن مكتب IAB.

عنصر التطبيق

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

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

bundle سلسلة مطلوب.

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

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

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

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

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

عنصر المحتوى

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

الحقل النوع التفاصيل
id سلسلة معرّف يحدّد المحتوى بشكل فريد.
episode عدد صحيح رقم حلقة المحتوى (عادةً لمحتوى الفيديو)
title سلسلة يُنصح باستخدامها لطلبات الفيديو والصوت على التلفزيون المتّصل.
series سلسلة يُنصح باستخدامها لطلبات الفيديو والصوت على التلفزيون المتّصل.
season سلسلة تمثّل هذه السمة تصنيفًا لموسم المحتوى.
artist سلسلة الفنان الذي تمّت الإشارة إليه في المحتوى
genre سلسلة نوع المحتوى الذي يصف المحتوى بأفضل شكل. تنصح "مساحة العرض والفيديو 360" بتقديم هذه الإشارة لطلبات التلفزيون المتّصل والفيديو والصوت.
تتيح "مساحة العرض والفيديو 360" بعض التصنيفات لقيم أنواع الفيديو في هذا الحقل:
  • قائمة الأنواع من 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 عدد صحيح علامة "عدم التتبّع" كما تم ضبطها في عنوان المتصفّح

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: معرّف مقدَّم من منصة العرض من جهة الخادم
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 إضافات المستخدمين إضافات لكائن المستخدم

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

الحقل النوع التفاصيل
consent سلسلة (base64 آمنة على الويب) سلسلة الموافقة في "مكتب الإعلانات التفاعلية"

تحتوي على بيانات وصفية حول المعلومات التي وافق المستخدم على جمعها، والمورّدين المسموح لهم باستخدام هذه المعلومات.

القيمة هي سلسلة ثنائية مرمّزة باستخدام base64 الآمن على الويب باستخدام تنسيق ثنائي مخصّص.

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

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

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

عنصر Extended ID UID

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

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

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

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

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

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

الحقل النوع التفاصيل
asi سلسلة اسم النطاق الأساسي لنظام منصة عرض جانب الطلب أو البورصة أو أداة تضمين العناوين الرئيسية أو غير ذلك، والذي يتم ربط مقدِّمي عروض الأسعار به. قد يمثل ذلك النطاق التشغيلي للنظام، إذا كان مختلفًا عن نطاق الشركة الرئيسي، لتسهيل عمليات البحث عن عناوين 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

السمة تفاصيل التنفيذ
خطأ

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

  • كان نص طلب عروض الأسعار فارغًا.
  • لم يكن طلب عرض السعر بعملة مدرَجة في القائمة المسموح بها في بورصة معيّنة.
  • لم يتضمّن طلب عرض السعر نوع 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 بشأن معرّف الإعلان على التلفزيون المتّصل (IFA) عند تمرير device.ifa وdevice.lmt عليك أيضًا تنفيذ device.ext.ifa_type للالتزام بالإرشادات. ستتطلّب جميع إمكانات تحديد عدد مرّات الظهور واستهداف الجمهور على التلفزيون المتّصل بالإنترنت توفّر معرّف خاص بالإعلان.

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

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

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

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

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

هل تتيح "مساحة العرض والفيديو 360" استخدام إضافات مخصّصة لتبادل الإعلانات؟
نعم، بالإضافة إلى الإضافات المدرَجة في هذا المواصفات، قد تتيح "مساحة العرض والفيديو 360" أيضًا إضافات مخصّصة على أساس كل حالة على حدة. يُنصح بتحديد الإضافة المخصّصة واختبارها خلال فترة الدمج.
هل تتوافق "مساحة العرض والفيديو 360" مع "الإعلانات مقابل مكافآت"؟
نعم، يُرجى إرسال إضافة الفيديو مقابل مكافأة إلينا.
يظهر الكثير من مستودعي الإعلاني على أنّه خصائص ديمغرافية غير معروفة، كيف يمكنني تحسين تغطية الخصائص الديمغرافية؟
املأ الحقلَين user.yob وuser.gender في طلبات عروض الأسعار التي يتم إرسالها إلى "مساحة العرض والفيديو 360" لزيادة مدى الوصول.
هل تتوفّر في "مساحة العرض والفيديو 360" نقاط نهاية لكل منطقة؟
لا، نحن نستخدم نقطة نهاية واحدة على مستوى العالم، ونوجّه الطلبات تلقائيًا إلى أقرب مركز بيانات، لذا لا يمكننا تقديم نقطة نهاية خاصة بمنطقة معيّنة.
ما هي متطلبات طلبات الخادم إلى الخادم (s2s)؟
تواصَل معنا لطلب إضافة نطاقك إلى القائمة المسموح بها. يجب إعادة توجيه سلسلة وكيل المستخدم الخاصة بالعميل، والتأكّد من إيقاف ملفات تعريف الارتباط أو تجاهلها في الردّ على عملية جلب VAST من الخادم إلى الخادم.
هل تتوافق "مساحة العرض والفيديو 360" مع OMID؟
يمكننا قياس إمكانية العرض باستخدام OMID طالما تم الإفصاح عن أنّه متوافق مع OMID في وقت طلب عرض السعر. يمكنك الاطّلاع على ملخّص حول هذا الموضوع في الصفحتين 24 و25.
ما هو إصدار Native الذي يتوافق مع تطبيقك؟ هل لديك أي متطلبات خاصة بـ Native؟
لا نتيح سوى Native Ver1.2. مواصفات الإعلانات المدمَجة مع المحتوى:
هل تتوافق "مساحة العرض والفيديو 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" أنّه يمكن للمعلِن الواحد تقديم عروض أسعار لما يصل إلى فرصة ظهور واحدة لكل طلب. نتوقّع أن تصنّف منصّات العرض (SSP) عناصر 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"
}

التواصل معنا

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