שולחנות פרטיים
טבלה אחת (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 |
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 |
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 |
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 |
creative_type | Enum |
0=Image or HTML5 |
טבלה אחת (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 |
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 .
|
טבלה אחת (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 | השם של אוסף האפליקציות הזה. |