אנחנו מעבירים בשלב זה קבוצת משנה של סוגי דוחות מדיווח אופליין לדיווח מיידי. אחרי העברת משתמש, התגובות של queries.list יכללו דוחות מיידיים קיימים. בפוסט הזה בבלוג אפשר לקרוא מידע נוסף.

דף זה תורגם על ידי Cloud Translation API.

פורמט הקבצים שנקראו של ישות – V2

סוגים משותפים
טבלאות פרטיות
טבלאות ציבוריות

סוגים משותפים

הסוגים האלה מגדירים את השדות המקוננים בחלק מהטבלאות. בשדות האלה אין טבלאות משלהם.

סוג אחד (`Numeric Id`)

Scalar	תיאור
`integer`	מספר מזהה מספרי שמשמש כמזהה של ישויות. אין להתייחס למזהים כמזהים אוניברסליים. לדוגמה, ייתכן שבקמפיין מסוים נעשה שימוש באותו ערך מזהה גם עבור Pixel.

סוג אחד (`Enum`)

Scalar	תיאור
`integer`	מספור של מספר אפשרויות אפשריות. האפשרויות השונות מתוארות בפירוט רב יותר בסוג של תבנית ההורה.

סוג אחד (`Time`)

Scalar	תיאור
`integer`	זמן unix במיקרו-שניות (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`	שם המשתמש שקשור למושב הזה (רלוונטי רק למושבים מסוג 'מדיה ימנית' שאינם RRTB).

סוג אחד (`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`, הערך של `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 במטבע המפרסם ב-micros.
`cpm_fee_5_advertiser_micros`	`integer`	עמלה של מחיר לאלף חשיפות 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`	סכום ההכנסה במכשירי ה-micro הנוכחיים של המפרסם. הערך הזה מוגדר רק אם הסוג הוא `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 ב-CM. אפשר לצרף את הערך הזה באמצעות `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` (56kbps ואיטי יותר). `3=UNKNOWN_CONNECTION_SPEED` `4=EDGE` (נתונים משופרים ל-GSM Evolution (2G). 57kbps ומהיר יותר). `5=UMT` (Universal Mobile Telecom System (3G). 384kbps ומהיר יותר). `6=DSL` (קו מנויים דיגיטלי. 768kbps ומהיר יותר). `7=HSDPA` (גישה לחבילת גלישה במהירות גבוהה (3.5G). 1.8MPb ומהירות גבוהה יותר). `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)` TimeZone: `0=USER 1=EASTERN 2=PACIFIC 3=LONDON 4=COPENHAGEN 5=SYDNEY 6=AUCKLAND 7=HONG_KONG 8=TOKYO 9=CALCUTTA 10=ADVERTISER` DayOf Week: `0=MONDAY 1=TUESDAY 2=WEDNESDAY 3=THURSDAY 4=FRIDAY 5=SATURDAY 6=SUNDAY` StartTime: דקות מאז חצות, בחילוק 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`, הערך הזה יהיה זהה לאזור הזמן של המפרסם ב-DFA המשויך.
`landing_page_url`	`string`	כתובת דף הנחיתה המוגדרת כברירת מחדל.
`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`	אם המדיניות מוגדרת כ-True, המערכת תמליץ על הזמנות קמפיינים של סרטונים.
`uses_display_creatives`	`boolean`	אם המדיניות מוגדרת כ-True, המערכת תמליץ על הזמנות קמפיינים ברשת המדיה.
`uses_audio_creatives`	`boolean`	אם המדיניות מוגדרת כ-True, המערכת תמליץ על הזמנות של הוספת אודיו.
`objective`	`Enum`	הערכים הם: `1 = BRAND_AWARENESS` `2 = ONLINE_ACTION` `3 = OFFLINE_ACTION` `4 = APP_INSTALL`
`metric`	`Enum`	מדד ביצועים מרכזיים. אפשר להשתמש בשדה הזה כדי לעקוב אחרי המדד הראשי שבו משתמשים כדי להעריך את הצלחת הקמפיין. הערכים האפשריים הם: `1 = IMPRESSIONS` `2 = VIEWABLE_IMPRESSIONS` `3 = CPM` `4 = CPV` `5 = UNIQUES` `6 = GRP` `7 = TRP` `8 = VCR` `9 = CPA` `10 = ROAS` `11 = CTR` `12 = CPC` `13 = CVR` `14 = CPI` `15 = VIEWABLE_PERCENT` `16 = CPIAVC` `17 = OTHER`
`objective_description`	`String`	כשהמדד הוא `OTHER`, זהו התיאור הקצר של המדד.
`metric_amount_micros`	`integer`	סכום היעד של המדד במיליוניות השנייה.

טבלה אחת (`InsertionOrder`)

שם השדה	סוג	תיאור
`common_data`	`EntityCommonData`
`advertiser_id`	`Numeric Id`	המזהה של אובייקט המפרסם ההורה. ניתן להצטרף באמצעות `Advertiser.common_data.id`.
`campaign_id`	`Numeric Id`	המזהה של אובייקט הקמפיין הראשי.
`overall_budget`	`Budget`	התקציב הכולל של הזמנת הקמפיין הזו. כולל את שעת ההתחלה ואת שעת הסיום.
`scheduled_segments`	`[Budget]`	מכילה פלחי תקציב מתוזמנים. יכול להיות שהמערך הזה ריק או שהוא חסר לגמרי.
`frequency_cap`	`FrequencyCap`	מכסת התדירות פעילה להזמנת הקמפיין הזו. אם לא הוגדרה מכסת תדירות, הערך הזה יהיה חסר.
`default_partner_costs`	`PartnerCosts`
`default_target_list`	`TargetList`

טבלה אחת (`LineItem`)

שם השדה	סוג	תיאור
`common_data`	`EntityCommonData`
`line_item_type`	`Enum`	`0=RTB 1=RMX_NON_RTB 2=RTB_EXPANDABLE 3=RTB_MOBILE 4=RTB_VIDEO 5=TRUEVIEW 6=NON_RTB_EXCHANGES 7=RTB_AUDIO 8=GMAIL 9=ADWORDS_UAC 11=OUT_OF_HOME`
`insertion_order_id`	`Numeric Id`	המזהה של אובייקט הזמנת הקמפיין ברמת ההורה. ניתן להצטרף באמצעות `InsertionOrder.common_data.id`
`creative_ids`	`[Numeric Id]`	מערך של נכסי קריאייטיב שמוקצים לפריט הזה. ניתן להצטרף באמצעות `Creative.common_data.id`.
`max_cpm_advertiser_micros`	`integer`	ערך העלות המקסימלית לאלף חשיפות במטבע מיקרו של המפרסם.
`performance_goal`	`Enum`	`0=NONE` (עלות לאלף חשיפות הניתנות לצפייה מושבתת) `1=CPC 2=CPA 3=ROI 4=CPCV 5=CPM 6=AVCPM 7=IMP_VALUE_ROAS 8=CIVA 9=IVO_TEN 10=AV_VIEWED 11=INCREMENTAL_CONVERSIONS`
`goal_advertiser_micros`	`integer`	היעד 'עלות לאלף חשיפות הניתנות לצפייה' במטבע המפרסם הערך הזה יהיה חסר אם המדיניות `performance_goal` מוגדרת כ-`NONE`.
`partner_revenue_model`	`PartnerRevenueModel`	מודל ההכנסות של השותף שבו נעשה שימוש בפריט הזה.
`cost_tracking_pixels`	`[CostTrackingPixel]`	מערך של נתוני 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`	מזהה מיקום המודעה ב-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`	מזהה Floodlight ב-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`	השם של מקור המלאי, כפי שמוצג בממשק המשתמש. יכול להיות שהשדה הזה חסר. אם הערך `inventory_name` חסר והמאפיין `unclassified` מוגדר כ-true, הערך מתייחס למלאי הלא מסווג של הבורסה. אם הוא חסר ו`unclassified` מוגדר כ-False, מקור המלאי הוא מלאי ברמת Exchange.
`exchange_id`	`Numeric Id`	המזהה של פלטפורמת ה-Exchange שבה מקור המלאי הזה זמין. ניתן להצטרף באמצעות `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`	השם של רשימת המשתמשים כפי שמוצג בממשק המשתמש.
`data_partner_id`	`Numeric Id`	ניתן להצטרף באמצעות `DataPartner.id`. השדה הזה מוגדר רק לרשימות משתמשים של צד שלישי.
`accessing_advertisers`	`[Numeric Id]`	מערך של מזהי מפרסמים, שאפשר לאחד עם `Advertiser.common_data.id`, עם הרשאה להשתמש ברשימת המשתמשים הזו. הערה: אם רשימת משתמשים זמינה לכל המפרסמים, השדה הזה לא יוצג.
`partner_pricing`	`UserListPricing`	סוג העלות יהיה תמיד עלות לאלף חשיפות (CPM), קוד המטבע תמיד יהיה דולר ארה"ב.
`advertiser_pricings`	`[UserListAdvertiserPricing]`	סוג העלות יהיה תמיד עלות לאלף חשיפות (CPM), קוד המטבע תמיד יהיה דולר ארה"ב.

טבלה אחת (`CustomAffinity`)

שם השדה	סוג	תיאור
`id`	`Numeric Id`	מפתח ייחודי לקהל בהתאמה אישית עם תחום עניין משותף.
`name`	`string`	השם של הקהל בהתאמה אישית עם תחום העניין המשותף, כפי שמוצג בממשק המשתמש.
`description`	`string`	התיאור של תחום העניין המותאם אישית, כפי שמוצג בממשק המשתמש.
`advertiser_id`	`Numeric Id`	המזהה של אובייקט המפרסם ההורה. ניתן להצטרף באמצעות `Advertiser.common_data.id`.

טבלה אחת (`UniversalChannel`)

שם השדה	סוג	תיאור
`id`	`Numeric Id`	מפתח ייחודי של הערוץ.
`name`	`string`	שם הערוץ כפי שמוצג בממשק המשתמש.
`site_ids`	`[Numeric Id]`	מערך שמכיל את המזהים של הערכים `UniversalSite` בערוץ הזה. ניתן להצטרף באמצעות `UniversalSite.id`.
`accessing_advertisers`	`[Numeric Id]`	מערך של מזהי מפרסמים, שאפשר להצטרף אליהם באמצעות `Advertiser.common_data.id`, עם הרשאה להשתמש בערוץ הזה. הערה: אם הערוץ זמין לכל המפרסמים, השדה הזה לא יוצג.
`is_deleted`	`boolean`	אם המדיניות מוגדרת לערך `true`, פריטים חדשים לא יוכלו לטרגט לערוץ הזה, אבל פריטים קיימים שכבר מטורגטים לערוץ הזה ימשיכו לעשות זאת.
`is_brand_safe_channel`	`boolean`	כשהערוץ מוגדר כ-`true`, אפשר להשתמש בו לצורך סינון לצורך הגנה על המותג. כרגע הסכום הזה הוא `true` רק ל-4 הרמות המובנות להגנה על המותג.

טבלה אחת (`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`	קוד אזור השוק הייעודי (DMA) של המיקום הגיאוגרפי הזה, לדוגמה `510`. יכול להיות שהשדה הזה חסר.

טבלה אחת (`Language`)

שם השדה	סוג	תיאור
`id`	`Numeric Id`	מקש ייחודי לשפה הזו.
`code`	`string`	קוד ISO-639-1 לשפה הזו, או אחד של `zh_CN` עבור סינית (פשוטה), `zh_TW` עבור סינית (מסורתית) או `other` עבור שפות אחרות.

טבלה אחת (`DeviceCriteria`)

שם השדה	סוג	תיאור
`id`	`Numeric Id`	מפתח ייחודי לקריטריונים של המכשיר הזה.
`is_mobile`	`boolean`	אם True, הקריטריון הזה חל רק על מכשירים ניידים. אם הערך הוא False, הרשומה הזו מתייחסת רק למכשירים שאינם ניידים, גם אם השם שלה (למשל, 'אחר') לא מציין זאת.
`name`	`string`	השם המוכר של 'קריטריונים למכשיר'.
`criteria_type`	`Enum`	`0=OPERATING_SYSTEM 1=MOBILE_MAKE_MODEL 2=DEVICE_TYPE`
`operating_system_id`	`Numeric Id`	משמש לזיהוי מערכת ההפעלה. השדה הזה יאוכלס רק כשהערך בשדה `criteria_type` הוא `0`.
`mobile_brand_name`	`string`	שם המותג של המכשיר. השדה הזה יאוכלס רק כשהערך בשדה `criteria_type` הוא `1`.
`mobile_model_name`	`string`	שם הדגם של המכשיר. השדה הזה יאוכלס רק כשהערך בשדה `criteria_type` הוא `1`. זה שינוי אופציונלי.
`mobile_make_model_id`	`Numeric Id`	מזהה את מספר הדגם של המכשיר. השדה הזה יאוכלס רק כשהערך בשדה `criteria_type` הוא `1`. זה שינוי אופציונלי.
`device_type`	`Enum`	מציין את סוג המכשיר. השדה הזה יאוכלס רק כשהערך בשדה `criteria_type` הוא `2`. `0=COMPUTER 1=OTHER 2=SMARTPHONE 3=TABLET 4=SMARTTV 5=CONNECTEDTV 6=SET_TOP_BOX 7=CONNECTEDDEVICE`

טבלה אחת (`Browser`)

שם השדה	סוג	תיאור
`id`	`Numeric Id`	מפתח ייחודי לדפדפן הזה.
`is_mobile`	`boolean`	אם True, הקריטריון הזה חל רק על מכשירים ניידים. אם הערך הוא False, הרשומה הזו מתייחסת רק למכשירים שאינם ניידים, גם אם השם שלה (למשל, 'אחר') לא מציין זאת.
`name`	`string`	השם המוכר של הדפדפן, לדוגמה `Safari 5`. הוא לא כולל את המחרוזת המלאה של סוכן המשתמש.

טבלה אחת (`Isp`)

שם השדה	סוג	תיאור
`id`	`Numeric Id`	מפתח ייחודי לספק האינטרנט הזה.
`is_mobile`	`boolean`	אם True, הקריטריון הזה חל רק על מכשירים ניידים. אם הערך הוא False, הרשומה הזו מתייחסת רק למכשירים שאינם ניידים, גם אם השם שלה (למשל, 'אחר') לא מציין זאת.
`name`	`string`	השם של ספק האינטרנט הזה.
`secondary_criteria_id`	`integer`	מזהה חלופי אופציונלי שיכול לשמש לזיהוי הישות.

טבלה אחת (`AppCollection`)

שם השדה	סוג	תיאור
`id`	`Numeric Id`	מפתח ייחודי לאוסף האפליקציות הזה.
`name`	`string`	השם של אוסף האפליקציות הזה.

פורמט הקבצים שנקראו של ישות – V2

סוגים משותפים

סוג אחד (Numeric Id)

סוג אחד (Enum)

סוג אחד (Time)

סוג אחד (Currency Micro)

סוג אחד (Percentage Milli)

סוג אחד (FileSummary)

סוג אחד (EntityCommonData)

סוג אחד (ExchangeSettings)

סוג אחד (ApprovalStatus)

סוג אחד (Budget)

סוג אחד (FrequencyCap)

סוג אחד (PartnerCosts)

סוג אחד (PartnerRevenueModel)

סוג אחד (CostTrackingPixel)

סוג אחד (Target)

סוג אחד (TargetUnion)

סוג אחד (TargetList)

סוג אחד (SummaryFile)

סוג אחד (UserListAdvertiserPricing)

סוג אחד (UserListPricing)

שולחנות פרטיים

טבלה אחת (Partner)

טבלה אחת (Advertiser)

טבלה אחת (Campaign)

טבלה אחת (InsertionOrder)

טבלה אחת (LineItem)

טבלה אחת (Creative)

טבלה אחת (Pixel)

טבלה אחת (Floodlight Activity)

טבלה אחת (InventorySource)

טבלה אחת (UserList)

טבלה אחת (CustomAffinity)

טבלה אחת (UniversalChannel)

טבלה אחת (NegativeKeywordList)