שולחנות פרטיים
טבלה אחת (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 |
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] | מערך של נתוני CostTrackingPixel שהוקצו למעקב אחרי הפריט הזה. |
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 | מזהה Floodlight ב-DFA שמשויך לפיקסל הזה. |
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. |
exchange_id | Numeric Id | המזהה של פלטפורמת ה-Exchange שבה מקור המלאי הזה זמין. ניתן להצטרף באמצעות SupportedExchange.id . |
accessing_advertisers | [Numeric Id] | מערך של מזהי מפרסמים, שאפשר להצטרף אליהם באמצעות Advertiser.common_data.id , עם הרשאה להשתמש במקור הזה של מלאי שטחי פרסום.הערה: אם מקור מלאי שטחי הפרסום זמין לכל המפרסמים, השדה הזה לא יוצג. |
external_id | string | המזהה החיצוני שניתן למקור הזה של מלאי שטחי פרסום ומוגדר על ידי הבורסה, ובדרך כלל נקרא מזהה עסקה או מזהה בית עסק. יכול להיות שהשדה הזה חסר. |
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 | סוג העלות יהיה תמיד עלות לאלף חשיפות (CPM), קוד המטבע תמיד יהיה דולר ארה"ב. |
advertiser_pricings | [UserListAdvertiserPricing] | סוג העלות יהיה תמיד עלות לאלף חשיפות (CPM), קוד המטבע תמיד יהיה דולר ארה"ב. |
טבלה אחת (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 | השם של אוסף האפליקציות הזה. |