التعرّف على مواصفات "العرض المنسّق في الوقت الفعلي"

ترسل Google SegmentRequest استنادًا إلى طلبات الإعلانات التي تطابق مستودعك الإعلاني المستهدَف مع عملية الدمج في ميزة "التنظيم في الوقت الفعلي". يوفّر العنصر SegmentRequest إشارات سياقية أو إشارات آمنة يمكنك استخدامها لتحديد الشرائح التي تنطبق على المستودع الإعلاني المحدّد في SegmentResponse. تتيح ميزة "التنظيم في الوقت الفعلي" استخدام العنصرَين SegmentRequest وSegmentResponse المرسَلَين بتنسيق JSON.

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

SegmentRequest

السمة	النوع	الوصف
imp	مصفوفة مرات الظهور	تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. تمثّل فرص ظهور الإعلان التي يتمّ تقديمها.
site	الموقع الإلكتروني	تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. تمثّل هذه السمة وصفًا للموقع الإلكتروني. يتم ملء الحقل site إذا كان المحتوى الذي يعرض الإعلانات عبارة عن موقع إلكتروني وليس تطبيقًا لا يستند إلى المتصفّح.
app	التطبيق	تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. واصف للتطبيق. يتم ملء الحقل app إذا كان المحتوى الذي يعرض الإعلانات تطبيقًا غير مستند إلى المتصفّح بدلاً من موقع إلكتروني.
pub	الناشر	تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. تمثّل هذه السمة وصفًا للناشر.
user	المستخدم	واصف للمستخدم الذي يتصفّح محتوى الناشر والذي بدأ طلب الشريحة.
device	الجهاز	تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. تمثّل هذه السمة وصفًا لجهاز المستخدم.
segment_request_id	سلسلة	معرّف فريد يُستخدَم لتحديد طلب المقطع بشكل مستقل عن جميع طلبات المقاطع الأخرى.

مرات الظهور

السمة	النوع	الوصف
id	سلسلة	تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. معرّف فريد لمرّة الظهور هذه في سياق طلب المقطع تبدأ القيمة من 1 وتزداد حتى n لعدد n من مرّات الظهور.
banner	البانر	تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. يتم ملء هذا الحقل إذا تمّ تقديم مرّة الظهور كفرصة لعرض إعلان بانر.
video	الفيديو	تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. يتم ملء هذا الحقل إذا كان ظهور الإعلان يُقدَّم كفرصة لعرض إعلان فيديو.
ext	ImpExt	يتم ملء هذا الحقل بإضافات لكائن Imp.

بانر

السمة	النوع	الوصف
w	int	تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. العرض بوحدات بكسل مستقلة عن الجهاز (DIPS)
h	int	تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. الارتفاع بوحدات البكسل المستقلة عن الجهاز (DIPS).
pos	int	تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. موضع عرض الإعلان على الشاشة لمزيد من المعلومات عن مواضع الإعلانات المحتملة، اطّلِع على القائمة: مواضع الإعلانات في AdCOM 1.0.

فيديو

السمة	النوع	الوصف
w	int	تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. عرض مشغّل الفيديو بوحدات بكسل مستقلة عن الجهاز (DIPS)
h	int	تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. تمثّل هذه السمة ارتفاع مشغّل الفيديو بوحدات البكسل المستقلة عن الجهاز (DIPS).
pos	int	تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. موضع عرض الإعلان على الشاشة لمزيد من المعلومات عن مواضع الإعلانات المحتملة، اطّلِع على القائمة: مواضع الإعلانات في AdCOM 1.0.

ImpExt

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

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

السمة	النوع	الوصف
page	سلسلة	تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. عنوان URL للصفحة التي تعرض مرّة الظهور.
mobile	int	تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. تشير إلى ما إذا كان الموقع الإلكتروني قد تمّت برمجته لتحسين التصميم عند عرضه على الأجهزة الجوّالة، حيث 0 = لا، 1 = نعم.

التطبيق

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

الناشر

السمة	النوع	الوصف
id	سلسلة	تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. رقم تعريف الناشر الذي يحدّده لاحقة رمز الناشر لرمز الموقع الإلكتروني على سبيل المثال، إذا كان لدى الناشر رمز موقع إلكتروني ca-pub-123، سيتم ضبط المعرّف على pub-123.

المستخدم

السمة	النوع	الوصف
consent	سلسلة	سلسلة موافقة الإصدار 2 من "إطار الشفافية والموافقة" الصادر عن مكتب IAB، وهي مشفّرة باستخدام base64 ومتوافقة مع الويب، ويتم استرجاعها من منصّة إدارة الموافقة الصادرة عن مكتب IAB (CMP) الخاصة بالناشر. يتم تعبئة الحقل consent إذا كان الناشر قد أجرى عملية دمج مع منصّة إدارة موافقة متوافقة مع الإصدار 2 من إطار الشفافية والموافقة، وتشير هذه المنصّة إلى أنّ "اللائحة العامة لحماية البيانات" تنطبق على طلب عرض الإعلان وتقدّم سلسلة موافقة صالحة. يمكنك الاطّلاع على قائمة المورّدين العالميين الصادرة عن مكتب IAB على vendor-list.consensu.org/v2/vendor-list.json للحصول على تفاصيل حول المورّدين المدرَجين في سلسلة الموافقة.
eids	مصفوفة EID	لا تتوفّر هذه الميزة إلا لشركاء الخدمات المختارة الذين يقدّمون إشارات آمنة. مثيلات المعرّف الموسّع في ميزة "التنظيم"، الحقل eids هو بيانات يتيحها الناشر، مثل الإشارات الآمنة.

عيد الفطر

السمة	النوع	الوصف
source	سلسلة	لا تتوفّر هذه الميزة إلا لشركاء الخدمات المختارة الذين يقدّمون إشارات آمنة. مزوّد المصدر أو التكنولوجيا المسؤول عن مجموعة البيانات المضمّنة ويُعبر عنها بنطاق المستوى الأعلى.
uids	مصفوفة UID	لا تتوفّر هذه الميزة إلا لشركاء الخدمات المختارة الذين يقدّمون إشارات آمنة. مصفوفة من عناصر المعرّف الفريد العالمي (UID) من المصدر المحدّد

الرقم التعريفي الفريد

السمة	النوع	الوصف
id	سلسلة	لا تتوفّر هذه الميزة إلا لشركاء الخدمات المختارة الذين يقدّمون إشارات آمنة. المعرّف في عملية التنظيم، يُعدّ الحقل id إشارة آمنة. لمزيد من المعلومات عن الإشارات الآمنة، اطّلِع على مقالة مشاركة الإشارات الآمنة مع مقدّمي عروض الأسعار وشركاء التنسيق في "مدير إعلانات Google".

الجهاز

السمة	النوع	الوصف
geo	الموقع الجغرافي	تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. الموقع الجغرافي لجهاز المستخدم
devicetype	int	تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. النوع العام للجهاز لمزيد من المعلومات حول أنواع الأجهزة المحتملة، يُرجى الاطّلاع على القائمة: أنواع الأجهزة في AdCOM 1.0.
os	سلسلة	تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. نظام تشغيل الجهاز (مثل "iOS")
make	سلسلة	تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. صانع الجهاز (مثل "Apple").

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

السمة	النوع	الوصف
country	سلسلة	تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. تمثّل هذه السمة البلد باستخدام معيار ISO-3166-1 Alpha-3.
region	سلسلة	تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. رمز المنطقة باستخدام معيار ISO-3166-2، وهو رمز الولاية المكوّن من حرفَين إذا كان البلد هو الولايات المتحدة الأمريكية.
metro	سلسلة	تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. رمز منطقة Google الحضرية الذي تم العثور عليه في ملف geo-table.csv
city	سلسلة	تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. المدينة التي تستخدم رمز الأمم المتحدة للمواقع الجغرافية التجارية والنقل

SegmentResponse

السمة	النوع	الوصف
segment	مصفوفة الشرائح	تمثّل واصفًا لجزء من المحتوى.

تقسيم

السمة	النوع	الوصف
segment_id	سلسلة	رقم تعريف الشريحة. يجب أن يتطابق المعرّف مع curatorDataSegmentId الوارد في اسم شريحة الجمهور في المورد curators.dataSegments ضِمن Marketplace API.