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

הפסקנו את השימוש בקבצים לקריאת ישויות. עוברים להשתמש ב-Display & Video 360 API.

ערכים סקלריים של Null וכן מערכי נתונים ריקים לא נכללים בקבצים.

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

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

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

סוג 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]	מערך שמכיל את המזהים של ה-UniversalSites בערוץ הזה. אפשר להצטרף אליו דרך 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	השם של אוסף האפליקציות הזה.