دمج OpenRTB

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

لمزيد من المعلومات عن نماذج OpenRTB Proto، اطّلِع على ملف ProRTB Proto. للاطّلاع على إضافات "الشراة المعتمَدون"، يُرجى الرجوع إلى ملف OpenRTB Extensions Protocol Buffer file.

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

  • تنسيق JSON
  • Protobuf: يمكن الإشارة إلى ملف تعريف .proto لفك ترميز الرسائل.

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

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

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

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

يُرجى أيضًا ملاحظة ما يلي:

  • الحقل cid هو معرّف الفوترة المحدّد في إعداد الاستهداف المسبق. ويُستخدم هذا الحقل لربط عرض السعر بـ billing_id الذي تم إرساله في طلب عرض السعر. إذا كان الطلب يتضمّن أكثر من cid/billing_id أو إذا كان لديك مقاعد نشِطة، عليك تحديد القيمة cid المقصودة في ردّك. وإذا لم يكن هناك أكثر من طلب واحد ولم يكن لديك أي مقاعد أطفال نشطة، تكون هذه هي القيمة التي سيتم افتراضها في الرد.
  • وتسمية التسمية في الأقسام أدناه OpenRTB للبساطة.
  • ستتم تعبئة كل الحقول في الطلب في حال توفّره. ولن نمرّر أبدًا قيمًا فارغة أو سلاسل فارغة.
  • لا يتم تضمين الأنواع والأوصاف من OpenRTB في الجداول أدناه. يمكنك الرجوع إلى ملف ProRTB Proto.
  • في طلبات عروض الأسعار بترميز JSON، سيتم إرسال جميع الحقول المكتوبة int64 أوFix64 أدناه كسلاسل لمنع فقدان الدقة لقيم 64 بت متكاملة.
  • يمثّل بروتوكول JSONRTB 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 أكثر فعالية من حيث معدل نقل البيانات والمعالجة، لذا ننصح به. نقل البيانات إلى Protobuf هو أمر بسيط لأن كلا التنسيقين يحتويان على حقول مطابقة.

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

دعم نموذج عرض إعلانات الفيديو والفيديو

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

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

السمة نجاح دائم Type تمثّل هذه السمة
المشترِون
المكافئون 		متاح تفاصيل التنفيذ
في الإصدار من Google
id نعم سلسلة BidRequest.id 2.3
2.4
2.5

معرّف فريد لطلب عرض السعر، يتم تقديمه من خلال تبادل الإعلانات

OpenRTB هو websafe Base64 (بدون مساحة متروكة).
imp نعم مصفوفة من كائنات Imp BidRequest.AdSlot 2.3
2.4
2.5

تمثيل مرات الظهور المعروضة

يجب إدخال عنصر Imp واحد على الأقل.
site غير متوافق عنصر Site طلب عرض السعر 2.3
2.4
2.5

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

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

ميزة واحدة مع app.
app غير متوافق عنصر App BidRequest
BiddingRequest.Mobile 		2.3
2.4
2.5

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

(تطبيقات غير متوافقة مع المتصفِّح). لا يسري إلا على التطبيقات.

ميزة واحدة مع site.
device غير متوافق عنصر Device BidRequest.Mobile وBRequestRequest.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 = السعر الثاني زائد.

يمكن تحديد أنواع المزاد الخاصة بخدمة Exchange باستخدام القيم التي تزيد عن 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. الرجوع إلى تعداد ContentCategory
badv غير متوافق مصفوفة سلسلة غير متاح 2.3
2.4
2.5

حظر قائمة المعلِنين حسب نطاقاتهم (مثل "addomain.com")
bapp غير متوافق مصفوفة سلسلة BidRequest.AdSlot.excluded_app_id 2.4
2.5
احظر قائمة التطبيقات حسب معرّفات التطبيقات المستقلة عن منصة معيّنة. في نظام التشغيل Android، يجب أن تكون هذه الملفات عبارة عن أسماء حِزم أو حِزم (على سبيل المثال، com.foo.mygame). في نظام التشغيل iOS، هذه أرقام تعريف رقمية.
test غير متوافق قيمة منطقية BidRequest.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.

ترتيب عرض السعر

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

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
bid_feedback غير متوافق مصفوفة من كائنات BidFeedback RequestRequest.bid_response_feedback ملاحظات حول عروض الأسعار التي تم إرسالها في الردود السابقة. يتم ضبط هذا الإعداد فقط في حال تفعيل الملاحظات في الوقت الفعلي لمقدّم عرض الأسعار. يُرجى التواصل مع مدير حسابك في حال أردت تفعيل الملاحظات في الوقت الفعلي.
google_query_id غير متوافق سلسلة BidRequest.google_query_id وهو يمثّل معرّفًا فريدًا لطلب البحث بشكل عام. في حال توفُّر عدة وسائل شرح لطلب بحث معيّن، ستحتوي جميع طلبات وسائل الشرح لطلب البحث هذا على معرّف google_query_id نفسه.
fcap_scope نعم تعداد واحد (FrequencyCappingScope) BidRequest.AdSlot.التكرارCappingScope

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

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

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
request_id غير متوافق سلسلة BidRequest.BiddingResponseملاحظات.request_id. المعرّف الفريد من BidRequest.id.
creative_status_code غير متوافق int32 BidRequest:BiddingResponsefeedback.creative_status_code رمز الحالة للإعلان. اطّلِع على رموز حالة المواد الإبداعية على صفحة Proto & Reference Data (البيانات الأولية والبيانات المرجعية) للحصول على قائمة بالمعرّفات.
price غير متوافق مزدوج BidRequest.BiddingResponsefeedback.CPM_micros وإذا فاز عرض السعر بالمزاد، هذا هو السعر المدفوع بعملة حسابك. وإذا شارك عرض السعر في المزاد ولكنه كان خارج عرض السعر، تكون هذه هي التكلفة لكل ألف ظهور التي يجب تجاوزها لتحقيق الفوز. ولا يتم تحديد هذه السمة إذا تمت فلترة عرض السعر قبل المزاد، أو إذا أوقف الناشر أو مقدّم عرض السعر الفائز الملاحظات بشأن السعر أو إذا أوقف حسابك مشاركة الأسعار الفائزة مع أنظمة عروض الأسعار الأخرى. بالنسبة إلى مزادات السعر الأول، يتمّ تعبئة الحدّ الأدنى_للعرض_إلى_البدلاً من هذا الحقل.
minimum_bid_to_win غير متوافق مزدوج BidRequest.BiddingResponsefeedback.Minimum_bid_to_win الحد الأدنى لقيمة عرض السعر اللازم للفوز بالمزاد بعملة حسابك. وإذا فاز عرض سعرك بالمزاد، هذا هو ثاني أعلى عرض سعر لم تتم فلترته (بما في ذلك السعر الأدنى). وإذا لم يفز عرض سعرك بالمزاد، سيكون هذا هو عرض السعر الفائز للمرشح. ولن تتم تعبئة هذا الحقل إلا إذا شارك عرض سعرك في مزاد السعر الأول، ولن تتم تعبئته في حال فلترة عرض أسعارك قبل المزاد.
sampled_mediation_cpm_ahead_of_auction_winner غير متوافق مزدوج BidRequest.BiddingResponsefeedback.sampled_توس_CPM_ahead_of_auction_winner عندما يستخدم الناشر مزادًا مستندًا إلى عرض الأسعار في الوقت الفعلي (RTB) وتوسّط حزمة تطوير البرامج (SDK) المستند إلى العرض الإعلاني بدون انقطاع في طلب البحث نفسه، يجب أن يفوز أيضًا الفائز في المزاد في الوقت الفعلي في تدفق العرض الإعلاني بدون انقطاع (الذي يتم ترتيبه حسب السعر) للحصول على مرة الظهور. إذا شارك عرض السعر في المزاد ولم يكن هناك أي تدفق، ستكون قيمة هذا الحقل 0. إذا شارك عرض السعر في المزاد وكان هناك عرض إعلاني بدون انقطاع، ستكون قيمة هذا الحقل سعرًا يمثل نموذج عرض سعر من شبكات التوسط المؤهلة التي كانت أعلى من الفائز في المزاد، بالاستناد إلى معدل التعبئة المتوقع. ويمكن استخدام هذا الحقل مع الحدّ الأدنى_للعرض_المطلوب_لتدريب نماذج عروض الأسعار. يتم استخدام التكلفة لكل ألف ظهور بعملة حسابك.
event_notification_token غير متوافق عنصر EventNotificationToken BidRequest:BiddingResponsefeedback.event_notifications_token الرمز المميّز المضمّن في عرض السعر المقابل
buyer_creative_id غير متوافق سلسلة BidRequest:BiddingResponsefeedback.buyer_creative_id رقم تعريف تصميم الإعلان المضمّن في عرض السعر المقابل
الرمز المميز للإشعارات

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

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
event_notification_token.payload غير متوافق سلسلة BidRequest:BiddingResponsefeedback.event_notifications_token محتوى الرمز المميّز
عنصر معالجة الخصوصية
أحد الوالدَين

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

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

السمة نجاح دائم Type تمثّل هذه السمة
المشترِون
المكافئون 		متاح تفاصيل التنفيذ
في الإصدار من 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 في الرسالة المصدر.
schain غير متوافق عنصر SupplyChain BidRequest.supply_chain 2.3
2.4
2.5

كائن OpenRTB RetailChain. وللحصول على مزيد من المعلومات، يُرجى الاطّلاع على هذه المقالة.

مصدر المصدر

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
omidpn غير متوافق سلسلة BidRequest.AdSlot.omidpn معرِّف دمج حزمة تطوير البرامج (SDK) في OM. لمزيد من المعلومات، يُرجى الاطّلاع على تلقّي تنبيهات OpenRTB لحزمة SDK للقياس.
omidpv غير متوافق سلسلة BidRequest.AdSlot.omidpv إصدار عملية دمج OM SDK. لمزيد من المعلومات، يُرجى الاطّلاع على تلقّي تنبيهات OpenRTB لحزمة SDK للقياس.
schain غير متوافق عنصر SupplyChain BidRequest.supply_chain تم إيقاف هذا الحقل نهائيًا لصالح BidRequest.source.schain، وستتم إزالته في كانون الأول (ديسمبر) 2023. يحتوي هذا الحقل على عنصر OpenRTB SavingChain. ولمزيد من المعلومات، يمكنك الاطّلاع على هذه المقالة.
سلسلة الإمداد

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

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

شيطان

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

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

السمة نجاح دائم Type معتمَدالمشترون متاح تفاصيل التنفيذ
في الإصدار من 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 VideoRequest
.AdSlot
BiddingRequest
.Video		 2.3
2.4
2.5

مطلوبة إذا تم تقديم مرة الظهور هذه كفرصة لإعلانات الفيديو.
audio غير متوافق عنصر Audio VideoRequest
.AdSlot
BiddingRequest
.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(عرض_الطلبات)
.AdSlot.
المطابقة
_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 على أجهزة iOS 9.x تُعتبر متصفِّحًا أصليًا لأغراض هذه السمة.
secure غير متوافق قيمة منطقية BidRequest
.ad_slot
.excluded_attribute
48:RichMedia
CapabilityNotSSL		 2.3
2.4
2.5

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

مصفوفة من الأسماء الخاصة بالتبادل لمحاذاة بيانات إطار iframe المتوافقة.
pmp غير متوافق عنصر Pmp RequestRequest
.AdSlot
.matchingAdData		 2.3
2.4
2.5

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

ويكون العنصر Native مطلوبًا إذا تم عرض مرة الظهور هذه كفرصة للإعلان مع المحتوى.
exp غير متوافق int32 BidRequest
.AdSlot
.impression_expiration
_seconds		 2.4
2.5
تنبيه بشأن عدد الثواني التي قد تنجم بين المزاد ومرة الظهور الفعلية
metric غير متوافق مصفوفة من كائنات Metric BidRequest
.AdSlot
.viewability
BiddingRequest
.AdSlot
.click_through
_rate

BidRequest
.AdSlot
.video_complete
_rate
BiddingRequest
.AdSlot
.session_depth 		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.
rwdd غير متوافق قيمة منطقية BidRequest.AdSlot.is_rewarded 2.6 يشير إلى ما إذا كان المستخدم قد تلقّى مكافأة مقابل مشاهدة الإعلان. بالنسبة إلى إعلانات الفيديو، تتيح عمليات التنفيذ المعتادة للمستخدمين قراءة مقالة إخبارية إضافية مجانًا، أو التعرّف على حياة إضافية في اللعبة، أو حضور جلسة موسيقية دعائية بلا إعلانات. وعادةً ما يتم توزيع المكافأة بعد اكتمال إعلان الفيديو.

إمبكس

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
billing_id نعم مصفوفة int64 BidRequest.AdSlot.تطابق المطابقةAdData.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.ExchangeBidding.publisher_PARAM سلاسل UTF8 التي يقدّمها الناشر اختياريًا كجزء من إعدادات مجموعة المطابقة المطابقة في واجهة مستخدم "مدير الإعلانات" ويكون هذا الشكل عشوائيًا ويجب أن يوافق عليه الناشر ومقدّم عروض الأسعار "الشراة المعتمَدون".
dfp_ad_unit_code غير متوافق سلسلة BidRequest.AdSlot.sdk_ad_unit_code رمز الوحدة الإعلانية في "مدير إعلانات Google". تتوفّر هذه الميزة حاليًا لطلبات "عروض الأسعار المفتوحة" فقط.
is_rewarded_inventory غير متوافق قيمة منطقية BidRequest.AdSlot.is_reward تم إيقاف هذا الحقل نهائيًا لصالح BidRequest.imp.rwdd، وستتم إزالته في تموز (يوليو) 2023. يشير هذا الحقل إلى ما إذا كان المستخدم قد حصل على مكافأة مقابل مشاهدة الإعلان. بالنسبة إلى إعلانات الفيديو، تتيح عمليات التنفيذ المعتادة للمستخدمين قراءة مقالة إخبارية إضافية مجانًا، أو التعرّف على حياة إضافية في اللعبة، أو حضور جلسة موسيقية دعائية بلا إعلانات. وعادةً ما يتم توزيع المكافأة بعد اكتمال إعلان الفيديو.
is_app_open_ad غير متوافق قيمة منطقية BidRequest.Mobile is_app_open_ad يشير إلى ما إذا كان طلب عرض سعر التطبيق المتوافق مع الأجهزة الجوّالة لإعلان على شاشة فتح التطبيق. اطّلِع على إرشادات الإعلانات على شاشة فتح التطبيق لمزيد من المعلومات.
ampad غير متوافق EmpAdRequirementType من Enum 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_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 المعلّمات ذات الصلة بعروض الأسعار المفتوحة
ad_unit_mapping غير متوافق عنصر AdUnitMapping BidRequest.AdSlot.ad_unit_mapping تعيينات الوحدات الإعلانية التي تتطابق مع الشريحة الإعلانية المحددة
allowed_restricted_category غير متوافق int32 BidRequest.AdSlot.allowed_restricted_category فئات الإعلانات المحظورة المسموح بها. يمكنك الاطّلاع على ad-restricted-category.txt للحصول على قائمة بالمعرّفات.
skadn غير متوافق SKAdNetworkRequest الكائن BidRequest.Mobileskadn معلومات SKAdNetwork الخاصة بالناشرين لإتاحة إحالة عمليات تثبيت التطبيقات إلى الإصدار 14 من نظام التشغيل iOS والإصدارات الأحدث. تساعد واجهة برمجة تطبيقات SKAdNetwork من Apple المعلِنين في قياس تثبيت التطبيقات المستندة إلى الإعلانات من خلال إرسال الإبلاغ عن الإحالات الناجحة إلى شبكة المواقع الإعلانية بعد إتمام التثبيت بنجاح. سيحتاج الناشرون إلى إعداد شبكات المواقع الإعلانية المتوافقة في قائمة المواقع الخاصة بتطبيقهم (Info.plist) للسماح بتثبيت التثبيت من خلال مرة ظهور الإعلان. لمزيد من المعلومات، يمكنك الاطّلاع على مستندات Apple.
تصميم الإعلان المستبعَد
buyer_creative_id غير متوافق سلسلة BidRequest.AdSlot.استثناء تصميم الإعلان.buyer_creative_id رقم تعريف تصميم الإعلان للمشتري في تصميم الإعلان غير المسموح به.
بيانات شراء المشتري
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.OpenBidding.is_open_bidding يتم ضبط هذا الحقل على "صحيح" إذا أعد الناشر مجموعة نتائج أو مجموعة توسّط تستهدف هذا الإعلان ومع نظام عروض الأسعار هذا. انتقِل إلى مركز المساعدة للحصول على معلومات عن عروض الأسعار المفتوحة وتأثيراتها في عملية عروض الأسعار.
ربط الوحدات الإعلانية
Keyval غير متوافق عنصر Keyval BidRequest.AdSlot.AdUnitMapping. يُستخدَم زوج المفتاح/القيمة لتحديد وحدة المستودع في مساحة اسم نظام عروض الأسعار.
FormatType غير متوافق تعداد BidRequest.AdSlot.AdUnitMapping.format_type أشكال الوحدات الإعلانية المحتملة التي يمكن استخدامها في عملية الربط. يتطابق مع المحوِّل الذي سيتم استخدامه على حزمة تطوير البرامج (SDK).

القيم المتاحة:

  • FORMAT_UNKNOWN = 0;
  • عرض إعلانات بانر لتطبيقات الويب أو الأجهزة الجوّالة على سبيل المثال، فتحة مقاس ليدربورد 320×50. ويشمل ذلك الفيديو خارج البث المباشر.

    FORMAT_BANNER = 1;

  • إعلان بملء الشاشة يتم عرضه داخل تطبيق متوافق مع الأجهزة الجوّالة.

    FORMAT_INTERSTITIAL = 2;

  • إعلانات فيديو أو إعلانات مخصّصة للويب أو للأجهزة الجوّالة تتطابق مع تجربة المستخدم المتعلّقة بالموقع الإلكتروني أو التطبيق الذي تم وضع الإعلانات فيه

    FORMAT_NATIVE = 3;

  • إعلانات الفيديو التي تظهر قبل بث محتوى الفيديو أو أثناءه أو بعده.

    FORMAT_VIDEO_VAST = 4;

  • إعلانات فيديو للتطبيقات المتوافقة مع الأجهزة الجوّالة تسمح للمستخدمين بمشاهدة إعلان طوعًا مقابل الحصول على مكافأة داخل التطبيق

    FORMAT_REWARDED = 5;

  • الإعلانات البينية التي تسمح للمستخدمين بمشاهدة إعلان مقابل الحصول على مكافأة داخل التطبيق لا يتطلب التفعيل. https://support.google.com/admanager/answer/7386053

    FORMAT_REWARDED_INTERSTITIAL = 6;

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

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

يمكن تحديد عدة أزواج من المفاتيح والقيم لمساعدة أنظمة عروض الأسعار التي تتضمّن مساحة لوحدة المستودع الهرمي تتضمّن معرّفات متعددة. يجب إعادة أزواج المفتاح/القيمة لـ AdUnitMapping التي تم اختيارها في استجابة عرض السعر على النحو التالي: BidResponse.seatbid.bid.ext.sdk_rendered_ad.sdk_params. يتم تمرير ذلك إلى حزمة تطوير البرامج (SDK) الخاصة بنظام عروض الأسعار.

السمة Type نجاح دائم مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
key سلسلة غير متوافق BidRequest.AdSlot.AdUnitMapping.مفتاح. والمفتاح هو اسم معرّف وحدة المستودع لنظام عروض الأسعار الخاص بحزمة تطوير البرامج (SDK).
value سلسلة غير متوافق BidRequest.AdSlot.AdUnitMapping.keyval.value قيمة رقم تعريف وحدة مستودع نظام عروض الأسعار للشكل المحدد.

المقياس

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

السمة نجاح دائم Type تمثّل هذه السمة
المشترِون
المكافئون 		متاح تفاصيل التنفيذ
في الإصدار من Google
type غير متوافق سلسلة أحد الخيارين التاليين:
BidRequest
.AdSlot
.viewability

BiddingRequest
.AdSlot
.click_
through_rate

BidRequest
.AdSlot
.video_
complete_rate

BidRequest
.AdSlot
.session_depth 		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 داخل الفيديو لوصف الإعلانات المصاحبة الاختيارية المحدّدة في مواصفات نموذج عرض إعلانات الفيديو.

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

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" متاح تفاصيل التنفيذ
في الإصدار من 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
BiddingRequest.StickySettings 		2.3
2.4
2.5

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

لا يمكن إدخال سوى قيمة واحدة في 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 غير متوافق مصفوفة من BannerAdType غير متاح 2.5 أنواع إعلانات البانر المحظورة

أمثلة:
XHTML_TEXT_AD = 1; // "Usuly mobile".
XHTML_BANNER_AD = 2; // "Usuly mobile".
JAVASCRIPT_AD = 3؛ // يجب أن تكون لغة JavaScript صالحة بتنسيق 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: BiddingRequest.Video.companionad.creative_format
BiddingRequest.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 غير متوافق قيمة منطقية BidRequest.Video.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

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

التنسيق

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

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" متاح تفاصيل التنفيذ
في الإصدار من Google
w غير متوافق int32 BidRequest.AdSlot.width 2.4
2.5
العرض بوحدات البكسل المستقلة للجهاز (DIPS).
h غير متوافق int32 BidRequest.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 للحصول على تفاصيل إضافية.

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" الإصدار متوافق مع 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 BidRequest.Video.min_ad_duration 2.3
2.4
2.5

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

موصى بها وفقًا لمواصفات OpenRTB.
maxduration غير متوافق int32 BidRequest.Video.max_ad_duration 2.3
2.4
2.5

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

موصى بها وفقًا لمواصفات OpenRTB.
protocols غير متوافق مصفوفة من كائنات Protocol BidRequest.Video.protocol 2.3
2.4
2.5

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

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

أمثلة:
نموذج عرض إعلانات الفيديو (VA_1_0) = 1؛
نموذج عرض إعلانات الفيديو (VA_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 BidRequest.Video.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 غير متوافق مصفوفة
المواد الإبداعية		 BidRequest.AdSlot.excluded_attribute 2.3
2.4
2.5

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

الحد الأقصى لمدة إعلان الفيديو الموسّع، إذا كانت الإضافة مسموح بها. إذا كانت القيمة فارغة أو 0، لا يُسمح باستخدام الإضافة. إذا كانت القيمة هي -1، يُسمح بالتمديد، ولا يتم فرض حدّ زمني. وإذا كانت القيمة أعلى من 0، تمثّل القيمة عدد الثواني الناتجة عن التشغيل الموسّع المتوافق مع القيمة القصوى للمدة.
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 في نافذة بنسبة 16:9، حيث لا يتوفّر العدد 0 = لا، 1 = نعم.
التلقائي = صحيح
playbackmethod غير متوافق صفيف
طريقة التشغيل		 BidRequest.Video.playback_method

AdX:
VideoVideoMethod.AUTO_PLAY_voice_ON
VideoPlaybackMethod.AUTO_PLAY_voice_off
VideoVideoMethod.CLICK_TO_PLAY
VideoVideoMethod.MOUSE_OVER
VideoPlaybackMethod.ENTER_voice_ON
VideoVideoMethod.ENTER_voice_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 أيضًا كعناصر فرعية من هذه الأنواع. ومع ذلك، يجب أن يتوافق أي عرض سعر محدد لمرات الظهور مع أحد الأنواع المعروضة.

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" متاح تفاصيل التنفيذ
في الإصدار من Google
mimes غير متوافق مصفوفة سلسلة BidRequest.Video.allowed_video_formats, BiddingRequest.AdSlot.excluded_attribute / VPAID 2.4
2.5
أنواع MIME للمحتوى المتوافقة (على سبيل المثال، "audio/mp4")

مطلوبة بمواصفات OpenRTB: عنصر واحد على الأقل.
minduration غير متوافق int32 BidRequest.Video.min_ad_duration 2.4
2.5
الحد الأدنى لمدة إعلان الفيديو بالثواني.

موصى بها وفقًا لمواصفات OpenRTB.
maxduration غير متوافق int32 BidRequest.Video.max_ad_duration 2.4
2.5
الحد الأقصى لمدة إعلان الفيديو بالثواني.

موصى بها وفقًا لمواصفات OpenRTB.
protocols غير متوافق مصفوفة من كائنات Protocol BidRequest.Video.protocol 2.4
2.5
مجموعة من بروتوكولات استجابة عروض الأسعار للفيديو المتوافقة. يجب تحديد بروتوكول متوافق واحد على الأقل.

أمثلة:
DAAST_1_0 = 9؛
DAAST_1_0_WRAPPER = 10؛
startdelay غير متوافق int32 BidRequest.Video.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). وبالتالي، يجب أن تكون الردود منظَّمة جيدًا لمنح الناشر دقّة دقيقة في عملية العرض.

وتجدر الإشارة إلى أن الإصدار 1.1 من Native متوافق مع الإصدارات 2.4 وOpenRTB 2.5.

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

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

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" متاح تفاصيل التنفيذ
في الإصدار من Google
request غير متوافق سلسلة BidRequest.AdSlot.NativeAdنموذج 2.3
2.4
2.5

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

يجب استخدام معرّف واحد من {request, request_native} على وجه التحديد.
request_native غير متوافق طلب محلي BidRequest.AdSlot.NativeAdنموذج 2.3
2.4
2.5

طلب حمولة تتوافق مع مواصفات الإعلانات المدمجة مع المحتوى يجب استخدام حقل واحد من {request, request_original} بالضبط، وهو حقل بديل يُفضَّل به تسلسل 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.

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" متاح تفاصيل التنفيذ
في الإصدار من Google
private_auction غير متوافق قيمة منطقية BidRequest.AdSlot.only_deal_bids_Acceptd 2.3
2.4
2.5

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

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

صفقة

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

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" متاح تفاصيل التنفيذ
في الإصدار من Google
id نعم سلسلة BidRequest.AdSlot.تطابقAdData.DirectDeal.direct_deal_id 2.3
2.4
2.5

هو معرّف فريد للصفقة المباشرة. مطلوبة لمواصفات OpenRTB.
bidfloor غير متوافق مزدوج BidRequest.AdSlot.تطابقAdData.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 مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
deal_type غير متوافق نوع الصفقة Enum BidRequest.AdSlot.تطابق المطابقةAdData.DirectDeal.deal_type نوع الصفقة يُرجى العِلم أنّ إلغاء سياسة "الشراة المعتمَدون" ينطبق على جميع عروض الأسعار الآلية المضمونة والصفقات المفضّلة، ولا ينطبق على عروض الأسعار لأنواع الصفقات الأخرى.

UNKNOWN_DEAL_TYPE = 0؛ تلقائي.

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

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

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

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

MARKETPLACE_PACKAGE = 5، رقم تعريف الصفقة لحِزم المستودع الذي ينظّمه الناشر. يتم إرسال أرقام تعريف الصفقات هذه تلقائيًا إلى أي مشترٍ مؤهل للحزمة. راجِع هذه المقالة للحصول على مزيد من المعلومات.

must_bid غير متوافق قيمة منطقية BidRequest.AdSlot.تطابق AdData.DirectDeal.Must_bid لا ينطبق هذا الحقل إلا على الصفقات الآلية المضمونة. ويُسمح للمشتري بتخطّي عروض الأسعار لمرات الظهور إذا كان هذا الحقل غير صحيح. وإذا كانت صحيحة، يُطلب من المشتري تقديم عروض أسعار لهذه الصفقة مقابل فرصة ظهور الإعلان هذه. وسيتم ملء هذا الحقل دائمًا بتنسيق أسلاك JSON. الخيار التلقائي = صحيح.
publisher_blocks_overridden غير متوافق قيمة منطقية BidRequest.AdSlot.VoiceingAdData.DirectDeal.publisher_blocks_Override ما إذا كان الناشر قد إعفاء هذه الصفقة من الوحدات الأساسية التي تم ضبطها. ولا تلغي هذه الإعدادات سياسات "الشراة المعتمَدون" أو قرارات "مركز مراجعة الإعلانات". راجِع هذه المقالة للحصول على مزيد من المعلومات.
creative_source غير متوافق Enum CreativeSourceType BidRequest.AdSlot.المطابقة المطابقةAdData.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. هذه الميزة غير متاحة حاليًا لمقدمي عروض الأسعار في الوقت الفعلي.

الموقع

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

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" متاح تفاصيل التنفيذ
في الإصدار من 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 غير متوافق سلسلة BidRequest.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 في رسالة Site.

SiteExt

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
amp غير متوافق EnumPage AmpPage BidRequest.AdSlot
.is_amp_page

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

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

DIALECT_HTML_AMP = 1، هذه صفحة AMP.
page_visibility غير متوافق حالة الرؤية Enum BidRequest.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.
inventorypartnerdomain غير متوافق سلسلة BidRequest.inventorypartnerdomain نطاق الشريك (مالك التطبيق) الذي يمتلك جزءًا من مستودع الإعلانات على التطبيق. ستتم استضافة ملف ads.txt أو app-ads.txt للشريك هنا. يمكنك الاطّلاع على مزيد من التفاصيل على الرابط http://iabtechlab.com/wp-content/uploads/2021/03/ctv-app-ads-explainer-guide.pdf

التطبيق

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

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" متاح تفاصيل التنفيذ
في الإصدار من Google
id غير متوافق سلسلة غير متاح 2.3
2.4
2.5

رقم تعريف التطبيق في عملية التبادل موصى بها وفقًا لمواصفات OpenRTB.
name غير متوافق سلسلة BidRequest.Mobile.app_name 2.3
2.4
2.5

اسم التطبيق (يمكن أن يكون مستعارًا بناءً على طلب الناشر)
domain غير متوافق سلسلة غير متاح 2.3
2.4
2.5		 نطاق التطبيق المستخدَم للحظر من جانب المعلن. على سبيل المثال، "mygame.foo.com".
cat غير متوافق مصفوفة سلسلة BidRequest.Mobile.app_category_id 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 غير متوافق سلسلة BidRequest.Mobile.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 غير متوافق سلسلة BidRequest.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 في رسالة App.

تنسيق AppExt

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
installed_sdk غير متوافق تم تثبيت التطبيق BidRequest.Mobile.install_sdk تمثّل هذه السمة معرِّفًا ومعلومات عن حزمة تطوير برامج (SDK) مثبَّتة في تطبيق الناشر ويمكن لنظام عروض الأسعار الوصول إليها، وغالبًا ما يكون ذلك بسبب استخدام حزمة تطوير البرامج (SDK) الخاصة بنظام عروض الأسعار.
inventorypartnerdomain غير متوافق سلسلة BidRequest.inventorypartnerdomain نطاق الشريك (مالك التطبيق) الذي يمتلك جزءًا من مستودع الإعلانات على التطبيق. ستتم استضافة ملف ads.txt أو app-ads.txt للشريك هنا. يمكنك الاطّلاع على مزيد من التفاصيل على الرابط http://iabtechlab.com/wp-content/uploads/2021/03/ctv-app-ads-explainer-guide.pdf
تم تثبيت التطبيق
id نعم سلسلة BidRequest.MobileInstallSdk.id معرِّف حزمة تطوير البرامج (SDK) المثبَّتة.
sdk_version نعم الإصدار OfferRequest.Mobile.InstallSdk.sdk_version إصدار حزمة تطوير البرامج (SDK) المثبَّتة
adapter_version نعم الإصدار OfferRequest.Mobile.InstallSdk.adapter_version إصدار المحوِّل الذي يتصل بحزمة تطوير البرامج (SDK) المثبَّتة.
الإصدار
major غير متوافق int32 غير متاح تلقائي = 1-
minor غير متوافق int32 غير متاح تلقائي = 1-
micro غير متوافق int32 غير متاح تلقائي = 1-

الناشر

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

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" متاح تفاصيل التنفيذ
في الإصدار من Google
id غير متوافق سلسلة BidRequest.publisher_id 2.3
2.4
2.5

الرقم التعريفي للناشر الخاص بالتبادل، كما هو محدَّد من خلال لاحقة رمز الناشر الخاصة برمز الموقع الإلكتروني. على سبيل المثال، 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 في رسالة الناشر.

الناشر

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
country غير متوافق سلسلة BidRequest
.publisher_country		 بلد عنوان إرسال الفواتير للناشر وقد يكون هذا مختلفًا عن البلد الذي تم اكتشاف المستخدم فيه في لعبةGeo-criteria_id أو البلد المستضيف للموقع الإلكتروني. راجِع أيضًا القائمة الكاملة لرموز البلدان.
host_publisher_id غير متوافق سلسلة BidRequest.host_publisher_id الرقم التعريفي للناشر المضيف. تشير هذه القيمة إلى أنّ الناشر المضيف قد شارك في مشاركة الأرباح، ويمكن استخدام المعرّف للسماح باستخدام ملف ads.txt.

المحتوى

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

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

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

مثال خارج الفيديو: "Ecoالتركيز" (مدونة المجلات الزمنية)
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 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.detect._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 فقط)
BiddingRequest.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 التوافق، استخدم السياق للإصدار 2.3 أو الإصدارات الأحدث.
livestream غير متوافق قيمة منطقية BidRequest.Video.is_livestream 2.3
2.4
2.5

0 = غير مباشر، 1 = المحتوى معروض (مثلاً، البث أو المدونة المباشرة)
sourcerelationship غير متوافق قيمة منطقية غير متاح 2.3
2.4
2.5

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

تفاصيل حول أداة نشر المحتوى
len غير متوافق int32 عرض السعر.الفيديو.المحتوىالسمات.duration_seconds 2.3
2.4
2.5

مدة المحتوى بالثواني، ويُعدّ ملائمًا للفيديو أو الصوت
qagmediarating غير متوافق تقييم الجودة غير متاح 2.3
2.4
2.5

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

إشارة إلى ما إذا كان المحتوى قابل للتضمين (على سبيل المثال، مشغّل فيديو قابل للتضمين)، حيث يكون 0 = لا، 1 = نعم
language غير متوافق سلسلة BidRequest: تم رصده_language 2.3
2.4
2.5

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

منتِج

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

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" متاح تفاصيل التنفيذ
في الإصدار من 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

نطاق المستوى الأعلى لمنتِج المحتوى (مثل "product.com").

الجهاز

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

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" متاح تفاصيل التنفيذ
في الإصدار من Google
dnt غير متوافق قيمة منطقية غير متوافق، ارجع إلى دليل ملفات تعريف الارتباط، google_error=1: 2.3
2.4
2.5

الخيار "عدم التعقب" العادي كما هو موضّح في العنوان من خلال المتصفّح، حيث 0 = التتبُّع غير محدود، 1 = لا يتم تتبُّعه مقترَحة بمواصفات OpenRTB.
ua غير متوافق سلسلة BidRequest.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.
قد تتوفر إحداهما dbidmd5 أو ifa
بناءً على إصدار حزمة SDK للأجهزة الجوّالة. 		2.3
2.4
2.5

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

- تختصر AdX إلى أول 8 وحدات ثمانيّة البت، ويكون 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 غير متوافق سلسلة BidRequest.Device.brand 2.3
2.4
2.5

ماركة الجهاز (مثل "Apple").
model غير متوافق سلسلة BidRequest.Device.طراز 2.3
2.4
2.5

طراز الجهاز (مثل "iPhone")
os غير متوافق سلسلة BidRequest.Device.platform 2.3
2.4
2.5

نظام تشغيل الجهاز (مثل "iOS")
osv غير متوافق سلسلة BidRequest.Device.os_version 2.3
2.4
2.5

إصدار نظام تشغيل الجهاز
hwv غير متوافق سلسلة RequestRequest.Device.hardware_version 2.3
2.4
2.5

إصدار الجهاز (على سبيل المثال، "5S" لهواتف iPhone 5S)
w غير متوافق int32 BidRequest.Device.screen_width 2.3
2.4
2.5

العرض الفعلي للشاشة بالبكسل.
h غير متوافق int32 BidRequest.Device.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
تشير إلى ما إذا كانت واجهة برمجة التطبيقات للموقع الجغرافي ستتوفّر لرمز JavaScript الذي يتم تشغيله في البانر، حيث يكون القيمة 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: جميع الأحرف الكبيرة).
ifa هي معرّف Android أو معرّف المعلِنين من Apple، وإما dbidmd5 أو
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

"الحدّ من تتبُّع الإعلانات" هو إشارة معتمَدة تجاريًا تستند إلى إعدادات نظام التشغيل أو الجهاز، حيث يشير false إلى أنّ ميزة التتبُّع غير محظورة وتشير true إلى أنّ التتبُّع يجب أن يكون محدودًا وفقًا للإرشادات التجارية.

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

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

مصدر الجهاز

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

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

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
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

يشير إلى (مزيج من "العلامة التجارية" أو الإصدار) في المتصفّح أو المنصة.

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

الموقع الجغرافي

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

في عملية تنفيذ Google لبروتوكول OpenRTB، يتم تقريب معلومات الموقع الجغرافي التقريبي استنادًا إلى عنوان IP للجهاز الذي نشأ منه طلب الإعلان. سيتم في العادة تضمين هذه المعلومات، ولكن ليس دائمًا، في طلب عرض السعر مع القيمة lat/lon التي تمثّل النقطة المركزية للدائرة حيث يمثّل accuracy نطاقها الجغرافي. ولمزيد من المعلومات عن رصد الموقع الجغرافي، يُرجى الاطّلاع على دليل الاستهداف الجغرافي.

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" متاح تفاصيل التنفيذ
في الإصدار من Google
lat غير متوافق مزدوج BidRequest.[Encrypt_]hyperlocal_set.
center_point.Latitude 		2.3
2.4
2.5

خط العرض من -90.0 إلى +90.0، حيث تكون السالبة جنوبًا.
lon غير متوافق مزدوج BidRequest.[Encrypt_]hyperlocal_set.center_point.خط العرض 2.3
2.4
2.5

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

البلد الذي يستخدم ISO-3166-1 Alpha-3.
region غير متوافق سلسلة BidRequest.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 غير متوافق سلسلة BidRequest.geo_criteria_id من خلالgeo-table.csv، والمدن-dma-region.csv 2.3
2.4
2.5

رمز المنطقة المركزية لـ Google، على نحو ليس مطابقًا تمامًا رموز Nielsen® DMA®

ارجع إلى صفحة الاستهداف الجغرافي للاطّلاع على رابط للرموز.
city غير متوافق سلسلة BidRequest.geo_criteria_id من خلالGeo-table.csv 2.3
2.4
2.5

المدينة التي تستخدم رمز الأمم المتحدة للتجارة والنقل بتنسيق "city": "San Antonio".يُرجى الرجوع إلى الملحق أ للحصول على رابط إلى الرموز.
zip غير متوافق سلسلة BidRequest.postal_code
BiddingRequest.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) للحصول على تفسير دقيق. Google: النطاق الجغرافي بالمتر للدائرة الذي يقترب من الموقع الجغرافي للجهاز، حيث يتم تحديد النقطة المركزية بواسطة خط الطول/العرض. وتتم تعبئة هذا الحقل استنادًا إلى الموقع الجغرافي التقريبي المستند إلى عنوان IP.
lastfix غير متوافق int32 غير متاح 2.4
2.5
عدد الثواني منذ إنشاء إصلاح الموقع الجغرافي هذا.

يُرجى العِلم أنّ الأجهزة قد تخزِّن بيانات الموقع الجغرافي مؤقتًا في عمليات جلب متعددة. ومن المفترض أن تكون هذه القيمة من وقت تطبيق الإصلاح الفعلي.
ipservice غير متوافق خدمة الموقع الجغرافي غير متاح 2.4
2.5
خدمة أو مقدّم خدمة لتحديد الموقع الجغرافي من عنوان IP إن أمكن (على سبيل المثال، النوع = 2)
utcoffset غير متوافق int32 BidRequest.timezone_offset 2.3
2.4
2.5

التوقيت المحلي كعدد +/- دقائق من التوقيت العالمي المنسَّق (UTC).

المستخدِم

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

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" متاح تفاصيل التنفيذ
في الإصدار من Google
id غير متوافق سلسلة BidRequest.[constrained_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" أخرى. (تشير القيمة Null إلى غير معروفة)
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: تم رصده_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 في رسالة المستخدم.

هوية المستخدم

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

لمعرفة قائمة المورّدين المدرَجين في سلسلة الموافقة، يمكنك الاطّلاع على قائمة المورّدين العالميين الصادرة عن مكتب الإعلانات التفاعلية (IAB) على الرابط vendor-list.consensu.org/v2/vendor-list.json.
eids غير متوافق مصفوفة تتضمن عناصر ExtendedId BidRequest.AdSlot.secure_signals إضافة عادية تُستخدَم لتمرير إشارات آمنة يختارها الناشر.
إعدادات ConsentedProvider

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

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

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

يتم نشر ربط معرّف ATP باسم ATP في provider.csv.
رقم تعريف موسّع

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

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

البيانات

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

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

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" متاح تفاصيل التنفيذ
في الإصدار من Google
id غير متوافق سلسلة متاح 2.3
2.4
2.5

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

الاسم الخاص بموفِّر البيانات في Exchange.
segment مصفوفة من كائنات Segment متاح 2.3
2.4
2.5

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

تقسيم

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

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" متاح تفاصيل التنفيذ
في الإصدار من 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 للحصول على مزيد من المعلومات.

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" متاح تفاصيل التنفيذ
في الإصدار من Google
coppa غير متوافق سلسلة RequestRequest.user_data_treatment / TAG_FOR_CHILD_DirectED_TREATMENT 2.3
2.4
2.5

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

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

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

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
gdpr غير متوافق قيمة منطقية BidRequest.AdSlot.regs_gdpr سيتم ضبط هذا الحقل على "صحيح" في إحدى الحالتَين التاليتَين:
  1. تتلقّى Google سلسلة موافقة صالحة من الإصدار الثاني من "إطار الشفافية والموافقة" الصادر عن مكتب 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.

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" متاح تفاصيل التنفيذ
في الإصدار من 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.

عرض تفاصيل الردّ

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

مقعد مقعد

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

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" متاح تفاصيل التنفيذ
في الإصدار من Google
bid غير متوافق مصفوفة من كائنات Bid BidResponse. 2.3
2.4
2.5

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

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

0 = يمكن تحقيق مرات الظهور بشكل فردي، ويجب ربح 1 = مرة ظهور أو فقدانها كمجموعة. التلقائي = خطأ

عرض السعر

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

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" متاح تفاصيل التنفيذ
في الإصدار من 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.loSlot.max_CPM_micros * 1,000,000 2.3
2.4
2.5

يتم التعبير عن سعر عرض السعر على أنه التكلفة لكل ألف ظهور، على الرغم من أن المعاملة الفعلية تستند إلى مرة ظهور للوحدة فقط. ويُرجى العلم بأنه على الرغم من أنّ النوع يشير إلى عائم، يُنصح بشدة باستخدام الحساب الصحيح لعدد صحيح عند التعامل مع العملات (على سبيل المثال، BigDecimal في Java). مطلوبة بمواصفات 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 غير متوافق الرد الأصلي 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.advertiserd_app_id 2.3
2.4
2.5

رقم تعريف التطبيق في متجر التطبيقات، مثل Apple App Store وGoogle Play. للاطّلاع على مزيد من التفاصيل حول السلاسل المتوقّعة لمتاجر التطبيقات للتلفزيون المتّصل (CTV)، يُرجى الاطّلاع على إرشادات تحديد التطبيق الخاص بالمتجر عبر خدمة البث المباشر على الإنترنت/CTV. بالنسبة إلى التطبيقات المتوافقة مع الأجهزة الجوّالة في "متجر Google Play"، يجب أن تشتمل هذه التطبيقات على أسماء حِزم أو حِزم، مثل com.foo.mygame. بالنسبة إلى التطبيقات في Apple App Store، يجب أن تكون أرقام تعريف رقمية. Google: بالإضافة إلى هذا الحقل، اضبط حقل Bid.ext.app_promotion_type للاستفادة من الميزات المتعلقة بأنواع الترويج للتطبيقات.
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 غير متوافق تقييم الجودة غير متاح 2.3
2.4
2.5

تقييم تصميم إعلان الوسائط وفقًا لإرشادات QAG.
dealid غير متوافق سلسلة BidResponse.Ad.AdSlot.deal_id (أو ResponseResponse.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 في رسالة "عرض الأسعار".

عرض السعر

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
impression_tracking_url غير متوافق مصفوفة سلسلة BidResponse.Ad.impression_tracking_url عناوين URL التي سيتم طلبها عند عرض مرة الظهور. ويُسمَح باستخدام هذه السمة لجميع أنواع المستودعات وجميع التنسيقات. في OpenRTB 2.5، يكون Bid.burl هو الحقل العادي المشابهة.
ad_choices_destination_url غير متوافق سلسلة BidResponse.Ad.ad_choices_destination_عنوان URL رابط إلى الإعدادات المفضّلة للإعلانات أو صفحة الإيقاف في حال توفّره، تتم إضافة رمز "خيارات الإعلان" العادي إلى تصميم الإعلان الأصلي، كما يتم ربطه بعنوان URL هذا. ويتوفر هذا الخيار للإعلانات المدمجة مع المحتوى، ولكنه ليس جزءًا من الرسالة المدمجة مع المحتوى في استجابة عرض السعر.
click_tracking_url غير متوافق سلسلة BidResponse.Ad.click_tracking_url عناوين URL التي سيتم الاتصال بها عند نقر المستخدم على الإعلان. هذه الميزة غير متاحة حاليًا إلا للإعلانات المدمجة مع المحتوى والصفقات المضمونة آليًا باستخدام تصميمات الإعلانات التي يديرها الناشر. وفي الحالة التي يديرها الناشر، سيتم إرسال أدوات تتبّع النقرات هذه إلى خادم نظام عروض الأسعار إلى الخادم. وفي جميع الحالات الأخرى، سيتم إرسال هذه الإشعارات من جهاز المستخدم. لمزيد من المعلومات عن تصميمات الإعلانات التي يديرها الناشر، اطّلِع على تصميمات الإعلانات التي يديرها الناشر.
bidder_name غير متوافق سلسلة BidResponse.Ad.bidder_name بالنسبة إلى أنظمة عروض أسعار "الشراة المعتمَدون" (خدمات تبادل عروض الأسعار التابعة لجهات خارجية والتي تقدّم عروض أسعار في الوقت الفعلي على "مدير إعلانات Google")، اسم مقدّم عروض الأسعار الذي يستدعي تبادله تقديم الإعلان. هذا نص عشوائي بتنسيق UTF8، ولكن يجب أن يكون كافيًا لتحديد نظام عروض الأسعار ويجب ضبطه بشكل متّسق على القيمة نفسها لنظام عرض الأسعار نفسه.
exchange_deal_type غير متوافق Enum ExchangeDealType BidResponse.Ad.AdSlot.exchange_deal_type OPEN_AUCTION = 0؛
CUSTOM_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_notifications_token رمز مميز يحدده مقدمو عروض الأسعار لتحديد المشاكل وحلّه وسيتم تضمينه في الملاحظات في الوقت الفعلي لعرض السعر الذي يتم إرساله فيه. لن يتم تسجيل محتوى الرمز المميّز.
restricted_category غير متوافق صفيف int32 BidResponse.Ad.restricted_category جميع الفئات المحظورة للإعلانات التي قد يتم عرضها من هذا المقتطف. يمكنك الاطّلاع على ad-restricted-category.txt للحصول على قائمة بالمعرّفات.
billing_id غير متوافق int64 BidResponse.Ad.AdSlot.billing_id رقم تعريف الفوترة الذي ينطبق عليه مرة الظهور هذه. يجب أن تكون القيمة في حقل BidRequest.Imp.ImpExt.billing_id المتكرّر الذي تم إرساله لمرات الظهور هذه. إذا كان طول BidRequest.ImpExtt.billing_id هو 1 بالضبط ولم يكن لنظام عروض الأسعار مقاعد ثانوية نشطة، لن يكون هذا الحقل مطلوبًا وسيتم تجاهل محتواه.
third_party_buyer_token غير متوافق سلسلة BidResponse.Ad.Adslot.three_party_buyer_token الرمز المميّز المستخدَم لتحديد معلومات المشترين النهائيين التابعين لجهات خارجية إذا كان وسيط تبادل المعلومات في إطار نظام تقديم عروض الأسعار المفتوح هو وسيط. يتم الحصول على هذه الشارة من المشتري التابع لطرف ثالث ويجب تمريرها إلى Google بدون تعديلها في استجابة عرض الأسعار.
buyer_reporting_id غير متوافق سلسلة BidResponse.Ad.Adslot.buyer_reporting_id المعرّف الذي أبداه المشتري وسيتم استخدامه لتقسيم مقاييس الإنفاق وزيارات الزيارات غير الصالحة في تقارير الشفافية حول الزيارات غير الصالحة في أداة طلبات البحث. يُرجى العِلم بأنّ أرقام التعريف التي سجّلت أقل من 1000 مرة لن يتم استخدامها لتقسيم المقاييس. وسيتم تجاهل المعرّفات التي يزيد حجمها عن 64 بايت.
skadn غير متوافق SKAdNetworkResponse الكائن BidResponse.Ad.قديم معلومات SKAdNetwork للمعلِن لإتاحة إحالة تثبيت التطبيق لنظام التشغيل iOS 14 والإصدارات الأحدث. تساعد واجهة برمجة تطبيقات SKAdNetwork من Apple المعلِنين في قياس تثبيت التطبيقات المستندة إلى الإعلانات من خلال إرسال الإبلاغ عن الإحالات الناجحة إلى شبكة المواقع الإعلانية بعد إتمام التثبيت بنجاح. وستحتاج شبكات المواقع الإعلانية إلى إرسال رقم تعريف الشبكة ومعلومات المعلِن الموقَّعة حتى تسمح بإسناد عملية التثبيت إلى مرة ظهور الإعلان. وللحصول على مزيد من المعلومات، يُرجى الاطّلاع على هذه المقالة.
app_promotion_type غير متوافق تعداد BidResponse.Ad.app_promotion_type نوع العرض الترويجي للتطبيق المتوافق مع التطبيق المُعلَن عنه والمحدَّد في الحقل seatbid.bid.bundle. في حال عدم تحديد التطبيق المُعلَن عنه، سيتم تجاهل هذا الحقل. سيتم التعامل مع إعداد bundle بدون هذا الحقل كما لو كان قد تم ضبط هذا الحقل على OTHER.
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 محتوى الرمز المميّز الذي سيتم تجاهله إذا تجاوز طوله 128 بايت
SKAdNetworkResponse
version غير متوافق سلسلة BidResponse.ad[].skadn.version إصدار SKAdNetwork المتوافق مع المعلِن. ويُستخدم أيضًا لتحديد كيفية إنشاء المعلن للتوقيع. ومن المفترض أن تتطابق هذه النسخة مع أحد الإصدارات من BidRequest.imp.ext.skad.versions.
network غير متوافق سلسلة BidResponse.ad[].skadn.network معرِّف شبكة المواقع الإعلانية المستخدَم في التوقيع. يجب أن يتطابق هذا مع أحد العناصر في BidRequest.imp.ext.skad.skadnetids.
campaign غير متوافق سلسلة BidResponse.ad[].skadn.campaign يتوافق رقم تعريف الحملة مع مواصفات Apple المستخدَمة في الإصدار 3.0 من SKAdNetwork والإصدارات الأقل. تم استبداله بالحقل BidResponse.imp.ext.skad.sourceidentifier في SKAdNetwork 4.0 والإصدارات الأحدث.
sourceidentifier غير متوافق سلسلة BidResponse.ad[].skadn.source_identifier عدد صحيح مكوّن من أربعة أرقام تحدّده شبكات المواقع الإعلانية لتمثيل الحملة الإعلانية يُستخدَم في الإصدار 4.0 من SKAdNetwork ويحلّ محلّ الحقل BidResponse.imp.ext.skad.campaign.
itunesitem غير متوافق سلسلة BidResponse.ad[].skadn.itunesitem رقم تعريف تطبيق المعلن في متجر تطبيقات Apple.
productpageid غير متوافق سلسلة BidResponse.ad[].skadn.product_page_id رقم تعريف صفحة المنتج المخصّصة لعرضها (لنظام التشغيل iOS 15 أو الإصدارات الأحدث) سيتم عرض صفحة المنتج التلقائية إذا لم يتم تحديد هذه القيمة. راجِع هذه المقالة للحصول على مزيد من التفاصيل عن صفحات المنتجات المخصّصة.
fidelities غير متوافق مصفوفة من كائنات Fidelity BidResponse.ad[].skadn.fidelities تبدأ واجهة برمجة تطبيقات SKAdNetwork من الإصدار 2.2 من خيارات عرض الإعلانات المتعددة التي تحدّدها المعلّمة fidelity-type لتوقيع SKAdNetwork. ويؤدي ذلك إلى الاحتفاظ بالمَعلمات المستخدَمة لإنشاء التوقيع الذي سيكون مختلفًا لكل نوع من أنواع الدقة المتوافقة. وللحصول على مزيد من المعلومات، يُرجى الاطّلاع على هذه المقالة.
nonce غير متوافق سلسلة BidResponse.ad[].skadn.nonce معرّف فريد فريد (UUID) صغير ينشئه المعلن لاستخدامه في إنشاء التوقيع ملاحظة: سيتم إيقاف هذا الحقل نهائيًا لصالح حقل 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 لتوفير أنواع متعددة من الدقة.
skoverlay غير متوافق SKOverlay الكائن BidResponse.ad[].skadn.skoverlay تشير هذه الخيارات إلى طريقة مشاركة عرض SKتراكب الذي يوصي بالتطبيق المُعلَن عنه، متوافق مع نظام التشغيل iOS 14 والإصدارات الأحدث.
كائن AdlaredAd

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

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

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

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
html_snippet غير متوافق سلسلة BidResponse.ad[].sdk_rendered_ad.أعلنd_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.أعلنd_ad.video_vast_xml مستند نموذج عرض إعلانات الفيديو (VAST) المُستخدَم لعرض إعلان مخصّص تعرِضه حزمة تطوير البرامج (SDK). ويجب أن يتوافق هذا المستند مع معيار نموذج عرض إعلانات الفيديو (VAST) 2.0 أو 3.0.
native_response غير متوافق NativeResponse BidResponse.ad[].sdk_rendered_ad.claimd_ad.Native_response محتوى الإعلان المدمج مع المحتوى. تتألف الإعلانات المدمجة مع المحتوى من وحدات أساسية متعددة يتم عرضها من خلال حزمة تطوير البرامج (SDK) للمشتري. يجب أن تتطابق مع تعريف OpenRTB Native 1.2 NativeResponse العادي. يجب ملء الحقل "NativeResponse.assets.img.type".
click_through_url غير متوافق سلسلة BidResponse.ad[].sdk_rendered_ad.أعلنd_ad.click_through_url الصفحات المقصودة النهائية للإعلان المعروض في حزمة تطوير البرامج (SDK).
دقة
السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
fidelity غير متوافق تعداد SKAdNetworkFidelityType BidResponse.ad[].skadn.fidelity_type نوع دقة الإحالة التي سيتم تتبُّعها. القيمة التلقائية = STOREKIT_RENDERED_ADS.

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

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

nonce غير متوافق سلسلة BidResponse.ad[].skadn.nonce معرّف فريد فريد (UUID) صغير ينشئه المعلن لاستخدامه في إنشاء التوقيع
timestamp غير متوافق سلسلة BidResponse.ad[].skadn.timestamp وقت Unix بالمللي ثانية وقت إنشاء التوقيع.
signature غير متوافق سلسلة BidResponse.ad[].skadn.signature توقيع SKAdNetwork كما هو محدّد من قِبل Apple.
تراكب تراكب
السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
delay غير متوافق int32 BidResponse.ad[].skadn.skoverlay.delay_seconds يمكنك التأخير بالثواني بعد بدء الإعلان قبل عرض التراكب. إذا تم ضبط هذا الحقل على 0، سيتم عرض التراكب مباشرةً بعد بدء الإعلان. في حال عدم ضبط هذا الحقل، لن يتم عرض الإعلان الذي يظهر على سطح الفيديو.
endcarddelay غير متوافق int32 BidResponse.ad[].skadn.skoverlay.endcard_delay_seconds يُرجى الانتظار بالثواني بعد ظهور بطاقة النهاية قبل مشاركة عرض التراكب. (لا ينطبق هذا الحقل إلا على تصميمات إعلانات الفيديو أو الإعلانات البينية بمكافأة.) في حال ضبط هذا الحقل على 0، سيتم عرض التراكب مباشرةً بعد ظهور بطاقة النهاية. في حال عدم ضبط هذا الحقل، لن يتم عرض التراكب لبطاقة النهاية. في حال ضبط السمتَين delay وendcarddelay، سيتم إغلاق التراكب تلقائيًا عند انتهاء الإعلان وسيتم عرضه مرة أخرى بعد ظهور بطاقة النهاية.
dismissible غير متوافق قيمة منطقية BidResponse.ad[].skadn.skoverlay.dismissible ما إذا كان بإمكان المستخدم إغلاق هذا التراكب. القيمة التلقائية هي "صحيح".

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

طلب محلي

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

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
ver نعم سلسلة "1.2" لنظام OpenRTB 2.5. عدد إصدارات الترميز الأصلي قيد الاستخدام
layout غير متوافق رقم تعريف التنسيق غير متاح رقم تعريف تنسيق الوحدة الإعلانية المدمجة مع المحتوى. مقترَح بواسطة OpenRTB Native 1.0، وهو اختياري في 1.1، ليتم إيقافه.
adunit غير متوافق رقم تعريف الوحدة الإعلانية غير متاح رقم تعريف الوحدة الإعلانية للوحدة الإعلانية المدمجة مع المحتوى. وذلك يتوافق مع إحدى وحدات الإعلانات المدمجة مع المحتوى ( Core-6) من مكتب الإعلانات التفاعلية (IAB). مقترَح بواسطة OpenRTB Native 1.0، اختياري في 1.1، ليتم إيقافه.
context غير متوافق نوع السياق غير متاح السياق الذي يظهر فيه الإعلان.
contextsubtype غير متوافق النوع الفرعي للسياق غير متاح سياق أكثر تفصيلاً يظهر فيه الإعلان.
plcmttype غير متوافق نوع الموضع إعلان مدمج مع المحتوى تصميم/تنسيق/وحدة الوحدة الإعلانية المعروضة.
plcmtcnt غير متوافق int32 غير متاح عدد مواضع الإعلانات المتطابقة في هذا التنسيق.
seq غير متوافق int32 غير متاح 0 للإعلان الأول، و1 للإعلان الثاني، وهكذا. يُرجى العِلم أنّه لن يتم استخدام هذه السمة بشكل عام مع plcmtcnt، بل إما أن تكون بصدد المزاد على مواضع متعدّدة متطابقة (في هذه الحالة plcmtcnt>1, seq=0) أو إجراء مزادات منفصلة لعناصر مختلفة في الخلاصة (أي plcmtcnt=1, seq>=1) في هذه الحالة.
assets غير متوافق مصفوفة من كائنات Asset متوافق في عنصر NativeAdTemplate.

يرتبط حقل مواد عرض OpenRTB بحقل native_ad_template Proto AdX. يُرجى العِلم أنّ هذه العملية لا تمثّل عملية ربط واحدة إلى واحدة.

ينقل النموذج الأولي في Google AdX الرسالة نفسها من خلال العنصر NativeAdTemplate، حيث يرسل الحقلان required_fields وrecommended_fields إلى نظام عروض الأسعار مواد العرض المطلوبة أو المقترَحة. تتضمن السمة NativeAdTemplate أيضًا حقولاً أخرى، مثل image_width.

يتم التعبير عن المعلومات في حقل assets في OpenRTB من خلال حقول متعدّدة في AdX.

ويجب أن يكون أي عرض أسعار متوافقًا مع مجموعة العناصر التي تحدّدها منصة Exchange. مطلوبة بواسطة مواصفات OpenRTB Native: عنصر واحد على الأقل.
aurlsupport غير متوافق bool متوافق ما إذا كان مصدر التوريد / مرّة الظهور يتيح عرض عنوان URL لمواد العرض بدلاً من عنصر مادة عرض ويشير عدم ظهور حقل أو عدم توفّره إلى مثل هذا الدعم. تم التنفيذ في الإصدار 1.2
durlsupport غير متوافق bool متوافق ما إذا كان مصدر التوريد أو مرة الظهور يتوافق مع عرض عنوان URL لـ DCO بدلاً من عنصر مادة العرض. ويشير عدم ظهور حقل أو عدم توفّره إلى مثل هذا الدعم. يتم التنفيذ في 1.2. ميزة تجريبية.
eventtrackers غير متوافق EventTrackers يتوافق الإصدار 1.2 من OpenRTB مع تتبُّع IMPRESSION وIMG. في حال تفعيل OMSDK للغة الأصلية، يكون JavaScript متوافقًا. يحدّد هذا الإعداد نوع تتبُّع الأحداث المتوافق. تم التنفيذ في الإصدار 1.2
privacy غير متوافق bool غير متاح اضبط القيمة على 1 عندما يسمح الإعلان المدمج مع المحتوى بإشعار الخصوصية الخاص بالمشتري. يتم ضبطها على 0 (أو عدم توفّر الحقل)، عندما لا يتوافق الإعلان المدمج مع المحتوى مع روابط الخصوصية المخصّصة أو إذا كان الدعم غير معروف. يُنصح بتنفيذه وتنفيذه في الإصدار 1.2. تتيح جميع الطلبات المدمجة مع المحتوى إرسال عنوان URL للخصوصية، لذا يكون هذا الرقم "1" ضمنيًا للطلبات الأصلية.
ext غير متوافق عنصر NativeRequestExt متاح بالنسبة إلى OpenRTB/Protobuf، يمكنك الوصول إلى هذا الكائن باستخدام مفتاح الإضافة [com.google.doubleclick.native_ext] (يختلف المسار الدقيق حسب اللغة المستخدَمة لإنشاء مكتبة Proto). بالنسبة إلى OpenRTB/JSON، يمكنك الوصول إلى الحقل ext في رسالة NativeRequest.

طلب محلي

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
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; (Default)
FLUID = 1؛

مادة العرض

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

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

تم اقتراحها من خلال مواصفات OpenRTB الأصلية. إنّها واحدة من Title أو Image أو Data أو Video.
img غير متوافق صورة الطلب BidRequest.AdSlot.Native_ad_template[0] من أنواع main/IMAGE, ICON/APP_ICON, LOGO/LOGO عنصر Image لمواد عرض الصور

تم اقتراحها من خلال مواصفات OpenRTB الأصلية. إنّها واحدة من Title أو Image أو Data أو Video.
video غير متوافق حملة فيديو BidRequest.AdSlot.NativeAdModel.required_fields عنصر Video لمواد عرض الفيديو يُرجى العلم أنّ الإعلانات التي تظهر أثناء عرض الفيديو ليست جزءًا من إعلان مدمج مع المحتوى. قد تحتوي الإعلانات المدمجة مع المحتوى على فيديو كتصميم الإعلان نفسه. يمكن أن تشير طلبات عروض الأسعار إلى أنّ الفيديو مطلوب في واجهة NativeResponse من خلال ضبط NativeRequest.assets[].required على true وتحديد NativeRequest.assets[].video. تم اقتراحها من خلال مواصفات OpenRTB الأصلية. تمثّل هذه السمة أحد Title أو Image أو Data أو Video.
data غير متوافق البيانات BidRequest.AdSlot.Native_ad_template[0] من أنواع CTATEXT/CALL_TO_ACTION, DETAIL/Body،

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

عنصر Data للتقييمات والأسعار وما إلى ذلك

تم اقتراحها من خلال مواصفات OpenRTB الأصلية. إنّها واحدة من Title أو Image أو Data أو Video.

Title

ويتم استخدام العنصر Title لعنصر العنوان في الإعلان الأصلي.

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

صورة

ويتم استخدام العنصر Image لعناصر الصورة في الإعلان الأصلي.

غير متاح
السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
type غير متوافق نوع مادة العرض للصور نوع حقل BidRequest.AdSlot.Native_ad_template[0] الرقم التعريفي لنوع الصورة الذي يدعمه الناشر ويمكن للناشر عرض هذه المعلومات بتنسيق مناسب.
w غير متوافق int32 غير متاح عرض الصورة بالبكسل.
h غير متوافق int32 غير متاح ارتفاع الصورة بالبكسل
wmin غير متوافق int32 BidRequest.AdSlot.Native_ad_template[0] من النوع: Major/IMAGE:image_width LOGO/LOGO: الشعار_width

ICON/APP_ICON: app_icon_width

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

حملة فيديو

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

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

مطلوبة من خلال مواصفات OpenRTB الأصلية: عنصر واحد على الأقل.
minduration نعم int32 BidRequest.Video.min_ad_duration الحد الأدنى لمدة إعلان الفيديو بالثواني.

مطلوبة بموجب مواصفات OpenRTB Native.
maxduration نعم int32 BidRequest.Video.max_ad_duration الحد الأقصى لمدة إعلان الفيديو بالثواني.

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

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

أمثلة:
نموذج عرض إعلانات الفيديو (VA_1_0) = 1؛
نموذج عرض إعلانات الفيديو (VA_2)0 = 2؛
نموذج عرض إعلانات الفيديو (VAST) 3_0 = 3؛

البيانات

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

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
type نعم نوع مادة العرض نوع حقل BidRequest.AdSlot.Native_ad_template[0] نوع معرّف العنصر الذي يتيحه الناشر ويمكن للناشر عرض هذه المعلومات بتنسيق مناسب. مطلوبة لمواصفات OpenRTB الأصلية.
len غير متوافق int32 BidRequest.AdSlot.Native_ad_template[0] من النوع:

المتعلقة بالنص الأساسي: body_max_safe_length

CTATEXT/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.

أجهزة تتبُّع الأحداث

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

الرد الأصلي

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

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
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 لتتبّع مرات الظهور التي يُتوقع أن تعرض صورة 1x1 أو استجابة 204 عادةً ما يتم تمريرها فقط عند استخدام برامج تتبع تابعة لجهة خارجية. يمكنك استخدام ماكرو %%WINNING_PRICE%% أو ${AUCTION_PRICE}.
jstracker غير متوافق سلسلة غير متاح أداة تتبُّع مرات ظهور JavaScript الاختيارية تحتوي على علامات script يتم تنفيذها في وقت الظهور حيث يمكن إتاحتها.
eventtrackers غير متوافق مصفوفة من كائنات EventTracker BidResponse.Ad.impression_tracking_url و BidResponse.Ad.impression_tracking_resource مصفوفة من أدوات تتبُّع أحداث الاستجابة التي يتم عرضها مع الإعلان، استجابةً للأساليب المعتمَدة المعلَن عنها في NativeRequest. تحل محل أدوات التتبُّع وأدوات تتبُّع JavaScript. يتم التنفيذ في 1.2.

أداة تتبُّع الأحداث

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

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

أداة EventTrackerExt
السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
context غير متوافق مصفوفة سياق التعداد BidResponse.Ad.exTrackingResource. تم توفير سياق إضافي للعرض.
غير معروف = 0؛
OMID = 1؛ غير متاح حاليًا.
verification_parameters غير متوافق سلسلة BidResponse.Ad.impressionTrackingResource.verification_ parameters المعلَمات المرتبطة بالمورد التي سيتم تمريرها إلى المورد عند تحميله. ويعتمد تنسيق المعلَمات على مورّد النص البرمجي.
vendor_key غير متوافق سلسلة BidResponse.Ad.impressionTrackingResource.vendor_key يُستخدَم لتعريف موفّر النص البرمجي لإثبات الملكية بشكل فريد.

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

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
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} في كل عنصر. ويجب أن تكون جميع القيم الأخرى فارغة أو غير موجودة. يجب أن يكون المعرّف فريدًا في صفيف مادة العرض بحيث يمكن محاذاة الاستجابة.

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
id نعم int32 غير متاح يجب أن يتطابق رقم تعريف مادة العرض الفريد، الذي تم تعيينه للتبادل، مع أحد أرقام تعريف مواد العرض في الطلب

مطلوبة بموجب مواصفات OpenRTB Native.
required غير متوافق قيمة منطقية غير متاح اضبط القيمة على 1 إذا كانت مادة العرض مطلوبة. (يتطلب عرض السعر عرضه)
title غير متوافق 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

يمكن أن تكون سلسلة تحتوي على نموذج 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

تتطابق مع العنصر Title في الطلب، مع القيمة التي تم ملؤها.

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
text نعم سلسلة BidResponse.Ad.Native_ad[0].headline النص المرتبط بالعنصر النصي. مطلوبة بموجب مواصفات OpenRTB Native.

صورة

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

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
url نعم سلسلة BidResponse.Ad.Native_ad[0] لنوع مادة عرض الطلب:

الصورة الرئيسية/الصورة: image.url

ICON/APP_ICON: app_icon.url

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

 عنوان URL لمادة عرض الصورة مطلوبة بموجب مواصفات OpenRTB Native.
w غير متوافق int32 BidResponse.Ad.Native_ad[0] لنوع مادة عرض الطلب:

الصورة الرئيسية/الصورة: image.url

ICON/APP_ICON: app_icon.url

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

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

الصورة الرئيسية/الصورة: image.url

ICON/APP_ICON: app_icon.url

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

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

حملة فيديو

تتطابق مع عنصر Video في الطلب، ولكن تتضمّن قيمة علامة نموذج عرض إعلانات فيديو (VAST) مطابقة كقيمة.

السمة نجاح دائم Type مكافئ "الشراة المعتمَدون" تفاصيل التنفيذ
vasttag نعم سلسلة غير متاح نموذج عرض إعلانات فيديو (VAST) بتنسيق XML. مطلوبة بموجب مواصفات OpenRTB Native.

البيانات

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

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

CTATEXT/CALL_TO_ACTION: Call_to_action

التحية/النص: النص

برعاية/المعلن: معلِن

PRICE/PRICE: السعر

RATING/STAR_RATING: تقييم_النجمة (يتطلب AdX علامة مزدوجة 0.5)

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

أمثلة