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

ב-31 באוקטובר 2024, נוציא משימוש את קובצי הקריאות של ישויות, והם לא ייווצרו יותר. פרטים נוספים זמינים במדריך המעבר ל-Display & Video 360 API.

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

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

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

סוג אחד (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 של יחידת מטבע), לדוגמה, אם המטבע היה EUR, המשמעות של 75000000 היא 75 אירו או אם המטבע הוא USD, הערך של 250000 יהיה 0.25$. אין המרות לסכומים בדולרים או מהם.

סוג אחד (Percentage Milli)

סקלר	תיאור
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, המערכת סופרת רק המרות לאחר קליק, ואם המספר הוא 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 kbps ומעלה). 3=UNKNOWN_CONNECTION_SPEED 4=EDGE (נתונים משופרים ל-GSM Evolution (2G). 57 kbps ומעלה). 5=UMT (מערכת Universal Mobile Telecom (3G). 384 kbps ומעלה). 6=DSL (קו מנויים דיגיטליים. 768 kbps ומעלה). 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) 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 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 המכילים מידע כמו מזהי המושבים שלהם. יוצגו רק פלטפורמות Exchange שהופעלו.
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]	מערך של 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 Floodlight המשויך לפיקסל הזה.
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_id	Numeric Id	המזהה של פלטפורמת ה-Exchange שבה מקור המלאי הזה זמין. אפשר להצטרף באמצעות SupportedExchange.id.
accessing_advertisers	[Numeric Id]	מערך של מזהי מפרסמים, שניתן לאחד עם Advertiser.common_data.id, עם הרשאה להשתמש במקור של מלאי שטחי הפרסום הזה. הערה: אם מקור של מלאי שטחי פרסום זמין לכל המפרסמים, השדה הזה לא יופיע.
external_id	string	המזהה החיצוני שניתן למקור המלאי הזה ומוגדר על ידי פלטפורמת ה-Exchange. המזהה הזה נקרא בדרך כלל מזהה עסקה או מזהה אתר מכירה. ייתכן שהשדה הזה חסר.
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	סוג העלות יהיה תמיד עלות לאלף חשיפות וקוד המטבע תמיד יהיה דולר ארה"ב.
advertiser_pricings	[UserListAdvertiserPricing]	סוג העלות יהיה תמיד עלות לאלף חשיפות וקוד המטבע תמיד יהיה דולר ארה"ב.

טבלה אחת (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	השם של אוסף האפליקציות הזה.