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

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

يتم حذف القيم القياسية الفارغة والصفائف الفارغة من الملفات.

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

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

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

نوع واحد (Numeric Id)

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

نوع واحد (Enum)

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

نوع واحد (Time)

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

نوع واحد (Currency Micro)

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	رسوم جميع الوسائل الأولى في Percentage Milli
media_fee_percent_2_millis	integer	رسوم جميع الوسائل الثانية في Percentage Milli
media_fee_percent_3_millis	integer	رسوم جميع الوسائل الثالثة في Percentage Milli
media_fee_percent_4_millis	integer	رسوم جميع الوسائل رقم 4 في Percentage Milli
media_fee_percent_5_millis	integer	رسوم جميع الوسائل رقم 5 في 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.5 غيغا) 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، ستكون هذه القيمة هي نفسها المنطقة الزمنية لمعلن DoubleClick المرتبط.
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	هدف vCPM بعملة المعلن بالمايكرو لن تتوفّر هذه القيمة في حال ضبط performance_goal على NONE.
partner_revenue_model	PartnerRevenueModel	نموذج أرباح الشركاء المستخدَم لهذا العنصر
cost_tracking_pixels	[CostTrackingPixel]	مصفوفة CostTrackingPixel المخصّصة لتتبُّع هذا البند.
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 في Floodlight المرتبط بهذا البكسل.
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	سيكون نوع التكلفة دائمًا هو التكلفة لكل ألف ظهور، وسيكون رمز العملة دائمًا بالدولار الأمريكي.
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	إذا كانت القيمة هي "صحيح"، سيشمل هذا المعيار الأجهزة الجوّالة فقط. إذا كانت القيمة "false"، لا يشمل هذا الإدخال سوى الأجهزة غير الجوّالة، حتى إذا كان اسمها (مثل "غير ذلك") لا يشير إلى ذلك.
name	string	اسم مزوّد خدمة الإنترنت هذا
secondary_criteria_id	integer	معرّف بديل اختياري يمكن استخدامه لتحديد الكيان.

جدول AppCollection

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