אנחנו מעבירים בשלב זה קבוצת משנה של סוגי דוחות מדיווח אופליין לדיווח מיידי. אחרי העברת משתמש, התגובות של
queries.list
יכללו דוחות מיידיים קיימים.
בפוסט הזה בבלוג אפשר לקרוא מידע נוסף.
פורמט הקבצים שנקראו של ישות – V2
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
ערכים סקלריים של 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
סוג אחד (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
השם של אוסף האפליקציות הזה.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0 . לפרטים, ניתן לעיין במדיניות האתר Google Developers . Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-11-15 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2024-11-15 (שעון UTC)."],[[["Entity Read Files, providing data on advertisers, campaigns, and other entities, will be sunset on October 31, 2024, requiring migration to the Display & Video 360 API."],["Shared data types like `Numeric Id`, `Enum`, `Time`, and custom types like `Budget` and `FrequencyCap` are used across various entities to represent specific attributes."],["Data is organized into tables like `Advertiser`, `Campaign`, `LineItem`, and `Creative`, each containing specific fields relevant to their respective entities."],["Tables are interconnected via joinable fields, enabling linking and analysis of data across entities, such as joining `Advertiser` and `Campaign` using `advertiser_id`."],["The `InventorySource` table provides details about ad inventory, including its source, accessibility for advertisers, and associated costs."]]],["Key data elements include numerical IDs for entities, with non-unique values across different types. Files omit null scalars and empty arrays. Time is recorded as Unix timestamps. Currency is measured in micros. Percentages are in millis. Entity files contain common data like IDs, names, and statuses. Budget settings specify timeframes, impression caps, spending, and pacing. Partner costs and revenue models define fees, markup percentages, and billing. Targeting information involves criteria, exclusions, and unions for inventory sources, geo-locations, devices, and more. Entity Read files are to be replaced by Display & Video 360 API.\n"]]