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

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

هذا الدليل هو مرجع لبروتوكول Real-time Curation يمكن أن يساعدك في إنشاء عملية الدمج.

SegmentRequest

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

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

السمة	النوع	الوصف
page	سلسلة	تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. عنوان URL للصفحة التي تعرض مرّة الظهور.

تطبيق

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

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

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

SegmentResponse

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

تقسيم

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