דף זה תורגם על ידי 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`	שם המשתמש שמשויך למושב הזה (רלוונטי רק למושבי 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`	עלות לאלף חשיפות 1 עמלה במטבע מיקרו של המפרסם.
`cpm_fee_2_advertiser_micros`	`integer`	עמלת עלות לאלף חשיפות 2 במיקרו-מטבעות של המטבע של המפרסם.
`cpm_fee_3_advertiser_micros`	`integer`	עמלה של עלות לאלף חשיפות 3 במטבע של המפרסם.
`cpm_fee_4_advertiser_micros`	`integer`	עמלת עלות לאלף חשיפות 4 במיקרו-מטבעות של המטבע של המפרסם.
`cpm_fee_5_advertiser_micros`	`integer`	עמלת עלות לאלף חשיפות 5 במיקרו-מטבעות של המטבע של המפרסם.
`media_fee_percent_1_millis`	`integer`	עמלת מדיה 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, נספרות רק המרות לאחר קליק.אם הוא עוקב אחר כל ההמרות, מתבצע מעקב אחר כל ההמרות.

סוג `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` הוא 1, המשמעות היא שהיעד מוחרג. ערך חסר פירושו `false`.

סוג אחד (`TargetUnion`)

שם השדה	סוג	תיאור
`union`	`[Target]`	מערך של סוגי `Target` שמייצג את האיחוד של היעדים.
`excluded`	`boolean`	כשהערך של `true` הוא 0, המשמעות היא שאיחוד היעדים לא נכלל. אם חסר ערך, המשמעות היא `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` (Digital Subscriber Line. 768Kbps ומעלה). `7=HSDPA` (גישה לחבילות בנתיב ירידה במהירות גבוהה (3.5G). 1.8Mbps ומעלה). המאפיין `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` type for language. אפשר להצטרף אל `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` DayOfWeek: `0=MONDAY 1=TUESDAY 2=WEDNESDAY 3=THURSDAY 4=FRIDAY 5=SATURDAY 6=SUNDAY` StartTime: דקות ממחצות, חלקי 15. הטווח הוא מ-0 ל-95. EndTime: דקות מאז חצות, חלקי 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 או B) וגם (C או 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`	כתובת דף הנחיתה שמוגדרת כברירת מחדל.
`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`	היעד של עלות לאלף חשיפות הניתנות לצפייה ב-micros של המטבע של המפרסם. הערך הזה יהיה חסר אם `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`	מזהה Floodlight ב-DFA שמשויך לפיקסל הזה.
`allow_google_redirect`	`boolean`
`allow_rm_redirect`	`boolean`	כשהערך מוגדר כ-`true`, הפיקסל יופעל להפניה אוטומטית אל Right Media או ממנה.
`remarketing_enabled`	`boolean`	אם הערך מוגדר ל-`true`, הפיקסל הזה יופעל לשימוש בטירגוט. הערך הזה יופיע רק אם הערך של `dfa_configuration` של המפרסם ההורה מוגדר כ-`NONE`.
`is_secure`	`boolean`	כשהערך מוגדר ל-`true`, ה-pixel ישתמש ב-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_id`	`Numeric Id`	המזהה של פלטפורמת ה-Exchange שבה מקור מלאי שטחי הפרסום הזה זמין. אפשר להצטרף אליו דרך `SupportedExchange.id`.
`accessing_advertisers`	`[Numeric Id]`	מערך של מזהי מפרסמים, שניתן לצרף ל-`Advertiser.common_data.id`, עם הרשאה להשתמש במקור המלאי הזה. הערה: אם מקור מלאי שטחי הפרסום זמין לכל המפרסמים, השדה הזה לא יופיע.
`external_id`	`string`	המזהה החיצוני שניתן למקור המלאי הזה ומוגדר על ידי פלטפורמת ה-Exchange. המזהה הזה נקרא בדרך כלל 'עסקה' או 'מזהה מוכר'. יכול להיות שהשדה הזה חסר.
`min_cpm_micros`	`integer`	מחיר המינימום בפועל של מקור מלאי שטחי הפרסום הזה, ב-micros של המטבע.
`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`	סוג העלות תמיד יהיה 'עלות לאלף חשיפות', וקידוד המטבע תמיד יהיה USD.
`advertiser_pricings`	`[UserListAdvertiserPricing]`	סוג העלות תמיד יהיה 'עלות לאלף חשיפות', וקידוד המטבע תמיד יהיה USD.

טבלה אחת (`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`s בערוץ הזה. אפשר להצטרף אליו דרך `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`	מיפוי מ-Universal Site 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

טבלאות גלויות לכולם

טבלה אחת (SupportedExchange)

טבלה של DataPartner

טבלה של UniversalSite

טבלה של SiteIdToPlacementId

טבלה של GeoLocation

טבלה אחת (Language)

טבלה של DeviceCriteria

טבלה של Browser

טבלה של Isp

טבלה של AppCollection

פורמט הקבצים שנקראו של ישות – 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`

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

טבלה של `DataPartner`

טבלה של `UniversalSite`

טבלה של `SiteIdToPlacementId`

טבלה של `GeoLocation`

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

טבלה של `DeviceCriteria`

טבלה של `Browser`

טבלה של `Isp`

טבלה של `AppCollection`