نعمل حاليًا على نقل مجموعة فرعية من أنواع التقارير من التقارير بلا إنترنت إلى التقارير الفورية. بعد نقل بيانات المستخدِم، ستتضمّن ردود queries.list تقارير فورية حالية. ويمكنك الاطّلاع على مشاركة المدونة للحصول على مزيد من المعلومات.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

تنسيق ملفات قراءة الكيانات - الإصدار 2

الأنواع المشتركة
الجداول الخاصة
الجداول العامة

الأنواع المشتركة

تحدِّد هذه الأنواع الحقول المضمّنة في بعض الجداول، ولا تتضمّن هذه الحقول جداول خاصة بها.

نوع واحد (`Numeric Id`)

Scalar	الوصف
`integer`	هو رقم تعريف رقمي يُستخدم كمعرّف للكيانات. يجب عدم التعامل مع المعرّفات على أنّها فريدة على مستوى العالم، على سبيل المثال، قد تكون قيمة المعرّف نفسها المستخدَمة في حملة مستخدَمة أيضًا في وحدة البكسل.

نوع `Enum`

Scalar	الوصف
`integer`	قائمة بالعديد من الخيارات المحتملة يتم وصف الخيارات المختلفة بمزيد من التفصيل في نوع العنصر الرئيسي.

نوع واحد (`Time`)

Scalar	الوصف
`integer`	وقت نظام التشغيل Unix بالميكروسكوند (1/1,000,000 ثانية)، على سبيل المثال، 1330403779608570 يمثّل يوم الثلاثاء 28 شباط (فبراير) 2012 04:36:19.608570.

نوع `Currency Micro`

Scalar الوصف

integer المبلغ المحدد بالعملة بالمايكرو (1/1,000,000 وحدة عملة)، على سبيل المثال، إذا كانت العملة هي اليورو، فإن 75000000 تعني 75 يورو أو إذا كانت العملة بالدولار الأمريكي، فإن 250000 يعني 0.25 دولار أمريكي. لا يتم تحويل المبالغ إلى دولار أمريكي أو العكس.

Scalar	الوصف
`integer`	المبلغ المحدد بالعملة بالمايكرو (1/1,000,000 وحدة عملة)، على سبيل المثال، إذا كانت العملة هي اليورو، فإن `75000000` تعني 75 يورو أو إذا كانت العملة بالدولار الأمريكي، فإن `250000` يعني 0.25 دولار أمريكي. لا يتم تحويل المبالغ إلى دولار أمريكي أو العكس.

نوع `Percentage Milli`

Scalar	الوصف
`integer`	نسبة مئوية معروضة بالملي ثانية (1/1,000 من النسبة المئوية)، على سبيل المثال، `100` تعني 0.1%.

نوع `FileSummary`

اسم الحقل	النوع	الوصف
`name`	`string`	اسم الملف (باستثناء اسم الحزمة أو الدليل)
`num_records`	`integer`	عدد الكيانات في الملف.
`version`	`integer`	رقم الإصدار الرئيسي للملف. قد يتغيّر هذا الرقم في حال إنشاء إصدارات جديدة من تنسيق بيانات العناصر في المستقبل.

نوع `EntityCommonData`

اسم الحقل	النوع	الوصف
`id`	`Numeric Id`	معرّف فريد ضمن كل نوع من أنواع الكيانات: على سبيل المثال، مع الكيانات الشريكة، سيكون هذا المعرّف هو رقم تعريف الشريك، وبالنسبة إلى المعلِنين، سيكون رقم تعريف المعلِن، وما إلى ذلك.
`name`	`string`	اسم الكيان الظاهر في واجهة المستخدم.
`active`	`boolean`	الحالة التي ضبطها المستخدم: قد لا يكون الكيان معروضًا لأسباب أخرى، مثل ميزانية مستنفدة أو انتهاء فترة عرض الإعلانات وما إلى ذلك.
`integration_code`	`string`	رمز الدمج الذي يحدّده المستخدم

نوع واحد (`ExchangeSettings`)

اسم الحقل	النوع	الوصف
`exchange_id`	`Numeric Id`	رقم تعريف التبادل. يمكن الانضمام إليها باستخدام SupportedExchange.id
`seat_id`	`string`	رقم تعريف المقعد المراد استبداله
`seat_user_name`	`string`	اسم المستخدم المرتبط بهذا المقعد (لا ينطبق إلا على مقاعد Right Media غير المستندة إلى عروض الأسعار في الوقت الفعلي)

نوع `ApprovalStatus`

اسم الحقل	النوع	الوصف
`auditor`	`Enum`	`0=DOUBLECLICK_BID_MANAGER 1=DOUBLECLICK_AD_EXCHANGE 2=APPNEXUS 3=APPNEXUS_MICROSOFT 4=RIGHT_MEDIA_NON_RTB`
`status`	`Enum`	`0=APPROVED 1=REJECTED 2=PENDING 3=NO_AUDIT 4=UN_AUDITABLE 5=UNKNOWN 6=IN_AUDIT`
`feedback`	`string`	ملاحظات من المدقّق قد تتضمّن معلومات إضافية، مثل أسباب الرفض
`sync_time`	`Time`	آخر مرة تمت فيها مزامنة الكيان مع `auditor`
`external_id`	`Numeric Id`	لا تتم تعبئة هذه السمة إلا إذا كانت قيمة `auditor` هي `APPNEXUS` أو `APPNEXUS_MICROSOFT` أو `RIGHT_MEDIA_NON_RTB`. هذا هو رقم تعريف الكيان في مساحة المدقّق.

نوع `Budget`

اسم الحقل	النوع	الوصف
`start_time_usec`	`Time`	وقت بدء فترة الميزانية
`end_time_usec`	`Time`	وقت انتهاء فترة الميزانية
`max_impressions`	`integer`	الحدّ الأقصى لعدد مرّات الظهور لهذه الميزانية إذا لم يكن هذا الحقل متوفّرًا، يعني ذلك أنّ الميزانية مخصّصة لمرّات الظهور غير المحدودة.
`max_spend_advertiser_micros`	`integer`	الحدّ الأقصى للإنفاق (بوحدات ميكرو عملة المعلِن) لهذه الميزانية. إذا لم يكن هذا الحقل متوفّرًا، يعني ذلك أنّ الميزانية هي ميزانية إنفاق غير محدود.
`pacing_type`	`Enum`	`0=FLIGHT 1=DAILY`
`pacing_max_impressions`	`integer`	الحد الأقصى لعدد مرات الظهور لكل فاصل زمني لمعدل السرعة تم ضبطه من خلال `pacing_type`. في حال عدم توفّر هذا الحقل، لن يكون هناك حدّ أقصى لعدد مرّات الظهور.
`pacing_max_spend_advertiser_micros`	`integer`	الحد الأقصى للإنفاق (بوحدات ميكرو عملة المعلِن) لكل فاصل سرعة يحدّده `pacing_type` إذا لم يكن هذا الحقل متوفّرًا، لن يكون هناك حدّ أقصى للإنفاق.
`pacing_distribution`	`Enum`	`0=ASAP 1=EVEN 2=AHEAD`

نوع `FrequencyCap`

اسم الحقل	النوع	الوصف
`max_impressions`	`integer`	الحد الأقصى لعدد مرّات الظهور في كلّ فاصل زمني للحدّ الأقصى
`time_unit`	`Enum`	وحدة الوقت: `0=MINUTE 1=HOUR 2=DAY 3=WEEK 4=MONTH 5=LIFE_TIME`
`time_range`	`integer`	عدد `time_units`، على سبيل المثال، إذا كان `time_unit` هو `1`، تكون قيمة 6 لـ `time_range` هي 6 ساعات.

نوع `PartnerCosts`

اسم الحقل	النوع	الوصف
`cpm_fee_1_advertiser_micros`	`integer`	رسوم التكلفة لكل ألف ظهور 1 بالدولار الأمريكي بالمايكرو
`cpm_fee_2_advertiser_micros`	`integer`	رسوم التكلفة لكل ألف ظهور 2 بالدولار الأمريكي بالمايكرو
`cpm_fee_3_advertiser_micros`	`integer`	رسوم التكلفة لكلّ ألف ظهور 3 بوحدات ميكرو بعملة المعلِن
`cpm_fee_4_advertiser_micros`	`integer`	رسوم التكلفة لكلّ ألف ظهور 4 بوحدات ميكرو بعملة المعلِن
`cpm_fee_5_advertiser_micros`	`integer`	رسوم التكلفة لكلّ ألف ظهور 5 بوحدات ميكرو عملة المعلِن
`media_fee_percent_1_millis`	`integer`	رسوم جميع الوسائل 1 في `Percentage Milli`
`media_fee_percent_2_millis`	`integer`	رسوم جميع الوسائل 2 في `Percentage Milli`
`media_fee_percent_3_millis`	`integer`	رسوم جميع الوسائل 3 في `Percentage Milli`
`media_fee_percent_4_millis`	`integer`	رسوم جميع الوسائل رقم 4 في `Percentage Milli`
`media_fee_percent_5_millis`	`integer`	رسوم جميع الوسائل الخامسة في `Percentage Milli`
`cpm_fee_1_cost_type`	`Enum`	`0=DEFAULT_COST_TYPE 1=BID_MANAGER_FEE 2=THIRDPARTY_AD_SERVER 3=DOUBLE_VERIFY 4=ADSAFE 5=ADXPOSE 6=VIZU 7=AGGREGATE_KNOWLEDGE 8=TERACENT 9=EVIDON 10=ATD_FEE 11=DMP_FEE 12=INTEGRAL_AD_SCIENCE_PREBID 13=DOUBLE_VERIFY_PREBID 14=SHOP_LOCAL 15=TRUST_METRICS 16=MEDIACOST_DATA 17=INTEGRAL_AD_SCIENCE_VIDEO 18=MOAT_VIDEO 19=NIELSON_OCR 20=COMSCORE_VCE 21=ADLOOX 22=ADLOOX_PREBID 23=EXTRA_XBID_FEE 24=ADLINGO_FEE 25=CUSTOM_FEE_1 26=CUSTOM_FEE_2 27=CUSTOM_FEE_3 28=CUSTOM_FEE_4 29=CUSTOM_FEE_5` يمثّل الرمز `ATD_FEE` رسوم مكتب التداول في الوكالة.
`cpm_fee_2_cost_type`	`Enum`	كما هو الحال مع `cpm_fee_1_cost_type`.
`cpm_fee_3_cost_type`	`Enum`	هذا الخيار مماثل لتاريخ `cpm_fee_1_cost_type`.
`cpm_fee_4_cost_type`	`Enum`	هذا الخيار مماثل لتاريخ `cpm_fee_1_cost_type`.
`cpm_fee_5_cost_type`	`Enum`	هذا الخيار مماثل لتاريخ `cpm_fee_1_cost_type`.
`media_fee_percent_1_cost_type`	`Enum`	هذا الخيار مماثل لتاريخ `cpm_fee_1_cost_type`.
`media_fee_percent_2_cost_type`	`Enum`	هذا الخيار مماثل لتاريخ `cpm_fee_1_cost_type`.
`media_fee_percent_3_cost_type`	`Enum`	هذا الخيار مماثل لتاريخ `cpm_fee_1_cost_type`.
`media_fee_percent_4_cost_type`	`Enum`	هذا الخيار مماثل لتاريخ `cpm_fee_1_cost_type`.
`media_fee_percent_5_cost_type`	`Enum`	كما هو الحال مع `cpm_fee_1_cost_type`.
`cpm_fee_1_bill_to_type`	`Enum`	`0=DEFAULT_BILL_TO_TYPE 1=INVITE_MEDIA 2=PARTNER`
`cpm_fee_2_bill_to_type`	`Enum`	كما هو الحال مع `cpm_fee_1_bill_to_type`.
`cpm_fee_3_bill_to_type`	`Enum`	كما هو الحال مع `cpm_fee_1_bill_to_type`.
`cpm_fee_4_bill_to_type`	`Enum`	كما هو الحال مع `cpm_fee_1_bill_to_type`.
`cpm_fee_5_bill_to_type`	`Enum`	كما هو الحال مع `cpm_fee_1_bill_to_type`.
`media_fee_percent_1_bill_to_type`	`Enum`	كما هو الحال مع `cpm_fee_1_bill_to_type`.
`media_fee_percent_2_bill_to_type`	`Enum`	كما هو الحال مع `cpm_fee_1_bill_to_type`.
`media_fee_percent_3_bill_to_type`	`Enum`	كما هو الحال مع `cpm_fee_1_bill_to_type`.
`media_fee_percent_4_bill_to_type`	`Enum`	كما هو الحال مع `cpm_fee_1_bill_to_type`.
`media_fee_percent_5_bill_to_type`	`Enum`	كما هو الحال مع `cpm_fee_1_bill_to_type`.

نوع `PartnerRevenueModel`

اسم الحقل	النوع	الوصف
`type`	`Enum`	`0=CPM 1=MEDIA_COST_MARKUP 2=TOTAL_MEDIA_COST_MARKUP`
`amount_advertiser_micros`	`integer`	مبلغ الأرباح في الميكروالإعلانات الحالية للمعلِن. لا يتم ضبط هذه القيمة إلا إذا كان النوع هو `CPM`.
`media_cost_markup_percent_millis`	`integer`	النسبة المئوية لزيادة الأرباح في `Percentage Milli`. لا يتم ضبط هذه القيمة إلا إذا كان النوع هو `MEDIA_COST_MARKUP` أو `TOTAL_MEDIA_COST_MARKUP`.
`post_view_conversion_tracking_fraction`	`float`	جزء من الإحالات الناجحة بعد الرؤية التي سيتم احتسابها لتتبُّع الإحالات الناجحة. إذا كانت القيمة 0، يتم احتساب الإحالات الناجحة بعد النقر فقط. وإذا كانت القيمة 1.0، يتم تتبُّع جميع الإحالات الناجحة.

نوع `CostTrackingPixel`

اسم الحقل	النوع	الوصف
`pixel_id`	`Numeric Id`	معرّف وحدة البكسل للتتبّع: يُرجى العِلم أنّه قد يتشارك `CostTrackingPixel`ان معرّف `pixel_id` نفسه ولكنّهما يختلفان في قيم عرض الإعلان أو نافذة النقرة. يمكن دمج هذه القيمة مع `Pixel.common_data.id`.
`view_window_minutes`	`integer`	عدد الدقائق التي يتم فيها البحث عن الإحالات الناجحة بعد المشاهدة
`click_window_minutes`	`integer`	عدد الدقائق التي يتم فيها البحث عن الإحالات الناجحة بعد النقر.
`floodlight_activity_id`	المعرّف الرقمي	أرقام تعريف أنشطة Floodlight في "مدير الحملة" يمكن دمج هذه القيمة مع `Pixel.dcm_floodlight_id`.

نوع `Target`

اسم الحقل	النوع	الوصف
`criteria_id`	`Numeric Id`	يمكن الانضمام إلى جدول آخر بناءً على النوع المحدّد في `TargetList`. قد لا تكون هذه القيمة متوفّرة.
`parameter`	`string`	مَعلمة إضافية يعتمد تعريفها على النوع المحدّد في `TargetList`. قد لا تكون هذه القيمة متوفّرة.
`excluded`	`boolean`	وعندما تكون القيمة `true`، يعني ذلك أنّه سيتم استبعاد الهدف. تشير القيمة غير المتوفّرة إلى `false`.

نوع `TargetUnion`

اسم الحقل	النوع	الوصف
`union`	`[Target]`	مصفوفة من أنواع `Target` تمثّل تجميع الاستهدافات
`excluded`	`boolean`	عندما يكون `true`، يعني ذلك أنّه تم استبعاد عملية دمج الاستهداف. تشير القيمة غير المتوفّرة إلى `false`.

نوع `TargetList`

اسم الحقل	النوع	الوصف
`inventory_sources`	`[Target]`	صفيف من أنواع `Target` لمصادر المستودع يمكن دمج `Target.criteria_id` مع `InventorySource.id` و `Target.parameter` غير محدّد.
`geo_locations`	`[Target]`	صفيف من أنواع `Target` للمواقع الجغرافية يمكن دمج `Target.criteria_id` مع `GeoLocation.id` و `Target.parameter` غير محدّد.
`ad_position`	`Target`	`Target` يشير إلى موضع الإعلان على صفحة الناشر قيم `Target.criteria_id` هي `0=ALL_POSITIONS 1=ABOVE_THE_FOLD 2=BELOW_THE_FOLD 3=UNKNOWN_POSITION` `Target.parameter` غير محدّدة.
`net_speed`	`Target`	`Target` يشير إلى سرعة الشبكة قيم `Target.criteria_id` هي: `0=ALL_CONNECTION_SPEEDS` `1=BROADBAND` (2.0 ميغابت في الثانية أو أسرع). `2=DIALUP` (56 كيلوبت في الثانية وأبطأ): `3=UNKNOWN_CONNECTION_SPEED` `4=EDGE` (Enhanced Data for GSM Evolution (2G). ‫57 كيلوبت في الثانية أو أسرع) `5=UMT` (Universal Mobile Telecom System (3G). 384 كيلوبت في الثانية وأسرع). `6=DSL` (خط المشترك الرقمي 768 كيلوبت في الثانية وأسرع). `7=HSDPA` (High-Speed Downlink Packet Access (3.5G). ‫1.8 ميغابت في الثانية أو أسرع) السمة `Target.parameter` غير معرَّفة.
`browsers`	`TargetUnion`	النوع `TargetUnion` للمتصفّحات. يمكن ضم `Target.criteria_id` باستخدام `Browser.id`، أمّا السمة `Target.parameter` فهي غير محدّدة.
`device_criteria`	`[Target]`	`Array of Target` أنواع لمعايير الأجهزة يمكن دمج `Target.criteria_id` مع `DeviceCriteria.id` و`Target.parameter` غير محدّد.
`languages`	`TargetUnion`	النوع `TargetUnion` للغة. يمكن دمج `Target.criteria_id` مع `Language.id` و`Target.parameter` غير محدّد.
`day_parting`	`TargetUnion`	‫`TargetUnion` نوع لفاصل اليوم يتألّف `Target.criteria_id` من 6 أرقام: `(TimeZone)(DayOfWeek)(StartTime)(EndTime)` المنطقة الزمنية: `0=USER 1=EASTERN 2=PACIFIC 3=LONDON 4=COPENHAGEN 5=SYDNEY 6=AUCKLAND 7=HONG_KONG 8=TOKYO 9=CALCUTTA 10=ADVERTISER` اليوم من الأسبوع: `0=MONDAY 1=TUESDAY 2=WEDNESDAY 3=THURSDAY 4=FRIDAY 5=SATURDAY 6=SUNDAY` وقت البدء: الدقائق منذ منتصف الليل مقسومة على 15. تتراوح بين 0 و95. EndTime: الدقائق منذ منتصف الليل، مقسومة على 15 تتراوح القيم بين 1 و96. على سبيل المثال، تعني القيمة `200380` الاثنين من الساعة 00:45 إلى 20:00 بتوقيت المحيط الهادئ. `Target.parameter` غير محدّد.
`audience_intersect`	`[TargetUnion]`	مصفوفة من أنواع `TargetUnion` لتقاطع الجماهير، على سبيل المثال [{“union”: [A, B]}, {“union”: [C, D]}, {“union”: [E, F], “excluded”: true}] يُقصد به "(أ أو ب) و (ج أو د) وليس (هـ أو F)". `Target.criteria_id` يمكن دمجه مع `UserList.id` و `Target.parameter` هي قيمة تكرار ظهور البكسل بالميكرو ثانية. في حال عدم توفّر هذه القيمة، يعني ذلك استهداف جميع شرائح الجمهور.
`keywords`	`[Target]`	مصفوفة مكوّنة من `Target` نوع للكلمات الرئيسية `Target.criteria_id` غير محدّد و`Target.parameter` كلمة رئيسية واحدة.
`kct_include_uncrawled_sites`	`boolean`	علامة للإشارة إلى ما إذا كان يجب تضمين المواقع الإلكترونية غير المفهرَسة في KCT
`page_categories`	`[Target]`	مصفوفة من أنواع `Target` لمواضع صفحات AdExchange. `Target.criteria_id` هو المعرّف الرقمي لقطاع و`Target.parameter` غير محدّد.
`universal_channels`	`[Target]`	صفيف من أنواع `Target` للقنوات يمكن دمج `Target.criteria_id` مع `UniversalChannel.id` و`Target.parameter` غير محدّد.
`sites`	`[Target]`	صفيف من أنواع `Target` للمواقع الإلكترونية يمكن الانضمام إلى `Target.criteria_id` باستخدام `UniversalSite.id` أو لا يتم ضبطه إذا لم يكن الموقع الإلكتروني في `UniversalSite`. `Target.parameter` هو موقع إلكتروني مثل `google.com`، ولكن لا يمكن العثور عليه بالضرورة في `UniversalSite`.
`isps`	`TargetUnion`	`TargetUnion` نوع مزوّد خدمة الإنترنت يمكن ضم `Target.criteria_id` باستخدام `ISP.id`، أمّا السمة `Target.parameter` فهي غير محدّدة.

نوع `SummaryFile`

اسم الحقل	النوع	الوصف
`file`	`[FileSummary]`	مصفوفة من صفر أو أكثر من إدخالات `FileSummary` إذا كانت هذه الصفيفة فارغة، هذا يعني أنّه لم يتم إنشاء أي بيانات في هذا التاريخ.

نوع `UserListAdvertiserPricing`

اسم الحقل	النوع	الوصف
`pricing`	`UserListPricing`
`advertiser_id`	`Numeric Id`

نوع `UserListPricing`

اسم الحقل	النوع	الوصف
`cost_type`	`string`
`currency_code`	`string`	رمز العملة المكوّن من ثلاثة أحرف وفقًا لمعيار ISO 4217، مثل USD للدولار الأمريكي
`cost_micros`	`Currency Micro`

الجداول الخاصة

جدول `Partner`

اسم الحقل	النوع	الوصف
`common_data`	`EntityCommonData`	يحتوي على البيانات الشائعة عن هذا الشريك، مثل الاسم ورقم التعريف.
`currency_code`	`string`	رمز العملة المكوّن من ثلاثة أحرف وفقًا لمعيار ISO 4217، مثل `USD` للدولار الأمريكي
`exchange_settings`	`[ExchangeSettings]`	صفيف من أنواع `ExchangeSettings` يحتوي على معلومات مثل أرقام تعريف المقاعد لن تظهر سوى التبادلات المفعَّلة.
`default_partner_costs`	`PartnerCosts`	يحتوي على معلومات عن التكاليف التلقائية لهذا الشريك.
`default_partner_revenue_model`	`PartnerRevenueModel`	يحتوي على معلومات عن نموذج الأرباح التلقائي لهذا الشريك.
`default_target_list`	`TargetList`	يحتوي على خيارات الاستهداف التلقائية للشريك. لا يتوفّر حاليًا سوى الاستهداف الجغرافي التلقائي هنا.

جدول `Advertiser`

اسم الحقل	النوع	الوصف
`common_data`	`EntityCommonData`	تحتوي على البيانات الشائعة عن هذا المعلِن، مثل الاسم ورقم التعريف.
`partner_id`	`Numeric Id`	رقم تعريف عنصر الشريك الرئيسي. يمكن الانضمام باستخدام `Partner.common_data.id`.
`currency_code`	`string`	رمز العملة المكوّن من ثلاثة أحرف وفقًا لمعيار ISO 4217، مثل `USD` للدولار الأمريكي
`timezone_code`	`string`	رمز المنطقة الزمنية الرسمي، على سبيل المثال "America/Los_Angeles". إذا تم ضبط `dfa_configuration` على `NORMAL` أو `HYBRID`، ستكون هذه القيمة هي نفسها المنطقة الزمنية لمعلن Firebase المرتبط.
`landing_page_url`	`string`	عنوان URL التلقائي للصفحة المقصودة.
`available_channel_ids`	`[integer]`	مصفوفة من الأعداد الصحيحة تحتوي على القنوات المتاحة المرتبطة بهذا المعلِن. يمكن الانضمام إليه باستخدام `UniversalChannel.id`.
`blacklist_channel_id`	`[integer]`	مصفوفة من الأعداد الصحيحة التي تحتوي على قنوات القائمة السوداء لهذا المعلِن. يمكن الانضمام باستخدام `UniversalChannel.id`.
`dcm_configuration`	`Enum`	`0=NONE 1=NORMAL 2=HYBRID`
`dcm_network_id`	`Numeric Id`	رقم تعريف شبكة "مدير الحملة 360". لن تظهر هذه القيمة إذا تم ضبط `dcm_configuration` على `NONE`.
`dcm_advertiser_id`	`Numeric Id`	رقم تعريف المعلِن في "مدير الحملة 360". لن تتوفّر هذه القيمة في حال ضبط `dcm_configuration` على `NONE`.
`dcm_floodlight_group_id`	`Numeric Id`	لن تظهر هذه القيمة إذا تم ضبط `dcm_configuration` على `NONE`.
`dcm_syncable_site_ids`	`[Numeric Id]`	صفيف من أنواع `Numeric Id` لكل موقع إلكتروني قابل للمزامنة لهذا المعلِن.
`enable_oba_tags`	`boolean`	يتم تفعيل علامات OBA عند ضبط هذا الخيار على `true`.

جدول `Campaign`

اسم الحقل	النوع	الوصف
`common_data`	`EntityCommonData`	يحتوي على البيانات الشائعة عن هذه الحملة، مثل الاسم والمعرّف.
`advertiser_id`	`Numeric Id`	رقم تعريف عنصر المعلِن الرئيسي. يمكن الانضمام إليها باستخدام `Advertiser.common_data.id`
`budget`	`Budget`	الميزانية المخطّط لها لهذه الحملة. ويشمل ذلك وقت البدء ووقت الانتهاء.
`frequency_cap`	`FrequencyCap`	الحدّ الأقصى لعدد مرّات الظهور النشط لهذه الحملة. لن تكون هذه القيمة متوفّرة في حال عدم ضبط عدد مرات الظهور.
`default_target_list`	`TargetList`	يحتوي على معلومات عن الاستهداف الساري لهذه الحملة.
`uses_video_creatives`	`boolean`	عند ضبطها على "صحيح"، سيتم اقتراح طلبات إدراج الفيديو.
`uses_display_creatives`	`boolean`	وعند ضبطها على "صحيح"، سيتم اقتراح طلبات الإدراج.
`uses_audio_creatives`	`boolean`	عند ضبطها على "صحيح"، سيتم اقتراح طلبات إدراج الصوت.
`objective`	`Enum`	القيم هي: `1 = BRAND_AWARENESS` `2 = ONLINE_ACTION` `3 = OFFLINE_ACTION` `4 = APP_INSTALL`
`metric`	`Enum`	مؤشر الأداء الرئيسي استخدم هذا الحقل لتتبع المقياس الأساسي الذي ستستخدمه لتقييم نجاح حملتك. القيم المحتمَلة هي: `1 = IMPRESSIONS` `2 = VIEWABLE_IMPRESSIONS` `3 = CPM` `4 = CPV` `5 = UNIQUES` `6 = GRP` `7 = TRP` `8 = VCR` `9 = CPA` `10 = ROAS` `11 = CTR` `12 = CPC` `13 = CVR` `14 = CPI` `15 = VIEWABLE_PERCENT` `16 = CPIAVC` `17 = OTHER`
`objective_description`	`String`	عندما يكون المقياس هو `OTHER`، هذا هو الوصف الموجز للمقياس.
`metric_amount_micros`	`integer`	المبلغ المستهدَف للمقياس بوحدات المايكرو

جدول `InsertionOrder`

اسم الحقل	النوع	الوصف
`common_data`	`EntityCommonData`
`advertiser_id`	`Numeric Id`	رقم تعريف عنصر المعلِن الرئيسي. يمكن الانضمام إليه باستخدام `Advertiser.common_data.id`.
`campaign_id`	`Numeric Id`	رقم تعريف عنصر الحملة الرئيسي.
`overall_budget`	`Budget`	الميزانية الإجمالية لطلب الإدراج هذا يشمل وقت البدء ووقت الانتهاء.
`scheduled_segments`	`[Budget]`	يحتوي على أيّ شرائح ميزانية مجدوَلة. قد تكون هذه المصفوفة فارغة أو غير متوفّرة على الإطلاق.
`frequency_cap`	`FrequencyCap`	الحدّ الأقصى لعدد مرّات الظهور النشط لطلب الإدراج هذا. لن تكون هذه القيمة متوفّرة في حال عدم ضبط عدد مرات الظهور.
`default_partner_costs`	`PartnerCosts`
`default_target_list`	`TargetList`

جدول `LineItem`

اسم الحقل	النوع	الوصف
`common_data`	`EntityCommonData`
`line_item_type`	`Enum`	`0=RTB 1=RMX_NON_RTB 2=RTB_EXPANDABLE 3=RTB_MOBILE 4=RTB_VIDEO 5=TRUEVIEW 6=NON_RTB_EXCHANGES 7=RTB_AUDIO 8=GMAIL 9=ADWORDS_UAC 11=OUT_OF_HOME`
`insertion_order_id`	`Numeric Id`	رقم تعريف عنصر طلب الإدراج الرئيسي يمكن الانضمام إليها باستخدام `InsertionOrder.common_data.id`.
`creative_ids`	`[Numeric Id]`	مصفوفة من تصميمات الإعلانات التي تمّ تعيينها لهذا العنصر يمكن الانضمام إليه باستخدام `Creative.common_data.id`.
`max_cpm_advertiser_micros`	`integer`	الحد الأقصى لقيمة التكلفة لكل ألف ظهور بالمايكرو بعملة المعلِن
`performance_goal`	`Enum`	`0=NONE` (التكلفة لكل ألف ظهور قابل للعرض غير مفعّلة) `1=CPC 2=CPA 3=ROI 4=CPCV 5=CPM 6=AVCPM 7=IMP_VALUE_ROAS 8=CIVA 9=IVO_TEN 10=AV_VIEWED 11=INCREMENTAL_CONVERSIONS`
`goal_advertiser_micros`	`integer`	هدف التكلفة لكل ألف ظهور قابل للعرض بالمايكرو بعملة المعلِن لن تظهر هذه القيمة إذا تم ضبط `performance_goal` على `NONE`.
`partner_revenue_model`	`PartnerRevenueModel`	نموذج أرباح الشريك المستخدَم لهذا العنصر
`cost_tracking_pixels`	`[CostTrackingPixel]`	صفيف من CostTrackingPixels تمّ تعيينه لتتبُّع هذا العنصر.
`Budget`	`Budget`	الميزانية الإجمالية لتفاصيل الإعلان هذه. يشمل وقت البدء ووقت الانتهاء.
`frequency_cap`	`FrequencyCap`	الحدّ الأقصى لعدد مرّات الظهور النشط لهذا العنصر لن تظهر هذه القيمة إذا لم يتم ضبط حدّ أقصى لعدد مرّات الظهور.
`partner_costs`	`PartnerCosts`
`target_list`	`TargetList`	يحتوي على معلومات عن الاستهداف الساري لهذا العنصر.

جدول `Creative`

اسم الحقل	النوع	الوصف
`common_data`	`EntityCommonData`
`advertiser_id`	`Numeric Id`	رقم تعريف عنصر المعلِن الرئيسي. يمكن الانضمام باستخدام `Advertiser.common_data.id`.
`dcm_placement_id`	`Numeric Id`	رقم تعريف موضع الإعلان في "مدير الحملة 360" المرتبط بتصميم الإعلان هذا.
`width_pixels`	`integer`	عرض تصميم الإعلان بالبكسل
`height_pixels`	`integer`	ارتفاع تصميم الإعلان بالبكسل
`approval_status`	`[ApprovalStatus]`	مصفوفة تحتوي على عناصر `ApprovalStatus` تمثّل حالة تصميمات الإعلانات في تبادلات الموافقة على تصميمات الإعلانات.
`expanding_direction`	`Enum`	`0=Not Expandable 1=Expanding Up 2=Expanding Down 3=Expanding Left 4=Expanding Right 5=Expanding Up Left 6=Expanding Up Right 7=Expanding Down Left 8=Expanding Down Right 9=Expanding Up or Down 10=Expanding Left or Right 11=Expanding Any Diagonal`
`creative_type`	`Enum`	`0=Image or HTML5 1=Expandable 2=Video 3=Mobile 4=Native Site 5=Facebook Exchange Page Post (News Feed) Ads 6=Templated App Install Mobile Ads (Banner) 10=Native Site Square 12=Templated App Install Mobile Ads (Interstitial/Video Interstitial) 13=Lightbox 14=Native App Install 15=Native App Install Square 16=Audio 17=Publisher Hosted 18=Native Video 22=Flipbook 23=Templated App Install Video 24=TRACKING`

جدول `Pixel`

اسم الحقل	النوع	الوصف
`common_data`	`EntityCommonData`
`advertiser_id`	`Numeric Id`	رقم تعريف عنصر المعلِن الرئيسي. يمكن الانضمام إليه باستخدام `Advertiser.common_data.id`.
`partner_id`	`Numeric Id`	رقم تعريف عنصر الشريك الرئيسي. يمكن الانضمام باستخدام `Partner.common_data.id`.
`dcm_floodlight_id`	`Numeric Id`	رقم تعريف Floodlight في DFA المرتبط بهذا البكسل.
`allow_google_redirect`	`boolean`
`allow_rm_redirect`	`boolean`	عند ضبطها على `true`، سيتم تفعيل البكسل لإعادة التوجيه إلى Right Media أو منها.
`remarketing_enabled`	`boolean`	عند ضبطه على `true`، سيتم تفعيل هذه البكسل لاستخدامها في الاستهداف. لن تتوفّر هذه القيمة إلا في حال ضبط `dfa_configuration` للمعلن الرئيسي على `NONE`.
`is_secure`	`boolean`	عند ضبطه على `true`، سيستخدم هذا البكسل بروتوكول HTTPS. لن تتوفّر هذه القيمة إلا في حال ضبط `dfa_configuration` للمعلن الرئيسي على `NONE`.

جدول `Floodlight Activity`

اسم الحقل	النوع	الوصف
`common_data`	`EntityCommonData`
`advertiser_id`	`Numeric Id`	رقم تعريف عنصر المعلِن الرئيسي. يمكن الانضمام باستخدام `Advertiser.common_data.id`.
`partner_id`	`Numeric Id`	معرّف عنصر الشريك المُدير للمعلِن الرئيسي يمكن الانضمام إليه باستخدام `Partner.common_data.id`.
`remarketing_enabled`	`boolean`	عند ضبطه على `true`، سيتم تفعيل هذا النشاط لاستخدامه في الاستهداف.
`ssl_required`	`boolean`	عند ضبط القيمة على `true`، يجب أن تكون العلامات متوافقة.

جدول `InventorySource`

اسم الحقل	النوع	الوصف
`id`	`Numeric Id`	مفتاح فريد لمصدر المستودع
`unclassified`	`boolean`	عند ضبط القيمة على `true`، سيتم تضمين جميع المستودعات غير المصنّفة.
`inventory_name`	`string`	اسم مصدر المستودع كما يظهر في واجهة المستخدم قد لا يكون هذا الحقل متوفّرًا. في حال عدم توفّر السمة `inventory_name` وكانت السمة `unclassified` صحيحة، يشير ذلك إلى المستودع غير المصنّف للتبادل. إذا لم يكن هذا الحقل متوفّرًا وكانت قيمة `unclassified` خاطئة، يكون مصدر المستودع هو المستودع على مستوى التبادل.
`exchange_id`	`Numeric Id`	رقم تعريف التبادل الذي يتوفّر فيه مصدر المستودع هذا. يمكن الانضمام إليه باستخدام `SupportedExchange.id`.
`accessing_advertisers`	`[Numeric Id]`	هناك مصفوفة من أرقام تعريف المعلنين، والتي يمكن الانضمام إليها مع `Advertiser.common_data.id`، والإذن باستخدام مصدر المستودع هذا. ملاحظة: إذا كان مصدر المستودع الإعلاني متاحًا لجميع المعلِنين، لن يكون هذا الحقل متوفّرًا.
`external_id`	`string`	رقم التعريف الخارجي الذي يتم منحه لمصدر المستودع هذا والمحدّد من خلال عملية التبادل، ويُعرف عادةً باسم الصفقة أو الرقم التعريفي للبائع. قد يكون هذا الحقل غير متوفر.
`min_cpm_micros`	`integer`	السعر الأدنى الساري لمستودع الإعلانات هذا بالفئات الصغيرة للعملة
`min_cpm_currency_code`	`string`	رمز العملة المكوّن من 3 أحرف وفقًا لمعيار ISO 4217 والمستخدَم في `min_cpm_micros`.

جدول `UserList`

اسم الحقل	النوع	الوصف
`id`	`Numeric Id`	مفتاح فريد لقائمة المستخدمين
`name`	`string`	اسم قائمة المستخدمين كما يظهر في واجهة المستخدم
`data_partner_id`	`Numeric Id`	يمكن الانضمام إليه باستخدام `DataPartner.id`. لا يتم ضبط هذا الحقل إلا لقوائم المستخدمين التابعة لجهات خارجية.
`accessing_advertisers`	`[Numeric Id]`	صفيف من أرقام تعريف المعلِنين، يمكن دمجه مع `Advertiser.common_data.id`، تم منحه الإذن باستخدام قائمة المستخدِمين هذه. ملاحظة: إذا كانت قائمة المستخدِمين متاحة لجميع المعلِنين، لن يظهر هذا الحقل.
`partner_pricing`	`UserListPricing`	سيكون نوع التكلفة دائمًا "التكلفة لكل ألف ظهور"، وسيكون رمز العملة دائمًا "دولار أمريكي".
`advertiser_pricings`	`[UserListAdvertiserPricing]`	سيكون نوع التكلفة دائمًا "التكلفة لكل ألف ظهور"، وسيكون رمز العملة دائمًا "دولار أمريكي".

جدول `CustomAffinity`

اسم الحقل	النوع	الوصف
`id`	`Numeric Id`	مفتاح فريد للجمهور المخصّص ذي الاهتمامات المشتركة
`name`	`string`	اسم التشابه المخصّص كما يظهر في واجهة المستخدِم
`description`	`string`	وصف الجمهور المخصّص ذي الاهتمامات المشتركة كما يظهر في واجهة المستخدِم
`advertiser_id`	`Numeric Id`	رقم تعريف عنصر المعلِن الرئيسي يمكن الانضمام إليه باستخدام `Advertiser.common_data.id`.

جدول `UniversalChannel`

اسم الحقل	النوع	الوصف
`id`	`Numeric Id`	مفتاح فريد للقناة
`name`	`string`	اسم القناة كما يظهر في واجهة المستخدم
`site_ids`	`[Numeric Id]`	مصفوفة تحتوي على معرّفات `UniversalSite` في هذه القناة يمكن الانضمام إليه باستخدام `UniversalSite.id`.
`accessing_advertisers`	`[Numeric Id]`	صفيف من أرقام تعريف المعلِنين الذين يمكن الانضمام إليهم باستخدام `Advertiser.common_data.id`، والذين لديهم الإذن باستخدام هذه القناة. ملاحظة: إذا كانت القناة متاحة لجميع المعلِنين، لن يظهر هذا الحقل.
`is_deleted`	`boolean`	عند ضبط القيمة على `true`، لن تتمكّن أيّ تفاصيل إعلان جديدة من استهداف هذه القناة، ولكن ستستمرّ تفاصيل الإعلان الحالية التي تستهدف هذه القناة في استهدافها.
`is_brand_safe_channel`	`boolean`	عند ضبطها على `true`، يمكن استخدام هذه القناة لفلترة أمان العلامة التجارية. يُرجى العِلم أنّ هذا السعر ينطبق حاليًا على `true` فقط للمستويات الأربعة المضمّنة لأمان العلامة التجارية.

جدول `NegativeKeywordList`

اسم الحقل	النوع	الوصف
`id`	`Numeric Id`	مفتاح فريد لقائمة الكلمات الرئيسية السلبية.
`name`	`string`	اسم قائمة الكلمات الرئيسية السلبية كما يظهر في واجهة المستخدم
`advertiser_id`	`Numeric Id`	رقم تعريف عنصر المعلِن الرئيسي. يمكن الانضمام إليه باستخدام `Advertiser.common_data.id`.

الجداول العلنية

جدول `SupportedExchange`

اسم الحقل	النوع	الوصف
`id`	`Numeric Id`	مفتاح فريد للتبادل
`name`	`string`	اسم التبادل، على سبيل المثال `Ad Exchange`.

جدول `DataPartner`

اسم الحقل	النوع	الوصف
`id`	`Numeric Id`	مفتاح فريد لموفّر البيانات التابع لجهة خارجية
`name`	`string`	اسم مقدّم البيانات التابع لجهة خارجية، على سبيل المثال `BlueKai`.

جدول `UniversalSite`

اسم الحقل	النوع	الوصف
`id`	`Numeric Id`	مفتاح فريد للموقع الإلكتروني العام.
`name`	`string`	عنوان URL للموقع الإلكتروني أو اسمه، على سبيل المثال `google.com` أو `Google Unclassified`

جدول `SiteIdToPlacementId`

اسم الحقل	النوع	الوصف
`siteId`	`Numeric Id`	التعيين من رقم تعريف الموقع العام إلى أرقام تعريف مواضع الويب.
`placementId`	`Numeric Id`	عنوان URL أو اسم موضع الإعلان على الويب، على سبيل المثال `google.com` أو `Google Unclassified`.

جدول `GeoLocation`

اسم الحقل	النوع	الوصف
`id`	`Numeric Id`	مفتاح فريد للموقع الجغرافي
`canonical_name`	`string`	سلسلة الموقع المفصولة بفواصل ومصادرها. مثال: "سياتل، واشنطن، الولايات المتحدة".
`geo_name`	`string`	اسم الموقع الجغرافي مثال: "الإسكندرية".
`country_code`	`string`	رمز البلد وفقًا لمعيار ISO-3166 alpha-2 لهذا الموقع الجغرافي، على سبيل المثال `US`.
`region_code`	`string`	رمز التقسيم الفرعي ISO-3166-2 لهذا الموقع الجغرافي، على سبيل المثال `US-WA`. قد لا يكون هذا الحقل متوفّرًا.
`city_name`	`string`	اسم المدينة لهذا الموقع الجغرافي، على سبيل المثال `Seattle`. قد لا يكون هذا الحقل متوفّرًا.
`postal_code`	`string`	الرمز البريدي لهذا الموقع الجغرافي، على سبيل المثال `98033` قد لا يكون هذا الحقل متوفّرًا.
`dma_code`	`integer`	رمز منطقة السوق المحدّدة لهذا الموقع الجغرافي، على سبيل المثال `510`. قد لا يكون هذا الحقل متوفّرًا.

جدول `Language`

اسم الحقل	النوع	الوصف
`id`	`Numeric Id`	مفتاح فريد لهذه اللغة.
`code`	`string`	ويمكنك استخدام رمز ISO-639-1 لهذه اللغة أو أحد `zh_CN` للغة الصينية (المبسّطة) أو `zh_TW` للصينية (التقليدية) أو `other` للغات الأخرى.

جدول `DeviceCriteria`

اسم الحقل	النوع	الوصف
`id`	`Numeric Id`	مفتاح فريد لمعايير الأجهزة هذه.
`is_mobile`	`boolean`	إذا كانت القيمة هي true، سيغطي هذا المعيار الأجهزة الجوّالة فقط. إذا كان القيمة خطأ، لا يشمل هذا الإدخال سوى الأجهزة غير الجوّالة، حتى إذا كان اسمه (مثل "غير ذلك") لا يشير إلى ذلك.
`name`	`string`	الاسم الشائع لـ "معايير الأجهزة".
`criteria_type`	`Enum`	`0=OPERATING_SYSTEM 1=MOBILE_MAKE_MODEL 2=DEVICE_TYPE`
`operating_system_id`	`Numeric Id`	تحدد نظام التشغيل. لا تتم تعبئة هذا الحقل إلّا عندما يكون `criteria_type` هو `0`.
`mobile_brand_name`	`string`	اسم العلامة التجارية للجهاز لا تتم تعبئة هذا الحقل إلّا عندما تكون قيمة `criteria_type` هي `1`.
`mobile_model_name`	`string`	اسم طراز الجهاز لا تتم تعبئة هذا الحقل إلا عندما يكون `criteria_type` هو `1`. اختياريّ.
`mobile_make_model_id`	`Numeric Id`	تحدد رقم طراز الجهاز. لا تتم تعبئة هذا الحقل إلا عندما يكون `criteria_type` هو `1`. اختياريّ.
`device_type`	`Enum`	تشير هذه السمة إلى نوع الجهاز. لا تتم تعبئة هذا الحقل إلّا عندما تكون قيمة `criteria_type` هي `2`. `0=COMPUTER 1=OTHER 2=SMARTPHONE 3=TABLET 4=SMARTTV 5=CONNECTEDTV 6=SET_TOP_BOX 7=CONNECTEDDEVICE`

جدول `Browser`

اسم الحقل	النوع	الوصف
`id`	`Numeric Id`	مفتاح فريد لهذا المتصفح.
`is_mobile`	`boolean`	إذا كان صحيحًا، لا يشمل هذا المعيار سوى الأجهزة الجوّالة. إذا كانت القيمة "false"، لا يشمل هذا الإدخال سوى الأجهزة غير الجوّالة، حتى إذا كان اسمها (مثل "غير ذلك") لا يشير إلى ذلك.
`name`	`string`	الاسم المألوف للمتصفّح، على سبيل المثال `Safari 5`. ولا يتضمّن سلسلة وكيل المستخدم الكاملة.

جدول `Isp`

اسم الحقل	النوع	الوصف
`id`	`Numeric Id`	مفتاح فريد لمزوّد خدمة الإنترنت هذا
`is_mobile`	`boolean`	إذا كانت القيمة هي true، سيغطي هذا المعيار الأجهزة الجوّالة فقط. إذا كانت القيمة "false"، لا يشمل هذا الإدخال سوى الأجهزة غير الجوّالة، حتى إذا كان اسمها (مثل "غير ذلك") لا يشير إلى ذلك.
`name`	`string`	اسم مزوّد خدمة الإنترنت هذا
`secondary_criteria_id`	`integer`	معرّف بديل اختياري يمكن استخدامه لتحديد الكيان

جدول `AppCollection`

اسم الحقل	النوع	الوصف
`id`	`Numeric Id`	مفتاح فريد لمجموعة التطبيقات هذه
`name`	`string`	اسم مجموعة التطبيقات هذه.

تنسيق ملفات قراءة الكيانات - الإصدار 2

الأنواع المشتركة

نوع واحد (Numeric Id)

نوع Enum

نوع واحد (Time)

نوع Currency Micro

نوع Percentage Milli

نوع FileSummary

نوع EntityCommonData

نوع واحد (ExchangeSettings)

نوع ApprovalStatus

نوع Budget

نوع FrequencyCap

نوع PartnerCosts

نوع PartnerRevenueModel

نوع CostTrackingPixel

نوع Target

نوع TargetUnion

نوع TargetList

نوع SummaryFile

نوع UserListAdvertiserPricing

نوع UserListPricing

الجداول الخاصة

جدول Partner

جدول Advertiser

جدول Campaign

جدول InsertionOrder

جدول LineItem

جدول Creative

جدول Pixel

جدول Floodlight Activity

جدول InventorySource

جدول UserList

جدول CustomAffinity

جدول UniversalChannel

جدول NegativeKeywordList