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

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

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

SegmentRequest

السمة النوع الوصف
imp صفيف 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.

المستخدم

السمة النوع الوصف
id سلسلة معرّف المستخدم على Google
buyeruid سلسلة بيانات المطابقة المستضافة التي يتم تحميلها باستخدام "خدمة مطابقة ملفات تعريف الارتباط" يتم تحديد ذلك تلقائيًا في ترميز base64 الآمن على الويب بدون إضافة مساحة فارغة. يمكنك اختياريًا ضبط هذا الحقل ليتم ملؤه بدون ترميز من خلال التواصل مع مدير حسابك.
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").
ifa سلسلة المعرّف الإعلاني غير المشفّر للجهاز (غير مجزّأ) في بروتوكول Real-time Curation من Google، يكون هذا المعرّف عادةً معرّفًا فريدًا عالميًا (UUID) يتألف من 36 حرفًا، حيث تكون معرّفات Android بأحرف صغيرة ومعرّفات IDFA بأحرف كبيرة. بالنسبة إلى أجهزة Samsung، تكون هذه القيم أبجدية رقمية وتتألف من 32 حرفًا.

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

السمة النوع الوصف
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.