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

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

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

نوع واحد (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)

اسم الحقلالنوعالوصف
namestringاسم ملف الملف (لا يشمل اسم الحزمة أو الدليل).
num_recordsintegerعدد الكيانات في الملف.
versionintegerرقم الإصدار الرئيسي للملف. قد يتغير هذا الرقم في حال إنشاء إصدارات جديدة من تنسيق بيانات الكيان في المستقبل.

نوع واحد (EntityCommonData)

اسم الحقلالنوعالوصف
idNumeric Idمعرّف فريد لكل نوع من أنواع الكيانات. على سبيل المثال، بالنسبة إلى كيانات الشركاء، سيكون هذا المعرّف هو "رقم تعريف الشريك"، أمّا بالنسبة إلى "المعلِنين"، فيتمثل في الرقم التعريفي للمعلِن وهكذا.
namestringاسم العنصر المرئي على واجهة المستخدم
activebooleanالحالة على النحو الذي حدّده المستخدم - قد لا يتم عرض الكيان لأسباب أخرى، مثل ميزانية مستنفدة، وانفاد الرحلة، وما إلى ذلك.
integration_codestringرمز الدمج الذي حدده المستخدم

نوع واحد (ExchangeSettings)

اسم الحقلالنوعالوصف
exchange_idNumeric Idرقم تعريف التبادل. يمكن الانضمام باستخدام SupportedExchange.id
seat_idstringرقم تعريف المقعد الخاص بالتبادل
seat_user_namestringاسم المستخدم المرتبط بهذا المقعد (ينطبق فقط على المقاعد التي لا تتوفر فيها عروض الأسعار في الوقت الفعلي فيright Media).

نوع واحد (ApprovalStatus)

اسم الحقلالنوعالوصف
auditorEnum0=DOUBLECLICK_BID_MANAGER
1=DOUBLECLICK_AD_EXCHANGE
2=APPNEXUS
3=APPNEXUS_MICROSOFT
4=RIGHT_MEDIA_NON_RTB
statusEnum0=APPROVED
1=REJECTED
2=PENDING
3=NO_AUDIT
4=UN_AUDITABLE
5=UNKNOWN
6=IN_AUDIT
feedbackstringويتم إرسال الملاحظات من المدقق الذي قد يحتوي على معلومات إضافية مثل أسباب الرفض.
sync_timeTimeآخر مرة تمت فيها مزامنة الكيان مع auditor
external_idNumeric Idلا يتم التعبئة إلا إذا كانت قيمة auditor هي APPNEXUS أو APPNEXUS_MICROSOFT أو RIGHT_MEDIA_NON_RTB. يمثل هذا الرقم تعريف الكيان في مساحة المدقق.

نوع واحد (Budget)

اسم الحقلالنوعالوصف
start_time_usecTimeوقت بدء فترة الميزانية
end_time_usecTimeوقت انتهاء فترة الميزانية.
max_impressionsintegerالحد الأقصى لعدد مرات الظهور في حدود هذه الميزانية في حال عدم توفّر هذا الحقل، تكون ميزانية الظهور غير محدودة.
max_spend_advertiser_microsintegerالحد الأقصى للإنفاق (بعملة المعلن) لهذه الميزانية. في حال عدم توفّر هذا الحقل، تكون ميزانية إنفاق غير محدودة.
pacing_typeEnum0=FLIGHT
1=DAILY
pacing_max_impressionsintegerالحد الأقصى لعدد مرات الظهور لكل فاصل سرعة محدَّد من قِبل pacing_type. في حال عدم توفّر هذا الحقل، لن يكون هناك حدّ أقصى لعدد مرّات الظهور.
pacing_max_spend_advertiser_microsintegerالحد الأقصى للإنفاق (بعملة المعلن) لكل فاصل سرعة يحدده pacing_type. في حال عدم توفّر هذا الحقل، لن يكون هناك حدّ للإنفاق.
pacing_distributionEnum0=ASAP
1=EVEN
2=AHEAD

نوع واحد (FrequencyCap)

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

نوع واحد (PartnerCosts)

اسم الحقلالنوعالوصف
cpm_fee_1_advertiser_microsintegerرسوم التكلفة لكل ألف ظهور 1 بالدولار الأمريكي بالمايكرو
cpm_fee_2_advertiser_microsintegerرسوم التكلفة لكل ألف ظهور 2 بالمايكرو بعملة المعلن.
cpm_fee_3_advertiser_microsintegerرسوم التكلفة لكل ألف ظهور 3 بالمايكرو بعملة المعلن.
cpm_fee_4_advertiser_microsintegerرسوم التكلفة لكل ألف ظهور 4 بالمايكرو بعملة المعلن.
cpm_fee_5_advertiser_microsintegerرسوم التكلفة لكل ألف ظهور 5 بالمايكرو بعملة المعلن.
media_fee_percent_1_millisintegerرسوم جميع الوسائل الأولى في Percentage Milli
media_fee_percent_2_millisintegerرسوم جميع الوسائل الثانية في Percentage Milli
media_fee_percent_3_millisintegerرسوم جميع الوسائل الثالثة في Percentage Milli
media_fee_percent_4_millisintegerرسوم جميع الوسائل رقم 4 في Percentage Milli
media_fee_percent_5_millisintegerرسوم جميع الوسائل رقم 5 في Percentage Milli
cpm_fee_1_cost_typeEnum0=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_typeEnumهذا الخيار مماثل لتاريخ cpm_fee_1_cost_type.
cpm_fee_3_cost_typeEnumهذا الخيار مماثل لتاريخ cpm_fee_1_cost_type.
cpm_fee_4_cost_typeEnumهذا الخيار مماثل لتاريخ cpm_fee_1_cost_type.
cpm_fee_5_cost_typeEnumهذا الخيار مماثل لتاريخ cpm_fee_1_cost_type.
media_fee_percent_1_cost_typeEnumهذا الخيار مماثل لتاريخ cpm_fee_1_cost_type.
media_fee_percent_2_cost_typeEnumهذا الخيار مماثل لتاريخ cpm_fee_1_cost_type.
media_fee_percent_3_cost_typeEnumهذا الخيار مماثل لتاريخ cpm_fee_1_cost_type.
media_fee_percent_4_cost_typeEnumهذا الخيار مماثل لتاريخ cpm_fee_1_cost_type.
media_fee_percent_5_cost_typeEnumهذا الخيار مماثل لتاريخ cpm_fee_1_cost_type.
cpm_fee_1_bill_to_typeEnum0=DEFAULT_BILL_TO_TYPE
1=INVITE_MEDIA
2=PARTNER
cpm_fee_2_bill_to_typeEnumهذا الخيار مماثل لتاريخ cpm_fee_1_bill_to_type.
cpm_fee_3_bill_to_typeEnumهذا الخيار مماثل لتاريخ cpm_fee_1_bill_to_type.
cpm_fee_4_bill_to_typeEnumهذا الخيار مماثل لتاريخ cpm_fee_1_bill_to_type.
cpm_fee_5_bill_to_typeEnumهذا الخيار مماثل لتاريخ cpm_fee_1_bill_to_type.
media_fee_percent_1_bill_to_typeEnumهذا الخيار مماثل لتاريخ cpm_fee_1_bill_to_type.
media_fee_percent_2_bill_to_typeEnumهذا الخيار مماثل لتاريخ cpm_fee_1_bill_to_type.
media_fee_percent_3_bill_to_typeEnumهذا الخيار مماثل لتاريخ cpm_fee_1_bill_to_type.
media_fee_percent_4_bill_to_typeEnumهذا الخيار مماثل لتاريخ cpm_fee_1_bill_to_type.
media_fee_percent_5_bill_to_typeEnumهذا الخيار مماثل لتاريخ cpm_fee_1_bill_to_type.

نوع واحد (PartnerRevenueModel)

اسم الحقلالنوعالوصف
typeEnum0=CPM
1=MEDIA_COST_MARKUP
2=TOTAL_MEDIA_COST_MARKUP
amount_advertiser_microsintegerمبلغ الأرباح بوحدات المايكرو الحالية للمعلن. ولا يتم ضبط هذه القيمة إلا إذا كان النوع CPM.
media_cost_markup_percent_millisintegerترميز النسبة المئوية للأرباح بعملة Percentage Milli. يتم ضبط هذه القيمة فقط إذا كان النوع MEDIA_COST_MARKUP أو TOTAL_MEDIA_COST_MARKUP.
post_view_conversion_tracking_fractionfloatجزء من الإحالات الناجحة بعد المشاهدة التي يتم احتسابها لتتبُّع الإحالات الناجحة. وإذا كانت قيمتها 0، لن يتم احتساب سوى الإحالات الناجحة بعد النقر. في حالة تتبُّع 1.0 لجميع الإحالات الناجحة.

نوع واحد (CostTrackingPixel)

اسم الحقلالنوعالوصف
pixel_idNumeric Idرقم تعريف بكسل التتبّع: تجدر الإشارة إلى أنّ CostTrackingPixel قد تتشارك نفس pixel_id ولكن تكون لهما قيم مختلفة لطريقة العرض أو النقر.

يمكن ضم هذه القيمة إلى Pixel.common_data.id.
view_window_minutesintegerعدد الدقائق التي يجب البحث خلالها عن الإحالات الناجحة بعد المشاهدة.
click_window_minutesintegerعدد الدقائق التي يجب البحث خلالها عن الإحالات الناجحة بعد النقر.
floodlight_activity_idالمعرّف الرقميأرقام تعريف نشاط Floodlight في "مدير الحملة" يمكن ضم هذه القيمة إلى Pixel.dcm_floodlight_id.

نوع واحد (Target)

اسم الحقلالنوعالوصف
criteria_idNumeric Idيمكن الانضمام إلى جدول آخر بناءً على النوع المحدّد في TargetList. قد تكون هذه القيمة مفقودة.
parameterstringمَعلمة إضافية يعتمد تعريفها على النوع المحدّد في TargetList. قد تكون هذه القيمة مفقودة.
excludedbooleanوعندما تكون القيمة true، يعني ذلك أنّه سيتم استبعاد الهدف. ويعني عدم توفّر قيمة false.

نوع واحد (TargetUnion)

اسم الحقلالنوعالوصف
union[Target]مصفوفة من أنواع Target تمثّل اتحاد الأهداف.
excludedbooleanوعندما تكون القيمة 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_sitesbooleanعلامة تشير إلى ما إذا كان يجب تضمين المواقع الإلكترونية غير المفهرسة في 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
ispsTargetUnionالنوع TargetUnion لمزوّد خدمة الإنترنت. يمكن ضم Target.criteria_id باستخدام ISP.id، أمّا السمة Target.parameter فهي غير محدّدة.

نوع واحد (SummaryFile)

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

نوع واحد (UserListAdvertiserPricing)

اسم الحقلالنوعالوصف
pricingUserListPricing
advertiser_idNumeric Id

نوع واحد (UserListPricing)

اسم الحقلالنوعالوصف
cost_typestring
currency_codestringرمز عملة مكوَّن من ثلاثة أحرف وفقًا لمعيار ISO 4217، مثل USD للدولار الأمريكي.
cost_microsCurrency Micro

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

جدول Partner

اسم الحقلالنوعالوصف
common_dataEntityCommonDataتحتوي على البيانات الشائعة عن هذا الشريك، مثل الاسم ورقم التعريف.
currency_codestringرمز عملة مكوَّن من ثلاثة أحرف وفقًا لمعيار ISO 4217، على سبيل المثال USD للدولار الأمريكي.
exchange_settings[ExchangeSettings]مصفوفة من أنواع ExchangeSettings تحتوي على معلومات مثل أرقام تعريف المقاعد لن تظهر سوى التبادلات المفعَّلة.
default_partner_costsPartnerCostsتحتوي على معلومات عن التكاليف المترتبة على هذا الخطأ بالنسبة إلى هذا الشريك.
default_partner_revenue_modelPartnerRevenueModelتحتوي على معلومات عن نموذج الأرباح التلقائي لهذا الشريك.
default_target_listTargetListيحتوي على خيارات الاستهداف التلقائية للشريك. لا يتوفّر حاليًا سوى الاستهداف الجغرافي التلقائي هنا.

جدول Advertiser

اسم الحقلالنوعالوصف
common_dataEntityCommonDataتحتوي على البيانات الشائعة عن هذا المعلِن، مثل الاسم ورقم التعريف.
partner_idNumeric Idرقم تعريف عنصر الشريك الرئيسي يمكن الانضمام باستخدام Partner.common_data.id.
currency_codestringرمز عملة مكوَّن من ثلاثة أحرف وفقًا لمعيار ISO 4217، على سبيل المثال USD للدولار الأمريكي.
timezone_codestringرمز المنطقة الزمنية الأساسي، على سبيل المثال "America/Los_Angeles". إذا تم ضبط dfa_configuration على NORMAL أو HYBRID، ستكون هذه القيمة هي نفسها المنطقة الزمنية لمعلن DoubleClick المرتبط.
landing_page_urlstringتمثّل هذه السمة عنوان URL التلقائي للصفحة المقصودة.
available_channel_ids[integer]مصفوفة من الأعداد الصحيحة التي تحتوي على القنوات المتاحة المرتبطة بهذا المعلِن. يمكن الانضمام باستخدام UniversalChannel.id.
blacklist_channel_id[integer]مصفوفة من الأعداد الصحيحة التي تحتوي على قنوات القائمة السوداء لهذا المعلِن. يمكن الانضمام باستخدام UniversalChannel.id.
dcm_configurationEnum0=NONE
1=NORMAL
2=HYBRID
dcm_network_idNumeric Idرقم تعريف شبكة "مدير الحملة 360" لن تتوفّر هذه القيمة في حال ضبط dcm_configuration على NONE.
dcm_advertiser_idNumeric Idرقم تعريف المعلِن في "مدير الحملة 360" لن تتوفّر هذه القيمة في حال ضبط dcm_configuration على NONE.
dcm_floodlight_group_idNumeric Idلن تتوفّر هذه القيمة في حال ضبط dcm_configuration على NONE.
dcm_syncable_site_ids[Numeric Id]مصفوفة من أنواع Numeric Id لكل موقع إلكتروني قابل للمزامنة لهذا المعلِن.
enable_oba_tagsbooleanيتم تفعيل علامات OBA عند ضبط القيمة على true.

جدول Campaign

اسم الحقلالنوعالوصف
common_dataEntityCommonDataتحتوي على البيانات الشائعة عن هذه الحملة، مثل الاسم ورقم التعريف.
advertiser_idNumeric Idرقم تعريف عنصر المعلِن الرئيسي يمكن الانضمام باستخدام Advertiser.common_data.id
budgetBudgetالميزانية المخطّطة لهذه الحملة ويشمل ذلك وقت البدء ووقت الانتهاء.
frequency_capFrequencyCapعدد مرات الظهور النشط لهذه الحملة لن تكون هذه القيمة متوفّرة في حال عدم ضبط عدد مرات الظهور.
default_target_listTargetListتحتوي على معلومات عن الاستهداف الساري لهذه الحملة.
uses_video_creativesbooleanعند ضبط هذه السياسة على "صحيح"، سيتم اقتراح طلبات إدراج الفيديو.
uses_display_creativesbooleanعند ضبط هذه السياسة على "صحيح"، سيتم اقتراح طلبات إدراج الإعلانات المعروضة.
uses_audio_creativesbooleanعند ضبط هذه السياسة على "صحيح"، سيتم اقتراح طلبات إدراج الصوت.
objectiveEnum القيم هي:
1 = BRAND_AWARENESS
2 = ONLINE_ACTION
3 = OFFLINE_ACTION
4 = APP_INSTALL
metricEnum مؤشر الأداء الرئيسي. استخدم هذا الحقل لتتبع المقياس الأساسي الذي ستستخدمه لتقييم نجاح حملتك. القيم المتاحة:
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_descriptionStringعندما يكون المقياس OTHER، يكون هذا هو الوصف المختصر للمقياس.
metric_amount_microsintegerالمبلغ المستهدَف للمقياس بالميكرو

جدول InsertionOrder

اسم الحقلالنوعالوصف
common_dataEntityCommonData
advertiser_idNumeric Idرقم تعريف عنصر المعلِن الرئيسي يمكن الانضمام باستخدام Advertiser.common_data.id.
campaign_idNumeric Idرقم تعريف عنصر الحملة الرئيسية.
overall_budgetBudgetالميزانية الإجمالية لطلب الإدراج هذا ويشمل ذلك وقت البدء ووقت الانتهاء.
scheduled_segments[Budget]يحتوي على أي شرائح مُجدوَلة للميزانية. قد تكون هذه المصفوفة فارغة أو غير متاحة إطلاقًا.
frequency_capFrequencyCapعدد مرّات الظهور النشط لطلب الإدراج هذا لن تكون هذه القيمة متوفّرة في حال عدم ضبط عدد مرات الظهور.
default_partner_costsPartnerCosts
default_target_listTargetList

جدول LineItem

اسم الحقلالنوعالوصف
common_data EntityCommonData
line_item_typeEnum 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_microsintegerقيمة التكلفة القصوى لكل ألف ظهور بعملة المعلن بالمايكرو.
performance_goalEnum0=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_microsintegerهدف vCPM بعملة المعلن بالمايكرو لن تتوفّر هذه القيمة في حال ضبط performance_goal على NONE.
partner_revenue_modelPartnerRevenueModelنموذج أرباح الشركاء المستخدَم لهذا العنصر
cost_tracking_pixels[CostTrackingPixel]مصفوفة CostTrackingPixel المخصّصة لتتبُّع هذا البند.
BudgetBudgetالميزانية الإجمالية لهذا العنصر ويشمل ذلك وقت البدء ووقت الانتهاء.
frequency_capFrequencyCapعدد مرّات الظهور النشط لهذا العنصر لن تكون هذه القيمة متوفّرة في حال عدم ضبط عدد مرات الظهور.
partner_costsPartnerCosts
target_listTargetListيحتوي على معلومات عن الاستهداف الساري لهذا العنصر.

جدول Creative

اسم الحقلالنوعالوصف
common_dataEntityCommonData
advertiser_idNumeric Idرقم تعريف عنصر المعلِن الرئيسي يمكن الانضمام باستخدام Advertiser.common_data.id.
dcm_placement_idNumeric Idرقم تعريف موضع الإعلان في "مدير الحملة 360" المرتبط بتصميم الإعلان هذا.
width_pixelsintegerعرض تصميم الإعلان بالبكسل
height_pixelsintegerارتفاع تصميم الإعلان بالبكسل
approval_status[ApprovalStatus]مصفوفة تحتوي على عناصر ApprovalStatus تمثل حالة تصميمات الإعلانات في التبادلات التي توافق على تصميمات الإعلانات
expanding_directionEnum0=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_typeEnum 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_dataEntityCommonData
advertiser_idNumeric Idرقم تعريف عنصر المعلِن الرئيسي يمكن الانضمام باستخدام Advertiser.common_data.id.
partner_idNumeric Idرقم تعريف عنصر الشريك الرئيسي يمكن الانضمام باستخدام Partner.common_data.id.
dcm_floodlight_idNumeric Idرقم تعريف Floodlight في Floodlight المرتبط بهذا البكسل.
allow_google_redirectboolean
allow_rm_redirectbooleanعند الضبط على true، سيتم تفعيل ميزة الانتقال من وإلى الوسائط اليمنى في وحدة البكسل.
remarketing_enabledbooleanعند الضبط على true، سيتم تفعيل وحدة البكسل هذه للاستخدام في الاستهداف. لن تتوفّر هذه القيمة إلا في حال ضبط dfa_configuration للمعلن الرئيسي على NONE.
is_securebooleanعند الضبط على true، سيستخدم هذا البكسل بروتوكول HTTPS. لن تتوفّر هذه القيمة إلا في حال ضبط dfa_configuration للمعلن الرئيسي على NONE.

جدول Floodlight Activity

اسم الحقلالنوعالوصف
common_dataEntityCommonData
advertiser_idNumeric Idرقم تعريف عنصر المعلِن الرئيسي يمكن الانضمام باستخدام Advertiser.common_data.id.
partner_idNumeric Idرقم تعريف عنصر الشريك المسؤول للمعلن الرئيسي. يمكن الانضمام باستخدام Partner.common_data.id.
remarketing_enabledbooleanعند ضبط هذه السياسة على true، سيتم تفعيل هذا النشاط للاستخدام في الاستهداف.
ssl_requiredbooleanوعند ضبطها على true، يجب أن تكون العلامات متوافقة مع السياسات.

جدول InventorySource

اسم الحقلالنوعالوصف
idNumeric Idمفتاح فريد لمصدر المستودع.
unclassifiedbooleanعند الضبط على true، سيتم تضمين كل المستودع غير المصنّف.
inventory_namestringاسم مصدر المستودع كما هو موضّح في واجهة المستخدم. قد لا يكون هذا الحقل متوفرًا. في حال عدم توفّر السمة inventory_name وكانت السمة unclassified صحيحة، يشير ذلك إلى المستودع غير المصنّف للتبادل. إذا لم تكن هذه السمة متوفّرة وكانت السمة unclassified غير صحيحة، يكون مصدر المستودع هو المستودع الإعلاني على مستوى الصرف.
exchange_idNumeric Idرقم تعريف التبادل الذي يتوفّر فيه مصدر المستودع هذا يمكن الانضمام باستخدام SupportedExchange.id.
accessing_advertisers[Numeric Id]هناك مصفوفة من أرقام تعريف المعلنين، والتي يمكن الانضمام إليها مع Advertiser.common_data.id، والإذن باستخدام مصدر المستودع هذا.

ملاحظة: إذا كان مصدر المستودع الإعلاني متاحًا لجميع المعلِنين، لن يكون هذا الحقل متوفّرًا.

external_idstringرقم التعريف الخارجي الذي يتم منحه لمصدر المستودع هذا والمحدّد من خلال عملية التبادل، ويُعرف عادةً باسم الصفقة أو الرقم التعريفي للبائع. قد يكون هذا الحقل غير متوفر.
min_cpm_microsintegerالسعر الأدنى الفعلي لمصدر المستودع هذا بعملة المايكرو.
min_cpm_currency_codestringتمثّل هذه السمة رمز العملة بالتنسيق ISO 4217 المكوَّن من 3 أحرف والمُستخدَم للسمة min_cpm_micros.

جدول UserList

اسم الحقلالنوعالوصف
idNumeric Idمفتاح فريد لقائمة المستخدمين.
namestringاسم قائمة المستخدمين كما هو موضّح في واجهة المستخدم.
data_partner_idNumeric Idيمكن الانضمام باستخدام DataPartner.id. تم ضبط هذا الحقل لقوائم المستخدمين التابعة لجهات خارجية فقط.
accessing_advertisers[Numeric Id]مصفوفة من أرقام تعريف المعلنين، يمكن الانضمام إليها مع Advertiser.common_data.id، والإذن باستخدام قائمة المستخدمين هذه.

ملاحظة: في حال توفّر قائمة مستخدمين لجميع المعلنين، لن يكون هذا الحقل متوفّرًا.

partner_pricingUserListPricingسيكون نوع التكلفة دائمًا هو التكلفة لكل ألف ظهور، وسيكون رمز العملة دائمًا بالدولار الأمريكي.
advertiser_pricings[UserListAdvertiserPricing]سيكون نوع التكلفة دائمًا هو التكلفة لكل ألف ظهور، وسيكون رمز العملة دائمًا بالدولار الأمريكي.

جدول CustomAffinity

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

جدول UniversalChannel

اسم الحقلالنوعالوصف
idNumeric Idمفتاح فريد للقناة
namestringاسم القناة كما هو موضّح في واجهة المستخدم.
site_ids [Numeric Id] مصفوفة تحتوي على أرقام تعريف UniversalSite في هذه القناة. يمكن الانضمام باستخدام UniversalSite.id.
accessing_advertisers[Numeric Id]إنّ مصفوفة من أرقام تعريف المعلنين، والتي يمكن الانضمام إليها مع Advertiser.common_data.id، حاصلة على إذن باستخدام هذه القناة.

ملاحظة: إذا كانت القناة متاحة لجميع المعلنين، لن يظهر هذا الحقل.

is_deletedbooleanعند الضبط على true، لن تتمكّن أي عناصر جديدة من استهداف هذه القناة، ولكن ستستمرّ العناصر الحالية التي تستهدف هذه القناة في ذلك.
is_brand_safe_channelbooleanعند ضبط هذه القيمة على true، يمكن استخدام هذه القناة لفلترة أمان العلامة التجارية. ويتوفر هذا التصنيف حاليًا true فقط لمستويات أمان العلامة التجارية الأربعة المدمجة.

جدول NegativeKeywordList

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

الجداول العامة

جدول SupportedExchange

اسم الحقلالنوعالوصف
idNumeric Idمفتاح فريد للتبادل.
namestringاسم التبادل، على سبيل المثال Ad Exchange.

جدول DataPartner

اسم الحقلالنوعالوصف
idNumeric Idمفتاح فريد لمزوّد بيانات الجهة الخارجية
namestringاسم مزوِّد البيانات التابع لجهة خارجية، مثل BlueKai.

جدول UniversalSite

اسم الحقلالنوعالوصف
idNumeric Idمفتاح فريد للموقع الإلكتروني العام.
namestringعنوان URL للموقع الإلكتروني أو اسمه، مثل google.com أو Google Unclassified

جدول SiteIdToPlacementId

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

جدول GeoLocation

اسم الحقلالنوعالوصف
idNumeric Idمفتاح فريد للموقع الجغرافي.
canonical_namestringسلسلة الموقع المفصولة بفواصل ومصادرها. مثال: "سياتل، واشنطن، الولايات المتحدة".
geo_namestringاسم الموقع الجغرافي مثال: "سياتل".
country_codestringرمز البلد بصيغة ISO-3166 alpha-2 لهذا الموقع الجغرافي، على سبيل المثال US.
region_codestringرمز التقسيم الفرعي ISO-3166-2 لهذا الموقع الجغرافي، على سبيل المثال US-WA. قد يكون هذا الحقل غير متوفّر.
city_namestringاسم المدينة لهذا الموقع الجغرافي، على سبيل المثال Seattle. قد يكون هذا الحقل غير متوفّر.
postal_codestringالرمز البريدي لهذا الموقع الجغرافي، على سبيل المثال 98033. قد يكون هذا الحقل غير متوفّر.
dma_codeintegerرمز منطقة السوق المحدّدة لهذا الموقع الجغرافي، على سبيل المثال 510. قد يكون هذا الحقل غير متوفّر.

جدول Language

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

جدول DeviceCriteria

اسم الحقلالنوعالوصف
idNumeric Idمفتاح فريد لمعايير الجهاز هذه.
is_mobilebooleanإذا كانت القيمة هي true، سيغطي هذا المعيار الأجهزة الجوّالة فقط. إذا كانت القيمة "خطأ"، لا يشمل هذا الإدخال سوى الأجهزة غير الجوّالة، حتى إذا كان اسمها (مثل "غير ذلك") لا يشير إلى ذلك.
namestringالاسم المألوف لمعايير الجهاز.
criteria_typeEnum0=OPERATING_SYSTEM
1=MOBILE_MAKE_MODEL
2=DEVICE_TYPE
operating_system_idNumeric Idتحدد نظام التشغيل. لا تتم تعبئة هذا الحقل إلّا عندما تكون قيمة criteria_type هي 0.
mobile_brand_namestringاسم العلامة التجارية للجهاز. لا تتم تعبئة هذا الحقل إلّا عندما تكون قيمة criteria_type هي 1.
mobile_model_namestringاسم طراز الجهاز لا تتم تعبئة هذا الحقل إلّا عندما تكون قيمة criteria_type هي 1. اختياريّ.
mobile_make_model_idNumeric Idتحدد رقم طراز الجهاز. لا تتم تعبئة هذا الحقل إلّا عندما تكون قيمة criteria_type هي 1. اختياريّ.
device_typeEnumتشير هذه السمة إلى نوع الجهاز. لا تتم تعبئة هذا الحقل إلّا عندما تكون قيمة criteria_type هي 2.

0=COMPUTER
1=OTHER
2=SMARTPHONE
3=TABLET
4=SMARTTV
5=CONNECTEDTV
6=SET_TOP_BOX
7=CONNECTEDDEVICE

جدول Browser

اسم الحقلالنوعالوصف
idNumeric Idمفتاح فريد لهذا المتصفح.
is_mobilebooleanإذا كانت القيمة هي "صحيح"، سيشمل هذا المعيار الأجهزة الجوّالة فقط. إذا كانت القيمة "false"، لا يشمل هذا الإدخال سوى الأجهزة غير الجوّالة، حتى إذا كان اسمها (مثل "غير ذلك") لا يشير إلى ذلك.
namestringالاسم المألوف للمتصفّح، على سبيل المثال Safari 5. ولا يتضمّن سلسلة وكيل المستخدم الكاملة.

جدول Isp

اسم الحقلالنوعالوصف
idNumeric Idمفتاح فريد لمزوّد خدمة الإنترنت هذا.
is_mobilebooleanإذا كانت القيمة هي "صحيح"، سيشمل هذا المعيار الأجهزة الجوّالة فقط. إذا كانت القيمة "false"، لا يشمل هذا الإدخال سوى الأجهزة غير الجوّالة، حتى إذا كان اسمها (مثل "غير ذلك") لا يشير إلى ذلك.
namestringاسم مزوّد خدمة الإنترنت هذا
secondary_criteria_idinteger معرّف بديل اختياري يمكن استخدامه لتحديد الكيان.

جدول AppCollection

اسم الحقلالنوعالوصف
idNumeric Idمفتاح فريد لمجموعة التطبيقات هذه
namestringاسم مجموعة التطبيقات هذه