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

في 31 تشرين الأول (أكتوبر) 2024، سيتم إيقاف ميزة "الملفات المقروءة الخاصة بالكيان" نهائيًا ولن يتم إنشاؤها بعد ذلك. للمزيد من التفاصيل، يمكنك الاطّلاع على دليل نقل البيانات إلى واجهة برمجة تطبيقات "مساحة العرض والفيديو 360".

يتم حذف البيانات العددية الفارغة

أيضًا من الملفات العددية الفارغة.

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

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

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

نوع واحد (Numeric Id)

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

نوع واحد (Enum)

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

نوع واحد (Time)

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

نوع واحد (Currency Micro)

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

نوع واحد (Percentage Milli)

عددي	الوصف
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" التي لا تستخدم RTB).

نوع واحد (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	رسوم جميع الوسائل الأولى في Percentage Milli
media_fee_percent_2_millis	integer	رسوم جميع الوسائل الثانية في Percentage Milli
media_fee_percent_3_millis	integer	رسوم جميع الوسائل الثالثة في Percentage Milli
media_fee_percent_4_millis	integer	رسوم جميع الوسائل الرابعة في 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 (البيانات المحسّنة لتطور GSM (2G) 57 كيلوبت في الثانية أو أكثر). 5=UMT (نظام اتصالات الجوّال العالمي (3G)) 384 كيلوبت في الثانية أو أكثر). 6=DSL (خط المشترك الرقمي) 768 كيلوبت في الثانية أو أكثر). 7=HSDPA (الوصول إلى حزم رابط التنزيل العالي السرعة (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. وقت الانتهاء: دقيقة منذ منتصف الليل، مقسومةً على 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}] تعني "(A OR B) AND (C OR D) AND NOT (E OR 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، ستكون هذه القيمة مماثلة للمنطقة الزمنية لمعلِن Floodlight المرتبط.
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 في DDEX المرتبط بوحدة البكسل هذه.
allow_google_redirect	boolean
allow_rm_redirect	boolean	عند ضبط هذه السياسة على true، سيتم تفعيل ميزة الانتقال إلى جديد من/إلى الوسائط اليمنى.
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	تمثّل هذه السمة رمز العملة بالتنسيق ISO 4217 المكوَّن من 3 أحرف والمستخدَم في 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	سيكون نوع التكلفة دائمًا هو تكلفة الألف ظهور (CPM)، ورمز العملة دائمًا هو بالدولار الأمريكي.
advertiser_pricings	[UserListAdvertiserPricing]	سيكون نوع التكلفة دائمًا هو تكلفة الألف ظهور (CPM)، ورمز العملة دائمًا هو بالدولار الأمريكي.

جدول "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	في حال اختيار القيمة "صحيح"، يشمل هذا المعيار الأجهزة الجوّالة فقط. إذا كانت الإجابة false، سيشمل هذا الإدخال الأجهزة غير الجوّالة فقط، حتى إذا كان اسمه (على سبيل المثال: "غير ذلك") لا يشير إلى ذلك.
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	في حال اختيار القيمة "صحيح"، يشمل هذا المعيار الأجهزة الجوّالة فقط. إذا كانت الإجابة false، سيشمل هذا الإدخال الأجهزة غير الجوّالة فقط، حتى إذا كان اسمه (على سبيل المثال: "غير ذلك") لا يشير إلى ذلك.
name	string	اسم مزوّد خدمة الإنترنت هذا.
secondary_criteria_id	integer	رقم تعريف بديل اختياري يمكن استخدامه لتحديد الكيان.

جدول "AppCollection"

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