دمج OpenRTB

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

يتناول هذا الدليل دمج OpenRTB 2.5 (بما في ذلك وحدات الماكرو) و الإعلانات المدمجة مع المحتوى مع "الشراة المعتمَدون". ويصف أيضًا كل حقل في النموذج الأولي لإضافات OpenRTB للمشترين.

للحصول على مزيد من المعلومات عن نماذج OpenRTB Protos، يمكنك الاطّلاع على ملف ProRTB Proto. للحصول على إضافات "الشراة المعتمَدون"، يمكنك الرجوع إلى ملف OpenRTB Extensions "بروتوكول البروتوكول المؤقت".

يتوفر تنفيذ OpenRTB على الشراة المعتمَدين بتنسيقين متشابهين.

  • JSON
  • البروتوكول: يمكن الرجوع إلى ملف التعريف .proto لفك ترميز الرسائل.

وتكون هذه الصفحة بمثابة مرجع لكلٍّ منهما.

اعتبارات الدمج

بنية هذا المستند

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

تجدر الإشارة أيضًا إلى ما يلي:

  • يمثّل الحقل cid معرّف الفوترة المحدّد في إعداد الاستهداف المسبق. يُستخدَم هذا الحقل لربط عرض السعر بقيمة billing_id المرسَلة في طلب عرض السعر. في حال توفّر أكثر من cid/billing_id في الطلب أو كانت لديك مقاعد للأطفال نشطة، عليك تحديد السمة cid المقصودة في ردّك. إذا كان الطلب يتضمّن مقعدًا واحدًا فقط ولم يكن لديك أي مقاعد ثانوية نشطة، تكون هذه هي القيمة التي سيتم افتراضها في الردّ.
  • تتبع التسمية في الأقسام أدناه OpenRTB ببساطة.
  • ستتم تعبئة كل الحقول في الطلب في حال توفّره. ولن نمرِّر أبدًا القيم الفارغة أو السلاسل الفارغة.
  • لا يتم تضمين الأنواع والأوصاف من OpenRTB في الجداول أدناه، يُرجى الرجوع إلى ملف OpenRTB Proto.
  • في طلبات عروض الأسعار المشفّرة بتنسيق JSON، سيتم إرسال جميع الحقول المكتوبة بالامتداد int64 أوfix64 أدناه كسلاسل لمنع فقدان الدقة لقيم 64 بت المتكاملة.
  • يمثّل بروتوكول OpenRTB JSON جميع حقول bool كأعداد صحيحة في الطلب، حيث يمثّل 0 false ويمثل 1 true. وهذا مطلوب في مواصفات OpenRTB.

حساب مرات الظهور واستخدام وحدات الماكرو

للحدّ من التناقضات، ننصحك باستخدام حقل BidResponse.seatbid[].bid[].ext.impression_tracking_url لجميع المستودعات، بما في ذلك الإعلانات المدمجة مع المحتوى.

يتعين على المشترين إزالة وحدات بكسل تتبع مرات الظهور من تصميم الإعلان (ترميز الإعلان)، وتضمين الحقل impression_tracking_url (السلسلة النصية) في استجابة عرض الأسعار بدلاً من ذلك. في OpenRTB 2.5، يمكن أيضًا استخدام BidResponse.seatbid[].bid[].burl. يتم تنشيط impression_tracking_url عندما يتم اعتبار مرة الظهور واجبة الدفع. وهذا يوفر دقة أعلى من وحدات بكسل التتبع التي يمكنها تتبع مرات الظهور التي أحضرها التطبيق بسبب الجلب المسبق، لكن لم يتم عرضها مطلقًا. استخدم ماكرو %%WINNING_PRICE%% المشفر لهذا الحقل، أو ماكرو ${AUCTION_PRICE}.

في ما يلي قائمة وحدات الماكرو المتوافقة مع impression_tracking_url وburl:

  • ${AUCTION_ID}: معرّف طلب عرض السعر، من السمة BidRequest.id
  • ${AUCTION_BID_ID}: معرّف عرض السعر، من السمة BidResponse.bidid
  • ${AUCTION_IMP_ID}: رقم تعريف مرّة الظهور التي تم الفوز بها للتو، من سمة BidRequest.imp[].id.
  • ${AUCTION_SEAT_ID}: معرّف مقعد نظام عروض الأسعار الذي تم تقديم عرض السعر له من السمة BidResponse.seatbid[].seat
  • ${AUCTION_AD_ID}: رقم تعريف ترميز الإعلان الذي يريد نظام عروض الأسعار عرضه، من السمة BidResponse.seatbid[].bid[].adid
  • ${AUCTION_PRICE} - محو السعر باستخدام العملة والوحدات نفسها المستخدمة في عرض السعر. تجدر الإشارة إلى أن وحدة الماكرو هذه غير متاحة حاليًا في إعلانات AMP.

يعمل تشفير OpenRTB من Google على تشفير AUCTION_PRICE بطريقة متوافقة مع وحدة ماكرو WINNING_PRICE لبروتوكول "الشراة المعتمَدون". لمزيد من المعلومات حول كيفية فك تشفير السعر، يمكنك الرجوع إلى دليل تأكيدات السعر لفك التشفير.

الترحيل إلى Protobuf

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

عند نقل البيانات من JSON إلى Protobuf، احرص على إعداد الحقل cid كسلسلة في استجابة عرض السعر. نستخدم ذلك الحقل لربط عرض السعر بسعر billing_id ضمن الاستهداف المسبق. وإذا كان غير قابل للقراءة، لن يتم قبول عرض السعر.

VAST ودعم الفيديو

بشكل افتراضي، نتيح استخدام عناوين URL عبر طبقة المقابس الآمنة بدلاً من تنسيق XML الكامل لإعلانات VAST. ومع ذلك، يمكن أن تُرجع عروض أسعار Exchange نموذج VAST المضمن بالكامل، ويمكن تمكين جميع الحسابات لهذه الميزة عن طريق الاتصال بفريق دعم الحساب.

لاحظ أنه في الإصدار OpenRTB 2.4 والإصدارات الأحدث، إذا كان video.skip=1، يمكن للمشترين تقديم عروض أسعار باستخدام تصميمات إعلانات الفيديو غير القابلة للتخطي أو القابلة للتخطي. ننصحك بتفعيل ميزة تخطي التصحيح أثناء إعداد الحساب، لأنه في نظام OpenRTB، لا يتم التمييز بين ALLOW_SKIPPABLE وREQUIRE_SKIPPABLE.

حقول غير متوافقة

الحقل Nurl غير متوافق حاليًا، ولكن impression_tracking_url متوافق، كما هو الحال في Bid.burl في OpenRTB 2.5: راجع التعليقات أعلاه.

بلا عرض أسعار

إذا لم يرغب العميل في تقديم عرض أسعار، يجب على العميل الرد باستخدام الرمز 204.

عمليات التعداد

يمكن العثور على جميع التعدادات في الوثائق الرسمية لـ OpenRTB 2.5 و الإعلانات المدمجة مع المحتوى.

لاحظ أن MRAID-1 هي مجموعة فرعية من MRAID-2. في OpenRTB 2.1 والإصدارات السابقة، كانت القيمة 3 MRAID. ومع ذلك، لا تفهم جميع واجهات برمجة التطبيقات التي تمكّن MRAID ميزات MRAID-2، لذا فالتفسير الوحيد الآمن للقيمة 3 هو MRAID-1. في OpenRTB 2.2، أصبح هذا صريحًا وتمت إضافة MRAID-2 كقيمة 5.

التحقق من إصدار OpenRTB

OpenRTB/JSON
x-openrtb-version متوفر ويحتوي على 2.2 أو 2.3 أو 2.4 أو 2.5. Content-Type هو application/json. charset=utf-8.
بروتوكول OpenRTB/Protobuf
x-openrtb-version متوفر ويحتوي على 2.3 أو 2.4 أو 2.5. Content-Type هو application/octet-stream.

متغيرات طلب عرض الأسعار وتعريفاته

طلب عرض السعر

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

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

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل

مشترين معتمَدين
متاح تفاصيل التنفيذ
في الإصدار من Google
id نعم سلسلة BidRequest.id 2.3
2.4
2.5


المعرّف الفريد لطلب عرض السعر، الذي يقدمه التبادل.

OpenRTB هو basesafe46 (بدون مساحة متروكة).

imp نعم صفيف Imp من العناصر BidRequest.AdSlot 2.3
2.4
2.5


تمثل مرات الظهور المقدمة.

مطلوب كائن Imp واحد على الأقل.

site لا عنصر واحد (Site) طلب عرض السعر 2.3
2.4
2.5


تفاصيل حول الموقع الإلكتروني للناشر.

ينطبق فقط ويوصى به لمواقع الويب.

مرة واحدة مع app.

app لا عنصر واحد (App) BidRequest
BidRequest.Mobile
2.3
2.4
2.5


تفاصيل حول تطبيق الناشر.

(التطبيقات التي لا تستند إلى المتصفح). ينطبق فقط ويُنصح به للتطبيقات.

مرة واحدة مع site.

device لا عنصر واحد (Device) BidRequest.Mobile، BidRequest.Device 2.3
2.4
2.5


تفاصيل عن جهاز المستخدم الذي سيتم عرض مرة الظهور له.
regs لا عنصر واحد (Regs) 2.3
2.4
2.5


تحدّد أي لوائح سارية في هذا المجال أو قوانين قانونية أو حكومية تنطبق على هذا الطلب.
user لا عنصر واحد (User) طلب عرض السعر 2.3
2.4
2.5


تفاصيل حول المستخدم البشري للجهاز؛ والجمهور الإعلاني.
at لا عنصر واحد (AuctionType) BidRequest.auction_type 2.3
2.4
2.5


حيث 1 = السعر الأول، 2 = السعر الثاني زائد.

يمكن تحديد أنواع المزادات المتعلقة بالتبادل باستخدام القيم > 500. الافتراضي = SECOND_PRICE.

tmax لا int32 من 80 إلى 1000 مللي ثانية 2.3
2.4
2.5


الحد الأقصى للمللي ثانية لإرسال عرض سعر لتجنب المهلة. ويتم عادةً نشر هذه القيمة بلا اتصال بالإنترنت.
wseat لا سلسلة غير متاح 2.3
2.4
2.5


القائمة المسموح بها لمقاعد المشترين (مثل المعلنين والوكالات) المسموح لها بتقديم عروض أسعار على مرة الظهور هذه. ويجب أن تكون معرّفات المقاعد ومعلومات معرفة عملاء المشتري الذين تتم الإشارة إليهم في تنسيق بين مقدّمي عروض الأسعار والتبادل. يشير عدم الحذف إلى عدم فرض قيود على المقاعد.
allimps لا قيمة منطقية غير متاح 2.3
2.4
2.5


خيار للإشارة إلى ما إذا كان بإمكان Exchange التحقّق من أنّ مرات الظهور المقدّمة تمثّل جميع مرات الظهور المتاحة في السياق (على سبيل المثال، جميع مرات الظهور المتاحة على صفحة الويب، وجميع مواضع الفيديو مثل إعلان ما قبل التشغيل أو أثناءه أو بعده) لإتاحة إمكانية حظر الإعلانات على الطريق. 0 = لا أو غير معروف، 1 = نعم، تمثل مرات الظهور المعروضة كل ما هو متاح.
cur لا مصفوفة سلسلة غير متاح 2.3
2.4
2.5


مصفوفة العملات المسموح بها لعروض الأسعار في طلب عرض الأسعار هذا باستخدام رموز ألفا ISO-4217. يُنصح به فقط في حال قبول التبادل بعملات متعددة.
bcat لا مصفوفة سلسلة BidRequest.AdSlot.
excluded_sensitive
_category, BidRequest.AdSlot.
excluded_product
_category
2.3
2.4
2.5


فئات المعلن الممنوعة باستخدام فئات محتوى IAB. يُرجى الرجوع إلى عدد فئات المحتوى.
badv لا مصفوفة سلسلة غير متاح 2.3
2.4
2.5


حظر قائمة المعلنين حسب نطاقاتهم (على سبيل المثال، "addomain.com")
bapp لا مصفوفة سلسلة غير متاح 2-4
2-5

يمكنك حظر قائمة التطبيقات من خلال معرِّفات التطبيقات المستقلة عن الأنظمة الأساسية والمُحدَّدة للنظام الأساسي. في نظام التشغيل Android، يجب أن تكون هذه أسماء الحزم أو الحزم (على سبيل المثال، com.foo.mygame). في نظام التشغيل iOS، هي أرقام التعريف الرقمية.
test لا قيمة منطقية عرض السعر.is_test 2.3
2.4
2.5


مؤشر وضع الاختبار حيث لا يمكن تحرير فواتير للمزادات، حيث 0 = الوضع المباشر، 1 = وضع الاختبار الافتراضي : 1
bseat لا سلسلة غير متاح 2.5 حظر قائمة مقاعد المشترين (مثل المعلنين والوكالات) المحظورة من تقديم عروض الأسعار على مرة الظهور هذه. ويجب تنسيق معرّفات المقاعد ومعلومات معرفة عملاء المشتري الذين تتم الإشارة إليهم بين مقدّمي عروض الأسعار والتبادل. على الأكثر، يجب استخدام سمة واحدة من wseat وbseat في الطلب نفسه. ولا يشمل حذف كل من هاتين الميزتين قيودًا على المقاعد.
wlang لا سلسلة BidRequest
.AdSlot
.allowed
_languages
2.5 قائمة اللغات المسموح بها للمواد الإبداعية باستخدام ISO-639-1-alpha-2. لا ينطوي الحذف على أي قيود محددة، ولكن يُنصح المشترون بمراعاة سمة اللغة في كائنات الجهاز و/أو المحتوى إذا كانت متوفرة.
source لا عنصر واحد (Source) تُستخدم للإضافات فقط 2.5 تمثّل هذه السمة الكائن Source الذي يقدّم بيانات حول مصدر المستودع والكيان الذي يتخذ القرار النهائي.
ext لا عنصر واحد (BidRequestExt) غير متاح 2.3
2.4
2.5


بالنسبة إلى OpenRTB/Protobuf، يمكنك الوصول إلى هذا الكائن باستخدام مفتاح الإضافة [com.google.doubleclick.bid_request] (يختلف المسار الصحيح استنادًا إلى اللغة المستخدمة لإنشاء مكتبة Proto). بالنسبة إلى OpenRTB/JSON، يمكنك الوصول إلى الحقل ext في رسالة BidRequest.

عرض السعر

يمكنك الرجوع إلى التعليقات في الوقت الفعلي للحصول على مزيد من المعلومات.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
bid_feedback لا صفيف BidFeedback من العناصر BidRequest.bid_response_feedback تعليقات على عروض الأسعار المقدمة في الردود السابقة. لا يتم ضبط هذا الإعداد إلا إذا تم تفعيل التعليقات في الوقت الفعلي لمقدّم عرض السعر. يُرجى التواصل مع مدير حسابك إذا أردت تفعيل الملاحظات في الوقت الفعلي.
google_query_id لا سلسلة BidRequest.google_query_id يمثل ذلك معرّفًا فريدًا للاستعلام العام. وفي حال توفّر عدة وسائل شرح لطلب بحث، ستتضمن جميع طلبات وسائل الشرح لطلب البحث هذا سمة google_query_id نفسها.
fcap_scope نعم تعداد FrequencyCappingScope BidRequest.AdSlot.FREQUENCYCappingScope

ميزة تجريبية؛ قد تخضع للتغيير. اطّلِع على تحديد عدد مرات الظهور الذي تستضيفه Google لعروض أسعار عروض الأسعار في الوقت الفعلي (RTB) للحصول على مزيد من المعلومات. يصف نطاق فرض تحديد عدد مرات الظهور المتاح لهذا الطلب. يمكن تحديد عدد مرات الظهور المطلوب تطبيقها على عرض السعر في حقل Bid.ext.fcap.

FREQUENCY_CAPPING_SCOPE_UNKNOWN = 0، القيمة التلقائية التي يجب عدم استخدامها، أو التي يمكن أن تشير إلى أنه تعذّر تحديد نطاق تحديد عدد مرات الظهور بشكل موثوق به.

FREQUENCY_CAPPING_SCOPE_NONE = 1، لا تتوفّر ميزة تحديد عدد مرات الظهور استنادًا إلى مواصفات استجابة عروض الأسعار لهذا الطلب. ستتم تصفية عرض السعر الذي تم تحديده لتحديد عدد مرات الظهور لطلب عرض السعر الذي لا يتوفر لتحديد عدد مرات الظهور قبل المزاد.

FREQUENCY_CAPPING_SCOPE_BROWSER = 2، ويتم فرض ميزة "تحديد عدد مرات الظهور" على عدة مواقع إلكترونية في المتصفح نفسه.

FREQUENCY_CAPPING_SCOPE_DEVICE = 3، ويتم فرض ميزة "تحديد عدد مرات الظهور" على عدة مواقع إلكترونية على الجهاز، باستثناء المتصفحات.

FREQUENCY_CAPPING_SCOPE_APP = 4، يتم فرض ميزة "تحديد عدد مرات الظهور" في تطبيق واحد.

FREQUENCY_CAPPING_SCOPE_SITE = 5، ويتم فرض ميزة تحديد عدد مرات الظهور في موقع إلكتروني واحد.

privacy_treatments لا PrivacyTreatments كائن طلب عروض الأسعار والخصوصية. أنواع معالجة الخصوصية: يمكن أن يتم تعديل أو إخفاء بعض الحقول في طلب عرض السعر من أجل حماية خصوصية المستخدم. تقدّم هذه الرسالة معلومات عن أساليب معالجة الخصوصية التي تنطبق على فرصة إعلان يتم تقديمها من خلال هذا الطلب.
ملاحظات حول عرض الأسعار

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

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
request_id لا سلسلة BidRequest.BidResponseFeedback.request_id. المعرّف الفريد من BidRequest.id.
creative_status_code لا int32 BidRequest.BidResponseFeedback.creative_status_code رمز حالة الإعلان. للاطّلاع على قائمة بالمعرّفات، يمكنك الاطّلاع على رموز الحالة الإبداعية في صفحة Protos & amp;Reference Data.
price لا مزدوج BidRequest.BidResponseFeedback.cpm_micros إذا فاز عرض السعر بالمزاد، يكون هذا هو السعر المدفوع بعملة حسابك. وإذا شارك عرض السعر في المزاد لكنه كان متوقفًا عن عروض الأسعار، تكون هذه التكلفة هي التكلفة لكل ألف ظهور التي كان يجب تجاوزها لتحقيق الفوز. ولا يتم ضبط ذلك إذا تمت فلترة عرض السعر قبل المزاد، أو إذا اختار الناشر أو مقدم عرض السعر الفائز إيقاف ملاحظات السعر أو إذا أوقف حسابك مشاركة الأسعار الفائزة مع أنظمة عروض الأسعار الأخرى. بالنسبة إلى مزادات السعر الأول، تتم تعبئة الحدّ الأدنى_للعرض_الأدنى_لقيمة_الحزمة بدلاً من هذا الحقل.
minimum_bid_to_win لا مزدوج BidRequest.BidResponseFeedback.minimum_bid_to_win تمثل هذه الخاصية الحد الأدنى لقيمة عرض السعر اللازم للفوز بالمزاد بعملة حسابك. إذا فاز عرض أسعارك في المزاد، فإن هذا هو ثاني أعلى عرض سعر لم تتم تصفيته (بما في ذلك السعر الأدنى). وإذا لم يفز عرض أسعارك بالمزاد، سيكون هذا هو عرض السعر الفائز للمرشح. لن تتم تعبئة هذا الحقل إلا إذا شارك عرض أسعارك في مزاد السعر الأول، ولن تتم تعبئته إذا تمت فلترة عرض أسعارك قبل المزاد.
sampled_mediation_cpm_ahead_of_auction_winner لا مزدوج BidRequest.BidResponseFeedback.sampled_mediation_cpm_ahead_of_auction_winner عندما يستخدِم ناشر مزاد "عرض الأسعار في الوقت الفعلي" (RTB) وتوسّط حزمة تطوير البرامج (SDK) المستند إلى العرض الإعلاني بدون انقطاع على طلب البحث نفسه، على الفائز في المزاد في الوقت الفعلي أيضًا التنافس في العرض الإعلاني بدون انقطاع للتوسّط (الذي يتم طلبه حسب السعر) للحصول على مرة الظهور. إذا شارك عرض السعر في المزاد ولم يكن هناك أي عرض إعلاني بدون انقطاع، ستكون قيمة هذا الحقل 0. إذا شارك عرض السعر في المزاد وكان هناك عرض إعلاني بدون انقطاع، تكون قيمة هذا الحقل سعرًا يمثل نموذج عرض أسعار من شبكات التوسّط المؤهّلة وكان أعلى من الفائز في المزاد، ويتم ترجيحه وفقًا لمعدّل التعبئة المتوقع. يمكن استخدام هذا الحقل مع الحد الأدنى لعرض السعر لتدريب نماذج عروض الأسعار. وتكون التكلفة لكل ألف ظهور بعملة حسابك.
event_notification_token لا عنصر واحد (EventNotificationToken) BidRequest.BidResponseFeedback.event_notification_token تضمين الرمز المميز في عرض السعر المقابل.
buyer_creative_id لا سلسلة BidRequest.BidResponseFeedback.buyer_creative_id رقم تعريف تصميم الإعلان المضمّن في عرض السعر المقابل.
رمز إشعار الحدث

تضمين الرمز المميز في عرض السعر المقابل.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
event_notification_token.payload لا سلسلة BidRequest.BidResponseFeedback.event_notification_token محتويات الرمز المميز.
عنصر معالجة الخصوصية
أحد الوالدَين

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

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
non_personalized_ads_reason لا تعداد NonPersonalizedAdsReason BidRequest.privacy_treatments.non_personalized_ads_reason

تحدّد أسباب عدم عرض الإعلانات التي تم عرضها استجابةً لهذا الطلب.

UNKNOWN = 0، والسبب غير معروف.

PUBLISHER_DECLARED_NPA = 1، أعلن الناشر أنّ هذا الطلب يجب أن يعرض إعلانات غير مخصّصة بشكل مستقل عن الإشارات الأخرى.

RESTRICT_DATA_PROCESSING= 2، طلب الناشر معالجة البيانات المقيّدة لهذا الطلب.

USER_OPT_OUT = 3، أوقف المستخدم تخصيص الإعلانات.

allow_user_data_collection لا قيمة منطقية BidRequest.privacy_treatments.allow_user_data_collection صحيح إذا منح الناشر الإذن للسماح لمقدم عروض الأسعار باستخدام معلومات زيارة المستخدم من موقع الناشر على الويب لإنشاء فئات اهتمامات يمكن استخدامها لعرض الإعلانات استنادًا إلى هذه الفئات. لاستخدام هذه البيانات لإنشاء فئات اهتمامات، يجب أن يفوز نظام عروض الأسعار مرة ظهور معيّنة. راجِع لمحة عن عناصر التحكّم في جمع البيانات (إصدار تجريبي).

المصدر

يصف هذا العنصر طبيعة الكيان وسلوكه الذي يُعد مصدر طلب عرض السعر من عملية التبادل. والغرض الأساسي من هذا العنصر هو تحديد قرار ما بعد المزاد أو اتخاذ قرار استلام المنتج عندما لا يتحكم التبادل نفسه في القرار النهائي. ومن الأمثلة الشائعة لذلك عرض الأسعار في عنوان الصفحة، ولكن يمكن أن ينطبق أيضًا على كيانات الخادم التي تبدأ عملية التحميل، مثل تبادل عرض أسعار الوقت الفعلي (RTB) أو نظام التوسّط أو خادم الإعلانات، بحيث يدمج خادم الإعلانات الحملات المباشرة مع طلب الجهات الخارجية في اتخاذ القرار.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل

مشترين معتمَدين
متاح تفاصيل التنفيذ
في الإصدار من Google
fd لا منطقي غير متاح 2.5 الكيان المسؤول عن القرار النهائي لبيع الظهور، حيث 0 = التبادل، 1 = مصدر التحميل. موصى بها بواسطة مواصفات OpenRTB.
tid لا سلسلة غير متاح 2.5 رقم تعريف المعاملة الذي يجب أن يكون مشتركًا بين جميع المشاركين في طلب عرض السعر هذا (على سبيل المثال، عمليات تبادل متعددة محتملة) موصى بها بواسطة مواصفات OpenRTB.
pchain لا سلسلة غير متاح 2.5 سلسلة سلسلة معرّف الدفع تحتوي على بنية مضمّنة موضّحة في الإصدار 1.0 من بروتوكول معرّف الدفع TAG. موصى بها بواسطة مواصفات OpenRTB.
ext لا عنصر واحد (SourceExt) غير متاح 2.3
2.4
2.5


بالنسبة إلى OpenRTB/Protobuf، يمكنك الوصول إلى هذا الكائن باستخدام مفتاح الإضافة [com.google.doubleclick.source] (يختلف المسار الصحيح استنادًا إلى اللغة المستخدمة لإنشاء مكتبة Proto). بالنسبة إلى OpenRTB/JSON، يمكنك الوصول إلى الحقل ext في الرسالة المصدر.

مصدر خارجي

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
omidpn لا سلسلة BidRequest.AdSlot.omidpn مُعرّف دمج OM SDK. للحصول على مزيد من المعلومات، يمكنك الاطّلاع على OpenrtB Advy for Open Measurement SDK.
omidpv لا سلسلة BidRequest.AdSlot.omidpv إصدار دمج OM SDK. للحصول على مزيد من المعلومات، يمكنك الاطّلاع على OpenrtB Advy for Open Measurement SDK.
schain لا عنصر واحد (SupplyChain) BidRequest.supply_chain كائن OpenRTB SupplyChain. ولمزيد من المعلومات، يمكنك الاطّلاع على هذه المقالة.
سلسلة التوريد

كائن OpenRTB SupplyChain. لمزيد من المعلومات، راجع هذه المقالة.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
complete لا int32 BidRequest.supply_chain.complete خيار يشير إلى ما إذا كانت السلسلة تحتوي على جميع العُقد المرتبطة بالمعاملة التي تؤدي إلى مالك الموقع الإلكتروني أو التطبيق أو أي وسيط آخر من المستودع، حيث 0 = no و1 = yes
nodes لا صفيف SupplyChainNode من العناصر BidRequest.supply_chain.nodes مصفوفة كائنات SupplyChainNode بترتيب السلسلة. في سلسلة الإمداد الكاملة، تمثل العُقدة الأولى نظام الإعلان الأولي والرقم التعريفي للبائع المشارك في المعاملة، على سبيل المثال، مالك الموقع الإلكتروني أو التطبيق أو أي وسيط آخر. في سلسلة الإمداد غير مكتملة، إنها تمثل أول عقدة معروفة. تمثل العقدة الأخيرة الكيان الذي يرسل طلب عرض السعر هذا.
ver لا سلسلة BidRequest.supply_chain.version إصدار مواصفات سلسلة التوريد قيد الاستخدام، بتنسيق "major.minor" على سبيل المثال، بالنسبة إلى الإصدار 1.0 من المواصفات، استخدِم السلسلة "1.0".
SupplyChainNode
السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
asi لا سلسلة BidRequest.supply_chain.nodes.advertising_system_identifier اسم النطاق الأساسي لنظام SSP، وExchange، والتفاف العنوان، وما إلى ذلك من أنظمة عروض الأسعار التي تتصل بها أنظمة عروض الأسعار. وقد يكون هذا هو النطاق التشغيلي للنظام، إذا كان مختلفًا عن النطاق الرئيسي للشركة، وذلك لتسهيل عمليات البحث في WHOIS وعكس عنوان IP لإثبات الملكية الواضحة لنظام المفوَّض. ويجب أن تكون هذه القيمة هي نفسها المستخدَمة لتحديد البائعين في ملف ads.txt في حال توفّره.
sid لا سلسلة BidRequest.supply_chain.nodes.seller_identifier المعرّف المرتبط بحساب البائع أو المورّد ضمن النظام الإعلاني. ويجب أن يحتوي على القيمة نفسها المستخدَمة في المعاملات (على سبيل المثال، طلبات عروض أسعار OpenRTB) في الحقل المحدّد من خلال نظام SSP/exchange. وعادة ما يكون ذلك في OpenRTB. وهذا هو publisher.id. وبالنسبة إلى OpenDirect، يمثل ذلك عادةً رقم تعريف المؤسسة للناشر. يجب ألا يزيد طوله عن 64 حرفًا.
rid لا سلسلة غير متاح معرف طلب OpenRTB للطلب الصادر عن هذا البائع.
name لا سلسلة غير متاح اسم الشركة (الكيان القانوني) التي يتمّ دفع رسومها للمستودع والتي تتمّ معاملتها بموجب معرّف البائع المحدد. هذه القيمة اختيارية ويجب عدم تضمينها إذا كانت متوفّرة في ملف sellers.json للنظام الإعلاني.
domain لا سلسلة غير متاح اسم نطاق النشاط التجاري للكيان الذي تمثله هذه العقدة. هذه القيمة اختيارية ويجب عدم تضمينها في حال توفّرها في ملف sellers.json في نظام الإعلانات.
hp لا int32 BidRequest.supply_chain.nodes.handles_payment تشير إلى ما إذا كانت هذه العقدة ستشارك في عملية الدفع للمستودع. وعند ضبط هذه القيمة على 1، يدفع نظام الإعلانات في حقل asi للبائع في حقل sid، ويكون مسؤولاً عن دفع العقدة السابقة في السلسلة. عند الضبط على القيمة 0، لا يتم تضمين هذه العقدة في عملية الدفع للمستودع. بالنسبة إلى الإصدار 1.0 من SupplyChain، يجب أن تكون هذه الخاصية دائمًا 1. ويجب تضمين هذه السمة صراحةً لأنّه من المتوقّع أن تتضمّن الإصدارات المستقبلية من المواصفات عُقدًا لمعالجة الدفعات بدون سداد الدفعات. وعلى مطوّري البرامج التأكّد من أنّهم يدعمون هذا الحقل وينشرونه بعد ذلك عند إنشاء كائنات SupplyChain في طلبات عروض الأسعار المرسَلة إلى نظام إعلانات تصاعدي.

شيطان

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

يشير توفّر الكائنات Banner أو Video أو Nativeالتابعة للعنصر Imp إلى نوع مرات الظهور المعروضة. ويمكن للناشر اختيار أحد هذه الأنواع التي تمثل الحالة المعتادة أو المزج بينها حسب تقديرها. يجب أن يتوافق أي عرض سعر محدد لمرة الظهور مع أحد الأنواع المعروضة.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادلشراةمكافئين متاح تفاصيل التنفيذ
في الإصدار من Google
id نعم سلسلة BidRequest
.Adslot.id
2.3
2.4
2.5


تمثل هذه الخاصية معرّفًا فريدًا لمرة الظهور هذه في سياق طلب عرض السعر (عادةً ما تبدأ القيمة بالرقم 1، وتزيد حتى n لعدد مرات الظهور).
banner لا عنصر واحد (Banner) BidRequest
.AdSlot
2.3
2.4
2.5


عنصر Banner، ويكون مطلوبًا في حال تقديم مرة الظهور هذه كفرصة لإعلانات البانر.
video لا عنصر واحد (Video) BidRequest
.AdSlot
BidRequest
.Video
2.3
2.4
2.5


مطلوبة إذا تم تقديم مرة الظهور هذه كفرصة لإعلانات الفيديو.
audio لا عنصر واحد (Audio) BidRequest
.AdSlot
BidRequest
.Video
2.3
2.4
2.5


مطلوبة إذا تم تقديم مرة الظهور هذه كفرصة للإعلان الصوتي.
displaymanager لا سلسلة BidRequest
.AdSlot
.renderer
2.3
2.4
2.5


اسم شريك توسط الإعلانات أو تقنية SDK أو المشغل المسؤول عن عرض الإعلان (عادةً ما يكون فيديو أو جوّال). تستخدمها بعض خوادم الإعلانات لتخصيص رمز الإعلان من قِبل الشريك. موصى به للفيديو و/أو التطبيقات.

أمثلة على السلاسل:
UNKNOWN_RENDERER
GOOGLE
PUBLISHER

displaymanagerver لا سلسلة غير متاح 2.3
2.4
2.5


إصدار شريك توسط الإعلان أو تقنية SDK أو المشغِّل المسؤول عن عرض الإعلان (عادةً عبر الفيديو أو الجوّال). تستخدمها بعض خوادم الإعلانات لتخصيص رمز الإعلان من قِبل الشريك. موصى به للفيديو و/أو التطبيقات.
instl لا قيمة منطقية BidRequest
.AdSlot
.Mobile.
is_interstitial
_request
2.3
2.4
2.5


1 = الإعلان كإعلان بيني أو بملء الشاشة، 0 = ليس إعلانًا بينيًا.
tagid لا سلسلة BidRequest
.AdSlot
.ad_block_key
2.3
2.4
2.5


معرّف موضع إعلان معيّن أو علامة إعلان معيّنة تم استخدامها لبدء المزاد. وقد يكون هذا الإجراء مفيدًا لتصحيح أي مشاكل أو لتحسين أداء المشتري.
bidfloor لا مزدوج min(BidRequest
.AdSlot.
matching
_ad_data
.minimum_cpm
_micros) * 1,000,000
2.3
2.4
2.5


الحد الأدنى لعرض سعر مرة الظهور هذه معبرًا عنه بالتكلفة لكل ألف ظهور.
bidfloorcur لا سلسلة مدعومة
تم الحصول عليها
من billing_id
2.3
2.4
2.5


تم تحديد العملة باستخدام رموز ألفا ISO-4217. وقد يختلف هذا عن عملة عرض السعر التي يعرضها نظام عروض الأسعار إذا سمح البورصة بذلك.

عملة واحدة، يتم الحصول عليها من billing_id المضمّنة.

clickbrowser لا قيمة منطقية غير متاح 2-4
2-5

للإشارة إلى نوع المتصفح الذي يتم فتحه عند النقر على تصميم الإعلان في أحد التطبيقات، حيث 0 = مضمن، و1 = مدمج مع المحتوى.

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

secure لا قيمة منطقية BidRequest
.ad_slot
.excluded_attribute
48:richMedia
CapabilityNonSSL
2.3
2.4
2.5


خيار للإشارة إلى ما إذا كانت مرة الظهور تتطلب ملفات أصل التصميم الآمن لعناوين URL تستخدم HTTPS والترميز، حيث 0 = غير آمن و1 = آمن. في حال حذفه، تكون الحالة الآمنة غير معروفة، ولكن يمكن افتراض دعم HTTP غير الآمن.
iframebuster لا مصفوفة سلسلة غير متوافق 2.3
2.4
2.5


مصفوفة من الأسماء المتبادلة لعمليات ضبط إطار iframe المعتمدة.
pmp لا عنصر واحد (Pmp) BidRequest
.AdSlot
.MatchingAdData
2.3
2.4
2.5


عنصر Pmp يحتوي على أي صفقات خاصة في السوق تُطبّق على مرّة الظهور هذه.
native لا مدمجة مع المحتوى BidRequest
.AdSlot
.NativeAdTemplate
2.3
2.4
2.5


كائن Native، مطلوب في حال عرض مرة الظهور هذه كفرصة لإعلانات مدمجة مع المحتوى.
exp لا int32 BidRequest
.AdSlot
.impression_expiration
_seconds
2-4
2-5

تنبيه بشأن عدد الثواني التي قد تمر بين المزاد ومرات الظهور الفعلية.
metric لا صفيف Metric من العناصر BidRequest
.AdSlot
.viewability
BidRequest
.AdSlot
.click_through
_rate

BidRequest
.AdSlot
.video_completion
_rate
BidRequest
.AdSlot
.session_عمق.
2.5 مصفوفة من Metric كائنات. يوفّر AdX المقاييس التالية للحقل: click_through_rate وviewability وcompletion_rate وsession_depth. مقياس viewability هو كسر من 0.00 إلى 1.00 في مقياس OpenRTB، ولكن يتم التعبير عنه في صورة نسبة مئوية [0-100] في بروتوكول AdX. ارجع إلى جدول كائن AdSlot في دليل عروض الأسعار في الوقت الفعلي للحصول على أوصاف لهذه المقاييس. ملاحظة session_depth هي قيمة عدد صحيح.
ext لا عنصر واحد (ImpExt) غير متاح 2.3
2.4
2.5


بالنسبة إلى OpenRTB/Protobuf، يمكنك الوصول إلى هذا الكائن باستخدام مفتاح الإضافة [com.google.doubleclick.imp] (يختلف المسار الصحيح استنادًا إلى اللغة المستخدمة لإنشاء مكتبة Proto). بالنسبة إلى OpenRTB/JSON، يمكنك الوصول إلى الحقل ext في رسالة Imp.

امتداد

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
billing_id نعم مصفوفة int64 BidRequest.AdSlot.MatchingAdData.billing_id أرقام تعريف الفوترة المقابلة لإعدادات الضبط المُسبَق التي تمت مطابقتها.
publisher_settings_list_id نعم صفيف لـ ثابت 64 BidRequest.publisher_settings_list_id
BidRequest.AdSlot.publisher_settings_list_id
رقم تعريف قائمة إعدادات الناشر الذي ينطبق على هذه الصفحة. للحصول على التفاصيل، يمكنك الرجوع إلى دليل إعدادات الناشر في الوقت الفعلي.
allowed_vendor_type لا مصفوفة int32 BidRequest.AdSlot.allowed_vendor_type أنواع المورّدين المسموح بها. ارجع إلى ملف vendors.txt للاطّلاع على قائمة المعرّفات.
excluded_creatives لا صفيف ExcludedCreative من العناصر BidRequest.AdSlot .excluded_creatives تصميمات الإعلانات غير المسموح بها لمرة الظهور. وسيؤدي إرسال عرض سعر باستخدام أحد تصميمات الإعلانات الواردة في هذه القائمة إلى فلترة عرض السعر هذا قبل المزاد. إذا أردت تفعيل هذه الميزة، يُرجى التواصل مع مدير حسابك.
publisher_parameter لا مصفوفة سلسلة BidRequest.AdSlot.ExchangeBid.publisher_parameter. سلاسل UTF8 التي يقدّمها الناشر اختياريًا كجزء من إعدادات مجموعة النتائج المتطابقة في واجهة مستخدم "مدير الإعلانات". يتم استخدام التنسيق بشكل عشوائي ويجب أن يوافق عليه الناشر الذي قدّم عرض السعر و"الشراة المعتمَدون".
dfp_ad_unit_code لا سلسلة BidRequest.AdSlot.dfp_ad_unit_code رمز الوحدة الإعلانية في "مدير الإعلانات". وقد تم ضبط ذلك حاليًا على طلبات "عرض الأسعار المفتوح" فقط.
is_rewarded_inventory لا قيمة منطقية BidRequest.AdSlot.is_rewarded ما إذا كان المستخدم يتلقى مكافأة مقابل مشاهدة الإعلان أم لا. بالنسبة إلى إعلانات الفيديو، تتيح عمليات التنفيذ المعتادة للمستخدمين قراءة مقالة إخبارية إضافية مجانًا، أو الاستمتاع بحياة إضافية في اللعبة، أو الحصول على جلسة موسيقية راعية بدون إعلانات. عادةً ما يتم توزيع المكافأة بعد اكتمال إعلان الفيديو.
ampad لا تعداد AmpAdRequirementType BidRequest.AdSlot.amp_ad_request_type أنواع المتطلبات المحتملة لإعلانات AMP.

UNKNOWN_AMP_AD_REQUIREMENT_TYPE = 1؛ متطلبات إعلانات AMP (الافتراضية) غير معروفة.

AMP_AD_NOT_ALLOWED = 2؛ إعلانات AMP غير مسموح بها.

AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED = 3، ويُسمح بإعلانات AMP أو الإعلانات التي ليست بتنسيق AMP، ولكن لا يتم عرض إعلانات AMP مبكرًا.

AMP_AD_ALLOWED_AND_EARLY_RENDERED = 4، حيث يُسمح بإعلانات AMP أو الإعلانات التي ليست بتنسيق AMP، ويتم عرض إعلانات AMP مسبقًا.

AMP_AD_REQUIRED = 5؛ يجب توفير إعلانات AMP. وقد يرفض الناشر الإعلانات التي ليست بتنسيق AMP.

buyer_generated_request_data لا مصفوفة من كائنات BuyerGeneratedRequestData BidRequest.AdSlot.secure_signals. إشارات آمنة مرّرها الناشر
billable_event_rate_adjustment لا مزدوج BidRequest.AdSlot.billable_event_rate_adjustment بالنسبة إلى الإعلانات التي يتم عرضها باستخدام حزمة تطوير برامج (SDK) مخصّصة فقط: يتم تطبيق المُضاعِف على عرض السعر في المزاد. يعكس التعديل احتمال أن يقدّم عرض أسعارك حدثًا قابلاً للفوترة (على سبيل المثال، يتم عرض الإعلان بنجاح) إذا فاز في المزاد، وذلك مع احتمال أن تُنشئ عروض الأسعار الأخرى حدثًا قابلاً للفوترة إذا فاز في المزاد. وقد يكون هذا التعديل أكبر أو أصغر من 1. وهذا يؤثر في الترتيب النهائي في المزاد فقط، وبالأخص أنّ هذا المُضاعِف لا يؤثر في الدفعة. الافتراضي = 1.0.
open_bidding لا OpenBidding الكائن BidRequest.AdSlot.open_bidding المَعلمات ذات الصلة بعروض الأسعار المفتوحة
allowed_restricted_category لا int32 BidRequest.AdSlot.allowed_restricted_category. فئات الإعلانات المقيَّدة المسموح بها. اطّلِع على ad-restricted-categories.txt للحصول على قائمة بالمعرّفات.
skadn لا SKAdNetworkRequest الكائن BidRequest.Mobile.skadn معلومات SKAdNetwork للناشر لدعم إحالة تثبيت التطبيق لنظام التشغيل iOS 14 والإصدارات الأحدث. تساعد SKAdNetwork API من Apple المعلِنين على قياس عمليات تثبيت التطبيقات المستندة إلى الإعلانات عن طريق إرسال الإبلاغ عن الإحالات الناجحة إلى شبكة المواقع الإعلانية بعد نجاح عملية التثبيت. سيحتاج الناشرون إلى ضبط شبكات الإعلانات المتوافقة في قائمة مواقع التطبيق (Info.plist) للسماح بإسناد التثبيت إلى مرة ظهور الإعلان. لمزيد من المعلومات، راجِع مستندات Apple.
تصميم مستبعد
buyer_creative_id لا سلسلة BidRequest.AdSlot.استبعد تصميم الإعلان.buyer_creative_id رقم تعريف تصميم إعلان المشتري لتصميم الإعلان غير المسموح به.
بيانات BuyerGeneratedRequest
data لا سلسلة BidRequest.AdSlot.SecureSignal.data الإشارة الآمنة.
source_app لا تطبيق المصدر BidRequest.AdSlot.SecureSignal.source مصدر البيانات.
تطبيق المصدر
id لا سلسلة BidRequest.AdSlot.SecureSignal.source معرّف حزمة تطوير البرامج (SDK) التي أنشأت هذه البيانات. ستتم مطابقة المعرّف في BidRequest.AppExt.InstalledSdk.id.
عرض الأسعار المفتوح
is_open_bidding لا قيمة منطقية BidRequest.AdSlot.OpenBid.is_open_bidding يتم ضبط هذا الحقل على "صحيح" إذا كان الناشر قد أعدّ مجموعة أرباح أو مجموعة توسّط تستهدف هذه الشريحة من عروض الأسعار هذه. يُرجى زيارة مركز المساعدة للحصول على معلومات عن "عرض الأسعار المفتوح" وتأثيراته في عملية تقديم عروض الأسعار.
طلب SKAdNetwork
version لا سلسلة BidRequest.Mobile.skadn.version تمّ الإيقاف. وستتم إزالتها في تشرين الثاني (نوفمبر) 2022. استخدِم BidRequest.imp.ext.skadn.versions بدلاً من ذلك.

إصدار SKAdNetwork متوافق. يعتمد ذلك على إصدار نظام التشغيل وإصدار حزمة تطوير البرامج (SDK).

versions لا مصفوفة من السلاسل BidRequest.Mobile.skadn.versions قائمة بجميع إصدارات SKAdNetwork المتوافقة مع الطلب، بناءً على إصدار نظام التشغيل وإصدار حزمة تطوير البرامج (SDK).
sourceapp لا سلسلة BidRequest.Mobile.skadn.sourceapp معرّف تطبيق الناشر في App Store التابع لشركة Apple.
skadnetids لا مصفوفة سلسلة BidRequest.Mobile.skadn.skadnetids إدخالات SKAdNetworkIdentifier في ملف Info.plist لتطبيق الناشر.
fidelities لا صفيف SKAdNetworkFidelityType من العناصر BidRequest.Mobile.skadn.supported_fidelity_types قائمة بأنواع الدقّة المتاحة، اعتمادًا على إصدار SKAdNetwork API المتوافق مع نظام التشغيل وحزمة تطوير البرامج (SDK) بالإضافة إلى خصائص الشرائح الإعلانية.

المقياس

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

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل

مشترين معتمَدين
متاح تفاصيل التنفيذ
في الإصدار من Google
type لا سلسلة أحد الخيارات التالية:
BidRequest
.AdSlot
.viewability

BidRequest
.AdSlot
.click_
through_rate

BidRequest
.AdSlot
.video_
completion_rate

BidRequest
.AdSlot
.session_عمق.
2.5 نوع المقياس الذي يتم تقديمه باستخدام أسماء سلاسل مُنظَّمة للتبادل ويجب نشرها لمقدّمي عروض الأسعار بشكل مسبق. مطلوبة بواسطة مواصفات OpenRTB. ومن الأنواع المتوافقة: click_through_rate وviewability وcompletion_rate وsession_depth.
value لا مزدوج القيمة بين 0 و1. 2.5 رقم يمثل قيمة المقياس. يجب أن تتراوح الاحتمالات بين 0.00 و1.00. مطلوبة بواسطة مواصفات OpenRTB. مقياس viewability هو كسر من 0.00 إلى 1.00 في مقياس OpenRTB، ولكن يتم التعبير عنه في صورة نسبة مئوية [0-100] في بروتوكول AdX.
vendor لا سلسلة التبادل 2.5 مصدر القيمة باستخدام أسماء سلاسل منظمّة للتبادل ويجب نشرها لمقدّمي عروض الأسعار بشكل مسبق إذا كان التبادل نفسه هو المصدر في مقابل جهة خارجية، يُنصَح باستخدام "EXCHANGE". موصى بها بواسطة مواصفات OpenRTB.

يمثل هذا الكائن النوع الأكثر عمومية من مرات الظهور. على الرغم من أن مصطلح "بانر" قد يحمل معنى محددًا في سياقات أخرى، فقد يشمل العديد من الأمور صورة ثابتة بسيطة، أو وحدة إعلانية قابلة للتوسعة، أو حتى فيديو داخل إعلان بانر (ارجع إلى الكائن Video للوحدات الإعلانية للفيديو الأكثر تعميمًا وكاملاً). يمكن أن تظهر أيضًا مصفوفة من عناصر Banner ضمن الفيديو لوصف الإعلانات المصاحبة الاختيارية التي يتم تحديدها في مواصفات VAST.

يشير وجود Banner كمتفرع لكائن Imp إلى أنه يتم تقديم مرة الظهور هذه كمرة ظهور من نوع إعلان البانر. ووفقًا لتقدير الناشر، قد يتم تقديم مرة الظهور نفسها أيضًا كفيديو و/أو إعلان مدمج مع المحتوى من خلال تضمين الكائنين Imp وVideo و/أو Native على التوالي. ومع ذلك، يجب أن يتوافق أي عرض سعر محدد لمرة الظهور مع أحد الأنواع المعروضة.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين متاح تفاصيل التنفيذ
في الإصدار من Google
w لا int32 BidRequest.AdSlot.width[0] 2.3
2.4
2.5


العرض في وحدات بكسل المستقلة (DIPS). إذا لم يتم تحديد أي كائنات Format، فهذا هو شرط العرض الدقيق. وإلا فإن العرض مفضل.
h لا int32 BidRequest.AdSlot.height[0] 2.3
2.4
2.5


الارتفاع بالبكسل المستقل للجهاز (DIPS). إذا لم يتم تحديد أي كائنات Format، فهذا هو شرط تام للارتفاع. وإلا فسيكون الارتفاع المفضل.
format لا صفيف Format من العناصر غير متاح 2-4
2-5
مصفوفة من Format من العناصر تمثل أحجام البانر المسموح بها. وفي حال عدم تحديد أي من هذه الفئات، ننصحك بشدة باستخدام السمتَين h وw.
id لا سلسلة BidRequest.AdSlot.id 2.3
2.4
2.5


معرّف فريد لكائن Banner هذا. ويُنصح باستخدامها عند استخدام كائنات Banner مع كائن Video لتمثيل مصفوفة من الإعلانات المصاحبة. تبدأ القيم عادةً من 1 وتزيد مع كل كائن؛ ويجب أن تكون فريدة في حدود مرة ظهور.
pos لا متوسط موضع الإعلان BidRequest.AdSlot.slot_visibility
BidRequest.StickySettings
2.3
2.4
2.5


يحتوي جدول OpenRTB هذا على قيم مستمدة من إرشادات ضمان الجودة (QAG) من IAB. على الممارسين إجراء مزامنة مع تعديلات قيم QAG كما تم نشرها على IAB.net. تنطبق القيم "4" - "7" على التطبيقات وفقًا لملحق الجوّال لإصدار QAG رقم 1.5.

Banner.pos تدعم قيمة واحدة فقط. إذا كانت قيمة is_sticky، Banner.pos، تكون قد تمت تعبئتها بالأرز. إذا تم استخدام unknown_stickiness، سيتم استخدام slot_visibility. وتشير القيمة الثابتة إلى أن إعلان البانر يظهر دائمًا على الشاشة، بينما يمكن أن يتغيّر مستوى رؤية الجزء المرئي من الصفحة أو الجزء السفلي غير المرئي من الصفحة أثناء تمرير المستخدم.

يمكن أن تكون إحدى القيم التالية:

ABOVE_THE_FOLD = 1;

BELOW_THE_FOLD = 3;

HEADER = 4;
ما يعادل sticky_settings.top_horizontal_stickiness في بروتوكول "عرض الأسعار في الوقت الفعلي (RTB)" في "الشراة المعتمَدون".

FOOTER = 5;
ما يعادل sticky_settings.bottom_horizontal_stickiness في بروتوكول "عرض الأسعار في الوقت الفعلي (RTB)" في "الشراة المعتمَدون".

SIDEBAR = 6;
ما يعادل sticky_settings.vertical_stickiness في بروتوكول "عرض الأسعار في الوقت الفعلي (RTB)" في "الشراة المعتمَدون".

btype لا مصفوفة تعداد الإعلانات enum غير متاح 2.5 أنواع إعلانات البانر المحظورة

أمثلة:
XHTML_TEXT_AD = 1; // "عادةً ما يكون جوّالاً".
XHTML_BANNER_AD = 2; // "Usually mobile".
JAVASCRIPT_AD = 3; // يجب أن يكون جافا سكريبت صالحًا xhtml
IFRAME = 4; // Iframe.

battr لا صفيف تعداد CreativeAttribute BidRequest.AdSlot.excluded_attribute 2.3
2.4
2.5


سمات تصميمات الإعلانات المحظورة.

أمثلة:
AUDIO_AUTO_PLAY = 1;
AUDIO_USER_INITIATED = 2;

mimes لا مصفوفة سلسلة تم التعيين فقط لـ BidRequest.Video.companionad: BidRequest.Video.companionad.creative_format
BidRequest.AdSlot.excluded_attribute / VPAID
2.3
2.4
2.5


القائمة المسموح بها لأنواع المحتوى MIME المدعومة. وتتضمن أنواع MIME الشائعة، على سبيل المثال لا الحصر، "image/jpg" و"image/gif" و"application/x-shockwave-flash".
topframe لا قيمة منطقية BidRequest.AdSlot.iframing_state

NO_IFRAME: خطأ
SAME_DOMAIN_IFRAME، CROSS_DOMAIN_IFRAME: صحيح

2.3
2.4
2.5


حدِّد ما إذا كان البانر يظهر في الإطار العلوي (صحيح) أو في إطار iframe (خطأ).
expdir لا صفيف ExpandableDirection من التعداد BidRequest.AdSlot.excluded_attribute / EXPANDING_* 2.3
2.4
2.5


الاتجاهات التي قد يتم توسيع البانر فيها
api لا صفيف APIFramework من العناصر BidRequest.AdSlot.excluded_attribute / MRAID_1_0 2.3
2.4
2.5


قائمة بإطارات عمل واجهة برمجة التطبيقات المتوافقة مع هذا الظهور. إذا لم تكن واجهة برمجة التطبيقات مدرجة بشكل صريح، فمن المفترض أنها غير متوفرة.
vcm لا قيمة منطقية عرض السعر.الفيديو.end_cap_support 2.5 هذه السمة مناسبة فقط لعناصر البانر المستخدَمة مع كائن فيديو في مجموعة من الإعلانات المصاحبة. للإشارة إلى وضع عرض إعلان بانر المصاحب مقارنةً بالفيديو المرتبط، حيث 0 = متزامن، 1 = بطاقة النهاية. نتيح حاليًا استخدام بطاقات النهاية على الإعلانات البينية لمقاطع فيديو تطبيقات mApp.
wmax لا int32 BidRequest.AdSlot.flexible_ad_slot_settings.max_width 2.3
2.4
2.5


الحد الأقصى لعرض مرات الظهور بالبكسل.
hmax لا int32 BidRequest.AdSlot.flexible_ad_slot_settings.max_height 2.3
2.4
2.5


الحد الأقصى لارتفاع الظهور بالبكسل.
wmin لا int32 BidRequest.AdSlot.flexible_ad_slot_settings.min_width 2.3
2.4
2.5


الحد الأدنى لعرض مرات الظهور بالبكسل.
hmin لا int32 BidRequest.AdSlot.flexible_ad_slot_settings.min_height 2.3
2.4
2.5


الحد الأدنى لارتفاع الظهور بالبكسل.

الشكل

يمثل هذا الكائن حجمًا مسموحًا به (تركيبة ارتفاع وعرض) لمرات ظهور إعلان البانر. وعادةً ما تُستخدم في مصفوفة لمرات الظهور التي يُسمح فيها بأحجام متعددة.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين متاح تفاصيل التنفيذ
في الإصدار من Google
w لا int32 BidRequest.AdSlot.width 2-4
2-5

العرض في وحدات بكسل المستقلة (DIPS).
h لا int32 عرض السعر.AdSlot.height 2-4
2-5

الارتفاع بالبكسل المستقل للجهاز (DIPS).
wratio لا int32 غير متاح 2.5 العرض النسبي عند التعبير عن الحجم كنسبة.
hratio لا int32 غير متاح 2.5 الارتفاع النسبي عند التعبير عن الحجم كنسبة.
wmin لا int32 غير متاح 2.5 الحد الأدنى للعرض في وحدات بكسل المستقلة للجهاز (DIPS) التي سيتم عرض الإعلان بها عند التعبير عن الحجم كنسبة.

حملة فيديو

يمثل هذا الكائن مرة ظهور إعلان ضمن بث فيديو مباشر. ولا تكون العديد من الحقول ضرورية للمعاملات البسيطة، ولكنها مضمّنة لتوفير إمكانية التحكّم الدقيق عند الحاجة. بشكل عام، يفترض الفيديو في OpenRTB الالتزام بمعيار VAST. على هذا النحو، يتم دعم مفهوم الإعلانات المصاحبة من خلال اختياريًا تضمين مجموعة من كائنات Banner التي تحدّد هذه الإعلانات المصاحبة.

ويشير ظهور السمة Video كمتفرع للعنصر Imp إلى أنّ هذا الظهور يتم عرضه كمرّة ظهور لنوع الفيديو. ووفقًا لتقدير الناشر، قد يتم تقديم مرة الظهور نفسها أيضًا كإعلان بانر و/أو إعلان مدمج مع المحتوى من خلال تضمين العناصر Imp وBanner و/أو Native على التوالي. ومع ذلك، يجب أن يتوافق أي عرض سعر محدد لمرة الظهور مع أحد الأنواع المعروضة.

ارجع إلى دليل إعلانات فيديو OpenRTB للحصول على تفاصيل إضافية.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين الإصدار متوافق مع Google تفاصيل التنفيذ
mimes نعم مصفوفة سلسلة BidRequest.Video.allowed_video_formats
BidRequest.AdSlot.excluded_attribute / VPAID
2.3
2.4
2.5


القائمة المسموح بها لأنواع المحتوى MIME المدعومة. وتشمل أنواع MIME الشائعة، على سبيل المثال لا الحصر، "image/jpg" و"image/gif" و"application/x-shockwave-flash".

مطلوبة بواسطة مواصفات OpenRTB: عنصر واحد على الأقل.

linearity لا int32 2.3
2.4
2.5


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

LINEAR = 1: خطي/إعلان ضمن البث المباشر
NON_LINEAR = 2: إعلان غير خطي/إعلان يظهر على سطح الفيديو

minduration لا int32 عرض السعر.الفيديو.min_ad_duration 2.3
2.4
2.5


الحد الأدنى لمدة إعلان الفيديو بالثواني.

موصى بها بواسطة مواصفات OpenRTB.

maxduration لا int32 عرض السعر.الفيديو.max_ad_duration 2.3
2.4
2.5


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

موصى بها بواسطة مواصفات OpenRTB.

protocols لا صفيف Protocol من العناصر BidRequest.Video.protocols 2.3
2.4
2.5


مجموعة من بروتوكولات الاستجابة لعروض أسعار الفيديو المتوافقة.

يجب تحديد بروتوكول متوافق واحد على الأقل.

أمثلة:
VAST_1_0 = 1;
VAST_2_0 = 2;
VAST_3_0 = 3;

w لا int32 BidRequest.AdSlot.width[0] 2.3
2.4
2.5
عرض مشغّل الفيديو بوحدات البكسل المستقلة في الجهاز (DIPS).

موصى بها بواسطة مواصفات OpenRTB.

h لا int32 BidRequest.AdSlot.height[0] 2.3
2.4
2.5


ارتفاع مشغّل الفيديو بوحدات البكسل المستقلة في الجهاز (DIPS).

موصى بها بواسطة مواصفات OpenRTB.

startdelay لا int32 عرض السعر.الفيديو.videoad_start_delay

>0: start delay in seconds
0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

القيم الأخرى:
videoad_start_delay / 1,000

2.3
2.4
2.5


للإشارة إلى تأخير البدء بالثواني لمواضع الإعلانات قبل التشغيل أو الإعلانات أثناء التشغيل أو ما بعد التشغيل. ارجع إلى التعداد StartDelay للحصول على قيم عامة.

موصى بها بواسطة مواصفات OpenRTB.

skip لا قيمة منطقية BidRequest.Video.video_ad_skippable 2-4
2-5

تشير هذه العلامة إلى ما إذا كان المشغّل يسمح بتخطّي الفيديو أو عندما لا تكون القيمة 0 = لا، 1 = نعم. إذا أرسل نظام عروض الأسعار ترميزًا/تصميم إعلان قابلاً للتخطي نفسه، يجب أن يتضمّن الكائن Bid مصفوفة سمة بها عنصر 16 يشير إلى فيديو قابل للتخطي.
skipmin لا int32 غير متاح 2-4
2-5

يمكن أن تكون الفيديوهات التي تبلغ مدتها الإجمالية أكثر من هذا العدد من الثواني قابلة للتخطي، ولا تنطبق إلا إذا كان الإعلان قابلاً للتخطي.
skipafter لا int32 غير متاح 2-4
2-5

عدد الثواني التي يجب خلالها تشغيل الفيديو قبل تفعيل التخطي، ولا يمكن تطبيقه إلا إذا كان الإعلان قابلاً للتخطي.
sequence لا int32 غير متاح 2.3
2.4
2.5


وفي حال تقديم مرات ظهور متعددة للإعلان في طلب عرض السعر نفسه، سيسمح رقم التسلسل بالعرض المنسَّق لتصميمات إعلانات متعددة.[default = 1]،
battr لا مصفوفة السمة
Creative (التصميم)
BidRequest.AdSlot.excluded_attribute 2.3
2.4
2.5


سمات تصميمات الإعلانات المحظورة.
maxextended لا int32 غير متاح 2.3
2.4
2.5


الحد الأقصى لمدة إعلان الفيديو الممتد، إذا كانت الإضافة مسموحًا بها. إذا كانت قيمة السمة فارغة أو 0، لن يُسمح باستخدام الإضافة. إذا تم استخدام -1، يتم السماح بالامتداد، وليس هناك حد زمني مفروض. إذا كانت القيمة أكبر من 0، ستمثل القيمة عدد الثواني من التشغيل الموسّع المسموح به بما يتجاوز قيمة maxduration.
minbitrate لا int32 غير متاح 2.3
2.4
2.5


الحد الأدنى لمعدل البت بوحدة كيلوبت في الثانية.
maxbitrate لا int32 غير متاح 2.3
2.4
2.5


الحد الأقصى لمعدل البت بوحدة كيلوبت في الثانية.
boxingallowed لا قيمة منطقية غير متاح 2.3
2.4
2.5


للإشارة إلى ما إذا كان مسموحًا باستخدام الأشرطة الأفقية لمحتوى 4:3 في نافذة بنسبة 9:16، حيث 0 = لا، 1 = نعم.
التلقائي = صحيح
playbackmethod لا مصفوفة طريقة
التشغيل
BidRequest .Video.playback_method

AdX:
VideoVideoMethod.AUTO_PLAY_SOUND_ON
VideoالتشغيلMethod.AUTO_PLAY_SOUND_OFF
VideoالتشغيلMethod.CLICK_TO_PLAY
VideoالتشغيلMethod.MOUSE_OVER
VideoالتشغيلMethod.ENTER_SOUND_ON
طريقة تشغيل الفيديو.ENTER_SOUND_OFF

2.3
2.4
2.5


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

AUTO_PLAY_SOUND_ON = 1: لبدء عملية تحميل الصفحة مع تفعيل الصوت.
AUTO_PLAY_SOUND_OFF = 2: يبدأ هذا الإعداد عند تحميل الصفحة مع إيقاف الصوت تلقائيًا.
CLICK_TO_PLAY = 3: يبدأ النقر مع تفعيل الصوت.
MOUSE_OVER = 4: لتفعيل ميزة تمرير الماوس مع تفعيل الصوت.
ENTER_SOUND_ON = 5: يبدأ هذا الإعداد عند الدخول إلى إطار العرض مع تفعيل الصوت.
ENTER_SOUND_OFF = 6: يبدأ هذا الإعداد عند الدخول إلى إطار العرض مع إيقاف صوته تلقائيًا.

delivery لا صفيف
ContentDelivery
Method
غير متاح 2.3
2.4
2.5


طرق التسليم المعتمدة (مثل البث والتقدم) إذا لم يتم تحديد أي من هذه القيم، افترض أنّ كل العناصر متوافقة.
البث = 1،
التقدّم = 2،
pos لا AdPosition BidRequest.AdSlot.slot_visibility 2.3
2.4
2.5


موضع الإعلان على الشاشة.
companionad لا صفيف Banner من العناصر BidRequest.Video.companion_slot 2.3
2.4
2.5


مصفوفة من كائنات Banner في حال توفّر إعلانات مصاحبة.
api لا صفيف APIFramework من العناصر BidRequest.AdSlot.excluded_attribute
/ MRAID_1_0
2.3
2.4
2.5


قائمة بإطارات عمل واجهة برمجة التطبيقات المتوافقة مع هذا الظهور. إذا لم يتم إدراج واجهة برمجة التطبيقات بشكل صريح، يُفترض أنّها غير متوافقة.
companiontype لا صفيف CompanionType من العناصر BidRequest.Video.companion_slot.creative_format 2.3
2.4
2.5


أنواع الإعلانات المصاحبة المتوافقة مع VAST. ويُنصح باستخدامها في حال تضمين كائنات Banner مصاحبة من خلال مصفوفة companionad.
placement لا VideoPlacementType عرض السعر.الفيديوموضع الإعلان

INSTREAM -> IN_STREAM_PLACEMENT
INTERSTITIAL -> FLOATING_PLACEMENT
IN_FEED -> IN_FEED_PLACEMENT IN_ARTICLE -> IN_ARTICLE_PLACEMENT
UNKNOWN_PLACEMENT -> UNDEFINED_VIDEO_PLACEMENT
AUDIO -> UNDEFINED_VIDEO_PLACEMENT
(غير محدّدة) -> IN_BANNER_PLACEMENT

2.5

نوع موضع الإعلان لمرة الظهور.

UNDEFINED_VIDEO_PLACEMENT: لم يتم تحديد موضع الفيديو. القيمة التلقائية.
IN_STREAM_PLACEMENT: تمّ تشغيلها قبل محتوى الفيديو الذي طلبه المستهلك أو أثناءه أو بعده. على سبيل المثال، إعلان ما قبل التشغيل، إعلان أثناء التشغيل، إعلان ما بعد التشغيل.
IN_BANNER_PLACEMENT: تقع في إعلان بانر على الويب يستغل مساحة إعلان البانر لتقديم تجربة فيديو بدلاً من تنسيق آخر ثابت أو للوسائط المتعددة التفاعلية. ويعتمد هذا الشكل على توفّر مستودع الإعلانات الصورية على الصفحة لعرضه.
IN_ARTICLE_PLACEMENT: يتم تحميله وتشغيله ديناميكيًا بين فقرات المحتوى التحريري، ويمكن استخدامه كرسالة مستقلة تحمل علامة تجارية.
IN_FEED_PLACEMENT: ضمن الخلاصة - يمكن العثور عليه في خلاصات المحتوى أو وسائل التواصل الاجتماعي أو المنتجات.
FLOATING_PLACEMENT: إعلان بيني/شريط تمرير/عائم. تغطي مساحة الشاشة بأكملها أو جزء منها، ولكنها تظهر دائمًا على الشاشة أثناء عرضها (على سبيل المثال، لا يمكن التمرير خارج منطقة العرض). تجدر الإشارة إلى أنه يمكن تمييز إعلان بيني بملء الشاشة (على سبيل المثال في الجوّال) عن وحدة عائمة/شريط تمرير من خلال حقل imp.instl.

playbackend لا PlaybackCessationMode غير متاح 2.5 الحدث الذي يؤدي إلى إنهاء التشغيل.

الصوت

يمثل هذا الكائن مرة ظهور لنوع الصوت. ولا تكون العديد من الحقول ضرورية للمعاملات البسيطة، ولكنها مضمّنة لتوفير إمكانية التحكّم الدقيق عند الحاجة. بشكل عام، يفترض الصوت في OpenRTB الامتثال لمعيار DAAST. على هذا النحو، يتم دعم مفهوم الإعلانات المصاحبة من خلال اختياريًا تضمين مصفوفة من عناصر Banner تحدّد هذه الإعلانات المصاحبة. يشير وجود الكائن Audio كمكون ثانوي للعنصر Imp إلى أن مرة الظهور هذه يتم تقديمها كمرّة ظهور من نوع الصوت. ووفقًا لتقدير الناشر، قد يتم تقديم مرة الظهور نفسها أيضًا كإعلان بانر و/أو فيديو و/أو إعلان مضمَّن من خلال تضمين عناصر Imp من هذه الأنواع أيضًا. ومع ذلك، يجب أن يتوافق أي عرض سعر مع مرات الظهور مع أحد الأنواع المعروضة.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين متاح تفاصيل التنفيذ
في الإصدار من Google
mimes لا مصفوفة سلسلة BidRequest.Video.allowed_video_formats و BidRequest.AdSlot.excluded_attribute / VPAID 2-4
2-5

أنواع المحتوى MIME المدعومة (على سبيل المثال، "صوت/mp4")

مطلوبة بواسطة مواصفات OpenRTB: عنصر واحد على الأقل.

minduration لا int32 عرض السعر.الفيديو.min_ad_duration 2-4
2-5

الحد الأدنى لمدة إعلان الفيديو بالثواني.

موصى بها بواسطة مواصفات OpenRTB.

maxduration لا int32 عرض السعر.الفيديو.max_ad_duration 2-4
2-5

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

موصى بها بواسطة مواصفات OpenRTB.

protocols لا صفيف Protocol من العناصر BidRequest.Video.protocols 2-4
2-5

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

أمثلة:
DAAST_1_0 = 9;
DAAST_1_0_WRAPPER = 10;

startdelay لا int32 عرض السعر.الفيديو.videoad_start_delay

>0: start delay in seconds
0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

القيم الأخرى:
videoad_start_delay / 1,000

2-4
2-5

للإشارة إلى تأخير البدء بالثواني لمواضع الإعلانات قبل التشغيل أو الإعلانات أثناء التشغيل أو ما بعد التشغيل. ارجع إلى التعداد StartDelay للحصول على قيم عامة.

موصى بها بواسطة مواصفات OpenRTB.

sequence لا int32 غير متاح 2-4
2-5
وفي حال تقديم مرات ظهور متعددة للإعلان في طلب عرض السعر نفسه، سيسمح رقم التسلسل بالعرض المنسَّق لتصميمات إعلانات متعددة.[default = 1]،
battr لا صفيف CreativeAttribute من العناصر BidRequest.AdSlot.excluded_attribute 2-4
2-5

سمات تصميمات الإعلانات المحظورة.
maxextended لا int32 غير متاح 2-4
2-5

الحد الأقصى لمدة إعلان الفيديو الممتد، إذا كانت الإضافة مسموحًا بها. إذا كانت قيمة السمة فارغة أو 0، لن يُسمح باستخدام الإضافة. إذا تم استخدام -1، يتم السماح بالامتداد، وليس هناك حد للوقت مفروض. إذا كانت القيمة أكبر من 0، ستمثل القيمة عدد الثواني من التشغيل الموسّع المسموح به خارج قيمة maxduration.
minbitrate لا int32 غير متاح 2-4
2-5

الحد الأدنى لمعدل البت بوحدة كيلوبت في الثانية.
maxbitrate لا int32 غير متاح 2-4
2-5

الحد الأقصى لمعدل البت بوحدة كيلوبت في الثانية.
delivery لا صفيف ContentDeliveryMethod من العناصر غير متاح 2-4
2-5

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

البث = 1،
التقدّم = 2،

companionad لا صفيف Banner من العناصر BidRequest.Video.companion_slot 2-4
2-5

مصفوفة من كائنات Banner في حال توفّر إعلانات مصاحبة.
api لا صفيف APIFramework من العناصر BidRequest.AdSlot.excluded_attribute / MRAID_1_0 2-4
2-5

قائمة بإطارات عمل واجهة برمجة التطبيقات المتوافقة مع هذا الظهور. إذا لم يتم إدراج واجهة برمجة التطبيقات بشكل صريح، يُفترض أنّها غير متوافقة.
companiontype لا صفيف CompanionType من العناصر BidRequest .Video.companion_slot.creative_format 2-4
2-5

أنواع الإعلانات المصاحبة المتوافقة مع DAAST.
maxseq لا int32 غير متاح 2-4
2-5

الحد الأقصى لعدد الإعلانات التي يمكن تشغيلها في لوحة إعلانية.
feed لا نوع الخلاصة غير متاح 2-4
2-5

نوع الخلاصة الصوتية.
stitched لا قيمة منطقية غير متاح 2-4
2-5

تشير إلى ما إذا كان قد تم تركيب الإعلان مع محتوى صوتي أو تم عرضه بشكل مستقل، حيث 0 = لا، 1 = نعم.
nvol لا VolumeNormalizationMode غير متاح 2-4
2-5

وضع تسوية مستوى الصوت.

مدمجة مع المحتوى

يمثل هذا الكائن مرة ظهور من النوع الأصلي. وتهدف الوحدات الإعلانية المدمجة مع المحتوى إلى الاندماج بسلاسة في المحتوى المحيط بها (على سبيل المثال، مشاركة إعلانية على Twitter أو Facebook). وبناءً على ذلك، يجب أن تكون الاستجابة منظمة بشكل جيد لمنح الناشر تحكمًا بالغ الدقة في العرض.

لاحظ أن Native 1.1 يتوفر في OpenRTB 2.4 وOpenRTB 2.5.

وضعت اللجنة الفرعية للإعلانات المدمجة مع المحتوى مواصفات مصاحبة لـ OpenRTB، تسمى مواصفات الإعلان المدمج مع المحتوى. ويحدّد معلمات الطلب وبنية ترميز الوحدات الإعلانية للإعلانات المدمجة مع المحتوى.

يوفر هذا الكائن وسائل نقل معلمات الطلبات كسلسلة مصمتة بحيث يمكن أن تتطور المعلمات المحددة بشكل منفصل تحت علامات مواصفات الإعلانات المدمجة مع المحتوى. وبالمثل، سيتم تنظيم ترميز الإعلانات المعروضة وفقًا لهذه المواصفات. يشير وجود علامة Native كمتفرع للعنصر Imp إلى أن هذا الظهور يتم عرضه كمرّة ظهور من النوع الأصلي. ووفقًا لتقدير الناشر، قد يتم عرض مرة الظهور نفسها أيضًا كإعلان بانر و/أو فيديو من خلال تضمين العناصر Imp أيضًا كعنصر ثانوي Banner و/أو Video على التوالي. ومع ذلك، يجب أن يتوافق أي عرض سعر مع مرات الظهور مع أحد الأنواع المعروضة.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين متاح تفاصيل التنفيذ
في الإصدار من Google
request لا سلسلة BidRequest.AdSlot.NativeAdنموذج 2.3
2.4
2.5


اطلب حمولة تتوافق مع مواصفات الإعلانات المدمجة مع المحتوى.

يجب استخدام سمة واحدة من {request, request_native}.

request_native لا NativeRequest BidRequest.AdSlot.NativeAdنموذج 2.3
2.4
2.5


اطلب حمولة تتوافق مع مواصفات الإعلانات المدمجة مع المحتوى. يجب استخدام أحد {request, native_native} بالضبط، وهو حقل بديل مفضّل لتسلسل Protobuf.
ver لا سلسلة موصى بها بواسطة مواصفات OpenRTB. 2.3
2.4
2.5


إصدار مواصفات الإعلانات المدمجة مع المحتوى التي يتوافق معها الطلب. موصى بها بواسطة مواصفات OpenRTB.
api صفيف APIFramework من العناصر BidRequest.AdSlot.excluded_attribute / MRAID_1_0 2.3
2.4
2.5


قائمة بإطارات عمل واجهة برمجة التطبيقات المتوافقة مع هذا الظهور. إذا لم يتم إدراج واجهة برمجة التطبيقات بشكل صريح، يُفترض أنّها غير متوافقة.
battr صفيف CreativeAttribute من العناصر BidRequest.AdSlot.excluded_attribute 2.3
2.4
2.5


سمات تصميمات الإعلانات المحظورة.

Pmp

هذا العنصر هو حاوية السوق الخاصة للصفقات المباشرة بين المشترين والبائعين التي قد تتعلّق بمرة الظهور هذه. يتم تمثيل الصفقات الفعلية كمجموعة من عناصر Deal.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين متاح تفاصيل التنفيذ
في الإصدار من Google
private_auction لا قيمة منطقية BidRequest.AdSlot.only_deal_bids_accepted 2.3
2.4
2.5


مؤشر أهلية المزاد للمقاعد التي تحمل اسم كائن "الصفقات المباشرة"، حيث 0 = يتم قبول جميع عروض الأسعار، 1 = تقتصر عروض الأسعار على الصفقات المحددة وبنودها.
deals لا صفيف Deal من العناصر BidRequest.AdSlot .MatchingAdData.DirectDeal 2.3
2.4
2.5


مصفوفة من عناصر Deal تنقل الصفقات المحدّدة التي تنطبق على مرة الظهور هذه.

صفقة

يمثل هذا العنصر صفقة محددة تم إبرامها مسبقًا بين المشتري والبائع. ويشير وجودها في مجموعة Pmp إلى أن هذا الظهور متاح بموجب بنود الصفقة.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين متاح تفاصيل التنفيذ
في الإصدار من Google
id نعم سلسلة BidRequest.AdSlot .MatchingAdData.DirectDeal.direct_deal_id 2.3
2.4
2.5


معرّف فريد للعرض المباشر. مطلوبة بواسطة مواصفات OpenRTB.
bidfloor لا مزدوج BidRequest.AdSlot.MatchingAdData.DirectDeal.fixed_cpm _micros *1,000,000 2.3
2.4
2.5


الحد الأدنى لعرض سعر مرة الظهور هذه معبرًا عنه بالتكلفة لكل ألف ظهور.
bidfloorcur لا سلسلة عملة واحدة، تم الحصول عليها من billing_id المضمّنة 2.3
2.4
2.5


تم تحديد العملة باستخدام رموز ألفا ISO-4217. وقد تختلف هذه العملة عن عملة عرض السعر التي يعرضها نظام عروض الأسعار إذا كان مسموحًا بذلك في exchange.default = "USD"
wseat لا مصفوفة سلسلة غير متاح 2.3
2.4
2.5


القائمة المسموح بها لمقاعد المشترين (مثل المُعلِنين والوكالات) التي يُسمح لها بتقديم عروض أسعار لهذه الصفقة أرقام تعريف المقاعد ومعرفة معلومات عن المشتري

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

wadomain لا مصفوفة سلسلة غير متاح 2.3
2.4
2.5


صفيف نطاقات المُعلِن (على سبيل المثال، advertiser.com) المسموح له بتقديم عروض أسعار على هذه الصفقة. لا يتضمن الحذف أي قيود مفروضة على المعلنين.
at لا نوع المزاد BidRequest.auction_type 2.3
2.4
2.5


إلغاء اختياري لنوع المزاد العام لطلب عرض السعر، حيث 1 = السعر الأول، 2 = السعر الثاني زائد، 3 = القيمة التي يتم تمريرها في الحد الأدنى لعرض السعر هي سعر الصفقة المتفق عليها. يمكن تحديد أنواع مزادات إضافية من خلال التبادل.
ext لا عنصر واحد (DealExt) غير متاح 2.3
2.4
2.5


بالنسبة إلى OpenRTB/Protobuf، يمكنك الوصول إلى هذا الكائن باستخدام مفتاح الإضافة [com.google.doubleclick.deal] (يختلف المسار الصحيح استنادًا إلى اللغة المستخدمة لإنشاء مكتبة Proto). بالنسبة إلى OpenRTB/JSON، يمكنك الوصول إلى الحقل ext في رسالة "الصفقة".

إكستإكست

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
deal_type لا نوع صفقة Enum BidRequest.AdSlot.MatchingAdData.DirectDeal.deal_type نوع الصفقة. وتجدر الإشارة إلى أنّ إلغاء سياسة "الشراة المعتمَدون" ينطبق على جميع عروض أسعار الصفقات الآلية المضمونة والصفقات المفضَّلة، ولا ينطبق على عروض الأسعار لأنواع الصفقات الأخرى.

UNKNOWN_DEAL_TYPE = 0؛ افتراضي.

PREFERRED_DEAL = 1؛ وتكون عروض الأسعار ثابتة السعر ويتم تقييمها قبل المزاد المفتوح. لا يُطلب من أنظمة عروض الأسعار تقديم عروض أسعار باستخدام "الصفقات المفضَّلة" عند توفرها في طلب عروض الأسعار. ولمزيد من المعلومات، يمكنك الاطّلاع على هذه المقالة.

PRIVATE_AUCTION = 2؛ تشارك عروض الأسعار في مزاد خاص ضد قائمة محددة من المشترين بطوابق محددة. ولمزيد من المعلومات، يمكنك الاطّلاع على هذه المقالة.

PROGRAMMATIC_GUARANTEED = 3؛ وتكون عروض الأسعار ثابتة السعر ويتم تقييمها قبل المزاد المفتوح. من المتوقّع أن يقدّم مقدّمو عروض الأسعار عروض أسعار باستخدام "الصفقات الآلية المضمونة" عندما تكون هذه العروض حاضرة في طلب عرض السعر وأن يكون حقل "يجب عرض السعر" صحيحًا لضمان عرض عدد مرات الظهور المتفق عليها لصفقة معيّنة. ولمزيد من المعلومات، يمكنك الاطّلاع على هذه المقالة.

AUCTION_PACKAGE = 4، معرّف الصفقة هو معرّف لمجموعة من مستودعات المزاد المفتوح التي تطابق مجموعة معيّنة من معايير الاستهداف. ولمزيد من المعلومات، يمكنك الاطّلاع على هذه المقالة.

must_bid لا قيمة منطقية BidRequest.AdSlot.MatchingAdData.DirectDeal.must_bid لا ينطبق هذا الحقل إلا على الصفقات الآلية المضمونة. ويُسمح للمشتري بتخطي عروض الأسعار لمرة الظهور إذا كان هذا الحقل غير صحيح. عندما يكون صحيحًا، يُطلب من المشتري تقديم عرض سعر على هذه الصفقة للحصول على فرصة الظهور هذه. سيتم دائمًا ملء هذا الحقل بشكل صريح لتنسيق سلك JSON. الافتراضي = صحيح.
publisher_blocks_overridden لا قيمة منطقية BidRequest.AdSlot.MatchingAdData.DirectDeal.publisher_blocks_overridden ما إذا كان الناشر قد إعفاء هذه الصفقة من عمليات الحظر التي تم ضبطها. ولا يلغي هذا الإعداد سياسات "الشراة المعتمَدون" أو قرارات "مركز مراجعة الإعلانات". ولمزيد من المعلومات، يمكنك الاطّلاع على هذه المقالة.
creative_source لا Enum CreativeSourceType BidRequest.AdSlot.MatchingAdData.DirectDeal.creative_source. حقل تجريبي، عرضة للتغيير. تعداد يُعلن عن مضيف تصميم الإعلان، والذي ستتم تعبئته فقط للصفقات الآلية المضمونة. في الوقت الحالي، يجب تعيين هذا الحقل فقط على CREATIVE_SOURCE_ADVERTISER.

CREATIVE_SOURCE_UNKNOWN = 0،

CREATIVE_SOURCE_ADVERTISER = 1; (افتراضي) تتم استضافة تصميم الإعلان من قِبل المعلن، مما يعني أن مقدم عروض الأسعار مطالب بتقديم تصميم إعلان في استجابة عرض الأسعار.

CREATIVE_SOURCE_PUBLISHER = 2، تتم استضافة تصميم الإعلان من قِبل الناشر، وهذا يعني أن مقدم عروض الأسعار لا يحتاج إلى تضمين تصميم إعلان في استجابة عرض الأسعار. لمزيد من المعلومات عن تصميمات الإعلانات التي يستضيفها الناشر، اطّلِع على https://support.google.com/admanager/answer/9243220. هذه الميزة غير متاحة حاليًا لعروض أسعار عروض الأسعار في الوقت الفعلي (RTB).

الموقع

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

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين متاح تفاصيل التنفيذ
في الإصدار من Google
id لا سلسلة غير متاح 2.3
2.4
2.5


معرّف الموقع في البورصة. موصى بها بواسطة مواصفات OpenRTB.
name لا سلسلة غير متاح 2.3
2.4
2.5


اسم الموقع (يمكن حجبه بناءً على طلب الناشر)
domain لا سلسلة غير متاح 2.3
2.4
2.5


نطاق الموقع، المستخدم للمنع من جانب المعلن. على سبيل المثال، "foo.com".
cat لا مصفوفة سلسلة غير متاح 2.3
2.4
2.5


مصفوفة من فئات محتوى مكتب الإعلانات التفاعلية (IAB) على الموقع الإلكتروني. الرجوع إلى التعداد ContentCategory.
sectioncat لا مصفوفة سلسلة غير متاح 2.3
2.4
2.5


مصفوفة من فئات محتوى مكتب الإعلانات التفاعلية (IAB) التي تصف القسم الحالي من الموقع الإلكتروني. الرجوع إلى التعداد ContentCategory.
pagecat لا مصفوفة سلسلة غير متاح 2.3
2.4
2.5


مصفوفة من فئات محتوى مكتب الإعلانات التفاعلية (IAB) التي تصف الصفحة أو الملف الشخصي الحالي للموقع الإلكتروني. الرجوع إلى التعداد ContentCategory.
page لا سلسلة عرض السعر.url 2.3
2.4
2.5


عنوان URL للصفحة التي سيتم عرض الظهور فيها
privacypolicy لا قيمة منطقية غير متاح 2.3
2.4
2.5


يشير إلى ما إذا كان الموقع يحتوي على سياسة خصوصية أم لا، حيث 0 = لا، 1 = نعم.
ref لا سلسلة غير متاح 2.3
2.4
2.5


عنوان URL المُحيل الذي تسبب في الانتقال إلى الصفحة الحالية.
search لا سلسلة غير متاح 2.3
2.4
2.5


سلسلة البحث التي تسببت في الانتقال إلى الصفحة الحالية.
publisher لا عنصر واحد (Publisher) طلب عرض السعر 2.3
2.4
2.5


تفاصيل حول الكائن Publisher للموقع الإلكتروني.
content لا عنصر واحد (Content) طلب عرض السعر 2.3
2.4
2.5


تفاصيل حول Content في الموقع الإلكتروني.
keywords لا سلسلة غير متاح 2.3
2.4
2.5


قائمة كلمات رئيسية مفصولة بفواصل حول هذا الموقع. ملاحظة: سمح OpenRTB 2.2 بمجموعة من السلاسل كتنفيذ بديل ولكن تم إصلاح ذلك في الإصدار 2.3 والإصدارات الأحدث، حيث يكون بالتأكيد سلسلة واحدة تتضمن محتوى CSV مرة أخرى. وقد يتطلّب التوافق مع بعض تبادلات OpenRTB 2.2 التي تعتمد التمثيل البديل معالجة JSON بشكل مخصّص.
mobile لا قيمة منطقية BidRequest.Mobile.is_mobile _web_enhanced 2.3
2.4
2.5


تشير إلى ما إذا كان الموقع الإلكتروني قد تمت برمجته لتحسين التنسيق عند عرضه على الأجهزة الجوّالة، حيث إنّ 0 = لا، 1 = نعم.
ext لا عنصر واحد (SiteExt) غير متاح 2.3
2.4
2.5


بالنسبة إلى OpenRTB/Protobuf، يمكنك الوصول إلى هذا الكائن باستخدام مفتاح الإضافة [com.google.doubleclick.site] (يختلف المسار الصحيح استنادًا إلى اللغة المستخدمة لإنشاء مكتبة Proto). بالنسبة إلى OpenRTB/JSON، يمكنك الوصول إلى الحقل ext في رسالة الموقع الإلكتروني.

SiteExt

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
amp لا عدد صفحات AMP BidRequest.AdSlot
.is_amp_page

سواء كانت هذه الصفحة بتنسيق AMP أم لا. يتم حذفها إذا لم تكن معروفة.

DIALECT_HTML = 0؛ هذه ليست صفحة AMP.

DIALECT_HTML_AMP = 1؛ هذه صفحة AMP.

page_visibility لا حالة الرؤية Enum عرض السعر.page_visibility

حالة رؤية صفحة الويب التي تحتوي على الشريحة الإعلانية. راجِع www.w3.org/TR/page-visibility/.

VISIBILITY_STATE_UNKNOWN = 0

VISIBILITY_STATE_VISIBLE = 1؛ الصفحة مرئية جزئيًا على الأقل. على سبيل المثال، في علامة تبويب المقدمة في نافذة غير مصغّرة.

VISIBILITY_STATE_HIDDEN = 2، الصفحة غير مرئية على الإطلاق للمستخدمين. على سبيل المثال، عندما تكون الصفحة في علامة تبويب في الخلفية في المتصفح أو في نافذة مصغّرة.

is_semi_transparent_request لا قيمة منطقية BidRequest.is_semi_transparent_request تشير هذه القيمة إلى أنّ الطلب يستخدم علامة تجارية شبه شفافة، ما يعني أنه سيتم توفير نسخة مقتطعة من عنوان URL للطلب فقط. يتخذ الناشر هذا القرار، ويُرجى الاطّلاع على support.google.com/admanager/answer/4584891.

تطبيق

يجب تضمين هذا الكائن إذا كان المحتوى الذي يتيح عرض الإعلانات ليس تطبيقًا متوافقًا مع المتصفح (عادةً على الجوّال) وليس لموقع ويب. يجب ألا يحتوي طلب عرض السعر على كل من الكائن App والعنصر Site. على أقل تقدير، من المفيد تقديم معرّف تطبيق أو حِزمة، ولكن هذا الإجراء ليس إلزاميًا.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين متاح تفاصيل التنفيذ
في الإصدار من Google
id لا سلسلة غير متاح 2.3
2.4
2.5


معرّف التطبيق في البورصة. موصى بها بواسطة مواصفات OpenRTB.
name لا سلسلة عرض السعر.الجوّال.app_name 2.3
2.4
2.5


اسم التطبيق (قد يتم تعيين اسم مستعار له بناءً على طلب الناشر)
domain لا سلسلة غير متاح 2.3
2.4
2.5
نطاق التطبيق المُستخدَم للمنع من جانب المُعلِن. على سبيل المثال، "mygame.foo.com".
cat لا مصفوفة سلسلة عرض السعر.الجوّال.app_category_ids 2.3
2.4
2.5


ملاحظة: يتم الآن تنقيح قيم هذا الحقل. مصفوفة من فئات المحتوى من مكتب الإعلانات التفاعلية (IAB) للتطبيق. ارجع إلى التعداد ContentCategory.
sectioncat لا مصفوفة سلسلة غير متاح 2.3
2.4
2.5
مصفوفة من فئات محتوى مكتب الإعلانات التفاعلية (IAB) التي تصف القسم الحالي من التطبيق. يمكنك الرجوع إلى التعداد ContentCategory.
pagecat لا مصفوفة سلسلة غير متاح 2.3
2.4
2.5
مصفوفة من فئات محتوى مكتب الإعلانات التفاعلية (IAB) التي تصف الصفحة أو الملف الشخصي الحالي للتطبيق. راجع التعداد ContentCategory.
ver لا سلسلة غير متاح 2.3
2.4
2.5
إصدار التطبيق.
bundle لا سلسلة عرض السعر.الجوّال.app_id 2.3
2.4
2.5


هو معرّف تطبيق خاص بالنظام الأساسي يهدف إلى أن يكون فريدًا للتطبيق ومستقلًا عن التبادل. في نظام التشغيل Android، يجب أن يكون هذا اسم الحزمة أو الحزمة (على سبيل المثال، com.foo.mygame). وعلى نظام التشغيل iOS، يكون المعرّف عبارة عن معرّف رقمي.
privacypolicy لا قيمة منطقية غير متاح 2.3
2.4
2.5
يشير إلى ما إذا كان الموقع يحتوي على سياسة خصوصية أم لا، حيث 0 = لا، 1 = نعم.
paid لا قيمة منطقية غير متاح 2.3
2.4
2.5
0 = التطبيق مجاني، 1 = التطبيق إصدار مدفوع.
publisher لا عنصر واحد (Publisher) طلب عرض السعر 2.3
2.4
2.5


تفاصيل حول الكائن Publisher للتطبيق.
content لا عنصر واحد (Content) طلب عرض السعر 2.3
2.4
2.5


تفاصيل حول Content داخل التطبيق.
keywords لا سلسلة غير متاح 2.3
2.4
2.5


قائمة كلمات رئيسية مفصولة بفواصل حول هذا التطبيق. ملاحظة: كان OpenRTB 2.2 يسمح بمجموعة من السلاسل كتنفيذ بديل، ولكن تم إصلاح ذلك في الإصدار 2.3 والإصدارات الأحدث، بالتأكيد حيث تكون سلسلة واحدة تتضمن محتوى CSV مرة أخرى. وقد يتطلّب التوافق مع بعض تبادلات OpenRTB 2.2 التي تعتمد التمثيل البديل معالجة JSON بشكل مخصّص.
storeurl لا سلسلة عرض السعر.url 2.3
2.4
2.5


عنوان URL لمتجر التطبيقات لتطبيق مثبّت.
ext لا عنصر واحد (AppExt) غير متاح 2.3
2.4
2.5


بالنسبة إلى OpenRTB/Protobuf، يمكنك الوصول إلى هذا الكائن باستخدام مفتاح الإضافة [com.google.doubleclick.app] (يختلف المسار الصحيح استنادًا إلى اللغة المستخدمة لإنشاء مكتبة Proto). بالنسبة إلى OpenRTB/JSON، يمكنك الوصول إلى الحقل ext في رسالة التطبيق.

إضافات التطبيقات

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
installed_sdk لا مثبت Sdk BidRequest.Mobile.installed_sdk تعريف حِزمة SDK مثبَّتة في تطبيق الناشر والمعلومات التي يستطيع مقدِّم عرض الأسعار الوصول إليها، وغالبًا ما تكون هذه الحزمة هي حزمة SDK الخاصة بمقدّم عرض السعر
مثبت Sdk
id نعم سلسلة BidRequest.Mobile.InstalledSdk.id معرّف حزمة تطوير البرامج (SDK) المثبّتة.
sdk_version نعم الإصدار BidRequest.Mobile.InstalledSdk.sdk_version إصدار حزمة تطوير البرامج (SDK) المثبَّتة.
adapter_version نعم الإصدار BidRequest.Mobile.InstalledSdk.adapter_version. إصدار المحوّل الذي يتصل بحزمة تطوير البرامج (SDK) المثبّتة.
الإصدار
major لا int32 غير متاح الافتراضي = -1.
minor لا int32 غير متاح الافتراضي = -1.
micro لا int32 غير متاح الافتراضي = -1.

الناشر

يصف هذا الكائن ناشر الوسائط الذي سيتم عرض الإعلان فيه. وعادةً ما يكون الناشر هو البائع في معاملة OpenRTB.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين متاح تفاصيل التنفيذ
في الإصدار من Google
id لا سلسلة عرض السعر.publisher_id 2.3
2.4
2.5


الرقم التعريفي للناشر الخاص بـ Exchange كما هو محدّد في لاحقة رمز الناشر لرمز الموقع الإلكتروني. على سبيل المثال، pub-123 هو رمز الناشر الخاص برمز الموقع الإلكتروني ca-pub-123.
name لا سلسلة غير متاح 2.3
2.4
2.5
اسم الناشر (يمكن أن يصبح اسمًا مستعارًا بناءً على طلب الناشر)
cat لا مصفوفة سلسلة غير متاح 2.3
2.4
2.5
مصفوفة من فئات محتوى مكتب الإعلانات التفاعلية (IAB) للتطبيق. ارجع إلى التعداد ContentCategory.
domain لا سلسلة غير متاح 2.3
2.4
2.5
نطاق المستوى الأعلى للناشر (على سبيل المثال، "publisher.com")
ext لا عنصر واحد (PublisherExt) غير متاح 2.3
2.4
2.5


بالنسبة إلى OpenRTB/Protobuf، يمكنك الوصول إلى هذا الكائن باستخدام مفتاح الإضافة [com.google.doubleclick.publisher] (يختلف المسار الصحيح استنادًا إلى اللغة المستخدمة لإنشاء مكتبة Proto). بالنسبة إلى OpenRTB/JSON، يمكنك الوصول إلى الحقل ext في رسالة الناشر.

الرقم التعريفي للناشر

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
country لا سلسلة عرض السعر
.publisher_country
بلد عنوان إرسال الفواتير الخاص بالناشر. وقد يختلف هذا عن البلد الذي تم اكتشاف المستخدم فيه في geo_criteria_id أو بلد استضافة الموقع الإلكتروني. راجع أيضًا القائمة الكاملة لرموز البلدان.
host_publisher_id لا سلسلة عرض السعر.host_publisher_id الرقم التعريفي للناشر المضيف. عند التعبئة، يشير ذلك إلى أن الناشر المضيف شارك في مشاركة الأرباح، ويمكن استخدام المعرّف لتفويض ads.txt.

المحتوى

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

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين متاح تفاصيل التنفيذ
في الإصدار من Google
id لا سلسلة غير متاح 2.3
2.4
2.5
المعرّف الذي يعرّف المحتوى بشكل فريد
episode لا int32 غير متاح 2.3
2.4
2.5
رقم حلقة المحتوى (ينطبق عادة على محتوى الفيديو).
title لا سلسلة غير متاح 2.3
2.4
2.5


عنوان المحتوى. أمثلة على الفيديوهات: "لجنة البحث" (تلفزيون) أو "أمل جديد" (فيلم) أو "لعبة نهائية" (مخصّصة للويب). مثال من خارج الفيديو: "لماذا يتذبذب نهر جليدي في القطب الجنوبي بسرعة كبيرة" (مقالة من مجلة التايم).
series لا سلسلة غير متاح 2.3
2.4
2.5
سلسلة المحتوى. أمثلة على الفيديو: "The Office" (تلفزيون)، أو "Star Wars" (فيلم) أو "Arby 'N' The The" (مصمّم للويب).

مثال لغير مقاطع الفيديو: "Ecocenter" (مدونة مجلة التايم)

season لا سلسلة غير متاح 2.3
2.4
2.5
موسم المحتوى؛ عادةً لمحتوى الفيديو (على سبيل المثال، "الموسم 3").
artist لا سلسلة غير متاح 2.3
2.4
2.5
تم نسب العمل إلى الفنّان في المحتوى.
genre لا سلسلة غير متاح 2.3
2.4
2.5
النوع الذي يصف المحتوى بأفضل شكل (مثل الروك والبوب وغير ذلك).
album لا سلسلة غير متاح 2.3
2.4
2.5
الألبوم الذي ينتمي إليه المحتوى، وعادةً ما يكون للصوت.
isrc لا سلسلة غير متاح 2.3
2.4
2.5
رمز تسجيل قياسي دولي متوافق مع ISO-3901.
url لا سلسلة (App.content فقط) BidRequest.url 2.3
2.4
2.5


عنوان URL للمحتوى، من أجل سياقية الشراء أو المراجعة.
cat لا مصفوفة سلسلة غير متاح 2.3
2.4
2.5
مجموعة من فئات محتوى مكتب الإعلانات التفاعلية (IAB) التي تصف المحتوى. الرجوع إلى التعداد ContentCategory.
prodq لا جودة الإنتاج غير متاح 2-4
2-5
جودة الإنتاج.
keywords لا غير متاح 2.3
2.4
2.5


قائمة كلمات رئيسية مفصولة بفواصل تصف المحتوى.

ملاحظة: سمح OpenRTB 2.2 بمجموعة من السلاسل كتنفيذ بديل ولكن تم إصلاح ذلك في الإصدار 2.3 والإصدارات الأحدث، حيث يكون بالتأكيد سلسلة واحدة تتضمن محتوى CSV مرة أخرى. قد يتطلب التوافق مع بعض تبادلات OpenRTB 2.2 التي اعتمدت التمثيل البديل معالجة مخصّصة لتنسيق JSON.

contentrating لا سلسلة BidRequest.detected_content_label 39:
"DV_G", 40: "DV_PG", 41: "DV_T", 42: "DV_MA", 43:
"DV_UNRATED"
2.3
2.4
2.5


ملاحظة: يتم الآن تنقيح قيم هذا الحقل. تقييم المحتوى (على سبيل المثال، MPAA).
userrating لا سلسلة (App.content فقط)
BidRequest.Mobile.app_rating
2.3
2.4
2.5


تقييم المستخدم للمحتوى (على سبيل المثال، عدد النجوم والإعجابات وما إلى ذلك).
context لا سياق المحتوى غير متاح 2.3
2.4
2.5


نوع المحتوى (لعبة، فيديو، نصي، إلخ.)
context_22 لا سلسلة غير متاح 2.3
2.4
2.5


OpenRTB <= 2.2 support; استخدام السياق للإصدار 2.3 والإصدارات الأحدث.
livestream لا قيمة منطقية BidRequest.Video.is_livestream 2.3
2.4
2.5


0 = not live, 1 = content is live (على سبيل المثال، البث أو المدونة المباشرة).
sourcerelationship لا قيمة منطقية غير متاح 2.3
2.4
2.5


0 = غير مباشر، 1 = مباشر.
producer لا سلسلة عرض السعر.الفيديو 2.3
2.4
2.5


تفاصيل حول منتج Producer.
len لا int32 عرض السعر.الفيديوالمحتوىالسمات.duration_seconds 2.3
2.4
2.5


طول المحتوى بالثواني؛ ويكون مناسبًا للفيديو أو الصوت.
qagmediarating لا QAGMediaRating غير متاح 2.3
2.4
2.5


تقييم الوسائط وفق إرشادات الجودة.
embeddable لا قيمة منطقية غير متاح 2.3
2.4
2.5


ما إذا كان المحتوى قابلاً للتضمين أم لا (على سبيل المثال، مشغل فيديو قابل للتضمين)، حيث 0 = لا، 1 = نعم.
language لا سلسلة BidRequest.detected_language 2.3
2.4
2.5


لغة المحتوى باستخدام ISO-639-1-alpha-2.

المنتِج

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

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين متاح تفاصيل التنفيذ
في الإصدار من Google
id لا سلسلة غير متاح 2.3
2.4
2.5


رقم تعريف منشئ المحتوى أو المنشئ. ويفيد هذا المحتوى إذا تمت مشاركة المحتوى وقد يتم نشره على موقع إلكتروني باستخدام علامات التضمين.
name لا سلسلة غير متاح 2.3
2.4
2.5


اسم مُنتِج المحتوى أو منشئه (على سبيل المثال، "WARNINGer Bros").
cat لا مصفوفة سلسلة غير متاح 2.3
2.4
2.5


مصفوفة من فئات محتوى مكتب الإعلانات التفاعلية (IAB) التي تصف منتج المحتوى. الرجوع إلى تعداد ContentCategory
domain لا سلسلة BidRequest .Video.description_url 2.3
2.4
2.5


نطاق المستوى الأعلى لمنتج المحتوى (على سبيل المثال، "producer.com").

الجهاز

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

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين متاح تفاصيل التنفيذ
في الإصدار من Google
dnt لا قيمة منطقية غير متوافق؛ راجع دليل ملفات تعريف الارتباط، google_error=1: 2.3
2.4
2.5


الخيار "عدم التعقب" القياسي كما تم تحديده في العنوان بواسطة المتصفح، حيث 0 = التتبّع غير مقيّد، 1 = لا يتم التتبع. مقترحة من خلال مواصفات OpenRTB.
ua لا سلسلة عرض السعر.user_agent 2.3
2.4
2.5


سلسلة وكيل مستخدم المتصفح. موصى بها بواسطة مواصفات OpenRTB.
ip لا سلسلة BidRequest.ip (يُقتطع AdX من أول 3 وحدات ثمانيّة البُعد؛
OpenRTB هو "X.X.X.0")
2.3
2.4
2.5


عنوان IPv4 الأقرب إلى الجهاز. مقترحة من خلال مواصفات OpenRTB
geo لا عنصر واحد (Geo) طلب عرض السعر 2.3
2.4
2.5


موقع الجهاز الذي يُفترض أن يكون الموقع الحالي للمستخدم الذي يتم تحديده بواسطة كائن Geo.

موصى بها بواسطة مواصفات OpenRTB.

didsha1 لا سلسلة غير متاح 2.3
2.4
2.5


رقم تعريف الجهاز (على سبيل المثال، IMEI)؛ تمت تجزئته من خلال SHA1.
didmd5 لا سلسلة غير متاح 2.3
2.4
2.5


رقم تعريف جهاز (على سبيل المثال، IMEI)؛ تمت تجزئته عبر MD5.
dpidsha1 لا سلسلة غير متاح 2.3
2.4
2.5


رقم تعريف الجهاز في النظام الأساسي (على سبيل المثال، رقم تعريف Android)، وقد تم تجزئته من خلال SHA1
dpidmd5 لا سلسلة BidRequest.Mobile.hashed_idfa -
برنامج AdX ثنائي، ويمثل OpenRTB إصدار base16 (سداسي عشري صغير)
وهو الإصدار المجزأ من ifa.
يتوفّر dpidmd5 أو ifa
بناءً على إصدار حزمة تطوير البرامج (SDK) للأجهزة الجوّالة.
2.3
2.4
2.5


رقم تعريف جهاز النظام الأساسي (على سبيل المثال، رقم تعريف Android)؛ تم الحل باستخدام MD5.
ipv6 لا سلسلة BidRequest.ip

- يتم اقتطاع AdX إلى أول 6 وحدات بت؛ بينما يكون OpenRTB هو "X:X:X:::::"

2.3
2.4
2.5


عنوان IPv6 الأقرب إلى الجهاز.
carrier لا سلسلة BidRequest.Device.carrier_id
الأرقام التعريفية هي نفس معرّفات المعيار كما هو مذكور في بروتوكول "الشراة المعتمَدون"، يرجى الرجوع إلى قائمة شركات تشغيل شبكة الجوّال.
2.3
2.4
2.5


مشغّل شبكة الجوّال أو مزوّد خدمة الإنترنت (على سبيل المثال، "VERIZON")، باستخدام أسماء السلاسل المنظَّمة للتبادل والتي يجب نشرها لمقدمي عروض الأسعار المسبقة.
language لا سلسلة غير متاح 2.3
2.4
2.5


لغة المتصفح باستخدام ISO-639-1-alpha-2.
make لا سلسلة عرض السعر.الجهاز.brand 2.3
2.4
2.5


ماركة الجهاز (على سبيل المثال، "Apple").
model لا سلسلة BidRequest.Device.model 2.3
2.4
2.5


طراز الجهاز (مثل "iPhone")
os لا سلسلة BidRequest.Device.platform 2.3
2.4
2.5


نظام تشغيل الجهاز (على سبيل المثال، "iOS")
osv لا سلسلة عرض السعر.الجهاز.os_version 2.3
2.4
2.5


إصدار نظام تشغيل الجهاز
hwv لا سلسلة عرض السعر.الجهاز.الأجهزة_version 2.3
2.4
2.5


إصدار الأجهزة (على سبيل المثال، "5S" لجهاز iPhone 5S)
w لا int32 عرض السعر.الجهاز.screen_width 2.3
2.4
2.5


العرض الفعلي للشاشة بالبكسل.
h لا int32 عرض السعر.الجهاز.screen_height 2.3
2.4
2.5


الارتفاع المادي للشاشة بالبكسل.
ppi لا int32 غير متاح 2.3
2.4
2.5


حجم الشاشة بالبكسل لكل بوصة طولية
pxratio لا مزدوج BidRequest.Device.screen_pixel_ratio_millis / 1,000 2.3
2.4
2.5


نسبة وحدات البكسل الفعلية إلى وحدات البكسل المستقلة للجهاز.
js لا قيمة منطقية غير متاح 2.3
2.4
2.5


دعم JavaScript، حيث 0 = no, 1 = yes.
geofetch لا قيمة منطقية غير متاح 2-4
2-5

للإشارة إلى ما إذا كانت واجهة برمجة التطبيقات للموقع الجغرافي ستكون متاحة لرمز جافا سكريبت الذي يتم تشغيله في إعلان البانر، حيث 0 = لا، 1 = نعم.
connectiontype لا نوع الاتصال غير متاح 2.3
2.4
2.5


نوع اتصال الشبكة
devicetype لا نوع الجهاز BidRequest.Device.device_type 2.3
2.4
2.5


النوع العام للجهاز.
flashver لا سلسلة غير متاح 2.3
2.4
2.5


إصدار Flash الذي يدعمه المتصفح.
ifa لا سلسلة BidRequest.Mobile.advertising_id -
AdX هو برنامج ثنائي، وOpenRTB هو 36 حرفًا UUID (معرّف Android: جميع الأحرف الصغيرة، ومعرّف المعلِنين (IDFA): كل الأحرف الكبيرة).
إذا كان معرّف Android هو معرّف Android أو معرّف المعلِنين (IDFA) من Apple، ويتوفر dpidmd5 أو
ifa اعتمادًا على إصدار حزمة تطوير البرامج (SDK) للأجهزة الجوّالة.
2.3
2.4
2.5


معرّف تم فرض عقوبات عليه لاستخدام المعلن بشكل واضح (على سبيل المثال، غير مجزأ)
macsha1 لا سلسلة غير متاح 2.3
2.4
2.5


عنوان MAC للجهاز؛ تمت تجزئته من خلال SHA1.
macmd5 لا سلسلة غير متاح 2.3
2.4
2.5


عنوان MAC للجهاز؛ مجزأة عبر MD5
lmt لا قيمة منطقية BidRequest.Device.limit_ad_tracking 2.3
2.4
2.5


إشارة "تقييد تتبع الإعلانات" معتمدة تجاريًا (على سبيل المثال، iOS وAndroid)، حيث تكون 0 = التتبّع غير مقيّدة، 1 = يجب أن يكون التتبّع محدودًا وفقًا للإرشادات التجارية.

موصى بها بواسطة مواصفات OpenRTB.

mccmnc لا سلسلة غير متاح 2.5 مشغّل شبكة الجوّال باعتباره رمز MCC-MNC المتسلسل (مثل "310-005" يحدّد شبكة Verizon Wireless CDMA في الولايات المتحدة الأمريكية). يمكنك الرجوع إلى https://en.wikipedia.org/wiki/Mobile_country_code للحصول على مزيد من الأمثلة. لاحظ أن الشرطة التي تفصل بين أجزاء MNC وMCC تكون مطلوبة لإزالة غموض التحليل.
ext لا عنصر واحد (DeviceExt) غير متاح 2.3
2.4
2.5


بالنسبة إلى OpenRTB/Protobuf، يمكنك الوصول إلى هذا الكائن باستخدام مفتاح الإضافة [com.google.doubleclick.device] (يختلف المسار الصحيح استنادًا إلى اللغة المستخدمة لإنشاء مكتبة Proto). بالنسبة إلى OpenRTB/JSON، يمكنك الوصول إلى الحقل ext في رسالة الجهاز.

ملحق الجهاز

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
session_id لا سلسلة BidRequest.session_id يمثِّل هذا الإعداد جلسة مستخدم قصيرة الأجل على أجهزة التلفزيون المتّصل (CTV)/خدمة البث المباشر على الإنترنت، وتكون مدتها القصوى 6 ساعات. لا يُسمح أبدًا باستخدام session_id لتخصيص الإعلانات. لا يمكن استخدام session_id إلا لتحديد عدد مرات الظهور أو الاستثناءات التنافسية أو الأغراض ذات الصلة. يتم ملء هذا الحقل بأبجدية base64 الآمنة على الويب.
atts لا int32 BidRequest.Device.app_tracking_authorization_status (iOS فقط) عدد صحيح تم تمريره لتمثيل حالة تفويض تتبُّع التطبيق للتطبيق، حيث 0 = لم يتم تحديده 1 = مقيَّد 2 = مرفوض 3 = مُصرَّح به. تم استرداد هذه القيمة من ATTrackingManager وتوفيرها كما هي. لمزيد من المعلومات حول حالة تفويض تتبُّع التطبيقات لنظام التشغيل iOS، يُرجى الاطّلاع على هذه المقالة.
user_agent_data لا عنصر واحد (UserAgent) BidRequest.user_agent_data معلومات وكيل المستخدم.
وكيل المستخدم

معلومات وكيل المستخدم. ستتم تعبئة هذا الحقل بمعلومات عن وكيل المستخدم، تم استخلاصه من رأس User-Agent أو من عناوين Sec-CH-UA.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
browser لا عنصر واحد (BrandVersion) BidRequest.user_agent_data.browser يحدد المتصفح.
platform لا عنصر واحد (BrandVersion) BidRequest.user_agent_data.platform يحدد النظام الأساسي.
mobile لا قيمة منطقية BidRequest.user_agent_data.mobile صحيح إذا كان الوكيل يفضّل محتوى "محسّن للجوّال". ارجع إلى حقل BidRequest.device للحصول على معلومات محدّدة عن الجهاز، والتي قد تكون أو لا تتوافق مع هذا الحقل (على سبيل المثال، قد يطلب متصفّح الهاتف الجوّال "موقع كمبيوتر سطح المكتب").
architecture لا سلسلة BidRequest.user_agent_data.architecture بنية الجهاز، على سبيل المثال "x86" أو "arm".
bitness لا سلسلة BidRequest.user_agent_data.bitness سرعة جهاز الجهاز، على سبيل المثال، "64" للبنية 64 بت.
model لا سلسلة BidRequest.user_agent_data.model طراز الجهاز.
كائن BrandVersion

مجموعة من (العلامة التجارية، الإصدار) للمتصفح أو النظام الأساسي.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
brand لا سلسلة BidRequest.user_agent_data.brand معرّف العلامة التجارية، مثل "Chrome" أو "Windows".
version لا سلسلة BidRequest.user_agent_data.version الإصدار، مقسّمًا إلى مكونات إذا لزم الأمر، على سبيل المثال {"85", "1"} = v85.1

Geo

ويجتذب هذا الكائن طرقًا متعددة لتحديد الموقع الجغرافي. وعند إسنادها إلى كائن Device، فإنها تشير إلى موقع الجهاز الذي يمكن تفسيره أيضًا على أنه الموقع الجغرافي الحالي للمستخدم. عند تابع عنصر User، فإنه يشير إلى موقع القاعدة الرئيسية للمستخدم (على سبيل المثال، ليس بالضرورة موقعه الحالي). يجب عدم تمرير سمات lat/lon إلا إذا كانت متوافقة مع الدقة الموضّحة في سمة النوع. فعلى سبيل المثال، يجب عدم تمرير المنطقة الوسطى من منطقة جغرافية، مثل الرمز البريدي.

ملاحظة بشأن بروتوكول عروض الأسعار في الوقت الفعلي "الشراة المعتمَدون": تكون معلومات الموقع الجغرافي الدقيق مقيَّدة بالقيود نفسها التي تنطبق على كائن Hyperlocalالشراة المعتمَدين. لا تحتوي جميع الطلبات على هذه المعلومات، ويمثّل lat/lon نقطة (وليس بالضرورة في الوسط) من مساحة يتناسب حجمها عكسيًا مع الكثافة السكانية. وهذا الإجراء جيد بما يكفي للاستهداف وليس للتتبّع الفردي.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين متاح تفاصيل التنفيذ
في الإصدار من Google
lat لا مزدوج BidRequest.[encrypted_]hyperlocal_set.
center_point.latitude.
2.3
2.4
2.5


خط العرض من -90.0 إلى +90.0، حيث السالب هو الجنوب.
lon لا مزدوج BidRequest.[encrypted_]hyperlocal_set.center_point.longitude 2.3
2.4
2.5


خط الطول من -180.0 إلى +180.0، حيث تكون القيمة السالبة غربًا.
country لا سلسلة عرض السعر.geo_criteria_id من خلال geo-table.csv 2.3
2.4
2.5


تمثّل هذه السمة البلد الذي يستخدم معيار ISO-3166-1 Alpha-3.
region لا سلسلة عرض السعر.geo_criteria_id من خلال geo-table.csv 2.3
2.4
2.5


رمز المنطقة باستخدام ISO-3166-2، ورمز الولاية المكوّن من حرفين إذا كانت الولايات المتحدة الأمريكية.
regionfips104 لا سلسلة 2.3
2.4
2.5


منطقة بلد تستخدم ترميز FIPS 10-4. على الرغم من أنّ OpenRTB يتيح استخدام هذه السمة، فقد سحبها فريق NIST في العام 2008.
metro لا سلسلة عرض السعر.geo_criteria_id من خلال geo-table.csv, city-dma-regions.csv 2.3
2.4
2.5


رمز المنطقة المركزية في Google؛ على غرار Nielsen DMA وليس بالضبط.

ارجع إلى صفحة الاستهداف الجغرافي للاطلاع على رابط للشفرات.

city لا سلسلة عرض السعر.geo_criteria_id من خلال geo-table.csv 2.3
2.4
2.5


مدينة تستخدم رمز الأمم المتحدة لمواقع التجارة والنقل بتنسيق "city": "San Antonio".يُرجى الرجوع إلى الملحق أ للحصول على رابط إلى الرموز.
zip لا سلسلة BidRequest.postal_code
BidRequest.postal_code_prefix
2.3
2.4
2.5


الرمز البريدي.
type لا نوع الموقع 2.3
2.4
2.5


مصدر بيانات الموقع الجغرافي؛ يوصى به عند تمرير خط الطول/خط العرض
accuracy لا int32 غير متاح 2-4
2-5

الدقة المقدّرة للموقع بالأمتار، ويُوصى بها عندما يتم تحديد خطوط الطول/العرض وتشتق من خدمات الموقع للجهاز (على سبيل المثال، النوع = 1) لاحظ أن هذه هي الدقة كما تم الإبلاغ عنها من الجهاز. يمكنك الرجوع إلى المستندات الخاصة بنظام التشغيل (مثل Android وiOS) للحصول على تفسير دقيق.
lastfix لا int32 غير متاح 2-4
2-5

عدد الثواني منذ إنشاء إصلاح الموقع الجغرافي هذا.

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

ipservice لا خدمة الموقع الجغرافي غير متاح 2-4
2-5

الخدمة أو المزود المستخدم لتحديد الموقع الجغرافي من عنوان IP إن أمكن (على سبيل المثال، النوع = 2).
utcoffset لا int32 عرض السعر.timezone_offset 2.3
2.4
2.5


التوقيت المحلي هو الرقم +/- للدقائق من UTC.

المستخدِم

يحتوي هذا الكائن على معلومات معروفة أو مشتقة من المستخدم الإنساني للجهاز (مثلاً، جمهور الإعلانات).ورقم تعريف المستخدم هو عنصر التبادل وقد يخضع إلى سياسات التناوب أو الخصوصية الأخرى. ولكن، يجب أن يكون رقم تعريف المستخدم ثابتًا بما فيه الكفاية ليتم عرضه بشكلٍ معقول كأساس لتحديد عدد مرات الظهور وإعادة الاستهداف.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين متاح تفاصيل التنفيذ
في الإصدار من Google
id لا سلسلة عرض السعر.[مقيَّد_usage_]google_user_id 2.3
2.4
2.5


رقم تعريف خاص بخادم Exchange للمستخدم. يُوصى باستخدام سمة واحدة على الأقل من id أو buyerid
buyeruid لا سلسلة BidRequest.[constrained_usage_]hosted_match_data - AdX برنامج ثنائي، OpenRTB هو websafe base64 (بدون مساحة متروكة) 2.3
2.4
2.5


رقم تعريف المستخدم للمشتري الذي تم تعيينه كما هو محدد في التبادل للمشتري. يوصى باستخدام سمة واحدة على الأقل من buyerid أو id.
gender لا سلسلة غير متاح 2.3
2.4
2.5


الجنس كذكر "M"، و"F" أنثى، "O" غير ذلك. (يشير النص فارغ إلى غير معروف)
keywords لا سلسلة غير متاح 2.3
2.4
2.5


قائمة مفصولة بفواصل للكلمات الرئيسية، أو الاهتمامات، أو القصد. ملاحظة: سمح OpenRTB 2.2 بمجموعة من السلاسل كتنفيذ بديل ولكن تم إصلاح ذلك في الإصدار 2.3 والإصدارات الأحدث، حيث يكون بالتأكيد سلسلة واحدة تتضمن محتوى CSV مرة أخرى. وقد يتطلّب التوافق مع بعض تبادلات OpenRTB 2.2 التي تعتمد التمثيل البديل معالجة JSON بشكل مخصّص.
customdata لا سلسلة BidRequest.[constrained_usage_]hosted_match_data - AdX برنامج ثنائي، OpenRTB هو websafe base64 (بدون مساحة متروكة) 2.3
2.4
2.5


ميزة اختيارية لتمرير مجموعة بيانات نظام عروض الأسعار في ملف تعريف ارتباط التبادل. يجب أن تكون السلسلة في أحرف base85 آمنة لملفات تعريف الارتباط وأن تكون بأي تنسيق. يجب استخدام ترميز JSON المناسب لتضمين علامات اقتباس "تم تخطيها".
geo لا عنصر واحد (Geo) غير متاح 2.3
2.4
2.5


موقع القاعدة الرئيسية للمستخدم الذي تم تحديده بواسطة كائن Geo. وهذا ليس بالضرورة أن يكون موقعهم الحالي.
data لا صفيف Data من العناصر BidRequest.detected_vertical 2.3
2.4
2.5


ملاحظة: يتم الآن تنقيح قيم هذا الحقل. بيانات سياقية إضافية يمثل كل كائن Data مصدر بيانات مختلفًا.

يشير segment.id إلى موضع الإعلان الذي اكتشفه التبادل للصفحة.

ويتطابق عنصر segment.value مع وزن موضع الإعلان الذي يتم اكتشافه، بينما يشير ارتفاع أعلى إلى أنّ الصفحة أكثر صلة بموضع الإعلان الذي تم اكتشافه.

ext لا عنصر واحد (UserExt) غير متاح 2.3
2.4
2.5


بالنسبة إلى OpenRTB/Protobuf، يمكنك الوصول إلى هذا الكائن باستخدام مفتاح الإضافة [com.google.doubleclick.user] (يختلف المسار الصحيح استنادًا إلى اللغة المستخدمة لإنشاء مكتبة Proto). بالنسبة إلى OpenRTB/JSON، يمكنك الوصول إلى الحقل ext في رسالة المستخدم.

الرقم الداخلي للمستخدم

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
consented_providers_settings لا عنصر واحد (ConsentedProvidersSettings) BidRequest.AdSlot.consented_providers_settings معلومات عن مزوّدي تقنية الإعلان الذين حدّد الناشر لهم أن Google قد وافق على أن يستخدم مستخدم المنطقة الاقتصادية الأوروبية بياناتهم الشخصية لتخصيص الإعلانات وفقًا لسياسة موافقة المستخدم في الاتحاد الأوروبي من Google. لن تتم تعبئة هذا الحقل إلا عندما تكون قيمة RegsExt.gdpr صحيحة.
consent لا سلسلة BidRequest.AdSlot.ConsentedProvidersSettings.tcf_consent_string سلسلة الموافقة الثانية بموجب "إطار الشفافية والموافقة" (TCF) المشفّرة بواسطة مكتب الإعلان التفاعلي (IAB) التي تم ترميزها باستخدام معيار web64 والمتوافقة مع الويب والتي تم جلبها من منصّة إدارة الموافقة (CMP) التي يستخدمها الناشر. يتم تحديد بنية السلسلة باستخدام الإصدار الثاني من إطار الشفافية والموافقة الصادر عن مكتب الإعلانات التفاعلية (IAB). سيتم ملء هذا الحقل إذا كان الناشر قد دمج مع منصّة إدارة الموافقة (CMP) للإصدار 2 من إطار الشفافية والموافقة، ويشير منصّة إدارة الموافقات (CMP) إلى أن اللائحة العامة لحماية البيانات (GDPR) تنطبق على طلب الإعلان هذا وتوفّر سلسلة موافقة صالحة. اطّلِع على هذه المقالة للحصول على معلومات إضافية عن دمج الإصدار الثاني من إطار الشفافية والموافقة من Google.

يمكنك الاطّلاع على قائمة المورّدين العالميين في IAB على vendor-list.consensu.org/v2/vendor-list.json للحصول على تفاصيل عن المورّدين المُدرجين في سلسلة الموافقة.

eids لا مصفوفة من ExtendedId من الكائنات BidRequest.AdSlot.secure_signals إضافة عادية تُستخدم لتمرير الإشارات الآمنة التي يختارها الناشر.
إعدادات ConsentedProvider

معلومات عن مزوّدي تقنية الإعلان الذين حدّد الناشر لهم أن Google وافقوا على استخدام بياناتهم الشخصية لأغراض تخصيص الإعلانات وفقًا لسياسة موافقة المستخدم في الاتحاد الأوروبي من Google. لن تتم تعبئة هذا الحقل إلا عندما تكون قيمة RegsExt.gdpr صحيحة.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
consented_providers لا مصفوفة int64 BidRequest.AdSlot.consented_providers مجموعة من أرقام التعريف الخاصة بمزوّدي تقنية الإعلان الذين حدّد الناشر لهم أن Google قد وافقوا على منح مستخدميهم في المنطقة الاقتصادية الأوروبية موافقة قانونية صالحة على: 1) استخدام ملفات تعريف الارتباط أو غير ذلك من البيانات المحفوظة على أجهزتهم المحلية حيثما يقتضي القانون 2) جمع البيانات الشخصية ومشاركتها واستخدامها لتخصيص الإعلانات من جانب مزوّد تقنية الإعلان وفقًا لسياسة موافقة المستخدم في الاتحاد الأوروبي التي تتّبعها Google.

إذا كان أحد الناشرين يستخدم الإصدار 2 من "إطار الشفافية والموافقة" (TCF) الصادر عن مكتب الإعلانات التفاعلية (IAB) لإدارة موافقة المستخدم، هذه هي مجموعة "مزوّدي تقنية الإعلان" الذين تمت الموافقة عليهم من خلال سلسلة الموافقة الإضافية (راجِع هذه المقالة للحصول على تفاصيل عن وضع الموافقة الإضافية من Google). يتم تمثيل مزوّدي تقنية الإعلان الذين تمت الموافقة عليهم من خلال سلسلة الموافقة الثانية للإصدار 2 من إطار الشفافية والموافقة في حقل UserExt.consent.

يتم نشر عملية ربط معرّف مزوّد تقنية الإعلان باسم مزوّد تقنية الإعلان (ATP) على موفّري البيانات.csv.

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

إشارات آمنة مرّرها الناشر

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
source لا سلسلة BidRequest.AdSlot.SecureSignal.source مصدر (مقدم) الإشارة.
uids لا مصفوفة تتضمن كائن ExtendedIdUid واحدًا لا ينطبق الإشارة الآمنة.
المعرّف الموسّع
السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
id لا سلسلة BidRequest.AdSlot.SecureSignal.data الإشارة الآمنة.

البيانات

يسمح الكائنان data وsegment معًا بتحديد بيانات سياقية إضافية. قد تأتي هذه البيانات من مصادر متعددة سواء من التبادل نفسه أو من مقدمي خدمات من جهات خارجية كما هو محدد في الحقل id. يمكن أن يمزج طلب عرض السعر بين كائنات البيانات من عدة مزوّدين. يجب نشر موفري البيانات المحددين قيد الاستخدام بواسطة التبادل مع مقدّمي عروض الأسعار.

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

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين متاح تفاصيل التنفيذ
في الإصدار من Google
id لا سلسلة متاح 2.3
2.4
2.5


معرّف خاص بخادم Exchange لموفر البيانات.
name لا سلسلة متاح 2.3
2.4
2.5


اسم خاص بمزوّد البيانات لخادم Exchange.
segment صفيف Segment من العناصر متاح 2.3
2.4
2.5


مصفوفة من كائنات Segment تحتوي على قيم البيانات الفعلية.

قسم

يسمح الكائنان data وsegment معًا بتحديد بيانات سياقية إضافية. قد تأتي هذه البيانات من مصادر متعددة سواء من التبادل نفسه أو من مقدمي خدمات من جهات خارجية كما هو محدد في الحقل id. يمكن أن يؤدي طلب عرض السعر إلى مزج Data من العناصر من العديد من مزودي الخدمة. يجب نشر موفري البيانات المحددين قيد الاستخدام من خلال التبادل مع مقدّمي عروض الأسعار.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين متاح تفاصيل التنفيذ
في الإصدار من Google
id لا سلسلة متاح 2.3
2.4
2.5


رقم تعريف شريحة البيانات المخصّصة لمزوِّد البيانات.
name لا سلسلة متاح 2.3
2.4
2.5


اسم شريحة البيانات الخاصة بمقدّم البيانات.
value سلسلة متاح 2.3
2.4
2.5


تمثيل سلسلة لقيمة شريحة البيانات.

قواعد التسجيل

يحتوي هذا الكائن على أي لوائح قانونية أو حكومية أو صناعية تسري على الطلب. يشير الخيار coppa إلى ما إذا كان الطلب يندرج ضمن لوائح لجنة التجارة الفيدرالية الأمريكية (COPPA) في الولايات المتحدة الأمريكية. راجع الفقرة 7.1 لمزيد من المعلومات.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين متاح تفاصيل التنفيذ
في الإصدار من Google
coppa لا سلسلة عرض السعر.user_data_treatment / TAG_FOR_CHILD_DIRECTED_TREATMENT 2.3
2.4
2.5


خيار يشير إلى ما إذا كان هذا الطلب خاضعًا للوائح قانون حماية خصوصية الأطفال على الإنترنت (COPPA) التي وضعتها لجنة التجارة الفيدرالية (FTC) بالولايات المتحدة الأمريكية، حيث 0 = لا، 1 = نعم.
ext لا عنصر واحد (RegsExt) غير متاح 2.3
2.4
2.5


بالنسبة إلى OpenRTB/Protobuf، يمكنك الوصول إلى هذا الكائن باستخدام مفتاح الإضافة [com.google.doubleclick.regs] (يختلف المسار الصحيح استنادًا إلى اللغة المستخدمة لإنشاء مكتبة Proto). بالنسبة إلى OpenRTB/JSON، يمكنك الدخول باستخدام الحقل ext في رسالة Regs.

التعبير العادي

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
gdpr لا قيمة منطقية BidRequest.AdSlot.regs_gdpr سيتم ضبط هذا الحقل على "صحيح" في إحدى الحالتين التاليتين:
  1. تتلقّى Google سلسلة الموافقة رقم 2 صالحة من "إطار الشفافية والموافقة" (TCF) الصادر عن مكتب الإعلانات التفاعلية (IAB) وتشير "منصة إدارة الموافقة" إلى أن "اللائحة العامة لحماية البيانات" تنطبق على طلب الإعلان هذا.
  2. لا تتلقّى Google سلسلة الموافقة رقم 2 من إطار الشفافية والموافقة الصادر عن IAB، واستنادًا إلى المعلومات المتاحة لشركة Google، سيتم عرض مرة الظهور هذه لمستخدم في المنطقة الاقتصادية الأوروبية.
لا تشكّل هذه الإرشادات إرشادات قانونية بشأن اللائحة العامة لحماية البيانات.
lgpd لا قيمة منطقية BidRequest.AdSlot.regs_lgpd سيتم ضبط هذا الحقل على "صحيح" عندما يتم عرض هذا مرة الظهور لمستخدم في البرازيل استنادًا إلى المعلومات المتاحة لـ Google. يمكنك الاطّلاع على https://storage.googleapis.com/adx-rtb-dictionaries/lgpd-providers.csv للحصول على قائمة بمزوّدي تقنية الإعلان المسموح لهم بعرض الإعلانات على الطلبات التي يفرضها قانون LGPD.

راجع هذه المقالة للحصول على مزيد من المعلومات حول قانون LGPD.

متغيرات واستجابة الردود على عروض الأسعار

يصف هذا القسم متغيرات وتعريفات استجابة عروض الأسعار.

عرض استجابة

هذا الكائن هو كائن استجابة عروض الأسعار من المستوى الأعلى (على سبيل المثال، كائن JSON بدون اسم). تعكس السمة id رقم تعريف طلب عرض الأسعار لأغراض التسجيل. وبالمثل، bidid هو معرّف اختياري لتتبّع الردود لعروض الأسعار. وفي حال تحديده، يمكن تضمينه في استدعاء إشعار الفوز اللاحق في حال فوز مقدم عرض السعر. يلزم توفر عنصر seatbid واحد على الأقل، والذي يحتوي على عرض سعر واحد على الأقل لمرات الظهور. السمات الأخرى اختيارية. لتعبير "no-bid"، يُرجى عرض استجابة فارغة مع HTTP 204. بدلاً من ذلك، إذا كان صاحب عرض السعر يرغب في توضيح سبب عدم تقديم عروض أسعار للتبادل، يتم عرض عنصر BidResponse فقط مع رمز سبب في السمة nbr.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين متاح تفاصيل التنفيذ
في الإصدار من Google
id نعم سلسلة لم يتم التعيين إلى أي حقل، ولكن تم التحقق من صحته مقابل BidRequest.id. 2.3
2.4
2.5


رقم تعريف طلب عرض الأسعار الذي يكون هذا ردًا عليه.

مطلوبة بواسطة مواصفات OpenRTB.

seatbid لا صفيف Seatbid من العناصر BidResponse.Ad 2.3
2.4
2.5


مصفوفة مكوّنة من Seatbid من العناصر، مطلوب 1+ إذا كان سيتم تقديم عرض سعر.
bidid لا سلسلة BidResponse.debug_string 2.3
2.4
2.5


أنشأ نظام عروض الأسعار رقم تعريف الاستجابة للمساعدة في التسجيل/التتبُّع.
cur لا سلسلة BidResponse.Ad.AdSlot.currency 2.3
2.4
2.5


استخدم عرض السعر باستخدام رموز ألفا ISO-4217. وفي حال ملء هذا الحقل، سيتم استخدام العملة المحدّدة لتفسير عرض السعر. وبخلاف ذلك، سيتم استخدام عملة عروض الأسعار التلقائية، والتي يتم تحديدها حسب الأولوية التالية:

  1. العملة على مستوى عرض السعر في حال ضبطها في إعدادات حساب "عرض الأسعار في الوقت الفعلي (RTB)".
  2. العملة على مستوى المشتري. وسيتم تحديد المشتري من خلال معرّف الفوترة المحدّد في حقل الإضافة BidResponse.seatbid.bid.ext.billing_id في حال تمت تعبئته، وإلا سيستند ذلك إلى معرّف الفوترة الوحيد الذي تم إرساله في طلب عرض السعر.

يتم تعيين عملة حساب المشتري عند إنشاء الحساب ويمكن التحقق منها من خلال الاتصال بالمدير الفني للحساب.

customdata لا سلسلة غير متاح 2.3
2.4
2.5


ميزة اختيارية للسماح لمقدم عروض الأسعار بتعيين البيانات في ملف تعريف ارتباط التبادل. يجب أن تكون السلسلة في أحرف base85 آمنة لملفات تعريف الارتباط وأن تكون بأي تنسيق. يجب استخدام ترميز JSON الصحيح لتضمين علامات اقتباس "تم تجاوزها".
nbr لا سبب عرض السعر غير متاح 2.3
2.4
2.5


سبب عدم تقديم عروض أسعار.
ext لا عنصر واحد (BidResponseExt) غير متاح 2.3
2.4
2.5


بالنسبة إلى OpenRTB/Protobuf، يمكنك الوصول إلى هذا الكائن باستخدام مفتاح الإضافة [com.google.doubleclick.bid_response] (يختلف المسار الصحيح استنادًا إلى اللغة المستخدمة لإنشاء مكتبة Proto). بالنسبة إلى OpenRTB/JSON، يمكنك الوصول إلى الحقل ext في رسالة BidResponse.

عرض استجابة الرد

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
processing_time_ms لا int32 BidResponse.processing_time_ms يمكنك ضبط وقت الاستجابة هذا على وقت المعالجة بالمللي ثانية من وقت تلقّي الطلب حتى وقت إرجاع الرد.

ترخيص المقعد

يمكن أن تحتوي استجابة عروض الأسعار على كائنات SeatBid متعددة، كلٌّ منها نيابة عن مقعد مختلف في نظام عروض الأسعار ويحتوي كل واحد على واحد أو أكثر من عروض الأسعار المنفردة. في حال تقديم مرات ظهور متعددة في الطلب، يمكن استخدام سمة المجموعة لتحديد ما إذا كان المقعد على استعداد لقبول أي مرات ظهور يمكن الفوز بها (الإعداد التلقائي) أو إذا كان مهتمًا بالفوز بأي منها فقط إذا كان يمكنه الفوز بها جميعًا كمجموعة.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين متاح تفاصيل التنفيذ
في الإصدار من Google
bid لا صفيف Bid من العناصر عرض_الإعلانات 2.3
2.4
2.5


مصفوفة مكونة من 1+ Bid من الكائنات ذات الصلة بمرة ظهور. ويمكن أن ترتبط عروض الأسعار المتعددة بالظهور نفسه.
seat لا سلسلة BidResponse.Ad.
AdSlot.buyer_reporting_id
2.3
2.4
2.5


رقم تعريف مقعد المشتري (على سبيل المثال، المعلن، الوكالة) الذي تم تقديم عرض الأسعار نيابة عنه.
group لا قيمة منطقية غير متاح 2.3
2.4
2.5


0 = مرات الظهور يمكن الفوز بها بشكل فردي؛ 1 = مرات الظهور يجب الفوز بها أو فقدها كمجموعة. افتراضي = false

عرض السعر

يحتوي الكائن SeatBid على كائن Bid واحد أو أكثر، ويرتبط كل منها بمرة ظهور محدّدة في طلب عرض السعر من خلال السمة impid، ويشكل عرضًا لشراء مرة الظهور مقابل سعر معيّن.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين متاح تفاصيل التنفيذ
في الإصدار من Google
id نعم سلسلة لم يتم التعيين إلى أي حقل، ولكن تم التحقق من صحته مقابل BidRequest.id. 2.3
2.4
2.5


رقم تعريف طلب عرض الأسعار الذي يكون هذا ردًا عليه.

مطلوبة بواسطة مواصفات OpenRTB.

impid نعم سلسلة BidResponse.Ad.AdSlot.id 2.3
2.4
2.5


رقم تعريف العنصر Imp في طلب عرض السعر ذي الصلة. مطلوبة بواسطة مواصفات OpenRTB.
price نعم مزدوج BidResponse.Ad.AdSlot.max_cpm_micros * 1,000,000 2.3
2.4
2.5


يتم تقديم عرض السعر كالتكلفة لكل ألف ظهور بالرغم من أن المعاملة الفعلية تستند إلى مرة ظهور الوحدة فقط. وتجدر الإشارة إلى أنه على الرغم من أن النوع يشير إلى العدد العائم، يوصى بشدة باستخدام الأعداد الصحيحة عند التعامل مع العملات (على سبيل المثال، BigDecimal في جافا). مطلوبة بواسطة مواصفات OpenRTB.
adid لا سلسلة غير متاح 2.3
2.4
2.5


رقم تعريف إعلان تم تحميله مسبقًا لعرضه في حال فوز عرض السعر.
nurl لا سلسلة غير متاح 2.3
2.4
2.5


عنوان URL لإشعار الاستدعاء الذي يتم استدعاؤه من خلال التبادل في حالة فوز عرض الأسعار، وتكون وسائل اختيارية لعرض ترميز الإعلانات.

لا يدعم DoubleClick إشعارات الفوز؛ استخدم %%WINNING_PRICE%% في عنوان URL لظهور المقتطف، أو ${AUCTION_PRICE}.

adm لا سلسلة BidResponse.Ad.html_snippet، BidResponse.Ad.video_url، BidResponse.Ad.video_vast_xml، أو BidResponse.Ad.native_ad 2.3
2.4
2.5


وسائل اختيارية لنقل ترميز الإعلان في حالة فوز عرض السعر؛ حيث يحل محل إشعار الفوز إذا تم تضمين الترميز في كليهما. بالنسبة إلى عروض أسعار الإعلانات المدمجة مع المحتوى، يجب استخدام قيمة واحدة فقط من {adm, adm_native}، وهذا هو الحقل المتوافق مع OpenRTB لتسلسلات JSON.
adm_native لا NativeResponse BidResponse.Ad.native_ad 2.3
2.4
2.5


استجابة الإعلان المدمج مع المحتوى. بالنسبة إلى عروض أسعار الإعلانات المدمجة مع المحتوى، يجب استخدام قيمة واحدة فقط من {adm, adm_native}، وهي الحقل المُستخدَم لتسلسل Protobuf.
adomain لا مصفوفة سلسلة BidResponse.Ad.click_through_url 2.3
2.4
2.5


نطاق المُعلِن للتحقّق من قوائم الحظر (مثل "addomain.com"). يمكن أن يكون هذا صفيفًا لحالة تصميم الإعلانات بالتناوب. ويمكن لعمليات Exchange السماح بفرض نطاق واحد فقط. لا تسمح مواصفات OpenRTB إلا بأسماء النطاقات في adomain، ويتوافق الشراة المعتمَدون مع عناوين URL الكاملة أيضًا. يجب أن يكون هذا النطاق أو عنوان URL قابلاً للزحف. بالنسبة إلى الإعلانات المدمجة مع المحتوى، ننصحك باستخدام BidResponse.seatbid[].bid[].adm_native.link.url بدلاً من adomain.
bundle لا سلسلة BidResponse.Ad.advertised_app_id 2.3
2.4
2.5


رقم تعريف المتجر للتطبيق في متجر تطبيقات مثل Apple App Store أو Google Play. للحصول على مزيد من التفاصيل حول السلاسل المتوقّعة لمتاجر تطبيقات التلفزيون المتّصل (CTV)، يُرجى الاطّلاع على إرشادات تحديد المتجر عبر شبكة OTT/CTV لمعرفة المزيد من التفاصيل. بالنسبة إلى التطبيقات المتوافقة مع الأجهزة الجوّالة في "متجر Google Play"، يجب أن تكون هذه أسماء الحِزَم أو الحزم، مثل com.foo.mygame. بالنسبة إلى التطبيقات في Apple App Store، يجب أن تكون أرقام التعريف هذه أرقام تعريف رقمية. في حالة توفير هذا الحقل، سيرى المستخدمون بطاقة بيانات متجر التطبيقات على شكل تراكب بعد النقر على الإعلان، بدون مغادرة تطبيق الناشر. ويتم حاليًا تمكين هذا الحقل في إعلانات الفيديو بمكافأة والإعلانات البينية فقط.
iurl لا سلسلة غير متاح 2.3
2.4
2.5


عنوان URL بدون استخدام التخزين المؤقت إلى صورة تمثل محتوى الحملة للتحقق من جودة الإعلان/الأمان.
cid لا سلسلة BidResponse.Ad.AdSlot.billing_id 2.3
2.4
2.5


رقم تعريف الحملة للمساعدة في التحقق من جودة الإعلان؛ مجموعة تصميمات الإعلانات التي ينبغي تمثيل iurl لها.

يطابق رقم تعريف الفوترة في الاستهداف المسبق. في حال عدم ضبط السياسة على أحد billing_id للمشتري، تُعتبر استجابة عرض السعر غير صالحة.

عند إرسال تصميمات الإعلانات، يجب تقديم cid في الرد في حال تحديد أكثر من billing_id في الطلب أو في حال توفّر مقاعد نشِطة للأطفال في نظام عروض الأسعار.

crid لا سلسلة BidResponse.Ad.buyer_creative_id 2.3
2.4
2.5


رقم تعريف تصميم الإعلان للمساعدة في التحقق من جودة الإعلان.
cat لا مصفوفة سلسلة BidResponse.Ad.category 2.3
2.4
2.5


فئات محتوى IAB لتصميم الإعلان.
attr لا صفيف CreativeAttribute من العناصر BidResponse.Ad.attribute 2.3
2.4
2.5


مجموعة من السمات التي تصف تصميم الإعلان. يمكن إعلانها في OpenRTB باسم bid.attr (OpenRTB) أو bid.ext.attribute (AdX).
api لا إطار عمل واجهة برمجة التطبيقات تدعم Bid.api الإعلان عن السمات 1 و2 و3 و5 التي تتوافق مع إصدارات VPAID وMRAID 2.3
2.4
2.5


واجهة برمجة التطبيقات مطلوبة بواسطة الترميز إن أمكن.
protocol لا البروتوكول غير متاح 2.3
2.4
2.5


بروتوكول استجابة الفيديو للترميز إن أمكن.
qagmediarating لا QAGMediaRating غير متاح 2.3
2.4
2.5


تقييم وسائط تصميم الإعلان وفقًا لإرشادات QAG.
dealid لا سلسلة BidResponse.Ad.AdSlot.deal_id (أو BidResponse.Ad.loSlot.exchange_deal_id إذا كان نظام عروض الأسعار تبادلاً خارجيًا) 2.3
2.4
2.5


الرجوع إلى deal.id من طلب عرض السعر إذا كان عرض السعر هذا يتعلق بصفقة مباشرة من سوق خاصة.
w لا int32 BidResponse.Ad.width - مطلوب فقط إذا كانت مرات الظهور متعددة الأحجام 2.3
2.4
2.5


عرض تصميم الإعلان بوحدات البكسل المستقلة في الجهاز (DIPS).
h لا int32 BidResponse.Ad.height - مطلوب فقط إذا كانت مرات الظهور متعددة الأحجام 2.3
2.4
2.5


ارتفاع تصميم الإعلان بالبكسل المستقل عن الجهاز (DIPS).
exp لا int32 غير متاح 2.4
2.5

نصيحة بشأن عدد الثواني التي يرغب فيها مقدم عروض الأسعار في الانتظار بين المزاد ومرة الظهور الفعلية.
burl لا سلسلة مرة ظهور_tracking_url 2.5 عنوان URL لإشعار الفوترة الذي يطلبه التبادل عندما يصبح عرض السعر الفائز قابلاً للفوترة استنادًا إلى سياسة النشاط التجاري المتعلقة بالتبادل (على سبيل المثال، عادةً ما يتم عرضه أو عرضه وما إلى ذلك). ويمكن استخدام وحدات الماكرو البديلة. تجدر الإشارة إلى أن BidExt.impression_tracking_url يقبل قائمة متكررة بعناوين URL لإشعارات الفوترة. إذا كانت حالة استخدامك تتطلب أكثر من عنوان URL واحد للفوترة، يمكنك استخدام تلك الإضافة بدلاً من burl.
lurl لا سلسلة غير متاح 2.5 عنوان URL لإشعار الخسارة الذي يتم طلبه من خلال التبادل عندما يكون من المعروف أن أحد عروض الأسعار قد تم فقده. يمكن استخدام وحدات الماكرو البديلة. قد تحول السياسة المتعلقة بالتبادل دون توفير إشعارات الخسائر أو الإفصاح عن أسعار المقاصة الفائزة التي تؤدي إلى إزالة وحدات الماكرو ${AUCTION_PRICE} (على سبيل المثال، استبدالها بسلسلة صفرية الطول).
tactic لا سلسلة غير متاح 2.5 معرّف تكتيكي لتمكين المشترين من تصنيف عروض الأسعار في التقارير لتبادل الأسلوب الذي تم إرسال عروض الأسعار من خلاله. ويجب توضيح الاستخدام المحدد لمعرّف التكتيك ومعنىه بين المشتري والتبادل.
language لا سلسلة غير متاح 2.5 لغة تصميم الإعلان باستخدام ISO-639-1-alpha-2. ويمكن أيضًا استخدام الرمز "xx" غير العادي إذا لم يكن تصميم الإعلان يتضمّن محتوىً لغويًا (على سبيل المثال، بانر يتضمّن شعار شركة فقط).
wratio لا int32 غير متاح 2.5 العرض النسبي لتصميم الإعلان عند التعبير عن الحجم كنسبة. مطلوب لإعلانات Flex.
hratio لا int32 غير متاح 2.5 الارتفاع النسبي لتصميم الإعلان عند التعبير عن الحجم كنسبة. مطلوب لإعلانات Flex.
ext لا عنصر واحد (BidExt) غير متاح 2.3
2.4
2.5


بالنسبة إلى OpenRTB/Protobuf، يمكنك الوصول إلى هذا الكائن باستخدام مفتاح الإضافة [com.google.doubleclick.bid] (يختلف المسار الصحيح استنادًا إلى اللغة المستخدمة لإنشاء مكتبة Proto). بالنسبة إلى OpenRTB/JSON، يمكنك الوصول إلى الحقل ext في رسالة "عرض الأسعار".

عرض السعر

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
impression_tracking_url لا مصفوفة سلسلة BidResponse.Ad.impression_tracking_url عناوين URL المطلوب استدعاءها عند عرض مرة الظهور. تتوفّر هذه الميزة لجميع أنواع المستودعات وبجميع الأشكال. في OpenRTB 2.5، يعتبر Bid.burl الحقل القياسي التناظري.
ad_choices_destination_url لا سلسلة BidResponse.Ad.عنوان URL لـ ad_choices_destination_ رابط إلى تفضيلات الإعلانات أو صفحة التعطيل. وفي حال توفّره، تتم إضافة رمز "خيارات الإعلان" العادي إلى تصميم الإعلان المدمج مع المحتوى وربطه بعنوان URL هذا. يتوفّر هذا الخيار للإعلانات المدمجة مع المحتوى ولكنه ليس جزءًا من الرسالة الأصلية في استجابة عرض السعر.
click_tracking_url لا سلسلة BidResponse.Ad?click_tracking_url عناوين URL التي يجب الاتصال بها عندما ينقر المستخدم على الإعلان. متاحة حاليًا للإعلانات المدمجة مع المحتوى والصفقات الآلية المضمونة فقط مع المواد الإبداعية التي يديرها الناشر. في الحالة التي يديرها الناشر، سيتم إرسال أدوات تتبّع النقرات هذه إلى خادم نظام عروض الأسعار إلى الخادم. وفي جميع الحالات الأخرى، سيتم إرسالها من جهاز المستخدم. لمزيد من المعلومات عن تصميمات الإعلانات التي يديرها الناشر، راجع تصميمات الإعلانات التي يديرها الناشر.
bidder_name لا سلسلة BidResponse.Ad.bidder_name بالنسبة إلى مقدمي عروض الأسعار "الشراة المعتمَدون" (التبادلات الخارجية التي تقدّم عروض أسعار في الوقت الفعلي على "مدير الإعلانات")، يكون اسم نظام عروض الأسعار الذي طلبه التبادل لتقديم الإعلان. هذا نص UTF8 عشوائي ولكن من المفترض أن يكون كافيًا لتحديد مقدّم عرض السعر ويجب ضبطه بشكل متّسق على القيمة نفسها لمقدم عروض الأسعار نفسه.
exchange_deal_type لا Enum ExchangeDealType BidResponse.Ad.AdSlot.exchange_deal_type OPEN_AUCTION = 0;
PRIVATE_AUCTION = 1;
PREFERRED_DEAL = 2;
EXCHANGE_AUCTION_PACKAGE = 3;
التلقائي = OPEN_AUCTION
attribute لا مصفوفة int32 BidResponse.Ad. ارجع إلى Buy-declarable-creative-attributes.txt للاطّلاع على قائمة المعرّفات. يُرجى العِلم بأنّه لا يتم عرض جميع السمات المُعلَن عنها في حقل BidRequest في حقول battr المختلفة. يعلن العديد من أنظمة عروض الأسعار عن سمة الإعلانات "المرنة" (المعروفة أيضًا باسم الإعلانات البينية "المتجاوبة" أو "غير محددة الحجم") التي يتم تغيير حجمها ديناميكيًا لشغل عرض وارتفاع الشاشة بالكامل. للمزيد من المعلومات، يمكنك الرجوع إلى الوصف المتوفّر في دليل الإعلانات البينية.
amp_ad_url لا سلسلة BidResponse.Ad.amp_ad_url عنوان URL لجلب إعلان AMPHTML. يجب تعيين أحد العناصر التالية فقط: html_snippet وvideo_url وamp_ad_url وNative_ad.
sdk_rendered_ad لا SdkRenderedAd الكائن BidResponse.Ad.sdk_rendered_ad إعلان سيتم عرضه بواسطة حزمة SDK معروفة للمشتري. لا يمكن استخدام هذا الإجراء إلا عندما يتضمّن BidRequest رسالة AppExt.InstalledSdk الفرعية.
event_notification_token لا EventNotificationToken الكائن BidResponse.Ad.event_notification_token رمز مميّز تحدّده أنظمة عروض الأسعار لتحديد المشاكل وحلّه والذي سيتم تضمينه في الملاحظات التي يتم إرسالها في الوقت الفعلي بشأن عرض السعر الذي تم إرساله إليه. ولن يتم تسجيل محتوى الرمز المميّز.
restricted_category لا مصفوفة int32 BidResponse.restricted_category (فئة_الإعلانات_المقيدة) جميع الفئات المحظورة للإعلانات التي قد تظهر من هذا المقتطف. اطّلِع على ad-restricted-categories.txt للحصول على قائمة بالمعرّفات.
billing_id لا int64 BidResponse.Ad.AdSlot.billing_id معرّف الفوترة المطلوب إسناده إلى مرة الظهور هذه. يجب أن تكون القيمة في حقل BidRequest.ImpEx.ImpExt.billing_id المتكرّر الذي تم إرساله لمرة الظهور هذه. إذا كان طول BidRequest.ImpExt.billing_id هو بالضبط 1 ولم يكن لدى نظام عروض الأسعار مقاعد ثانوية نشطة، لن يكون هذا الحقل مطلوبًا وسيتم تجاهل محتوياته.
third_party_buyer_token لا سلسلة BidResponse.Ad.Adslot.third_party_buyer_token رمز مميز يُستخدم لتحديد معلومات المشتري من جهة خارجية إذا كان التبادل بمثابة نظام عرض أسعار مفتوح وسيطًا. ويتم الحصول على هذه المعلومات من المشتري الخارجي ويجب تمريرها إلى Google بدون أي تعديل في استجابة عرض الأسعار.
buyer_reporting_id لا سلسلة BidResponse.Ad.Adslot.buyer_reporting_id المعرّف الذي أعلن عنه المشتري والذي سيتم استخدامه لتقسيم مقاييس الإنفاق والزيارات غير الصالحة في تقارير الشفافية حول الزيارات غير الصالحة في أداة طلبات البحث. يُرجى العِلم بأنّه لن يتم استخدام أرقام التعريف التي تتضمّن أقل من 1000 مرة ظهور لتقسيم المقاييس. وسيتم تجاهل المعرّفات التي يتجاوز حجمها 64 بايت.
skadn لا SKAdNetworkResponse الكائن BidResponse.Ad.skadn معلومات SKAdNetwork للمعلن لدعم إحالة تثبيت التطبيق لنظام التشغيل iOS 14 والإصدارات الأحدث. تساعد SKAdNetwork API من Apple المعلِنين على قياس عمليات تثبيت التطبيقات المستندة إلى الإعلانات عن طريق إرسال الإبلاغ عن الإحالات الناجحة إلى شبكة المواقع الإعلانية بعد نجاح عملية التثبيت. ستحتاج شبكات الإعلانات إلى إرسال رقم تعريف الشبكة ومعلومات المعلِن المُوقَّع للسماح بإسناد التثبيت إلى مرة ظهور الإعلان. لمزيد من المعلومات، راجع هذه المقالة.
SdkRenderedAd
id لا سلسلة BidResponse.ad[].sdk_rendered_ad.id رقم تعريف حزمة SDK التي ستعرض الإعلان. ويجب أن تتطابق مع BidRequest.app.ext.installed_sdk.id المرسلة في طلب عرض الأسعار المقابل.
rendering_data لا سلسلة BidResponse.ad[].sdk_rendered_ad.rendering_data البيانات التي يتم تمريرها إلى SDK حتى يتم عرض الإعلان. هذه البيانات غير واضحة للناشر وGoogle.
declared_ad لا DelcaredAd BidResponse.ad[].sdk_rendered_ad.declared_ad مواد عرض الإعلانات المُعلَن عنها لدعم فحص تصميم الإعلانات وتصنيفها وتنفيذها وحظر الإعلانات للناشرين الذين يتم عرضهم باستخدام حزمة تطوير برامج (SDK) مخصّصة. اضبط سمة واحدة فقط من html_snippet أو video_url أو video_vast_xml أو native_response.
رمز إشعار الحدث
payload لا سلسلة BidResponse.ad[].event_notification_token محتوى الرمز المميّز الذي سيتم تجاهله إذا كان حجمه يتجاوز 64 بايت
SKAdNetworkResponse
version لا سلسلة BidResponse.ad[].skadn.version إصدار SKAdNetwork الذي يتيحه المعلن. ويُستخدم أيضًا لتحديد كيفية إنشاء التوقيع من قِبل المعلن. ومن المفترض أن يتطابق هذا مع الإصدار من BidRequest.imp.ext.skad.version.
network لا سلسلة BidResponse.ad[].skadn.network معرّف شبكة الإعلانات المستخدم في التوقيع. ومن المفترَض أن يتطابق هذا مع أحد العناصر في BidRequest.imp.ext.skad.skadnetids.
campaign لا سلسلة BidResponse.ad[].skadn.campaign الرقم التعريفي للحملة متوافق مع مواصفات Apple.
itunesitem لا سلسلة BidResponse.ad[].skadn.itunesitem رقم تعريف تطبيق المعلن في متجر تطبيقات Apple.
fidelities لا صفيف Fidelity من العناصر BidResponse.ad[].skadn.fidelities تتوافق واجهة برمجة تطبيقات SKAdNetwork بدءًا من الإصدار 2.2 مع خيارات عرض إعلانات متعددة محدّدة من خلال المعلّمة fidelity-type لتوقيع SKAdNetwork. ويؤدي هذا إلى الاحتفاظ بالمعلمات المستخدَمة لإنشاء التوقيع الذي سيكون مختلفًا لكل نوع من الدقّة المتاحة. لمزيد من المعلومات، راجع هذه المقالة.
nonce لا سلسلة BidResponse.ad[].skadn.nonce معرّف مستخدم فريد فريد مؤلف من أحرف صغيرة وينشئه المعلِن لاستخدامه في إنشاء التوقيع. ملاحظة: سيتم إيقاف هذا الحقل لصالح حقل BidResponse.bid.ext.skadn.fidelities.nonce لإتاحة أنواع متعددة من الدقّة.
sourceapp لا سلسلة BidResponse.ad[].skadn.sourceapp رقم تعريف تطبيق الناشر في متجر تطبيقات Apple. ويجب أن يتطابق هذا مع رقم التعريف من BidRequest.imp.ext.skad.sourceapp.
timestamp لا سلسلة BidResponse.ad[].skadn.timestamp وقت نظام التشغيل Unix بالمللي ثانية عند إنشاء التوقيع. ملاحظة: سيتم إيقاف هذا الحقل لصالح حقل BidResponse.bid.ext.skadn.fidelities.timestamp يتيح استخدام أنواع متعددة من الدقّة.
signature لا سلسلة BidResponse.ad[].skadn.signature توقيع SKAdNetwork على النحو الذي تحدّده Apple. ملاحظة: سيتم إيقاف هذا الحقل لصالح حقل BidResponse.bid.ext.skadn.fidelities.signature لإتاحة أنواع متعددة من الدقّة.
كائن الإعلان

مواد عرض الإعلانات المُعلَن عنها لدعم فحص تصميم الإعلانات وتصنيفها وتنفيذها وحظر الإعلانات للناشرين الذين يتم عرضهم باستخدام حزمة تطوير برامج (SDK) مخصّصة.

اضبط سمة واحدة فقط من html_snippet أو video_url أو video_vast_xml أو native_response.

أحد الوالدَين

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
html_snippet لا سلسلة BidResponse.ad[].sdk_rendered_ad.claimd_ad.html_snippet ممثل مقتطف HTML للإعلان المعروض بحزمة SDK.
video_url لا سلسلة BidResponse.ad[].sdk_rendered_ad.claimd_ad.video_url عنوان URL لمادة عرض VAST المستخدمة في الإعلان المعروض في SDK.
video_vast_xml لا سلسلة BidResponse.ad[].sdk_rendered_ad.claimd_ad.video_vast_xml. مستند VAST المستخدم لعرض الإعلان المخصص الذي يتم عرضه بواسطة SDK. يجب أن يتوافق هذا المستند مع معيار VAST 2.0 أو 3.0.
native_response لا NativeResponse BidResponse.ad[].sdk_rendered_ad.advertised_ad.native_response محتوى الإعلان المدمج مع المحتوى. تتألف الإعلانات المدمجة مع المحتوى من وحدات أساسية متعددة يتم عرضها بواسطة حزمة تطوير البرامج (SDK) للمشتري. يجب أن يتطابق مع المعيار OpenRTB Native 1.2 العادي NativeResponse. NativeResponse.assets.img.type مطلوب.
click_through_url لا سلسلة BidResponse.ad[].sdk_rendered_ad.claimd_ad.click_through_url الصفحات المقصودة النهائية للإعلان المعروض بحزمة SDK.
دقة
السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
fidelity لا تعداد SKAdNetworkFidelity BidResponse.ad[].skadn.fidelity_type نوع الدقة في الإحالة المطلوب تتبعها. الافتراضي = STOREKIT_RENDERED_ADS.

VIEW_THROUGH_ADS = 0؛ إحالة لعمليات تثبيت التطبيق خلال 24 ساعة من مشاهدة إعلان لمدة 3 ثوانٍ على الأقل. يتوفّر هذا الخيار للإصدار 2.2 من SKAdnetwork والإصدارات الأحدث. لمزيد من المعلومات، راجع هذه المقالة.

STOREKIT_RENDERED_ADS = 1؛ إحالة لعمليات تثبيت التطبيقات التي تم بدؤها من صفحة منتج متجر التطبيقات المعروضة على StoreKit الناتجة عن النقرات على الإعلانات. يتوفّر ذلك لجميع إصدارات SKAdNetwork. لمزيد من المعلومات، راجع هذه المقالة.

nonce لا سلسلة BidResponse.ad[].skadn.nonce معرّف مستخدم فريد فريد مؤلف من أحرف صغيرة وينشئه المعلِن لاستخدامه في إنشاء التوقيع.
timestamp لا سلسلة BidResponse.ad[].skadn.timestamp وقت نظام التشغيل Unix بالمللي ثانية عند إنشاء التوقيع.
signature لا سلسلة BidResponse.ad[].skadn.signature توقيع SKAdNetwork على النحو الذي تحدّده Apple.

متغيرات عروض الأسعار المدمجة والتعريفات والإضافات

NativeRequest

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

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
ver لا سلسلة "1.0" لـ OpenRTB 2.3 و"1.1" لـ OpenRTB 2.4 رقم إصدار "الترميز الأصلي" قيد الاستخدام.
layout لا الرقم التعريفي للتنسيق غير متاح رقم تعريف تنسيق الوحدة الإعلانية المدمجة مع المحتوى. تم اقتراحه من خلال OpenRTB Native 1.0، وهو اختياري في الإصدار 1.1، وسيتم إيقافه.
adunit لا الرقم التعريفي للوحدة الإعلانية غير متاح رقم تعريف الوحدة الإعلانية للوحدة الإعلانية المدمجة مع المحتوى. وهذا يتوافق مع إحدى الوحدات الإعلانية المدمجة مع المحتوى المدمجة مع المحتوى (Core-6) الصادرة عن مكتب الإعلانات التفاعلية (IAB). تم اقتراحه بواسطة الإصدار 1.0 من OpenRTB Native، وهو اختياري في 1.1، وسيتم إيقافه.
context لا نوع السياق غير متاح السياق الذي يظهر فيه الإعلان.
contextsubtype لا نوع السياق الفرعي غير متاح سياق أكثر تفصيلاً يظهر فيه الإعلان.
plcmttype لا نوع الموضع NativeAdTemplate.native_placement_type تصميم/تنسيق/تنسيق الوحدة الإعلانية المعروضة.
plcmtcnt لا int32 غير متاح عدد المواضع المتطابقة في هذا التنسيق.
seq لا int32 غير متاح 0 للإعلان الأول، و1 للإعلان الثاني، وهكذا. وتجدر الإشارة إلى أنه لا يمكن استخدام ذلك بشكل عام مع plcmtcnt - إما أن تكون بصدد المزاد على مواضع متطابقة متعددة (في هذه الحالة plcmtcnt>1, seq=0) أو تعقد مزادات منفصلة لعناصر مختلفة في الخلاصة (في هذه الحالة plcmtcnt=1, seq>=1).
assets لا صفيف Asset من العناصر غير متاح يجب أن يتوافق أي عرض سعر مع مصفوفة العناصر التي تعبّر عنها Exchange. مطلوبة بواسطة مواصفات OpenRTB Native: عنصر واحد على الأقل.
aurlsupport لا bool غير متاح ما إذا كان مصدر التوريد / مرات الظهور يتيح عرض عنوان URL لمادة العرض بدلاً من كائن مادة العرض. 0 أو غياب الحقل يشير إلى عدم توفر هذا الدعم. تم التنفيذ في 1.2
durlsupport لا bool غير متاح تحدّد هذه السمة ما إذا كان مصدر التوريد / الظهور يتيح عرض عنوان URL لـ DCO بدلاً من كائن مادة العرض. 0 أو غياب الحقل يشير إلى عدم توفر هذا الدعم. تم التنفيذ في 1.2. ميزة تجريبية.
eventtrackers لا EventTrackers غير متاح تحدِّد هذه السياسة نوع تتبُّع الأحداث المتوافق. تم التنفيذ في 1.2
privacy لا bool غير متاح اضبط على 1 عندما يدعم الإعلان المدمج مع المحتوى إشعار الخصوصية الخاص بالمشتري. اضبط القيمة على 0 (أو حقل غير متوفر) عندما لا يدعم الإعلان المدمج مع المحتوى روابط الخصوصية المخصصة أو إذا كان الدعم غير معروف. موصى بها وتنفيذها في 1.2. تتوافق جميع الطلبات الأصلية التي نرسلها مع عنوان URL للخصوصية، لذا يكون هذا الرقم "1" ضمنيًا دائمًا للطلبات الأصلية.
ext لا عنصر واحد (NativeRequestExt) غير متاح بالنسبة إلى OpenRTB/Protobuf، يمكنك الوصول إلى هذا الكائن باستخدام مفتاح الإضافة [com.google.doubleclick.native_ext] (يختلف المسار الصحيح استنادًا إلى اللغة المستخدمة لإنشاء مكتبة Proto). بالنسبة إلى OpenRTB/JSON، يمكنك الوصول إلى الحقل ext في رسالة NativeRequest.

NativeRequestExt

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
style_id لا int32 BidRequest.AdSlot.
native_ad_template[0].style_id
تمثّل هذه السمة معرّفًا مختلفًا بشكل عام للنمط المحدّد وHTML وCSS التي يتم عرض الإعلان المدمج مع المحتوى بها.
style_height لا int32 BidRequest.AdSlot.
native_ad_template[0]
.style_height
إذا كانت قيمة style_layout_type هي Pixel، هذا هو ارتفاع الإعلان المدمج مع المحتوى بالكامل بعد العرض.
style_width لا int32 BidRequest.AdSlot.
native_ad_template[0]
.style_width
إذا كانت style_layout_type هي Pixel، يكون هذا هو عرض الإعلان المدمج مع المحتوى بالكامل بعد العرض.
style_layout_type لا نوع تنسيق تعداد BidRequest.AdSlot.
native_ad_template[0]
.style_layout_type
Enum LayoutType:
PIXEL = 0; (تلقائي)
FLUID = 1،

مادة العرض

كائن الحاوية الرئيسي لكل مادة عرض يطلبها أو يدعمها Exchange نيابةً عن عميل العرض. يجب وضع علامة على أي عنصر مطلوب. يجب أن يتوفر كائن واحد فقط من {title,img,video,data} في كل كائن. يجب أن تكون جميع القيم الأخرى فارغة أو غير موجودة. يجب أن تكون السمة id فريدة في مصفوفة Asset بحيث يمكن محاذاة الاستجابة.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
id نعم int32 1.N لمواد العرض N بترتيب غير محدّد، المقابلة للحقول المُقترَحة أو المطلوبة في أول NativeAdTemplate. معرّف مادة العرض الفريد الذي يتم تعيينه من خلال التبادل. العدّاد عادةً للمصفوفة. مطلوبة بواسطة مواصفات OpenRTB Native.
required لا قيمة منطقية BidRequest.AdSlot.native_ad_template[0].
required_fields
اضبط هذه القيمة على "صحيح" إذا كانت مادة العرض مطلوبة.
title لا عنوان الطلب BidRequest.AdSlot.native_ad_template[0] من النوع HEADLINE Title لمادة عرض العناوين.

موصى بها بواسطة مواصفات OpenRTB Native. أحد Title، Image، Data، Video.

img لا طلب صورة BidRequest.AdSlot.native_ad_template[0] من أنواع MAIN/IMAGE، ICON/APP_ICON، LOGO/LOGO Image من مواد عرض الصور.

موصى بها بواسطة مواصفات OpenRTB Native. أحد Title، Image، Data، Video.

video لا حملة فيديو BidRequest.AdSlot.NativeAdTemplate.required_fields Video لمواد عرض الفيديو. تجدر الإشارة إلى أن الإعلانات ضمن بث الفيديو المباشر ليست جزءًا من الإعلانات المدمجة مع المحتوى. وقد تحتوي الإعلانات المدمجة مع المحتوى على فيديو بوصفه تصميم الإعلان نفسه. يمكن أن تشير طلبات عروض الأسعار إلى أن الفيديو مطلوب في NativeResponse من خلال ضبط NativeRequest.assets[].required على true وتحديد NativeRequest.assets[].video. موصى بها بواسطة مواصفات OpenRTB Native. أحد Title، Image، Data، Video.
data لا البيانات BidRequest.AdSlot.native_ad_template[0] من الأنواع CTATEXT/CALL_TO_ACTION، DESC/BODY،

برعاية/معلن، PRICE/PRICE، RATING/STAR_RATING

عنصر واحد (Data) للتقييمات والأسعار وغيرها

موصى بها بواسطة مواصفات OpenRTB Native. أحد Title، Image، Data، Video.

العنوان

ويتعيّن استخدام الكائن Title في عنصر العنوان في الإعلان المدمج مع المحتوى.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
len لا int32 BidRequest.AdSlot.native_ad_template[0].headline_max_safe_length الحد الأقصى لطول النص في عنصر العنوان. يُنصَح بأن تكون القيمة أيًا مما يلي: 25 أو 90 أو 140. مطلوبة بواسطة مواصفات OpenRTB Native.

صورة

ويتم استخدام الكائن Image لعناصر الصورة في الإعلان المدمج مع المحتوى.

غير متاح
السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
type لا نوع مادة عرض الصورة نوع حقل BidRequest.AdSlot.native_ad_template[0] الرقم التعريفي لنوع عنصر الصورة الذي يدعمه الناشر. ويمكن للناشر عرض هذه المعلومات بتنسيق مناسب.
w لا int32 غير متاح عرض الصورة بالبكسل.
h لا int32 غير متاح ارتفاع الصورة بالبكسل.
wmin لا int32 BidRequest.AdSlot.native_ad_template[0] من النوع: MAIN/IMAGE:image_width LOGO/LOGO: logo_width

ICON/APP_ICON: app_icon_width

الحد الأدنى المطلوب لعرض الصورة بالبكسل. يجب استخدام هذا الخيار لأي تغيير في حجم الصور بواسطة البرنامج. يجب إرسال إما w أو wmin. إذا تم تضمين w فقط، يجب اعتباره مطلبًا دقيقًا. موصى بها بواسطة مواصفات OpenRTB Native.
hmin لا int32 BidRequest.AdSlot.native_ad_template[0] من النوع: MAIN/IMAGE:image_height LOGO/LOGO: logo_height ICON/APP_ICON: app_icon_height الحد الأدنى المطلوب لارتفاع الصورة بالبكسل. يجب استخدام هذا الخيار لأي تغيير في حجم الصور بواسطة البرنامج. يجب نقل h أو hmin. إذا تم تضمين h فقط، يجب اعتباره مطلبًا دقيقًا. موصى بها بواسطة مواصفات OpenRTB Native.
mimes لا سلسلة القائمة المسموح بها لأنواع المحتوى MIME المدعومة. تشمل أنواع MIME الرائجة على سبيل المثال لا الحصر "image/jpg" و"image/gif". يجب أن يكون لكل Exchange مُنفَّذ قائمة خاصة به من الأنواع المتوافقة في مستندات الدمج. يمكنك الاطّلاع على صفحة MIME على Wikipedia للحصول على مزيد من المعلومات والروابط لجميع RFC لـ IETF. إذا كانت فارغة، فافترض أن جميع الأنواع مسموح بها.

حملة فيديو

ويتعيّن استخدام الكائن Video في عناصر الفيديو ضمن الإعلان المدمج مع المحتوى.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
mimes نعم مصفوفة سلسلة BidRequest .Video.allowed_video_formats يتم دعم أنواع MIME للمحتوى. وتتضمّن أنواع MIME الرائجة على سبيل المثال لا الحصر "video/x-mswmv" لـ Windows Media و"video/x-flv" لـ Flash Video أو "video/mp4". يُرجى العِلم بأنّ الإعلانات المدمجة مع المحتوى لا تتوافق عادةً مع الفلاش.

مطلوبة بواسطة مواصفات OpenRTB Native: عنصر واحد على الأقل.

minduration نعم int32 عرض السعر.الفيديو.min_ad_duration الحد الأدنى لمدة إعلان الفيديو بالثواني.

مطلوبة بواسطة مواصفات OpenRTB Native.

maxduration نعم int32 عرض السعر.الفيديو.max_ad_duration الحد الأقصى لمدة إعلان الفيديو بالثواني.

مطلوبة بواسطة مواصفات OpenRTB Native.

protocols نعم صفيف Protocol من التعداد BidRequest.Video.protocols مجموعة من بروتوكولات الفيديو التي يمكن للناشر قبولها في استجابة عروض الأسعار.

مطلوبة بواسطة مواصفات OpenRTB Native: عنصر واحد على الأقل.

أمثلة:
VAST_1_0 = 1;
VAST_2_0 = 2;
VAST_3_0 = 3;

البيانات

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

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
type نعم نوع مادة العرض نوع حقل BidRequest.AdSlot.native_ad_template[0] الرقم التعريفي لنوع العنصر الذي يدعمه الناشر. يمكن للناشر عرض هذه المعلومات بتنسيق مناسب. مطلوبة بواسطة مواصفات OpenRTB المدمجة مع المحتوى.
len لا int32 BidRequest.AdSlot.native_ad_template[0] من النوع:

DESC/BODY: body_max_safe_length

عبارة الحث على اتخاذ إجراء/CALL_TO_ACTION: call_to_action_max_safe_length

راعي/معلن: advertiser_max_safe_length

PRICE/PRICE: price_max_safe_length

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

ملاحظة: لا يُستخدم AdX لـ RATING/STAR_RATING، ولكن يلزم 0.5 في AdX

أدوات متابعة الأحداث

يحدد كائن EventTrackers نوع الأحداث التي يمكن أن يطلب نظام عروض الأسعار أن يتم تتبعها في استجابة عرض السعر، وأنواع التتبع المتوفرة لكل نوع حدث، ويتم تضمينه كمصفوفة في الطلب.
السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
event نعم نوع الحدث غير متاح نوع الحدث المتاح للتتبّع. مطلوبة بواسطة مواصفات OpenRTB Native.
methods نعم طريقة تتبع الأحداث غير متاح مصفوفة أنواع التتبع المتاحة للحدث المقدم. مطلوبة بواسطة مواصفات OpenRTB Native.

NativeResponse

كائن الاستجابة المدمجة مع المحتوى هو كائن JSON ذو المستوى الأعلى الذي يحدد استجابة مدمجة مع المحتوى.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
ver لا سلسلة "1.0" لـ OpenRTB 2.3 و"1.1" لـ OpenRTB 2.4 إصدار نسخة الترميز الأصلية المستخدمة.
assets لا مصفوفة مواد العرض BidResponse.Ad.native_ad[0]. يتم ربط جميع مواد العرض بحقول إعلان مدمج مع المحتوى واحد. قائمة بمواد عرض الإعلان المدمج مع المحتوى.
link نعم رابط BidResponse.Ad.native_ad[0] رابط الوجهة.مطلوب من خلال المواصفات الأصلية لـ OpenRTB.
imptrackers لا مصفوفة سلسلة BidResponse.Ad.impression_tracking_url مصفوفة من عناوين URL لتتبع مرات الظهور والتي يُتوقع أن تعرض صورة 1×1 أو استجابة 204 - لا يتم تمريرها عادة إلا عند استخدام برامج تتبع الجهات الخارجية. استخدم %%WINNING_PRICE%% ماكرو أو ${AUCTION_PRICE}.
jstracker لا سلسلة غير متاح أداة تتبُّع مرات الظهور الاختيارية لجافا سكريبت. تحتوي على علامات script ليتم تنفيذها في وقت الظهور حيث يمكن دعمها.
eventtrackers لا صفيف EventTracker من العناصر BidResponse.Ad.impression_tracking_url وBidResponse.Ad.impression_tracking_resource مصفوفة من أدوات تتبع أحداث الاستجابة لتشغيلها مع الإعلان استجابةً للطرق المعتمدة المعلنة في NativeRequest. يحل محل Imptrackers وjstrackers. تم التنفيذ في 1.2.

متتبع الأحداث

استجابة أداة تتبُّع الأحداث عبارة عن مصفوفة من العناصر وتحدّد أنواع الأحداث التي يريد نظام عروض الأسعار تتبّعها وعناوين URL/المعلومات المطلوب تتبّعها. يجب أن يستجيب مقدّم عرض الأسعار فقط بالطرق المُشار إليها في الطلب. يُرجى العِلم بأنّ معظم برامج تتبُّع JavaScript تتوقّع أن يتم تحميلها في وقت الظهور، لذا لا يُنصَح بوجهٍ عام بأنّ المشتري يردّ باستخدام برامج تتبّع JavaScript على أحداث أخرى، ولكن يعود ذلك إلى كل مشترٍ.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
event نعم عدد صحيح غير متاح نوع الحدث المطلوب تتبعه.
method نعم عدد صحيح غير متاح نوع التتبع المطلوب.
url لا ملف نصي BidResponse.Ad.impression_tracking_url وBidResponse.Ad.ImpressionTrackingResource.script_url عنوان URL للصورة أو js. مطلوبة للصورة أو js، اختيارية للمخصّصة.
customdata لا كائن يحتوي على أزواج المفتاح/القيمة. غير متاح للاتفاق بشكل فردي على التبادل، يجب أن تكون مجموعة من كائنات key:value للتتبع المخصص، على سبيل المثال، رقم حساب DSP مع شركة تتبع، على سبيل المثال {"accountnumber":"123"}.
ext لا عنصر واحد (EventTrackerExt) غير متاح بالنسبة إلى OpenRTB/Protobuf، يمكنك الوصول إلى هذا الكائن باستخدام مفتاح الإضافة [com.google.doubleclick.eventtrackers] (يختلف المسار الصحيح استنادًا إلى اللغة المستخدمة لإنشاء مكتبة Proto). بالنسبة إلى OpenRTB/JSON، يمكنك الوصول إلى الحقل ext في رسالة EventTracker.

متتبع الأحداث
السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
context لا مصفوفة سياق تعداد عرض_الاستجابة لـ BidResponse.ImpressionTrackingResourceالسياق. تم توفير سياق إضافي للعرض.
غير معروف = 0؛
OMID = 1؛ غير متاح حاليًا.
verification_parameters لا سلسلة BidResponse.Ad.ImpressionTrackingResource.verification_parameters المعلّمات المرتبطة بالمورد التي سيتم تمريرها إلى المورد عند تحميله. ويعتمد تنسيق المعلَمات على مورّد النص البرمجي.
vendor_key لا سلسلة BidResponse.Ad.ImpressionTrackingResource.vendor_key يُستخدم للتعريف عن مزوّد النص البرمجي للتحقُّق.

تُستخدم لمواد عرض "الحث على اتخاذ إجراء"، أو لروابط أخرى من الإعلان المدمج مع المحتوى. ويجب إقران هذا الكائن بكائن نظير في الكائن الرئيسي Asset. عند تنشيط كائن النظير (نقر عليه)، من المفترض أن ينقل الإجراء المستخدم إلى موقع الرابط.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
url لا سلسلة BidResponse.ad[].native_ad.click_link_url عنوان URL المقصود للرابط القابل للنقر.
clicktrackers لا مصفوفة سلسلة (NativeResponse.link) BidResponse.Ad.NativeAd.click_tracking_url[0] عناوين URL للتتبع التابعة لجهة خارجية والتي سيتم تنشيطها عند النقر على عنوان URL. تعيد أدوات تتبُّع النقرات من Google إعادة توجيه HTTP 30x إلى أداة تتبُّع عروض الأسعار. يُسمح بتعدد أدوات النقر.
fallback لا سلسلة غير متاح عنوان URL الاحتياطي للرابط لموضع معيّن. للاستخدام إذا كان عنوان URL المقدم في url غير متوافق مع الجهاز.

مادة العرض

يتطابق مع الكائن Asset في الطلب. كائن الحاوية الرئيسي لكل مادة عرض يطلبها أو يدعمها Exchange نيابة عن عميل العرض. ويجب وضع علامة على أي عنصر مطلوب. يجب أن يكون هناك عنصر واحد فقط من الكائنات {title,img,video,data} في كل كائن. ويجب أن تكون جميع القيم الأخرى فارغة أو غير موجودة. يجب أن يكون المعرّف فريدًا داخل مصفوفة مواد العرض حتى يمكن محاذاة الاستجابة.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
id نعم int32 غير متاح يجب أن يتطابق معرّف مادة العرض الفريد الذي تم تعيينه من خلال التبادل مع أحد معرّفات مواد العرض في الطلب

مطلوبة بواسطة مواصفات OpenRTB Native.

required لا قيمة منطقية غير متاح اضبط القيمة على 1 إذا كانت مادة العرض مطلوبة. (يجب تقديم عرض السعر)
title لا العنوان AdX: BidResponse.Ad.native_ad[0] / العنوان أحد Title، Image، Data، Video

كائن العنوان لمواد عرض العناوين.

img لا صورة BidResponse.Ad.native_ad[0] / IMAGE|LOGO|APP_ICON أحد Title، Image، Data، Video

Image من مواد عرض الصور.

video لا حملة فيديو BidResponse.Ad.NativeAd.video_url أو BidResponse.Ad.NativeAd.video_vast_xml

يمكن أن يكون سلسلة تحتوي على VAST XML أو عنوان URL لمستند VAST من خلال السمة NativeResponse.assets[].video.vasttag.

Video لمواد عرض الفيديو. تجدر الإشارة إلى أن الإعلانات ضمن بث الفيديو المباشر ليست جزءًا من "الإعلانات المدمجة مع المحتوى". وقد تحتوي الإعلانات المدمجة مع المحتوى على فيديو بوصفه تصميم الإعلان نفسه.

data لا البيانات BidResponse.Ad.native_ad[0] /
BODY|CALL_TO_ACTION|ADVERTISER|STAR_RATING_PRICE_STORE
أحد Title، Image، Data، Video.

عنصر Data للتقييمات والأسعار وغيرها

link لا رابط BidResponse.Ad.native_ad[0] ربط كائن للحث على اتخاذ إجراء. ويتم ربط هذا الرابط بالحقل الآخر المعبأ داخل الكائن.

العنوان

يتطابق مع الكائن Title في الطلب، مع ملء القيمة.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
text نعم سلسلة BidResponse.Ad_native_ad[0].headline النص المرتبط بعنصر النص. مطلوبة بموجب مواصفات OpenRTB Native

صورة

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

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
url نعم سلسلة BidResponse.Ad.native_ad[0] لنوع طلب مادة العرض:

الرئيسي/IMAGE: image.url

ICON/APP_ICON: app_icon.url

الشعار/الشعار: logo.url

عنوان URL لمادة عرض الصورة. مطلوبة بواسطة مواصفات OpenRTB Native.
w لا int32 BidResponse.Ad.native_ad[0] لنوع طلب مادة العرض:

الرئيسي/IMAGE: image.url

ICON/APP_ICON: app_icon.url

الشعار/الشعار: logo.url

عرض الصورة بالبكسل. مقترح بواسطة مواصفات OpenRTB Native.
h لا int32 BidResponse.Ad.native_ad[0] لنوع طلب مادة العرض:

الرئيسي/IMAGE: image.url

ICON/APP_ICON: app_icon.url

الشعار/الشعار: logo.url

ارتفاع الصورة بالبكسل.

حملة فيديو

يتطابق مع الكائن Video في الطلب، ولكنه يحتوي على قيمة لعلامة VAST مطابقة كقيمة.

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
vasttag نعم سلسلة غير متاح VAST xml. مطلوبة بواسطة مواصفات OpenRTB Native.

البيانات

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

السمة يتم اجتياز الاختبار دائمًا النوع ما يعادل شراة معتمدين تفاصيل التنفيذ
label لا سلسلة غير متاح اسم السلسلة المنسَّقة لنوع البيانات المطلوب عرضها.
value نعم سلسلة BidResponse.Ad.native_ad[0] لنوع مادة عرض الطلب OpenRTB/AdX:

عبارة الحث على اتخاذ إجراء/CALL_TO_ACTION: عبارة الحث على اتخاذ إجراء

DESC/BODY: النص

راعي/معلن: معلن

PRICE/PRICE: السعر

RATING/STAR_RATING: Star_rating (يتطلب AdX مضاعفة القيمة 0.5)

سلسلة البيانات المنسقة المراد عرضها. ويمكن أن تحتوي على قيمة منسَّقة مثل "5 نجوم" أو "10 دولارات أمريكية" أو "3.4 نجوم من 5". مطلوبة بواسطة مواصفات OpenRTB المدمجة مع المحتوى.

أمثلة