ما در حال حاضر در حال انتقال زیرمجموعه ای از انواع گزارش از آفلاین به گزارش فوری هستیم. پس از انتقال کاربر، پاسخهای
queries.list
شامل گزارشهای فوری موجود میشود. برای اطلاعات بیشتر به
پست وبلاگ ما مراجعه کنید.
فرمت فایل های خوانده شده موجودیت - 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
نوع 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
نام این مجموعه برنامه.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-08-29 بهوقت ساعت هماهنگ جهانی.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"اطلاعاتی که نیاز دارم وجود ندارد"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"بیشازحد پیچیده/ مراحل بسیار زیاد"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"قدیمی"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"مشکل ترجمه"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"مشکل کد / نمونهها"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"غیره"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"درک آسان"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"مشکلم را برطرف کرد"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"غیره"
}]
{"lastModified": "\u062a\u0627\u0631\u06cc\u062e \u0622\u062e\u0631\u06cc\u0646 \u0628\u0647\u200c\u0631\u0648\u0632\u0631\u0633\u0627\u0646\u06cc 2024-08-29 \u0628\u0647\u200c\u0648\u0642\u062a \u0633\u0627\u0639\u062a \u0647\u0645\u0627\u0647\u0646\u06af \u062c\u0647\u0627\u0646\u06cc."}
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2024-08-29 بهوقت ساعت هماهنگ جهانی."]]