فرمت فایل های خوانده شده موجودیت - V2

انواع مشترک

این انواع فیلدهای تودرتو را در برخی جداول تعریف می کنند. این فیلدها جداول خود را ندارند.

نوع 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 یورو یا اگر ارز USD بود، 250000 به معنای 0.25 دلار بود. هیچ تبدیلی به یا از مبالغ دلاری وجود ندارد.

Percentage Milli

اسکالر توضیحات
integer درصد نشان داده شده بر حسب میلی (1/1000 درصد)، برای مثال 100 به معنای 0.1٪ است.

نوع FileSummary

نام فیلد تایپ کنید توضیحات
name string نام فایل فایل (بدون شامل نام سطل یا دایرکتوری).
num_records integer تعداد موجودیت های موجود در فایل.
version integer شماره نسخه اصلی فایل اگر نسخه‌های جدیدی از قالب داده موجودیت در آینده ایجاد شود، ممکن است این عدد تغییر کند.

نوع EntityCommonData

نام فیلد تایپ کنید توضیحات
id Numeric Id شناسه منحصربه‌فرد در هر نوع نهاد - برای مثال با نهادهای شریک، این شناسه شناسه شریک است، برای تبلیغ‌کنندگان، شناسه تبلیغ‌کننده و غیره.
name string نام قابل مشاهده UI موجودیت.
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 کارمزد CPM 1 در میکرو ارز تبلیغ‌کننده.
cpm_fee_2_advertiser_micros integer کارمزد CPM 2 در میکرو ارز تبلیغ‌کننده.
cpm_fee_3_advertiser_micros integer کارمزد CPM 3 در میکرو ارز تبلیغ‌کننده.
cpm_fee_4_advertiser_micros integer کارمزد CPM 4 در میکرو ارز آگهی‌دهنده.
cpm_fee_5_advertiser_micros integer کارمزد CPM 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 هزینه رسانه 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 شناسه عددی شناسه فعالیت CM 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.0mbps و سریعتر).
2=DIALUP (56 کیلوبیت در ثانیه و کندتر).
3=UNKNOWN_CONNECTION_SPEED
4=EDGE (داده های پیشرفته برای GSM Evolution (2G). 57 کیلوبیت بر ثانیه و سریعتر).
5=UMT (سیستم تلفن همراه جهانی (3G). 384 کیلوبیت در ثانیه و سریعتر).
6=DSL (خط مشترک دیجیتال. 768 کیلوبیت در ثانیه و سریعتر).
7=HSDPA (دسترسی به بسته های پایین لینک با سرعت بالا (3.5G). 1.8mpbs و سریعتر).

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) و (C OR D) و نه (E یا 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 تنظیم شود، این مقدار با منطقه زمانی تبلیغ‌کننده DFA مرتبط یکسان خواهد بود.
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 شناسه شبکه CM360. اگر dcm_configuration به عنوان NONE تنظیم شود، این مقدار از بین خواهد رفت.
dcm_advertiser_id Numeric Id شناسه تبلیغ‌کننده CM360. اگر 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 وقتی روی true تنظیم شود، نمایش دستورهای درج توصیه می شود.
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 حداکثر مقدار CPM در میکرو ارز تبلیغ‌کننده.
performance_goal Enum 0=NONE (vCPM غیرفعال است)
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] آرایه ای از 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 شناسه مکان CM360 مرتبط با این خلاقیت.
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 شناسه نورافکن DFA مرتبط با این پیکسل.
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 نام منبع موجودی همانطور که در UI نشان داده شده است. ممکن است این فیلد وجود نداشته باشد. اگر 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 نام لیست کاربران همانطور که در UI نشان داده شده است.
data_partner_id Numeric Id قابل پیوستن با DataPartner .id . این فیلد فقط برای لیست کاربران شخص ثالث تنظیم شده است.
accessing_advertisers [Numeric Id] آرایه‌ای از شناسه‌های آگهی‌دهنده، قابل پیوستن با Advertiser .common_data.id ، مجاز به استفاده از این فهرست کاربر.

توجه: اگر لیست کاربری برای همه تبلیغ‌کنندگان در دسترس باشد، این قسمت وجود نخواهد داشت.

partner_pricing UserListPricing نوع هزینه همیشه CPM، کد ارز همیشه USD خواهد بود.
advertiser_pricings [UserListAdvertiserPricing] نوع هزینه همیشه CPM، کد ارز همیشه USD خواهد بود.

جدول CustomAffinity

نام فیلد تایپ کنید توضیحات
id Numeric Id کلید منحصر به فرد برای میل سفارشی.
name string نام وابستگی سفارشی همانطور که در UI نشان داده شده است.
description string شرح وابستگی سفارشی همانطور که در UI نشان داده شده است.
advertiser_id Numeric Id شناسه شی تبلیغ‌کننده والد. با Advertiser .common_data.id قابل پیوستن است.

جدول UniversalChannel

نام فیلد تایپ کنید توضیحات
id Numeric Id کلید منحصر به فرد برای کانال.
name string نام کانال همانطور که در UI نشان داده شده است.
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 تنظیم شود، این کانال می تواند برای فیلتر ایمنی برند استفاده شود. در حال حاضر این فقط برای 4 ردیف ایمنی ساخته شده با نام تجاری true است.

جدول NegativeKeywordList

نام فیلد تایپ کنید توضیحات
id Numeric Id کلید منحصر به فرد برای لیست کلمات کلیدی منفی.
name string نام لیست کلیدواژه منفی همانطور که در UI نشان داده شده است.
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 آدرس یا نام سایت، برای مثال google.com یا Google Unclassified .

جدول SiteIdToPlacementId

نام فیلد تایپ کنید توضیحات
siteId Numeric Id نقشه برداری از شناسه سایت جهانی به شناسه های مکان وب.
placementId Numeric Id نشانی اینترنتی یا نام مکان وب، برای مثال google.com یا Google Unclassified .

جدول GeoLocation

نام فیلد تایپ کنید توضیحات
id Numeric Id کلید منحصر به فرد برای مکان جغرافیایی.
canonical_name string رشته مکان و والدین آن با کاما به هم پیوسته است. مثال: "سیاتل، واشنگتن، ایالات متحده".
geo_name string نام مکان. مثال: "سیاتل".
country_code string کد کشور ISO-3166 آلفا-2 برای این مکان جغرافیایی، به عنوان مثال US .
region_code string کد زیربخش ISO-3166-2 برای این مکان جغرافیایی، به عنوان مثال US-WA . ممکن است این فیلد وجود نداشته باشد.
city_name string نام شهر برای این موقعیت جغرافیایی، به عنوان مثال Seattle . ممکن است این فیلد وجود نداشته باشد.
postal_code string کد پستی این مکان جغرافیایی، به عنوان مثال 98033 . ممکن است این فیلد وجود نداشته باشد.
dma_code integer کد DMA برای این مکان جغرافیایی، به عنوان مثال 510 . ممکن است این فیلد وجود نداشته باشد.

جدول Language

نام فیلد تایپ کنید توضیحات
id Numeric Id کلید منحصر به فرد برای این زبان.
code string کد ISO-639-1 برای این زبان، یا یکی از zh_CN برای چینی (ساده شده)، zh_TW برای چینی (سنتی)، یا other برای زبان های دیگر.

جدول DeviceCriteria

نام فیلد تایپ کنید توضیحات
id Numeric Id کلید منحصر به فرد برای این معیار دستگاه.
is_mobile boolean اگر درست باشد، این معیار فقط دستگاه های تلفن همراه را پوشش می دهد. اگر نادرست باشد، این ورودی فقط دستگاه‌های غیر همراه را پوشش می‌دهد، حتی اگر نام آن (به عنوان مثال، «سایر») نشان‌دهنده آن نباشد.
name string نام آشنای Device Criteria.
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 اگر درست باشد، این معیار فقط دستگاه های تلفن همراه را پوشش می دهد. اگر نادرست باشد، این ورودی فقط دستگاه‌های غیر همراه را پوشش می‌دهد، حتی اگر نام آن (به عنوان مثال، «سایر») نشان‌دهنده آن نباشد.
name string نام آشنای مرورگر، به عنوان مثال Safari 5 . این شامل رشته کامل user-agent نیست.

جدول Isp

نام فیلد تایپ کنید توضیحات
id Numeric Id کلید منحصر به فرد برای این ارائه دهنده خدمات اینترنتی.
is_mobile boolean اگر درست باشد، این معیار فقط دستگاه های تلفن همراه را پوشش می دهد. اگر نادرست باشد، این ورودی فقط دستگاه‌های غیر همراه را پوشش می‌دهد، حتی اگر نام آن (به عنوان مثال، «سایر») نشان‌دهنده آن نباشد.
name string نام این ارائه دهنده خدمات اینترنتی.
secondary_criteria_id integer شناسه جایگزین اختیاری که می تواند برای شناسایی موجودیت استفاده شود.

جدول AppCollection

نام فیلد تایپ کنید توضیحات
id Numeric Id کلید منحصر به فرد برای این مجموعه برنامه.
name string نام این مجموعه برنامه.