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

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

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

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

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

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

طلب عرض السعر هو طلب 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 الجديدة الخاصة بحركة المرور غير الصالحة (IVT) الصادرة عن مجلس قياس وسائل الإعلام (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) تسجيل مقاييس إمكانية العرض بشكل منفصل عن المقاييس المعتمَدة من MRC. مزيد من المعلومات

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

Regs object

الحقل	النوع	التفاصيل
`coppa`	عدد صحيح	‫`0` (القيمة التلقائية): لا ينطبق قانون حماية خصوصية الأطفال على الإنترنت (COPPA) على هذا الطلب. `1`: ينطبق قانون حماية خصوصية الأطفال على الإنترنت (COPPA) على هذا الطلب.
`gdpr`	سلسلة	علم يشير إلى ما إذا كان الطلب يخضع للوائح اللائحة العامة لحماية البيانات، 0 = لا، 1 = نعم، يشير الحذف إلى أنّ الحالة غير معروفة. لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات اللائحة العامة لحماية البيانات (GDPR) في "مساحة العرض والفيديو 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 object

الحقل	النوع	التفاصيل
`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`: Flash
`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 في Active View.‫ `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`	عدد صحيح	نوع خلاصة الصوت يُرجى الرجوع إلى القائمة: أنواع الخلاصات في AdCOM 1.0. `1`: خدمة بث الموسيقى `2`: بث FM/AM (بث مباشر للمحتوى عبر شبكة غير سلكيّة، ولكنّه متاح أيضًا باستخدام البث المباشر على الإنترنت) `3`: بودكاست (محتوى أصلي مسجّل مسبقًا يتم توزيعه على شكل حلقات في سلسلة) `4`: راديو عند الطلب (مقطع مسجّل من برنامج إذاعي تم بثه مباشرةً في الأصل) `5`: راديو على الويب (محتوى مباشر متاح فقط باستخدام البث المباشر على الإنترنت، وليس كبث AM/FM) `6`: لعبة فيديو (صوت في الخلفية في ألعاب الفيديو) `7`: تحويل النص إلى كلام (كتب صوتية، ومكوّن إضافي لموقع إلكتروني يمكنه قراءة مقالة)
`stitched`	عدد صحيح	غير متاح.
`nvol`	عدد صحيح	غير متاح.

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

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

الحقل	النوع	التفاصيل
`request`	سلسلة	السلسلة التي تم ترميز عنصر json الأصلي بها.
`ver`	سلسلة	`1.0`: غير متاح `1.1`: غير متاح `1.2`
`api`	مصفوفة الأعداد الصحيحة	قائمة بأُطر عمل واجهة برمجة التطبيقات المتوافقة مع هذا الانطباع. ‫`7`: الإصدار 1 من Omid
`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` بدلاً من هذا الحقل.

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، يجب أن يكون رقم تعريف متجر التطبيقات رقميًا. لا نقبل معرّف حزمة الأنماط لنظام أسماء النطاقات العكسي. بالنسبة إلى تطبيق CTV، ننصحك بتمرير معرّف التطبيق الذي يحدّده المتجر. يُرجى الالتزام بإرشادات معرّف المتجر المخصّص لخدمات البث المباشر عبر الإنترنت (OTT) والتلفزيون المتّصل (CTV) الصادرة عن مكتب IAB مؤخرًا.
`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`	سلسلة	مطلوبة إذا كان لديك عنوان IPv6 في حال تم اقتطاع عنوان 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 للمطوّرين.

كائن 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`	سلسلة (قيم مفصولة بفواصل)	غير متاح.
`customdata`	سلسلة	غير متاح.
`geo`	Geo object	غير متاح.
`data`	مصفوفة من عناصر البيانات	بيانات إضافية
`consent`	سلسلة (base64 متوافق مع الويب)	عندما تكون لوائح "اللائحة العامة لحماية البيانات" سارية، تحتوي هذه السمة على بنية بيانات "سلسلة الموافقة" الخاصة بـ "إطار الشفافية والموافقة" الصادر عن مكتب IAB. القيمة هي سلسلة ثنائية مرمّزة باستخدام base64 الآمن على الويب، وذلك باستخدام تنسيق IAB. توضّح مستندات اللائحة العامة لحماية البيانات في "مساحة العرض والفيديو 360" كيفية استخدام "مساحة العرض والفيديو 360" لهذه الإشارة. يجب استخدام إحدى السمتين `user.consent` و`user.ext.consent` فقط.
`eids`	مصفوفة من عناصر المعرّف الموسّع	مثيلات المعرّف الموسّع التي يقدّمها التبادل.
`ext`	إضافات المستخدم	إضافات لكائن المستخدم

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

الحقل	النوع	التفاصيل
`consent`	سلسلة (base64 متوافق مع الويب)	سلسلة الموافقة بموجب "اللائحة العامة لحماية البيانات"، كما هو موضّح في `user.consent` أعلاه. يجب استخدام إحدى السمتين `user.consent` أو `user.ext.consent` فقط.
`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	المعرّفات الفعلية

عنصر UID الخاص بمعرّف Extended ID

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

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

الحقل النوع التفاصيل

complete عدد صحيح ‫0 (الإعداد التلقائي): سلسلة الإمداد غير مكتملة.‫
1: سلسلة الإمداد كاملة وصولاً إلى الناشر.

ver سلسلة الحقل مطلوب.
يتم تنسيق القيمة على النحو "الإصدار الرئيسي.الإصدار الثانوي"، مثلاً، الإصدار 1.0 هو السلسلة "1.0".

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

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

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

السمة

تفاصيل التنفيذ

خطأ

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

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

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

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

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

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

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

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

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

يجب أيضًا الالتزام بإرشادات رقم التعريف المخصّص من متجر التطبيقات على أجهزة OTT/CTV المنشورة مؤخرًا من IAB، والتي تحدّد كيفية تمرير 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 ضمن ملف XML الخاص بـ VAST:

<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>

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

لائحة الذكاء الاصطناعي في الاتحاد الأوروبي بشأن "الدفع المدمج" على منصات تابعة لجهات خارجية

لتمكين المعلِنين من الامتثال للوائح التنظيمية الجديدة المتعلّقة بالشفافية تقتضي اللوائح التنظيمية المتعلقة بالذكاء الاصطناعي في الاتحاد الأوروبي والهند وولاية نيويورك تضمين إفصاحات في الإعلانات التي تستخدم مواد عرض معينة تم إنشاؤها أو تعديلها باستخدام الذكاء الاصطناعي، وذلك لإعلام المستهلكين بأن هذه الإعلانات هي من إنشاء الذكاء الاصطناعي. اعتبارًا من يوليو 2026، ستسمح "مساحة العرض والفيديو 360" (DV360) للمعلِنين بإضافة تصنيف يشير إلى أنّ تصميم الإعلان تم إنشاؤه أو تعديله باستخدام الذكاء الاصطناعي لمساعدتهم في الامتثال للوائح الشفافية الجديدة المتعلّقة بالذكاء الاصطناعي.

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

بالنسبة إلى الإعلانات التي تعرضها Google، تستخدم استراتيجية الامتثال التي اخترناها تصنيفًا بسيطًا بالذكاء الاصطناعي يظهر قبل النقر على الإعلان، بالإضافة إلى إفصاح يظهر بعد النقر على الإعلان في لوحة About This Ad (الإعلان الشفاف).

بالنسبة إلى أشكال "الإعلانات المدمجة مع المحتوى" على منصات الطرف الثالث، لا تتحكّم Google في العرض النهائي للإعلان. في هذه الحالات، سيتم نشر إشارة شهادة الإفصاح هذه كجزء من استجابة الإعلان لكي تعرض البورصة أو الناشرون الإعلان النهائي الذي يتضمّن تصنيف استخدام الذكاء الاصطناعي أو الإفصاح. ستكون الإشارة جزءًا من حقل adm.native.ext في استجابة الإعلان المدمج مع المحتوى. يكون الحقل الجديد adm.native.ext بالتنسيق التالي:

  "ext" {
     "should_disclose_ai": "true",
     "ai_disclosure_url": ""
  }

يشير should_disclosure_ai (صحيح أو خطأ) إلى ما إذا كان الإعلان النهائي بحاجة إلى تضمين تصنيف استخدام الذكاء الاصطناعي.
قد يكون الحقل ai_disclosure_url متوفّرًا أو غير متوفّر. لن يظهر هذا الحقل إلا عندما يتم ضبط should_disclosure_ai على "صحيح" ويكون حقل عنوان URL الخاص بـ native.privacy فارغًا. في هذه الحالة، يجب أن يؤدي النقر على تصنيف استخدام الذكاء الاصطناعي إلى توجيه المستخدم إلى عنوان URL المقدَّم في هذا الحقل. بخلاف ذلك، من المفترض أن يؤدي النقر على تصنيف استخدام الذكاء الاصطناعي إلى توجيه المستخدم إلى حقل عنوان URLnative.privacy العادي.

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

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

هل تتيح "مساحة العرض والفيديو 360" استخدام إضافات مخصّصة لتبادل الإعلانات؟

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

هل تتيح "مساحة العرض والفيديو 360" عرض "إعلانات الفيديو مقابل مكافآت"؟

نعم، أرسِل إلينا إضافة "الفيديوهات مقابل مكافأة".

يظهر الكثير من مستودعي الإعلاني على أنّه خصائص ديمغرافية غير معروفة، كيف يمكنني تحسين تغطية الخصائص الديمغرافية؟

املأ الحقلَين user.yob وuser.gender في طلبات عروض الأسعار التي يتم إرسالها إلى "مساحة العرض والفيديو 360" لزيادة التغطية.

هل تتوفّر نقاط نهاية لكل منطقة في "مساحة العرض والفيديو 360"؟

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

ما هي متطلبات الطلبات من خادم إلى خادم (s2s)؟

تواصَل معنا لطلب إضافة نطاقك إلى القائمة المسموح بها. يجب إعادة توجيه وكيل المستخدم الخاص بالعميل، والتأكّد من أنّه تم إيقاف ملفات تعريف الارتباط أو تجاهلها في الردّ على عملية جلب VAST من الخادم إلى الخادم.

هل تتوافق "مساحة العرض والفيديو 360" مع OMID؟

يمكننا قياس إمكانية العرض باستخدام OMID طالما تم الإفصاح عن أنّه متوافق مع OMID في وقت طلب عرض السعر. يمكنك الاطّلاع على ملخّص حول هذا الموضوع في الصفحتين 24 و25.

ما هو إصدار Native الذي يتوافق مع تطبيقك؟ هل لديك أي متطلبات خاصة بـ Native؟

لا نتوافق إلا مع الإصدار 1.2 من الإعلانات المدمجة مع المحتوى. مواصفات الإعلانات المدمَجة مع المحتوى

هل تتيح "مساحة العرض والفيديو 360" طلبات عروض الأسعار المُرسَلة بتنسيق GZIP؟

يمكن أن تتلقّى "مساحة العرض والفيديو 360" طلبات عروض أسعار مضغوطة بتنسيق gzip، وستردّ باستجابات مضغوطة بتنسيق gzip إذا كان عنوان Accept-Encoding يشير إلى أنّ هذا التنسيق متوافق.

هل تتوافق "مساحة العرض والفيديو 360" مع DBURL؟

لن يتم ذلك حاليًا.

هل تتيح "مساحة العرض والفيديو 360" إرسال إشعارات بشأن فقدان الأجهزة؟

نعم، تملأ "مساحة العرض والفيديو 360" الحقل bid.lurl في الاستجابات لعروض الأسعار. في حال عدم الفوز بالمزاد، قد يرسل Ad Exchange إشعارًا إلى عنوان URL هذا مع ذكر السبب، وسيظهر هذا السبب للمعلِنين. يمكن أن تقدّم هذه الأسباب نصائح للمعلِنين حول كيفية تجنُّب الخسائر في المستقبل.

هل تتطلّب "مساحة العرض والفيديو 360" توفير App.name للاستهداف؟

لا، تستخدم "مساحة العرض والفيديو 360" App.name كمرجع، ولكنّه ليس مطلوبًا للاستهداف، App.bundle ويتم استخدام

هل يمكن أن تتيح "مساحة العرض والفيديو 360" أحجام إعلانات متعدّدة يتم إرسالها في طلب عرض أسعار واحد؟

نعم، سنأخذ في الاعتبار جميع أحجام تصاميم الإعلانات المؤهّلة في banner.format.

هل تتيح "مساحة العرض والفيديو 360" استخدام تنسيقات متعدّدة في طلب عروض الأسعار نفسه؟

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

هل تتيح "مساحة العرض والفيديو 360" أنواع مرات الظهور المختلطة في الطلب نفسه؟

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

هل يمكن أن ترسل مقاعد متعدّدة عروض أسعار متعدّدة لفرصة ظهور إعلان واحدة أو أكثر من هذه الفرص في الطلب نفسه؟

نعم.

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

تفرض "مساحة العرض والفيديو 360" قيودًا على المعلِنين، إذ يمكن لكل معلِن تقديم عروض أسعار لما يصل إلى فرصة ظهور واحدة لكل طلب. نتوقّع من منصّات العرض أن تجمع عناصر imp بطريقة منطقية، مثلاً، كلّها في الصفحة نفسها أو كلّها في التطبيق نفسه، وما إلى ذلك.

هل تتيح "منصة العرض والفيديو 360" عرض مرّات ظهور متعدّدة في طلب عرض السعر نفسه؟

تتيح "منصة العرض والفيديو 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"
}

التواصل معنا

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