التعرّف على مواصفات "العرض المنسّق في الوقت الفعلي"
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
ترسل Google
SegmentRequest
استنادًا إلى طلبات الإعلانات التي تطابق مستودعك الإعلاني المستهدَف مع عملية الدمج في ميزة "اختيار المحتوى في الوقت الفعلي". يوفّر العنصر SegmentRequest إشارات سياقية أو إشارات جمهور يمكنك استخدامها لتحديد الشرائح التي تنطبق على المستودع الإعلاني المحدّد في SegmentResponse.
تتيح ميزة "التنظيم في الوقت الفعلي" استخدام العنصرَين SegmentRequest وSegmentResponse
المرسَلَين بتنسيق JSON.
هذا الدليل هو مرجع لبروتوكول "اختيار المحتوى في الوقت الفعلي" الذي يمكن أن يساعدك في إنشاء عملية الدمج.
تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. تمثّل هذه السمة وصفًا للموقع الإلكتروني. يتم ملء الحقل site إذا كان المحتوى الذي يعرض الإعلانات عبارة عن موقع إلكتروني وليس تطبيقًا لا يعمل على المتصفح.
تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. وصف للتطبيق. يتم ملء الحقل app إذا كان المحتوى الذي يعرض الإعلانات تطبيقًا غير متصفّح بدلاً من موقع إلكتروني.
تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. العرض بوحدات بكسل مستقلة عن الجهاز (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 للحصول على تفاصيل حول المورّدين المدرَجين في سلسلة الموافقة.
تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. الموقع الجغرافي لجهاز المستخدم
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
سلسلة
تتوفّر هذه الميزة لشركاء التنظيم حسب السياق فقط. المدينة باستخدام رمز الأمم المتحدة للمواقع الجغرافية التجارية والنقل
رقم تعريف شريحة الجمهور. يجب أن يتطابق المعرّف مع curatorDataSegmentId الوارد في اسم شريحة الجمهور في المورد curators.dataSegments ضِمن Marketplace API.
تاريخ التعديل الأخير: 2026-09-23 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2026-09-23 (حسب التوقيت العالمي المتفَّق عليه)"],[],[]]