אינדקס
AccessibleBiddingStrategy
(הודעה)AccessibleBiddingStrategy.MaximizeConversionValue
(הודעה)AccessibleBiddingStrategy.MaximizeConversions
(הודעה)AccessibleBiddingStrategy.TargetCpa
(הודעה)AccessibleBiddingStrategy.TargetImpressionShare
(הודעה)AccessibleBiddingStrategy.TargetRoas
(הודעה)AccessibleBiddingStrategy.TargetSpend
(הודעה)Ad
(הודעה)AdGroup
(הודעה)AdGroupAd
(הודעה)AdGroupAdEffectiveLabel
(הודעה)AdGroupAdLabel
(הודעה)AdGroupAsset
(הודעה)AdGroupAssetSet
(הודעה)AdGroupAudienceView
(הודעה)AdGroupBidModifier
(הודעה)AdGroupCriterion
(הודעה)AdGroupCriterion.PositionEstimates
(הודעה)AdGroupCriterion.QualityInfo
(הודעה)AdGroupCriterionEffectiveLabel
(הודעה)AdGroupCriterionLabel
(הודעה)AdGroupEffectiveLabel
(הודעה)AdGroupLabel
(הודעה)AgeRangeView
(הודעה)Asset
(הודעה)AssetGroup
(הודעה)AssetGroupAsset
(הודעה)AssetGroupAssetCombinationData
(הודעה)AssetGroupListingGroupFilter
(הודעה)AssetGroupSignal
(הודעה)AssetGroupTopCombinationView
(הודעה)AssetSet
(הודעה)AssetSetAsset
(הודעה)Audience
(הודעה)BiddingStrategy
(הודעה)Campaign
(הודעה)Campaign.DynamicSearchAdsSetting
(הודעה)Campaign.GeoTargetTypeSetting
(הודעה)Campaign.NetworkSettings
(הודעה)Campaign.OptimizationGoalSetting
(הודעה)Campaign.SelectiveOptimization
(הודעה)Campaign.ShoppingSetting
(הודעה)Campaign.TrackingSetting
(הודעה)CampaignAsset
(הודעה)CampaignAssetSet
(הודעה)CampaignAudienceView
(הודעה)CampaignBudget
(הודעה)CampaignCriterion
(הודעה)CampaignEffectiveLabel
(הודעה)CampaignLabel
(הודעה)CartDataSalesView
(הודעה)Conversion
(הודעה)ConversionAction
(הודעה)ConversionAction.AttributionModelSettings
(הודעה)ConversionAction.FloodlightSettings
(הודעה)ConversionAction.ValueSettings
(הודעה)ConversionCustomVariable
(הודעה)ConversionCustomVariable.FloodlightConversionCustomVariableInfo
(הודעה)ConversionTrackingSetting
(הודעה)CustomColumn
(הודעה)Customer
(הודעה)CustomerAsset
(הודעה)CustomerAssetSet
(הודעה)CustomerClient
(הודעה)CustomerManagerLink
(הודעה)DoubleClickCampaignManagerSetting
(הודעה)DynamicSearchAdsSearchTermView
(הודעה)GenderView
(הודעה)GeoTargetConstant
(הודעה)KeywordView
(הודעה)Label
(הודעה)LanguageConstant
(הודעה)ListingGroupFilterDimension
(הודעה)ListingGroupFilterDimension.ProductBiddingCategory
(הודעה)ListingGroupFilterDimension.ProductBrand
(הודעה)ListingGroupFilterDimension.ProductChannel
(הודעה)ListingGroupFilterDimension.ProductCondition
(הודעה)ListingGroupFilterDimension.ProductCustomAttribute
(הודעה)ListingGroupFilterDimension.ProductItemId
(הודעה)ListingGroupFilterDimension.ProductType
(הודעה)ListingGroupFilterDimensionPath
(הודעה)LocationView
(הודעה)ProductBiddingCategoryConstant
(הודעה)ProductGroupView
(הודעה)SearchAds360Field
(הודעה)ShoppingPerformanceView
(הודעה)UserList
(הודעה)UserLocationView
(הודעה)Visit
(הודעה)WebpageView
(הודעה)
AccessibleBiddingStrategy
מייצגת תצוגה של שיטות בידינג שבבעלות הלקוח וששותפו איתו.
בניגוד ל-BiddingStrategy, המשאב הזה כולל אסטרטגיות שבבעלות מנהלי הלקוח ומשותפות עם הלקוח הזה – בנוסף לאסטרטגיות שבבעלות הלקוח הזה. המשאב הזה לא מספק מדדים, והוא חושף רק קבוצת משנה מוגבלת של המאפיינים של שיטת הבידינג.
שדות | |
---|---|
resource_name |
שם המשאב של שיטת הבידינג הנגישה. שמות המשאבים של AccessibleBiddingStrategy מופיעים בפורמט:
|
id |
המזהה של שיטת הבידינג. |
name |
השם של שיטת הבידינג. |
type |
הסוג של שיטת הבידינג. |
owner_customer_id |
המזהה של הלקוח שבבעלותו אסטרטגיית הבידינג. |
owner_descriptive_name |
השם המפורט של הלקוח שבבעלותו שיטת הבידינג. |
שדה האיחוד אפשר להגדיר רק אחד. הערך של |
|
maximize_conversion_value |
שיטת בידינג אוטומטית שעוזרת לכם להשיג את ערך ההמרה הגבוה ביותר מהקמפיינים שלכם במסגרת התקציב. |
maximize_conversions |
שיטת בידינג אוטומטית שיעזרו לכם להשיג כמה שיותר המרות בקמפיינים במסגרת התקציב. |
target_cpa |
שיטת בידינג שמגדירה הצעות מחיר כדי לעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם. |
target_impression_share |
שיטת בידינג שמבצעת אופטימיזציה אוטומטית להשגת אחוז מסוים של חשיפות. |
target_roas |
שיטת בידינג שעוזרת לכם למקסם את ההכנסות תוך עמידה בערך ממוצע של יעד ספציפי של החזר על הוצאות פרסום (ROAS). |
target_spend |
שיטת בידינג שמגדירה את הצעות המחיר באופן שיעזור לכם לקבל כמה שיותר קליקים במסגרת התקציב. |
MaximizeConversionValue
שיטת בידינג אוטומטית שעוזרת לכם להשיג את ערך ההמרה הגבוה ביותר מהקמפיינים שלכם במסגרת התקציב.
שדות | |
---|---|
target_roas |
האפשרות 'יעד החזר על הוצאות פרסום (ROAS)'. אם ההגדרה הזו מוגדרת, שיטת הבידינג תעזור לכם למקסם את ההכנסות תוך שמירה על ערך ממוצע של יעד ההחזר על הוצאות הפרסום. אם יעד ההחזר על הוצאות הפרסום גבוה, יכול להיות ששיטת הבידינג לא תוכל להוציא את כל התקציב. אם לא תגדירו יעד החזר על הוצאות פרסום, שיטת הבידינג תנסה להשיג את ההחזר הגבוה ביותר על הוצאות הפרסום במסגרת התקציב. |
MaximizeConversions
שיטת בידינג אוטומטית שיעזרו לכם להשיג כמה שיותר המרות בקמפיינים במסגרת התקציב.
שדות | |
---|---|
target_cpa |
האפשרות 'יעד עלות להמרה (CPA)'. זהו הסכום הממוצע שאתם רוצים להוציא לכל עסקה. |
target_cpa_micros |
האפשרות 'יעד עלות להמרה (CPA)'. זהו הסכום הממוצע שאתם רוצים להוציא לכל עסקה. |
TargetCpa
זוהי שיטת בידינג אוטומטית שמגדירה הצעות מחיר כדי לעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם.
שדות | |
---|---|
target_cpa_micros |
יעד עלות ממוצעת להמרה (CPA). היעד הזה צריך להיות גדול או שווה ליחידת החיוב המינימלית, בהתאם למטבע של החשבון. |
TargetRoas
שיטת בידינג אוטומטית שעוזרת לכם למקסם את ההכנסות תוך עמידה בערך ממוצע של יעד החזר ספציפי על הוצאות הפרסום (ROAS).
שדות | |
---|---|
target_roas |
ההכנסה שנבחרה (על סמך נתוני ההמרות) לכל יחידת הוצאה. |
TargetSpend
שיטת בידינג אוטומטית שמגדירה את הצעות המחיר כדי לעזור לכם לקבל כמה שיותר קליקים במסגרת התקציב.
שדות | |
---|---|
target_spend_micros |
יעד ההוצאות במסגרתו יתבצע מיקסום הקליקים. מגיש הצעות מחיר לפי יעד הוצאה ינסה להוציא את הסכום הנמוך מבין הערך הזה או סכום ההוצאה הטבעי לאחר הצמצום. אם לא צוין יעד הוצאה, המערכת תשתמש בתקציב כיעד ההוצאה. השדה הזה הוצא משימוש ואין להשתמש בו יותר. פרטים נוספים זמינים בכתובת https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html. |
cpc_bid_ceiling_micros |
תקרת הצעות המחיר המקסימלית שאפשר להגדיר בשיטת הבידינג. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי השיטה. |
מודעה
מודעה.
שדות | |
---|---|
resource_name |
שם המשאב של המודעה. שמות המשאבים של המודעות מופיעים בפורמט:
|
final_urls[] |
רשימת כתובות ה-URL הסופיות האפשריות אחרי כל ההפניות האוטומטיות של המודעה בין דומיינים. |
type |
סוג המודעה. |
id |
המזהה של המודעה. |
display_url |
כתובת ה-URL שמופיעה בתיאור המודעה בפורמטים מסוימים של מודעות. |
name |
שם המודעה. המזהה הזה משמש רק לזיהוי המודעה. הוא לא חייב להיות ייחודי ולא משפיע על המודעה המוצגת. בשלב זה, אפשר להשתמש בשדה השם רק במודעות DisplayUploadAd, ImageAd, ShoppingComparisonListingAd ו-VideoAd. |
שדה האיחוד ad_data . פרטים שרלוונטיים לסוג המודעה. חובה להגדיר ערך אחד בלבד. הערך של ad_data יכול להיות רק אחת מהאפשרויות הבאות: |
|
text_ad |
פרטים שקשורים למודעת טקסט. |
expanded_text_ad |
פרטים שקשורים למודעת טקסט מורחבת. |
responsive_search_ad |
פרטים שקשורים למודעה רספונסיבית לרשת החיפוש. |
product_ad |
פרטים שקשורים למודעה של מוצר. |
expanded_dynamic_search_ad |
פרטים לגבי מודעת חיפוש דינמית מורחבת. |
קבוצת מודעות
קבוצת מודעות.
שדות | |
---|---|
resource_name |
שם המשאב של קבוצת המודעות. שמות המשאבים של קבוצות המודעות בפורמט:
|
status |
הסטטוס של קבוצת המודעות. |
type |
הסוג של קבוצת המודעות. |
ad_rotation_mode |
המצב של סבב המודעות בקבוצת המודעות. |
creation_time |
חותמת הזמן שבה קבוצת המודעות הזו נוצרה. חותמת הזמן היא לפי אזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'. |
targeting_setting |
הגדרה לתכונות שקשורות לטירגוט. |
labels[] |
שמות המשאבים של התוויות שמצורפות לקבוצת המודעות הזו. |
effective_labels[] |
שמות המשאבים של תוויות יעילות שמצורפות לקבוצת המודעות הזו. תווית יעילה היא תווית שעברה בירושה לקבוצת המודעות הזו או שהוקצה לה ישירות. |
engine_id |
המזהה של קבוצת המודעות בחשבון של מנוע החיפוש החיצוני. השדה הזה מיועד רק לחשבונות שאינם של Google Ads, למשל Yahoo Japan, Microsoft, Baidu וכו'. עבור ישות של Google Ads, צריך להשתמש במקום זאת ב-'ad_group.id'. |
start_date |
התאריך שבו קבוצת המודעות הזו תתחיל להציג מודעות. כברירת מחדל, קבוצת המודעות מתחילה לפעול עכשיו או בתאריך ההתחלה של קבוצת המודעות, המאוחר מביניהם. אם השדה הזה מוגדר, קבוצת המודעות תתחיל לפעול בתחילת התאריך שצוין באזור הזמן של הלקוח. השדה הזה זמין רק לחשבונות שער של Microsoft Advertising ושל Facebook. פורמט: YYYY-MM-DD דוגמה: 2019-03-14 |
end_date |
התאריך שבו הצגת המודעות בקבוצת המודעות תסתיים. כברירת מחדל, קבוצת המודעות מסתיימת בתאריך הסיום שלה. אם השדה הזה מוגדר, קבוצת המודעות תסתיים בסוף התאריך שצוין באזור הזמן של הלקוח. השדה הזה זמין רק לחשבונות שער של Microsoft Advertising ושל Facebook. פורמט: YYYY-MM-DD דוגמה: 2019-03-14 |
language_code |
השפה של המודעות ומילות המפתח בקבוצת מודעות. השדה הזה זמין רק לחשבונות Microsoft Advertising. פרטים נוספים: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage |
last_modified_time |
תאריך ושעה של השינוי האחרון בקבוצת המודעות הזו. תאריך ושעה לפי אזור הזמן של הלקוח, בפורמט 'yyyy-MM-dd HH:mm:ss.ssssss'. |
id |
המזהה של קבוצת המודעות. |
name |
השם של קבוצת המודעות. השדה הזה נדרש ואסור שיהיה ריק כשיוצרים קבוצות מודעות חדשות. השם חייב להכיל פחות מ-255 תווים בתקן UTF-8 ברוחב מלא. אסור לכלול תווים של null (נקודת קוד 0x0), פיד שורה NL (נקודת קוד 0xA) או תו חזרה לתחילת השורה (נקודת קוד 0xD). |
cpc_bid_micros |
הצעת המחיר המקסימלית לקליק (CPC). |
engine_status |
סטטוס המנוע של קבוצת המודעות. |
AdGroupAd
מודעה בקבוצת מודעות.
שדות | |
---|---|
resource_name |
שם המשאב של המודעה. שמות המשאבים של המודעות בקבוצת המודעות הם בפורמט:
|
status |
הסטטוס של המודעה. |
ad |
המודעה. |
creation_time |
חותמת הזמן שבה ad_group_ad נוצר. תאריך ושעה לפי אזור הזמן של הלקוח, בפורמט 'yyyy-MM-dd HH:mm:ss.ssssss'. |
labels[] |
שמות המשאבים של התוויות שמצורפות למודעה בקבוצת המודעות הזו. |
effective_labels[] |
שמות המשאבים של התוויות הפעילות שמצורפות למודעה הזו. תווית יעילה היא תווית שעברה בירושה או הוקצתה ישירות למודעה הזו. |
engine_id |
המזהה של המודעה בחשבון מנוע החיפוש החיצוני. השדה הזה מיועד לחשבון Search Ads 360 בלבד, למשל Yahoo Japan, Microsoft, Baidu וכו'. עבור ישות שאינה חשבון Search Ads 360, צריך להשתמש במקום זאת ב-'ad_group_ad.ad.id'. |
engine_status |
סטטוס נוסף של המודעה בחשבון של מנוע החיפוש החיצוני. הסטטוסים האפשריים (בהתאם לסוג החשבון החיצוני) כוללים 'פעיל', 'עומד בדרישות', 'בהמתנה לבדיקה' וכו'. |
last_modified_time |
תאריך ושעה של השינוי האחרון במודעה בקבוצת המודעות הזו. תאריך ושעה לפי אזור הזמן של הלקוח, בפורמט 'yyyy-MM-dd HH:mm:ss.ssssss'. |
AdGroupAdEffectiveLabel
קשר בין מודעה בקבוצת מודעות לבין תווית יעילה. תווית יעילה היא תווית שעברה בירושה או שהוקצה לה ישירות מודעה בקבוצת המודעות הזו.
שדות | |
---|---|
resource_name |
שם המשאב של התווית 'מודעה יעילה' של קבוצת המודעות. שמות המשאבים של תוויות יעילות של מודעות בקבוצת מודעות הם בפורמט: |
ad_group_ad |
המודעה בקבוצת המודעות שאליה מצורפת התווית היעילה. |
label |
התווית בפועל שהוקצתה למודעה בקבוצת המודעות. |
owner_customer_id |
המזהה של הלקוח שבבעלותו התווית היעילה. |
AdGroupAdLabel
קשר בין מודעה בקבוצת מודעות לבין תווית.
שדות | |
---|---|
resource_name |
שם המשאב של תווית המודעות של קבוצת המודעות. שמות המשאבים של תוויות המודעות של קבוצות המודעות הם בפורמט: |
ad_group_ad |
מודעת קבוצת המודעות שאליה מצורפת התווית. |
label |
התווית שמוקצית למודעה בקבוצת המודעות. |
owner_customer_id |
המזהה של הלקוח שבבעלותו התווית. |
AdGroupAsset
קישור בין קבוצת מודעות לבין נכס.
שדות | |
---|---|
resource_name |
שם המשאב של נכס קבוצת המודעות. שמות המשאבים מסוג AdGroupAsset הם בפורמט:
|
ad_group |
חובה. קבוצת המודעות שאליה הנכס מקושר. |
asset |
חובה. הנכס שמקושר לקבוצת המודעות. |
status |
הסטטוס של הנכס הדיגיטלי של קבוצת המודעות. |
AdGroupAssetSet
AdGroupAssetSet הוא הקישור בין קבוצת מודעות לבין קבוצת נכסים. יצירת קבוצת נכסים בקבוצת מודעות מקשרת קבוצת נכסים לקבוצת מודעות.
שדות | |
---|---|
resource_name |
שם המשאב של קבוצת הנכסים של קבוצת המודעות. שמות המשאבים של קבוצת הנכסים של קבוצת המודעות הם בפורמט:
|
ad_group |
קבוצת המודעות שאליה מקושרת קבוצת הנכסים הזו. |
asset_set |
קבוצת הנכסים שמקושרת לקבוצת המודעות. |
status |
הסטטוס של קבוצת הנכסים של קבוצת המודעות. קריאה בלבד. |
AdGroupAudienceView
תצוגה של קהל קבוצת מודעות. הדוח כולל נתוני ביצועים מתחומי עניין ורשימות רימרקטינג למודעות ברשת המדיה וב-YouTube Network, ורשימות רימרקטינג למודעות לרשת החיפוש (RLSA), שמצטברים ברמת הקהל.
שדות | |
---|---|
resource_name |
שם המשאב של תצוגת הקהל של קבוצת המודעות. שמות המשאבים של תצוגת הקהל של קבוצת המודעות הם בפורמט:
|
AdGroupBidModifier
מייצג מגביל של הצעת מחיר לקבוצת מודעות.
שדות | |
---|---|
resource_name |
שם המשאב של מגביל הצעת המחיר של קבוצת המודעות. שמות המשאבים של מגבילי הצעות המחיר של קבוצות המודעות הם בפורמט:
|
bid_modifier |
המכפיל של הצעת המחיר כשהקריטריון תואם. הערך של המשתנה המשנה צריך להיות בטווח: 0.1 עד 10.0. הטווח של PreferredContent הוא 1.0 עד 6.0. כדי לבטל את ההסכמה לשימוש בסוג מכשיר מסוים, מזינים 0. |
שדה האיחוד חובה בפעולות יצירה החל מגרסה 5. הערך של |
|
device |
קריטריון למכשיר. |
AdGroupCriterion
קריטריון של קבוצת מודעות. הדוח ad_group_criterion מחזיר רק קריטריונים שנוספו במפורש לקבוצת המודעות.
שדות | |
---|---|
resource_name |
שם המשאב של קריטריון קבוצת המודעות. שמות המשאבים של קריטריונים של קבוצות מודעות הם בפורמט:
|
creation_time |
חותמת הזמן שבה נוצר קריטריון קבוצת המודעות הזה. חותמת הזמן היא לפי אזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'. |
status |
הסטטוס של הקריטריון. זהו הסטטוס של הישות של קריטריון קבוצת המודעות, שהוגדר על ידי הלקוח. הערה: דוחות ממשק המשתמש עשויים לכלול מידע נוסף שמשפיע על האפשרות להפעיל קריטריון. במקרים מסוימים, קריטריון שהוסרה ב-API עדיין יכול להופיע כמופעל בממשק המשתמש. לדוגמה, כברירת מחדל, הקמפיינים מוצגים למשתמשים בכל טווחי הגילאים, אלא אם הם מוחרגים. בממשק המשתמש יופיע כל טווח גילאים כ'מופעל', כי הוא עומד בדרישות להצגת המודעות. אבל ב-AdGroupCriterion.status יופיע הערך 'הוסר', כי לא נוסף קריטריון חיובי. |
quality_info |
מידע על איכות הקריטריון. |
type |
סוג הקריטריון. |
labels[] |
שמות המשאבים של התוויות שמצורפות לקריטריון הזה של קבוצת המודעות. |
effective_labels[] |
שמות המשאבים של התוויות הפעילות שמצורפות לקריטריון הזה של קבוצת המודעות. תווית יעילה היא תווית שעברה בירושה או הוקצתה ישירות לקריטריון הזה של קבוצת המודעות. |
position_estimates |
אומדנים של הצעות מחיר לפי קריטריונים במיקומים שונים. |
final_urls[] |
רשימת כתובות ה-URL הסופיות האפשריות אחרי כל ההפניות האוטומטיות של המודעה בין דומיינים. |
engine_id |
המזהה של קריטריון קבוצת המודעות בחשבון של מנוע החיפוש החיצוני. השדה הזה מיועד רק לחשבונות שאינם של Google Ads, למשל Yahoo Japan, Microsoft, Baidu וכו'. עבור ישות של Google Ads, צריך להשתמש במקום זאת ב-'ad_group_criterion.criterion_id'. |
last_modified_time |
תאריך ושעה של השינוי האחרון בקריטריון של קבוצת המודעות. תאריך ושעה לפי אזור הזמן של הלקוח, בפורמט 'yyyy-MM-dd HH:mm:ss.ssssss'. |
criterion_id |
המזהה של הקריטריון. |
ad_group |
קבוצת המודעות שאליה שייך הקריטריון. |
negative |
אם לטרגט ( השדה הזה לא ניתן לשינוי. כדי להפוך קריטריון מחיובי לשלילי, צריך להסיר אותו ואז להוסיף אותו מחדש. |
bid_modifier |
המכפיל של הצעת המחיר כשהקריטריון תואם. הערך של המשתנה המשנה צריך להיות בטווח: 0.1 עד 10.0. רוב סוגי הקריטריונים לטירגוט תומכים בשימוש בגורמים משנים. |
cpc_bid_micros |
הצעת המחיר לקליק (CPC). |
effective_cpc_bid_micros |
הצעת המחיר בפועל לקליק (CPC). |
engine_status |
סטטוס המנוע של קריטריון קבוצת המודעות. |
final_url_suffix |
תבנית של כתובת URL להוספת פרמטרים לכתובת ה-URL הסופית. |
tracking_url_template |
תבנית כתובת ה-URL ליצירת כתובת URL למעקב. |
שדה האיחוד צריך להגדיר רק ערך אחד. הערך של |
|
keyword |
מילת מפתח. |
listing_group |
קבוצת כרטיסי מוצר. |
age_range |
טווח הגילאים. |
gender |
מגדר. |
user_list |
רשימת משתמשים. |
webpage |
דף אינטרנט |
location |
מיקום. |
PositionEstimates
אומדנים של הצעות מחיר לפי קריטריונים במיקומים שונים.
שדות | |
---|---|
top_of_page_cpc_micros |
ההערכה של הצעת המחיר לקליק (CPC) שנדרשת כדי שהמודעה תוצג בחלק העליון של הדף הראשון של תוצאות החיפוש. |
QualityInfo
מאגר של מידע על איכות הקריטריונים של קבוצת המודעות.
שדות | |
---|---|
quality_score |
ציון האיכות. יכול להיות שהשדה הזה לא יאוכלס אם ל-Google אין מספיק מידע כדי לקבוע ערך. |
AdGroupCriterionEffectiveLabel
קשר בין קריטריון של קבוצת מודעות לבין תווית יעילה. תווית יעילה היא תווית שעברה בירושה או הוקצתה ישירות לקריטריון הזה של קבוצת המודעות.
שדות | |
---|---|
resource_name |
שם המשאב של התווית היעילה של קריטריון קבוצת המודעות. שמות המשאבים של תוויות יעילות של קריטריונים של קבוצות מודעות הם בפורמט: |
ad_group_criterion |
קריטריון קבוצת המודעות שאליו מצורפת התווית היעילה. |
label |
התווית בפועל שהוקצתה לקריטריון של קבוצת המודעות. |
owner_customer_id |
המזהה של הלקוח שבבעלותו התווית היעילה. |
AdGroupCriterionLabel
קשר בין קריטריון של קבוצת מודעות לבין תווית.
שדות | |
---|---|
resource_name |
שם המשאב של תווית הקריטריון של קבוצת המודעות. שמות המשאבים של תוויות של קריטריונים של קבוצות מודעות הם בפורמט: |
ad_group_criterion |
קריטריון קבוצת המודעות שאליו מצורפת התווית. |
label |
התווית שהוקצה לקריטריון של קבוצת המודעות. |
owner_customer_id |
המזהה של הלקוח שבבעלותו התווית. |
AdGroupEffectiveLabel
קשר בין קבוצת מודעות לבין תווית יעילה. תווית יעילה היא תווית שעברה בירושה לקבוצת המודעות הזו או שהוקצה לה ישירות.
שדות | |
---|---|
resource_name |
שם המשאב של התווית היעילה של קבוצת המודעות. שמות המשאבים של תוויות יעילות של קבוצות מודעות הם בפורמט: |
ad_group |
קבוצת המודעות שאליה מצורפת התווית היעילה. |
label |
התווית בפועל שהוקצתה לקבוצת המודעות. |
owner_customer_id |
המזהה של הלקוח שבבעלותו התווית היעילה. |
AdGroupLabel
קשר בין קבוצת מודעות לבין תווית.
שדות | |
---|---|
resource_name |
שם המשאב של תווית קבוצת המודעות. שמות המשאבים של תיאורי המקומות של קבוצות המודעות הם בפורמט: |
ad_group |
קבוצת המודעות שאליה מצורפת התווית. |
label |
התווית שמוקצית לקבוצת המודעות. |
owner_customer_id |
המזהה של הלקוח שבבעלותו התווית. |
AgeRangeView
תצוגה של טווח גילאים.
שדות | |
---|---|
resource_name |
שם המשאב של תצוגת טווח הגילאים. שמות המשאבים של תצוגת טווח הגילאים הם בפורמט:
|
נכס
נכס הוא חלק ממודעה שאפשר לשתף בין כמה מודעות. הנכס יכול להיות תמונה (ImageAsset), סרטון (YoutubeVideoAsset) וכו'. אי אפשר לשנות את הנכסים או להסיר אותם. כדי להפסיק את הצגת נכס, מסירים אותו מהישות שמשתמשת בו.
שדות | |
---|---|
resource_name |
שם המשאב של הנכס. שמות המשאבים של הנכסים מופיעים בפורמט:
|
type |
סוג הנכס. |
final_urls[] |
רשימה של כתובות URL סופיות אפשריות אחרי כל ההפניות האוטומטיות בין דומיינים. |
status |
הסטטוס של הנכס. |
creation_time |
חותמת הזמן שבה נוצר הנכס. חותמת הזמן היא לפי אזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'. |
last_modified_time |
תאריך ושעה של השינוי האחרון בנכס. תאריך ושעה לפי אזור הזמן של הלקוח, בפורמט 'yyyy-MM-dd HH:mm:ss.ssssss'. |
id |
מזהה הנכס. |
name |
שם אופציונלי של הנכס. |
tracking_url_template |
תבנית של כתובת URL ליצירת כתובת URL למעקב. |
engine_status |
סטטוס המנוע של נכס. |
שדה האיחוד asset_data . הסוג הספציפי של הנכס. הערך של asset_data יכול להיות רק אחת מהאפשרויות הבאות: |
|
youtube_video_asset |
נכס וידאו ב-YouTube. |
image_asset |
נכס תמונות. |
text_asset |
נכס טקסט. |
callout_asset |
נכס יתרונות מרכזיים מאוחד. |
sitelink_asset |
נכס Sitelink מאוחד. |
page_feed_asset |
נכס מאוחד של פיד דפי נחיתה. |
mobile_app_asset |
נכס אפליקציה לנייד. |
call_asset |
נכס התקשרות מאוחד. |
call_to_action_asset |
נכס קריאה לפעולה. |
location_asset |
נכס מיקום מאוחד. |
AssetGroup
קבוצת נכסים. השדה AssetGroupAsset משמש לקישור נכס לקבוצת הנכסים. הנכס AssetGroupSignal משמש לשיוך אות לקבוצת נכסים.
שדות | |
---|---|
resource_name |
שם המשאב של קבוצת הנכסים. שמות המשאבים של קבוצת הנכסים מופיעים בתבנית:
|
id |
המזהה של קבוצת הנכסים. |
campaign |
הקמפיין שאליו משויך קבוצת הנכסים הזו. הנכס שמקושר לקבוצת הנכסים. |
name |
חובה. השם של קבוצת הנכסים. חובה. האורך המינימלי של השם הוא 1 והאורך המקסימלי הוא 128. השם חייב להיות ייחודי בקמפיין. |
final_urls[] |
רשימה של כתובות URL סופיות אחרי כל ההפניות האוטומטיות בין דומיינים. כברירת מחדל, כתובות ה-URL בקמפיינים למיקסום הביצועים עומדות בדרישות להרחבה, אלא אם בוטלה ההסכמה לכך. |
final_mobile_urls[] |
רשימה של כתובות URL סופיות לניידים אחרי כל ההפניות האוטומטיות בין דומיינים. כברירת מחדל, כתובות ה-URL בקמפיינים למיקסום הביצועים עומדות בדרישות להרחבה, אלא אם בוטלה ההסכמה לכך. |
status |
הסטטוס של קבוצת הנכסים. |
path1 |
החלק הראשון של הטקסט שעשוי להופיע כתוספי לכתובת ה-URL שמוצגת במודעה. |
path2 |
החלק השני של הטקסט שעשוי להופיע כתווספת לכתובת ה-URL שמוצגת במודעה. אפשר להגדיר את השדה הזה רק כשהשדה path1 מוגדר. |
ad_strength |
חוזק המודעה הכולל של קבוצת הנכסים הזו. |
AssetGroupAsset
AssetGroupAsset הוא הקישור בין נכס לקבוצת נכסים. הוספת AssetGroupAsset מקשרת נכס לקבוצת נכסים.
שדות | |
---|---|
resource_name |
שם המשאב של נכס קבוצת הנכסים. שם המשאב של נכס בקבוצת נכסים הוא בצורה הבאה:
|
asset_group |
קבוצת הנכסים שאליה הנכס הזה בקבוצת הנכסים מקשר. |
asset |
הנכס שאליו הנכס בקבוצת הנכסים הזו מקושר. |
field_type |
התיאור של מיקום הנכס בקבוצת הנכסים. לדוגמה: HEADLINE, YOUTUBE_VIDEO וכו' |
status |
הסטטוס של הקישור בין נכס לבין קבוצת נכסים. |
AssetGroupAssetCombinationData
נתונים על שילובי נכסים בקבוצת נכסים
שדות | |
---|---|
asset_combination_served_assets[] |
נכסים שמוצגים. |
AssetGroupListingGroupFilter
AssetGroupListingGroupFilter מייצג צומת של עץ מסנן של קבוצת כרטיסי מוצר בקבוצת נכסים.
שדות | |
---|---|
resource_name |
שם המשאב של מסנן הקבוצות של כרטיסי המוצר בנכסים הדיגיטליים. שם המשאב של מסנן קבוצות של כרטיסי מוצר בנכסים דיגיטליים הוא בצורה הבאה:
|
asset_group |
קבוצת הנכסים שאליה שייך מסנן הקבוצות של כרטיסי המוצר בנכסים הדיגיטליים. |
id |
המזהה של ListingGroupFilter. |
type |
הסוג של צומת מסנן של קבוצת כרטיסי מוצר. |
vertical |
הציר האנכי שמייצג את עץ הצמתים הנוכחי. כל הצמתים באותו עץ חייבים להיות שייכים לאותו תחום עסקי. |
case_value |
ערך המאפיין שבו קבוצת כרטיסי המוצר הזו מחדדת את ההורה שלה. לא מוגדר לקבוצת הבסיס. |
parent_listing_group_filter |
שם המשאב של חלוקת המשנה של קבוצת כרטיסי המוצר הראשית. Null לצומת המסנן של קבוצת כרטיסי המוצר ברמה הבסיסית. |
path |
הנתיב של המאפיינים שמגדירים את המסנן הזה של קבוצת כרטיסי המוצר. |
AssetGroupSignal
AssetGroupSignal מייצג אות בקבוצת נכסים. קיומו של אות מאפשר לקמפיין למיקסום הביצועים לזהות את המשתמשים שהסיכוי שהם ישלימו המרה הוא הגבוה ביותר. בקמפיינים למיקסום הביצועים נעשה שימוש באות הקהל כדי להגיע לאנשים חדשים עם כוונת רכישה דומה או חזקה יותר, כדי למצוא המרות ברשת החיפוש, ברשת המדיה, במודעות וידאו וברשתות נוספות.
שדות | |
---|---|
resource_name |
שם המשאב של האות של קבוצת הנכסים. שם המשאב של האות לזיהוי קהלים בקבוצת נכסים הוא בצורה הבאה:
|
asset_group |
קבוצת הנכסים שאליה שייך האות הזה של קבוצת הנכסים. |
שדה האיחוד signal . האות של קבוצת הנכסים. הערך של signal יכול להיות רק אחת מהאפשרויות הבאות: |
|
audience |
האות לזיהוי הקהל שמשמש את הקמפיין למיקסום הביצועים. |
AssetGroupTopCombinationView
תצוגה של השימוש בשילובי הנכסים המובילים בקבוצת הנכסים.
שדות | |
---|---|
resource_name |
שם המשאב בתצוגה של שילובי הנכסים המובילים בקבוצת הנכסים. שמות המשאבים של תצוגת AssetGroup Top Combination הם בפורמט: "customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}" |
asset_group_top_combinations[] |
השילובים המובילים של נכסים שמוצגים יחד. |
AssetSet
קבוצת נכסים שמייצגת אוסף של נכסים. משתמשים ב-AssetSetAsset כדי לקשר נכס לקבוצת הנכסים.
שדות | |
---|---|
id |
המזהה של קבוצת הנכסים. |
resource_name |
שם המשאב של קבוצת הנכסים. שמות המשאבים של קבוצת הנכסים הם בפורמט:
|
AssetSetAsset
AssetSetAsset הוא הקישור בין נכס לבין קבוצת נכסים. הוספת AssetSetAsset מקשרת נכס לקבוצת נכסים.
שדות | |
---|---|
resource_name |
שם המשאב של הנכס שהוגדר על ידי נכס. שמות המשאבים של נכסי קבוצת הנכסים הם בפורמט:
|
asset_set |
קבוצת הנכסים שאליה הנכס הזה שמוגדר על ידי נכס מקשר. |
asset |
הנכס שאליו הנכס שהוגדר על ידי נכס מסוים מקושר. |
status |
הסטטוס של הנכס שהוגדר על ידי נכס. קריאה בלבד. |
קהל
קהל הוא אפשרות יעילה לטירגוט שמאפשרת ליצור חפיפה בין מאפייני פילוח שונים, כמו מידע דמוגרפי מפורט וקהלים עם תחום עניין משותף, וכך ליצור קהלים שמייצגים קטעים של פילוחי היעד.
שדות | |
---|---|
resource_name |
שם המשאב של הקהל. שמות הקהלים מופיעים בתבנית:
|
id |
המזהה של הקהל. |
name |
חובה. שם הקהל. הוא צריך להיות ייחודי לכל הקהלים. האורך המינימלי של השדה הוא 1 והאורך המקסימלי הוא 255. |
description |
תיאור הקהל. |
BiddingStrategy
שיטת בידינג.
שדות | |
---|---|
resource_name |
שם המשאב של שיטת הבידינג. שמות המשאבים של שיטות הבידינג בפורמט:
|
status |
הסטטוס של שיטת הבידינג. השדה הזה הוא לקריאה בלבד. |
type |
הסוג של שיטת הבידינג. יוצרים שיטת בידינג על ידי הגדרת תוכנית הבידינג. השדה הזה הוא לקריאה בלבד. |
currency_code |
המטבע שבו נעשה שימוש בשיטת הבידינג (קוד מטבע בן 3 אותיות לפי תקן ISO 4217). בשיטות בידינג בחשבונות ניהול, אפשר להגדיר את המטבע הזה בזמן היצירה, והמטבע שמוגדר כברירת מחדל הוא המטבע של חשבון הניהול. בחשבונות לקוח להצגת מודעות, לא ניתן להגדיר את השדה הזה. כל השיטות בחשבון לקוח להצגת מודעות משתמשות במטבע של החשבון להצגת מודעות באופן משתמע. בכל המקרים, השדה effective_currency_code מחזיר את המטבע שבו נעשה שימוש בשיטה. |
id |
המזהה של שיטת הבידינג. |
name |
השם של שיטת הבידינג. לכל שיטות הבידינג בחשבון צריך להיות שם ייחודי. אורך המחרוזת הזו צריך להיות בין 1 ל-255, כולל, בייטים של UTF-8 (אחרי חיתוך). |
effective_currency_code |
המטבע שבו נעשה שימוש בשיטת הבידינג (קוד מטבע בן 3 אותיות לפי תקן ISO 4217). בשיטות בידינג בחשבונות של לקוחות ניהול, זוהי המטבע שהמפרסם הגדיר כשיצר את השיטה. ללקוחות שמקבלים שירות, זהו currency_code של הלקוח. המדדים של שיטת הבידינג מדווחים במטבע הזה. השדה הזה הוא לקריאה בלבד. |
campaign_count |
מספר הקמפיינים שמשויכים לשיטת הבידינג הזו. השדה הזה הוא לקריאה בלבד. |
non_removed_campaign_count |
מספר הקמפיינים שעדיין לא הוסרו ושמשויכים לשיטת הבידינג הזו. השדה הזה הוא לקריאה בלבד. |
שדה האיחוד אפשר להגדיר רק אחד. הערך של |
|
enhanced_cpc |
שיטת בידינג שמגדילה את הצעות המחיר על קליקים שסביר יותר שיובילו להמרה ומקטינה אותן על קליקים שסביר פחות שיובילו להמרה. |
maximize_conversion_value |
שיטת בידינג אוטומטית שעוזרת לכם להשיג את ערך ההמרה הגבוה ביותר מהקמפיינים שלכם במסגרת התקציב. |
maximize_conversions |
שיטת בידינג אוטומטית שיעזרו לכם להשיג כמה שיותר המרות בקמפיינים במסגרת התקציב. |
target_cpa |
שיטת בידינג שמגדירה הצעות מחיר כדי לעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם. |
target_impression_share |
שיטת בידינג שמבצעת אופטימיזציה אוטומטית להשגת אחוז מסוים של חשיפות. |
target_outrank_share |
שיטת בידינג שמגדירה הצעות מחיר על סמך החלק היעד במכרזים שבהם המפרסם אמור לקבל דירוג גבוה יותר ממתחרה ספציפי. השדה הזה הוצא משימוש. לא ניתן ליצור שיטת בידינג חדשה עם השדה הזה או לצרף קמפיינים לשיטות בידינג עם השדה הזה. מותר לבצע מוטציות לשיטות שכבר מאוכלסות בתוכנית הזו. |
target_roas |
שיטת בידינג שעוזרת לכם למקסם את ההכנסות תוך עמידה בערך ממוצע של יעד ספציפי של החזר על הוצאות פרסום (ROAS). |
target_spend |
שיטת בידינג שמגדירה את הצעות המחיר באופן שיעזור לכם לקבל כמה שיותר קליקים במסגרת התקציב. |
קמפיין
קמפיין.
שדות | |
---|---|
resource_name |
שם המשאב של הקמפיין. שמות המשאבים של הקמפיינים הם בפורמט:
|
status |
הסטטוס של הקמפיין. כשמוסיפים קמפיין חדש, הסטטוס שמוגדר כברירת מחדל הוא 'מופעל'. |
serving_status |
סטטוס הצגת המודעות בקמפיין. |
bidding_strategy_system_status |
סטטוס המערכת של שיטת הבידינג של הקמפיין. |
ad_serving_optimization_status |
סטטוס האופטימיזציה של הצגת המודעות בקמפיין. |
advertising_channel_type |
היעד הראשי להצגת מודעות בקמפיין. אפשר לשפר את אפשרויות הטירגוט בקטע השדה הזה חובה, ואסור להשאיר אותו ריק כשיוצרים קמפיינים חדשים. אפשר להגדיר את האפשרות הזו רק בזמן יצירת הקמפיינים. אי אפשר לשנות את השדה אחרי יצירת הקמפיין. |
advertising_channel_sub_type |
שיפור אופציונלי ל- אפשר להגדיר את האפשרות הזו רק בזמן יצירת הקמפיינים. אי אפשר לשנות את השדה אחרי יצירת הקמפיין. |
url_custom_parameters[] |
רשימת המיפויים שמשמשים להחלפת תגי פרמטרים מותאמים אישית ב- |
real_time_bidding_setting |
הגדרות לבידינג בזמן אמת, תכונה שזמינה רק בקמפיינים שמטרגטים לרשת Ad Exchange. |
network_settings |
הגדרות הרשת של הקמפיין. |
dynamic_search_ads_setting |
ההגדרה לניהול מודעות דינמיות לרשת החיפוש (DSA). |
shopping_setting |
ההגדרה לניהול קמפיינים של שופינג. |
geo_target_type_setting |
ההגדרה של טירגוט גיאוגרפי של מודעות. |
effective_labels[] |
שמות המשאבים של התוויות הפעילות שמצורפות לקמפיין הזה. תווית יעילה היא תווית שעברה בירושה או הוקצתה ישירות לקמפיין הזה. |
labels[] |
שמות המשאבים של התוויות שמצורפות לקמפיין הזה. |
bidding_strategy_type |
הסוג של שיטת הבידינג. אפשר ליצור שיטת בידינג על ידי הגדרת תוכנית הבידינג ליצירת שיטת בידינג רגילה, או הגדרת השדה השדה הזה הוא לקריאה בלבד. |
accessible_bidding_strategy |
שם המשאב של AccessibleBiddingStrategy, תצוגה לקריאה בלבד של המאפיינים ללא הגבלה של שיטת הבידינג הכוללת המצורפת שזוהתה על ידי 'bidding_strategy'. ריק, אם לא מוגדרת בקמפיין שיטת בידינג כוללת. מאפייני האסטרטגיה ללא הגבלה זמינים לכל הלקוחות שאיתם האסטרטגיה משותפת, והם נקראים מהמשאב AccessibleBiddingStrategy. לעומת זאת, מאפיינים מוגבלים זמינים רק ללקוח הבעלים של האסטרטגיה ולמנהלים שלו. אפשר לקרוא מאפיינים מוגבלים רק מהמשאב BiddingStrategy. |
frequency_caps[] |
רשימה שמגבילה את התדירות שבה כל משתמש יראה את המודעות בקמפיין הזה. |
selective_optimization |
הגדרת אופטימיזציה סלקטיבית בקמפיין הזה, שכוללת קבוצה של פעולות המרה שהמערכת תבצע עליהן אופטימיזציה בקמפיין הזה. התכונה הזו רלוונטית רק לקמפיינים לקידום אפליקציות שמשתמשים ב-MULTI_CHANNEL בתור AdvertisingChannelType וב-APP_CAMPAIGN או ב-APP_CAMPAIGN_FOR_ENGAGEMENT בתור AdvertisingChannelSubType. |
optimization_goal_setting |
הגדרת יעד האופטימיזציה של הקמפיין, שכוללת קבוצה של סוגי יעדי אופטימיזציה. |
tracking_setting |
הגדרות ברמת הקמפיין לגבי פרטי המעקב. |
engine_id |
המזהה של הקמפיין בחשבון של מנוע החיפוש החיצוני. השדה הזה מיועד רק לחשבונות שאינם של Google Ads, למשל Yahoo Japan, Microsoft, Baidu וכו'. עבור ישות של Google Ads, צריך להשתמש במקום זאת ב-'campaign.id'. |
excluded_parent_asset_field_types[] |
סוגי שדות הנכסים שצריך להחריג מהקמפיין הזה. קישורי נכסים עם סוגי השדות האלה לא יועברו בירושה לקמפיין הזה מהרמה העליונה. |
create_time |
חותמת הזמן שבה הקמפיין נוצר. חותמת הזמן היא לפי אזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'. השדה create_time יוסר בגרסה 1. במקום זאת, צריך להשתמש ב-creation_time. |
creation_time |
חותמת הזמן שבה הקמפיין נוצר. חותמת הזמן היא לפי אזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'. |
last_modified_time |
חותמת הזמן של מועד השינוי האחרון של הקמפיין. תאריך ושעה לפי אזור הזמן של הלקוח, בפורמט 'yyyy-MM-dd HH:mm:ss.ssssss'. |
id |
המזהה של הקמפיין. |
name |
השם של מסע הפרסום. השדה הזה חובה, ואסור להשאיר אותו ריק כשיוצרים קמפיינים חדשים. אסור לכלול תווים של null (נקודת קוד 0x0), פיד שורה NL (נקודת קוד 0xA) או תו חזרה לתחילת השורה (נקודת קוד 0xD). |
tracking_url_template |
תבנית כתובת ה-URL ליצירת כתובת URL למעקב. |
campaign_budget |
שם המשאב של תקציב הקמפיין. |
start_date |
התאריך שבו הקמפיין התחיל לפעול לפי אזור הזמן של הלקוח שמקבל את המודעות, בפורמט YYYY-MM-DD. |
end_date |
היום האחרון של הקמפיין לפי אזור הזמן של הלקוח שמקבל את המודעות, בפורמט YYYY-MM-DD. במהלך היצירה, ברירת המחדל היא 30 בדצמבר 2037, כלומר הקמפיין יפעל ללא הגבלת זמן. כדי להגדיר קמפיין קיים לפעול ללא הגבלת זמן, צריך להגדיר את השדה הזה ל-30 בדצמבר 2037. |
final_url_suffix |
סיומת שמשמשת להוספת פרמטרים של שאילתות לדפי נחיתה שמוצגים עם מעקב מקביל. |
url_expansion_opt_out |
הערך הזה מייצג ביטול ההסכמה להרחבת כתובות URL לכתובות URL ממוקדות יותר. אם ההסכמה בוטלה (true), המערכת תתמקד רק בכתובות ה-URL הסופיות בקבוצת הנכסים או בכתובות ה-URL שצוינו בפידים של פרטי העסק או ב-Google Merchant Center של המפרסם. אם הבעלים הביעו הסכמה (false), הדומיין כולו יטורגט. אפשר להגדיר את השדה הזה רק בקמפיינים למיקסום הביצועים, שבהם ערך ברירת המחדל הוא false. |
שדה האיחוד השיטה צריכה להיות שיטת בידינג כוללת (שיצרתם באמצעות השירות BiddingStrategy) או שיטת בידינג רגילה שמוטמעת בקמפיין. הערך של |
|
bidding_strategy |
שם המשאב של שיטת הבידינג הכוללת שמשמשת את הקמפיין. |
manual_cpa |
שיטת בידינג רגילה לפי עלות ידנית להמרה. שיטת בידינג ידנית שמאפשרת למפרסם להגדיר את הצעת המחיר לכל פעולה שצוינה על ידו. התכונה נתמכת רק בקמפיינים של 'Google בעלי מקצוע'. |
manual_cpc |
שיטת בידינג רגילה לפי עלות ידנית לקליק. בידינג ידני מבוסס-קליקים שבו המשתמש משלם לכל קליק. |
manual_cpm |
שיטת בידינג רגילה לפי עלות לאלף חשיפות (CPM) בשיטה ידנית. בידינג ידני מבוסס-חשיפות שבו המשתמש משלם על כל אלף חשיפות. |
maximize_conversions |
שיטת בידינג רגילה לפי מקסימום המרות שמגדילה באופן אוטומטי את מספר ההמרות תוך ניצול התקציב. |
maximize_conversion_value |
אסטרטגיית בידינג רגילה לפי 'מקסימום ערך המרות' שמגדירה הצעות מחיר באופן אוטומטי כדי למקסם את ההכנסות תוך ניצול התקציב. |
target_cpa |
שיטת בידינג רגילה לפי יעד עלות להמרה (CPA) שמגדירה הצעות מחיר באופן אוטומטי כדי לעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם. |
target_impression_share |
שיטת בידינג לפי יעד נתח חשיפות. שיטת בידינג אוטומטית שמגדירה הצעות מחיר כדי להשיג אחוז מסוים של חשיפות. |
target_roas |
שיטת בידינג רגילה לפי יעד החזר על הוצאות פרסום (ROAS) שממקסמת באופן אוטומטי את ההכנסות תוך שמירה על החזר ממוצע על הוצאות פרסום (ROAS) ספציפי. |
target_spend |
שיטת בידינג רגילה לפי יעד הוצאות שמגדירה את הצעות המחיר באופן אוטומטי כדי לעזור לכם לקבל כמה שיותר קליקים במסגרת התקציב. |
percent_cpc |
שיטת בידינג רגילה לפי עלות לקליק באחוזים, שבה הצעות המחיר הן חלק מהמחיר המפורסם של מוצר או שירות כלשהו. |
target_cpm |
שיטת בידינג שמבצעת אופטימיזציה אוטומטית של העלות לאלף חשיפות. |
DynamicSearchAdsSetting
ההגדרה לניהול מודעות דינמיות לרשת החיפוש (DSA).
שדות | |
---|---|
domain_name |
חובה. שם הדומיין באינטרנט שההגדרה הזו מייצגת, למשל google.com או www.google.com. |
language_code |
חובה. קוד השפה שמציין את שפת הדומיין, לדוגמה 'iw'. |
use_supplied_urls_only |
האם בקמפיין נעשה שימוש רק בכתובות URL שסופקו על ידי המפרסם. |
GeoTargetTypeSetting
מייצג אוסף של הגדרות שקשורות לטירגוט גיאוגרפי של מודעות.
שדות | |
---|---|
positive_geo_target_type |
ההגדרה שמשמשת לטירגוט גיאוגרפי חיובי בקמפיין הספציפי הזה. |
negative_geo_target_type |
ההגדרה שמשמשת לטירגוט גיאוגרפי שלילי בקמפיין הספציפי הזה. |
NetworkSettings
הגדרות הרשת של הקמפיין.
שדות | |
---|---|
target_google_search |
אם המודעות יוצגו עם תוצאות החיפוש ב-google.com. |
target_search_network |
אם המודעות יוצגו באתרים של שותפים ברשת החיפוש של Google (נדרש שהערך של |
target_content_network |
אם המודעות יוצגו במיקומי מודעות ספציפיים ברשת המדיה של Google. מיקומי המודעות מצוינים באמצעות קריטריון מיקום המודעה. |
target_partner_search_network |
אם המודעות יוצגו ברשת שותפי Google. האפשרות הזו זמינה רק בחלק מחשבונות השותפים של Google. |
OptimizationGoalSetting
הגדרת יעד האופטימיזציה של הקמפיין, שכוללת קבוצה של סוגי יעדי אופטימיזציה.
שדות | |
---|---|
optimization_goal_types[] |
רשימת סוגי יעדי האופטימיזציה. |
SelectiveOptimization
הגדרת אופטימיזציה סלקטיבית בקמפיין הזה, שכוללת קבוצה של פעולות המרה שהמערכת תבצע עליהן אופטימיזציה בקמפיין הזה. התכונה הזו רלוונטית רק לקמפיינים לקידום אפליקציות שמשתמשים ב-MULTI_CHANNEL בתור AdvertisingChannelType וב-APP_CAMPAIGN או ב-APP_CAMPAIGN_FOR_ENGAGEMENT בתור AdvertisingChannelSubType.
שדות | |
---|---|
conversion_actions[] |
קבוצת שמות המשאבים שנבחרו לפעולות ההמרה לצורך אופטימיזציה של הקמפיין הזה. |
ShoppingSetting
ההגדרה של קמפיינים של שופינג. ההגדרה הזו קובעת את היקף המוצרים שאפשר לפרסם בקמפיין ואת האינטראקציה של הקמפיין הזה עם קמפיינים אחרים של שופינג.
שדות | |
---|---|
feed_label |
תווית הפיד של המוצרים שרוצים לכלול בקמפיין. אפשר להגדיר רק אחד מהשדות feed_label או sales_country. אם משתמשים בשדה feed_label במקום בשדה sales_country, אפשר להזין בו קודי מדינות באותו פורמט. לדוגמה: 'XX'. אחרת, יכולה להיות כל מחרוזת שמשמשת לתווית פיד ב-Google Merchant Center. |
use_vehicle_inventory |
האם לטרגט מלאי שטחי פרסום של מודעות למכירת רכב. |
merchant_id |
המזהה של חשבון Merchant Center. השדה הזה נדרש לפעולות יצירה. אי אפשר לשנות את השדה הזה בקמפיינים של שופינג. |
sales_country |
מדינת המכירה של המוצרים שרוצים לכלול בקמפיין. |
campaign_priority |
עדיפות הקמפיין. קמפיינים עם עדיפות גבוהה יותר מבחינה מספרית מקבלים עדיפות על פני קמפיינים עם עדיפות נמוכה יותר. השדה הזה נדרש בקמפיינים של שופינג, והערכים שלו יכולים להיות בין 0 ל-2, כולל. השדה הזה הוא אופציונלי בקמפיינים חכמים לשופינג, אבל אם מגדירים אותו, הוא חייב להיות שווה ל-3. |
enable_local |
האם לכלול מוצרים בחנויות מקומיות. |
TrackingSetting
הגדרות ברמת הקמפיין לגבי פרטי המעקב.
שדות | |
---|---|
tracking_url |
כתובת ה-URL שמשמשת למעקב דינמי. |
CampaignAsset
קישור בין קמפיין לנכס.
שדות | |
---|---|
resource_name |
שם המשאב של נכס הקמפיין. שמות המשאבים מסוג CampaignAsset הם בפורמט:
|
status |
הסטטוס של נכס הקמפיין. |
campaign |
הקמפיין שאליו הנכס מקושר. |
asset |
הנכס שמקושר לקמפיין. |
CampaignAssetSet
CampaignAssetSet הוא הקישור בין קמפיין לקבוצת נכסים. הוספת CampaignAssetSet מקשרת קבוצת נכסים לקמפיין.
שדות | |
---|---|
resource_name |
שם המשאב של קבוצת הנכסים של הקמפיין. שמות המשאבים של נכסי קבוצת הנכסים הם בפורמט:
|
campaign |
הקמפיין שאליו מקושר קבוצת הנכסים הזו. |
asset_set |
קבוצת הנכסים שמקושרת לקמפיין. |
status |
הסטטוס של הנכס בקבוצת הנכסים של הקמפיין. קריאה בלבד. |
CampaignAudienceView
תצוגה של קהל בקמפיין. הדוח כולל נתוני ביצועים מתחומי עניין ורשימות רימרקטינג של מודעות ברשת המדיה וב-YouTube Network, ורשימות רימרקטינג של מודעות לרשת החיפוש (RLSA), שמצטברים לפי קמפיין וקריטריון קהל. התצוגה הזו כוללת רק קהלים שצורפו ברמת הקמפיין.
שדות | |
---|---|
resource_name |
שם המשאב של תצוגת הקהל בקמפיין. שמות המשאבים של תצוגת הקהל בקמפיין הם בפורמט:
|
CampaignBudget
תקציב קמפיין.
שדות | |
---|---|
resource_name |
שם המשאב של תקציב הקמפיין. שמות המשאבים של תקציב הקמפיין הם בפורמט:
|
delivery_method |
שיטת ההצגה שקובעת את הקצב שבו התקציב של הקמפיין מנוצל. אם לא צוין ערך בפעולה ליצירה, ערך ברירת המחדל הוא STANDARD. |
period |
התקופה שבמהלכה התקציב ינוצל. אם לא צוין ערך, ערך ברירת המחדל הוא DAILY. |
amount_micros |
סכום התקציב במטבע המקומי של החשבון. הסכום מצוין במיליוניות, כאשר מיליון שווה ליחידת מטבע אחת. התקרה של ההוצאה החודשית היא פי 30.4 מסכום זה. |
CampaignCriterion
קריטריון קמפיין.
שדות | |
---|---|
resource_name |
שם המשאב של קריטריון הקמפיין. שמות המשאבים של קריטריונים בקמפיינים הם בפורמט:
|
display_name |
שם התצוגה של הקריטריון. המערכת מתעלמת מהשדה הזה בפעולות שינוי (mutate). |
type |
סוג הקריטריון. |
status |
הסטטוס של הקריטריון. |
last_modified_time |
תאריך ושעה של השינוי האחרון של קריטריון הקמפיין הזה. תאריך ושעה לפי אזור הזמן של הלקוח, בפורמט 'yyyy-MM-dd HH:mm:ss.ssssss'. |
criterion_id |
המזהה של הקריטריון. המערכת מתעלמת מהשדה הזה במהלך הטרנספורמציה. |
bid_modifier |
המכפיל של הצעות המחיר כשהקריטריון תואם. הערך של המשתנה המשנה צריך להיות בטווח: 0.1 עד 10.0. רוב סוגי הקריטריונים לטירגוט תומכים בשימוש בגורמים משנים. כדי לבטל את ההסכמה לשימוש בסוג מכשיר מסוים, מזינים 0. |
negative |
אם לטרגט ( |
שדה האיחוד צריך להגדיר רק ערך אחד. הערך של |
|
keyword |
מילת מפתח. |
location |
מיקום. |
device |
מכשיר. |
age_range |
טווח הגילאים. |
gender |
מגדר. |
user_list |
רשימת משתמשים. |
language |
שפה. |
webpage |
דף אינטרנט. |
location_group |
קבוצת מיקומים |
CampaignEffectiveLabel
מייצג קשר בין קמפיין לבין תווית יעילה. תווית יעילה היא תווית שעברה בירושה או הוקצתה ישירות לקמפיין הזה.
שדות | |
---|---|
resource_name |
שם המשאב. שמות המשאבים של CampaignEffectivelabel הם בפורמט: |
campaign |
הקמפיין שאליו מצורפת התווית היעילה. |
label |
התווית בפועל שהוקצה לקמפיין. |
owner_customer_id |
המזהה של הלקוח שבבעלותו התווית היעילה. |
CampaignLabel
מייצג קשר בין קמפיין לבין תווית.
שדות | |
---|---|
resource_name |
שם המשאב. שמות המשאבים של תוויות הקמפיינים הם בפורמט: |
campaign |
הקמפיין שאליו מצורפת התווית. |
label |
התווית שהוקצה לקמפיין. |
owner_customer_id |
המזהה של הלקוח שבבעלותו התווית. |
CartDataSalesView
תצוגת המכירות של נתוני עגלות הקניות.
שדות | |
---|---|
resource_name |
שם המשאב של תצוגת המכירות של נתוני עגלות הקניות. שמות המשאבים בתצוגת המכירות של נתוני עגלות הקניות הם בפורמט: |
המרה
המרה.
שדות | |
---|---|
resource_name |
שם המשאב של ההמרה. שמות המשאבים של ההמרות מופיעים בתבנית:
|
id |
המזהה של ההמרה |
criterion_id |
מזהה הקריטריון ב-Search Ads 360. ערך של 0 מציין שהקריטריון לא משויך. |
merchant_id |
המזהה של חשבון המלאי ב-Search Ads 360 שמכיל את המוצר שלחצו עליו. המערכת של Search Ads 360 יוצרת את המזהה הזה כשמקשרים חשבון מלאי שטחי פרסום ב-Search Ads 360. |
ad_id |
מזהה המודעה. ערך של 0 מציין שהמודעה לא משויכת. |
click_id |
מחרוזת ייחודית של הביקור שאליו משויכת ההמרה, שמועברת לדף הנחיתה כפרמטר של כתובת ה-URL של מספר הקליק. |
visit_id |
מזהה הביקור ב-Search Ads 360 שאליו משויכת ההמרה. |
advertiser_conversion_id |
בהמרות אופליין, זהו מזהה שמסופק על ידי המפרסמים. אם המפרסם לא מציין מזהה כזה, מערכת Search Ads 360 יוצרת מזהה כזה. בהמרות אונליין, השדה הזה שווה לעמודה id או לעמודה floodlight_order_id, בהתאם להוראות של המפרסם ב-Floodlight. |
product_id |
המזהה של המוצר שעליו לחץ המשתמש. |
product_channel |
ערוץ המכירות של המוצר שלחצו עליו: אונליין או מקומי. |
product_language_code |
השפה (ISO-639-1) שהוגדרה בפיד Merchant Center שמכיל נתונים על המוצר. |
product_store_id |
החנות שמוצגת במודעת המלאי של החנות המקומית שעליה בוצע הקליק. הערך הזה צריך להתאים למזהי החנויות שמשמשים בפיד המוצרים של החנויות המקומיות. |
product_country_code |
המדינה (בפורמט ISO-3166) שרשומה בפיד המלאי שמכיל את המוצר שעליו לחץ המשתמש. |
attribution_type |
הגורם שאליו משויכת ההמרה: ביקור או מילת מפתח + מודעה. |
conversion_date_time |
חותמת הזמן של אירוע ההמרה. |
conversion_last_modified_date_time |
חותמת הזמן של הפעם האחרונה שבה ההמרה שונתה. |
conversion_visit_date_time |
חותמת הזמן של הביקור שאליו משויכת ההמרה. |
conversion_quantity |
כמות הפריטים שתועדה בהמרה, כפי שנקבע על ידי הפרמטר qty בכתובת ה-URL. המפרסם אחראי לאכלוס דינמי של הפרמטר (למשל, מספר הפריטים שנמכרו בהמרה). אחרת, הערך שמוגדר כברירת מחדל הוא 1. |
conversion_revenue_micros |
ההכנסה המותאמת במיליוני פסיק לאירוע ההמרה. הערך הזה תמיד יהיה במטבע של החשבון להצגת המודעות. |
floodlight_original_revenue |
ההכנסה המקורית ללא שינוי שמשויכת לאירוע ב-Floodlight (במטבע של הדוח הנוכחי), לפני השינויים בהוראות המטבע ב-Floodlight. |
floodlight_order_id |
מזהה ההזמנה ב-Floodlight שסיפק המפרסם עבור ההמרה. |
status |
הסטטוס של ההמרה: 'מופעל' או 'הוסר'. |
asset_id |
המזהה של הנכס שבו הייתה אינטראקציה במהלך אירוע ההמרה. |
asset_field_type |
סוג השדה של הנכס באירוע ההמרה. |
ConversionAction
פעולת המרה.
שדות | |
---|---|
resource_name |
שם המשאב של פעולת ההמרה. שמות המשאבים של פעולות ההמרה מופיעים בתבנית:
|
creation_time |
חותמת הזמן של יצירת הפעילות ב-Floodlight, בפורמט ISO 8601. |
status |
הסטטוס של פעולת ההמרה הזו לצורך צבירת אירועי המרה. |
type |
הסוג של פעולת ההמרה הזו. |
category |
הקטגוריה של ההמרות שדוּוחו לגבי פעולת ההמרה הזו. |
value_settings |
הגדרות שקשורות לערך של אירועי ההמרה המשויכים לפעולת ההמרה הזו. |
attribution_model_settings |
הגדרות שקשורות למודל השיוך של פעולת ההמרה הזו. |
floodlight_settings |
הגדרות Floodlight לסוגי המרות ב-Floodlight. |
id |
המזהה של פעולת ההמרה. |
name |
השם של פעולת ההמרה. השדה הזה הוא חובה, ואסור להשאיר אותו ריק כשיוצרים פעולות המרה חדשות. |
primary_for_goal |
אם הבייט primary_for_goal של פעולת המרה מסוימת הוא false, לא ניתן להגיש עליה הצעות מחיר בכל הקמפיינים, ללא קשר ליעד ההמרה של הלקוח או ליעד ההמרה של הקמפיין. עם זאת, יעדים מותאמים אישית של המרות לא מתייחסים לערך של primary_for_goal, כך שאם בקמפיין מוגדר יעד המרה מותאם אישית עם פעולת המרה שהערך שלה בשדה primary_for_goal הוא false, עדיין אפשר להגיש עליה הצעות מחיר. כברירת מחדל, אם לא תגדירו את הפרמטר primary_for_goal, הערך שלו יהיה true. בגרסה 9, אפשר להגדיר את primary_for_goal כ-false רק אחרי היצירה באמצעות פעולת 'update', כי הוא לא מוגדר כאופציונלי. |
owner_customer |
שם המשאב של הלקוח הבעלים של פעולת ההמרה, או null אם מדובר בפעולת המרה שהוגדרה על ידי המערכת. |
include_in_client_account_conversions_metric |
האם פעולת ההמרה הזו צריכה להיכלל במדד 'client_account_conversions'. |
include_in_conversions_metric |
האם פעולת ההמרה הזו צריכה להיכלל במדד 'המרות'. |
click_through_lookback_window_days |
המספר המקסימלי של ימים שיכולים לחלוף בין אינטראקציה (למשל, קליק) לבין אירוע המרה. |
app_id |
מזהה האפליקציה של פעולת המרה באפליקציה. |
AttributionModelSettings
הגדרות שקשורות למודל השיוך של פעולת ההמרה הזו.
שדות | |
---|---|
attribution_model |
סוג מודל השיוך של פעולת ההמרה הזו. |
data_driven_model_status |
הסטטוס של מודל השיוך מבוסס-הנתונים לפעולת ההמרה. |
FloodlightSettings
הגדרות שקשורות לפעולת המרה ב-Floodlight.
שדות | |
---|---|
activity_group_tag |
מחרוזת שמשמשת לזיהוי קבוצת פעילות ב-Floodlight בדיווח על המרות. |
activity_tag |
מחרוזת שמשמשת לזיהוי פעילות ב-Floodlight בדיווח על המרות. |
activity_id |
המזהה של הפעילות ב-Floodlight ב-DoubleClick Campaign Manager (DCM). |
ValueSettings
הגדרות שקשורות לערך של אירועי ההמרה המשויכים לפעולת ההמרה הזו.
שדות | |
---|---|
default_value |
הערך שבו המערכת תשתמש כשאירועי המרה של פעולת ההמרה הזו יישלחו עם ערך לא חוקי, לא מורשה או חסר, או כשפעולת ההמרה הזו מוגדרת תמיד להשתמש בערך ברירת המחדל. |
default_currency_code |
קוד המטבע שישמש כשאירועי ההמרה של פעולת ההמרה הזו נשלחים עם קוד מטבע לא חוקי או חסר, או כשפעולת ההמרה הזו מוגדרת תמיד להשתמש בערך ברירת המחדל. |
always_use_default_value |
קובע אם המערכת תשתמש בערך ברירת המחדל ובקוד המטבע שמוגדר כברירת מחדל במקום בערך ובקוד המטבע שצוינו באירועי ההמרה של פעולת ההמרה הזו. |
ConversionCustomVariable
משתנה המרה מותאם אישית. מידע נוסף זמין במאמר 'מידע על מדדים ומאפיינים של Floodlight בממשק החדש של Search Ads 360' בכתובת https://support.google.com/sa360/answer/13567857
שדות | |
---|---|
resource_name |
שם המשאב של המשתנה המותאם אישית של ההמרה. השמות של משאבי המשתנים המותאמים אישית של ההמרות הם בפורמט:
|
id |
המזהה של משתנה ההמרה המותאם אישית. |
name |
חובה. השם של המשתנה המותאם אישית של ההמרה. השם צריך להיות ייחודי. האורך המקסימלי של השם הוא 100 תווים. אסור להוסיף רווחים מיותרים בתחילתו של השם ובסופו. |
tag |
חובה. התג של המשתנה המותאם אישית של ההמרה. התג צריך להיות ייחודי ולהיפתח בתו u ולאחריו מספר שקטן מ-100 או שווה לו. לדוגמה: 'u4'. |
status |
הסטטוס של המשתנה המותאם אישית של ההמרה לצורך צבירת אירועי המרה. |
owner_customer |
שם המשאב של הלקוח שבבעלותו המשתנה המותאם אישית של ההמרה. |
family |
המשפחה של משתנה ההמרה המותאם אישית. |
cardinality |
העוצמה של משתנה ההמרה המותאם אישית. |
floodlight_conversion_custom_variable_info |
שדות למשתנים מותאמים אישית של המרות ב-Floodlight ב-Search Ads 360. |
custom_column_ids[] |
המזהים של עמודות בהתאמה אישית שמשתמשות במשתנה המותאם אישית הזה של ההמרה. |
FloodlightConversionCustomVariableInfo
מידע על משתנים מותאמים אישית של המרות ב-Floodlight ב-Search Ads 360.
שדות | |
---|---|
floodlight_variable_type |
סוג המשתנה ב-Floodlight שמוגדר ב-Search Ads 360. |
floodlight_variable_data_type |
סוג הנתונים של משתנה Floodlight שהוגדר ב-Search Ads 360. |
ConversionTrackingSetting
אוסף של הגדרות ברמת הלקוח שקשורות למעקב ההמרות ב-Search Ads 360.
שדות | |
---|---|
accepted_customer_data_terms |
אם הלקוח אישר את התנאים בנוגע לנתונים של לקוחות. אם משתמשים במעקב המרות ברמת חשבון ניהול, הערך הזה עובר בירושה מהחשבון הניהול. השדה הזה הוא לקריאה בלבד. מידע נוסף זמין בכתובת https://support.google.com/adspolicy/answer/7475709. |
conversion_tracking_status |
סטטוס מעקב ההמרות. הוא מציין אם הלקוח משתמש במעקב המרות, ומי הבעלים של מעקב ההמרות של הלקוח הזה. אם הלקוח הזה משתמש במעקב המרות ברמת חשבון ניהול, הערך המוחזר ישתנה בהתאם ל- |
enhanced_conversions_for_leads_enabled |
אם הלקוח הביע הסכמה לשימוש בתכונה 'המרות משופרות לצורך שיוך ללידים'. אם משתמשים במעקב המרות ברמת חשבון ניהול, הערך הזה עובר בירושה מהחשבון הניהול. השדה הזה הוא לקריאה בלבד. |
google_ads_conversion_customer |
שם המשאב של הלקוח שבו נוצרות ומנוהלות ההמרות. השדה הזה הוא לקריאה בלבד. |
conversion_tracking_id |
מזהה מעקב ההמרות שמשמש את החשבון הזה. המזהה הזה לא מציין אם הלקוח משתמש במעקב המרות (המזהה conversion_tracking_status מציין זאת). השדה הזה הוא לקריאה בלבד. |
google_ads_cross_account_conversion_tracking_id |
מזהה מעקב ההמרות של חשבון הניהול של הלקוח. השדה הזה מוגדר כשהלקוח מאשר את מעקב ההמרות, והוא מבטל את ההגדרה של conversion_tracking_id. אפשר לנהל את השדה הזה רק דרך ממשק המשתמש של Google Ads. השדה הזה הוא לקריאה בלבד. |
cross_account_conversion_tracking_id |
מזהה מעקב ההמרות של חשבון הניהול של הלקוח. השדה הזה מוגדר כשהלקוח הביע הסכמה למעקב המרות ברמת חשבון ניהול, והוא מבטל את ההגדרה של conversion_tracking_id. |
CustomColumn
עמודה בהתאמה אישית. מידע נוסף על עמודות בהתאמה אישית ב-Search Ads 360 זמין בכתובת https://support.google.com/sa360/answer/9633916
שדות | |
---|---|
resource_name |
שם המשאב של העמודה בהתאמה אישית. שמות המשאבים של עמודות בהתאמה אישית הם בפורמט:
|
id |
המזהה של העמודה בהתאמה אישית. |
name |
שם שהמשתמש נתן לעמודה בהתאמה אישית. |
description |
תיאור של העמודה בהתאמה אישית שהוגדר על ידי המשתמש. |
value_type |
הסוג של ערך התוצאה של העמודה בהתאמה אישית. |
references_attributes |
הערך True מופיע כאשר העמודה בהתאמה אישית מפנה למאפיין אחד או יותר. |
references_metrics |
הערך True מופיע כאשר העמודה בהתאמה אישית מפנה למדד אחד או יותר. |
queryable |
הערך True מופיע כאשר העמודה בהתאמה אישית זמינה לשימוש בשאילתה של SearchAds360Service.Search ושל SearchAds360Service.SearchStream. |
referenced_system_columns[] |
רשימת עמודות המערכת שאלהן מופנית העמודה בהתאמה אישית הזו. לדוגמה, עמודה בהתאמה אישית בשם 'סכום החשיפות והקליקים' הפנתה לעמודות המערכת {"metrics.clicks", "metrics.impressions"}. |
render_type |
איך צריך לפרש את ערך התוצאה של העמודה בהתאמה אישית. |
לקוח
לקוח/ה.
שדות | |
---|---|
resource_name |
שם המשאב של הלקוח. שמות המשאבים של הלקוחות מופיעים בתבנית:
|
conversion_tracking_setting |
הגדרת מעקב המרות ללקוח. |
account_type |
סוג חשבון מנוע החיפוש, לדוגמה, Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track וכו'. |
double_click_campaign_manager_setting |
הגדרה ב-DoubleClick Campaign Manager (DCM) ללקוח ניהול. |
account_status |
סטטוס החשבון, למשל: מופעל, מושהה, הוסר וכו'. |
last_modified_time |
חותמת הזמן של מועד השינוי האחרון של הלקוח. תאריך ושעה לפי אזור הזמן של הלקוח, בפורמט 'yyyy-MM-dd HH:mm:ss.ssssss'. |
engine_id |
המזהה של החשבון בחשבון של מנוע החיפוש החיצוני. |
status |
הסטטוס של הלקוח. |
creation_time |
חותמת הזמן שבה הלקוח הזה נוצר. חותמת הזמן היא לפי אזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'. |
manager_id |
מספר הלקוח של חשבון הניהול. ערך 0 מציין שללקוח אין חשבון ניהול ב-SA360. |
manager_descriptive_name |
השם התיאורי של המנהל. |
sub_manager_id |
מספר הלקוח של חשבון הניהול המשני. ערך 0 מציין שללקוח אין חשבון ניהול משני ב-SA360. |
sub_manager_descriptive_name |
השם התיאורי של חשבון הניהול המשני. |
associate_manager_id |
מספר הלקוח של חשבון הניהול המשני. ערך 0 מציין שללקוח אין מנהל שותף ב-SA360. |
associate_manager_descriptive_name |
השם התיאורי של מנהל השותף. |
account_level |
רמת החשבון של הלקוח: חשבון ניהול, חשבון ניהול משני, חשבון ניהול משני לשותפים, חשבון שירות. |
id |
המזהה של הלקוח. |
descriptive_name |
שם תיאורי אופציונלי ולא ייחודי של הלקוח. |
currency_code |
המטבע שבו פועל החשבון. יש תמיכה בקבוצת משנה של קודי המטבעות מהתקן ISO 4217. |
time_zone |
מזהה אזור הזמן המקומי של הלקוח. |
tracking_url_template |
תבנית כתובת ה-URL ליצירת כתובת URL למעקב מפרמטרים. |
final_url_suffix |
תבנית כתובת ה-URL להוספת פרמטרים לכתובת ה-URL הסופית. |
auto_tagging_enabled |
האם התיוג האוטומטי מופעל אצל הלקוח. |
manager |
האם הלקוח הוא מנהל. |
CustomerAsset
קישור בין לקוח לנכס.
שדות | |
---|---|
resource_name |
שם המשאב של נכס הלקוח. שמות המשאבים מסוג CustomerAsset הם בפורמט:
|
asset |
חובה. הנכס שמקושר ללקוח. |
status |
הסטטוס של הנכס הדיגיטלי של הלקוח. |
CustomerAssetSet
CustomerAssetSet הוא הקישור בין לקוח לבין קבוצת נכסים. הוספת CustomerAssetSet מקשרת קבוצת נכסים ללקוח.
שדות | |
---|---|
resource_name |
שם המשאב של קבוצת הנכסים של הלקוח. שמות המשאבים של נכסי קבוצת הנכסים הם בפורמט:
|
asset_set |
קבוצת הנכסים שמקושרת ללקוח. |
customer |
הלקוח שאליו מקושר קבוצת הנכסים הזו. |
status |
הסטטוס של הנכס בקבוצת הנכסים הדיגיטליים של הלקוח. קריאה בלבד. |
CustomerClient
קישור בין הלקוח הנתון ללקוח של לקוח. הרשאות CustomerClients קיימות רק ללקוחות ניהול. כל הלקוחות הישירים והעקיפים של הלקוח נכללים, וגם חשבון הניהול עצמו.
שדות | |
---|---|
resource_name |
שם המשאב של לקוח הלקוח. שמות המשאבים של CustomerClient הם בפורמט: |
applied_labels[] |
שמות המשאבים של התוויות שבבעלות הלקוח המבקש שחלות על חשבון הלקוח. שמות המשאבים של התוויות הם בפורמט:
|
status |
הסטטוס של לקוח הלקוח. קריאה בלבד. |
client_customer |
שם המשאב של לקוח הלקוח שמקושר ללקוח הנתון. קריאה בלבד. |
level |
המרחק בין הלקוח ללקוח נתון. בקישור עצמי, ערך הרמה יהיה 0. קריאה בלבד. |
time_zone |
ייצוג מחרוזת של מאגר נתוני האזור (CLDR) של אזור הזמן של הלקוח, לדוגמה: America/Los_Angeles. קריאה בלבד. |
test_account |
מזהה אם הלקוח הוא חשבון בדיקה. קריאה בלבד. |
manager |
מזהה אם הלקוח הוא חשבון ניהול. קריאה בלבד. |
descriptive_name |
שם תיאורי של הלקוח. קריאה בלבד. |
currency_code |
קוד המטבע (לדוגמה, 'USD', 'EUR') של הלקוח. קריאה בלבד. |
id |
המזהה של לקוח הלקוח. קריאה בלבד. |
CustomerManagerLink
מייצג את הקשר בין הלקוח לחשבון הניהול.
שדות | |
---|---|
resource_name |
שם המשאב. שמות המשאבים של CustomerManagerLink הם בפורמט: |
status |
סטטוס הקישור בין הלקוח לחשבון הניהול. |
manager_customer |
חשבון הניהול שמקושר ללקוח. |
manager_link_id |
המזהה של הקישור בין הלקוח לחשבון הניהול. השדה הזה הוא לקריאה בלבד. |
start_time |
חותמת הזמן שבה CustomerManagerLink נוצר. חותמת הזמן היא לפי אזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'. |
DoubleClickCampaignManagerSetting
הגדרה ב-DoubleClick Campaign Manager (DCM) ללקוח ניהול.
שדות | |
---|---|
advertiser_id |
המזהה של המפרסם ב-Campaign Manager שמשויך ללקוח הזה. |
network_id |
המזהה של הרשת ב-Campaign Manager שמשויכת ללקוח הזה. |
time_zone |
אזור הזמן של הרשת ב-Campaign Manager שמשויכת ללקוח הזה, בפורמט של מסד נתוני אזורי הזמן של IANA, למשל America/New_York. |
DynamicSearchAdsSearchTermView
תצוגה של מונחי חיפוש של מודעות דינמיות לרשת החיפוש.
שדות | |
---|---|
resource_name |
שם המשאב של תצוגת מונחי החיפוש של המודעות הדינמיות לרשת החיפוש. שמות המשאבים בתצוגת מונח החיפוש של מודעות דינמיות לרשת החיפוש הם בפורמט הבא:
|
landing_page |
כתובת דף הנחיתה שנבחרה באופן דינמי של החשיפת המודעות. השדה הזה הוא לקריאה בלבד. |
GenderView
תצוגה לפי מגדר. המשאב gender_view משקף את סטטוס ההצגה בפועל, ולא את הקריטריונים שנוספו. קבוצת מודעות ללא קריטריונים למגדר מוצגת כברירת מחדל לכל המגדרים, ולכן כל המגדרים מופיעים ב-gender_view עם נתונים סטטיסטיים.
שדות | |
---|---|
resource_name |
שם המשאב של תצוגת המגדר. שמות המשאבים בתצוגת המגדר הם בפורמט:
|
GeoTargetConstant
קבוע של יעד גיאוגרפי.
שדות | |
---|---|
resource_name |
שם המשאב של קבוע היעד הגיאוגרפי. שמות המשאבים של קבועי הטירגוט הגיאוגרפי הם בפורמט:
|
status |
הסטטוס של קבוע הטירגוט הגיאוגרפי. |
id |
המזהה של קבוע הטירגוט הגיאוגרפי. |
name |
השם באנגלית של קבוע הטירגוט הגיאוגרפי. |
country_code |
קוד המדינה בתקן ISO-3166-1 alpha-2 שמשויך ליעד. |
target_type |
סוג היעד של טירגוט גיאוגרפי קבוע. |
canonical_name |
השם האנגלי המלא, שכולל את שם היעד ואת שם ההורה והמדינה שלו. |
parent_geo_target |
שם המשאב של קבוע היעד הגיאוגרפי ברמת ההורה. שמות המשאבים של קבועי הטירגוט הגיאוגרפי הם בפורמט:
|
KeywordView
תצוגת מילות מפתח.
שדות | |
---|---|
resource_name |
שם המשאב של תצוגת מילות המפתח. שמות המשאבים בתצוגת מילות המפתח מופיעים בפורמט:
|
תווית
תווית.
שדות | |
---|---|
resource_name |
שם המשאב. שמות המשאבים של התוויות מופיעים בפורמט: |
status |
הסטטוס של התווית. קריאה בלבד. |
text_label |
סוג של תווית שמוצג בה טקסט על רקע צבעוני. |
id |
המזהה של התווית. קריאה בלבד. |
name |
השם של התווית. השדה הזה חובה, ואסור שהוא יהיה ריק כשיוצרים תווית חדשה. אורך המחרוזת צריך להיות בין 1 ל-80 תווים, כולל. |
LanguageConstant
שפה.
שדות | |
---|---|
resource_name |
שם המשאב של קבוע השפה. שמות המשאבים של קבועי השפה הם בפורמט:
|
id |
המזהה של קבוע השפה. |
code |
קוד השפה, למשל 'en_US', 'en_AU', 'es', 'fr' וכו'. |
name |
השם המלא של השפה באנגלית, למשל, 'English (US)', 'Spanish' וכו'. |
targetable |
אם אפשר לטרגט את השפה. |
ListingGroupFilterDimension
מאפייני כרטיסי מוצר במסנן קבוצות של כרטיסי מוצר בנכסים דיגיטליים.
שדות | |
---|---|
שדה האיחוד dimension . תמיד מופיע מימד מאחד מהסוגים הבאים. הערך של dimension יכול להיות רק אחת מהאפשרויות הבאות: |
|
product_bidding_category |
קטגוריית הבידינג של מוצר. |
product_brand |
המותג של מוצר. |
product_channel |
המיקום של מוצר. |
product_condition |
מצב של מבצע על מוצר. |
product_custom_attribute |
מאפיין מותאם אישית של מוצר. |
product_item_id |
מזהה הפריט של מבצע על מוצר. |
product_type |
סוג המבצע על המוצר. |
ProductBiddingCategory
רכיב אחד של קטגוריית בידינג ברמה מסוימת. קטגוריות ברמה העליונה נמצאות ברמה 1, הקטגוריות המשניות שלהן נמצאות ברמה 2 וכן הלאה. בשלב זה אנחנו תומכים ב-5 רמות לכל היותר. המשתמש צריך לציין את סוג המאפיין שמציין את רמת הקטגוריה. לכל המקרים באותה חלוקה משנית צריך להיות אותו סוג מאפיין (ברמת הקטגוריה).
שדות | |
---|---|
level |
רמת הקטגוריה בטקסונומיה. |
id |
המזהה של קטגוריית הבידינג של המוצר. המזהה הזה זהה למזהה google_product_category כפי שמתואר במאמר הזה: https://support.google.com/merchants/answer/6324436 |
ProductBrand
המותג של המוצר.
שדות | |
---|---|
value |
ערך המחרוזת של מותג המוצר. |
ProductChannel
המיקום של מוצר.
שדות | |
---|---|
channel |
הערך של מקום האירוע. |
ProductCondition
מצב של מבצע על מוצר.
שדות | |
---|---|
condition |
הערך של התנאי. |
ProductCustomAttribute
מאפיין מותאם אישית של מוצר.
שדות | |
---|---|
index |
האינדקס של המאפיין המותאם אישית. |
value |
ערך המחרוזת של המאפיין המותאם אישית של המוצר. |
ProductItemId
מזהה הפריט של מבצע על מוצר.
שדות | |
---|---|
value |
הערך של המזהה. |
ProductType
סוג המבצע על המוצר.
שדות | |
---|---|
level |
רמת הסוג. |
value |
הערך של הסוג. |
ListingGroupFilterDimensionPath
הנתיב להגדרת המאפיינים שמגדירים מסנן של קבוצת כרטיסי מוצר.
שדות | |
---|---|
dimensions[] |
הנתיב המלא של המאפיינים דרך היררכיית המסננים של קבוצות כרטיסי המוצר (לא כולל צומת הבסיס) אל מסנן קבוצות כרטיסי המוצר הזה. |
LocationView
בתצוגה לפי מיקום מוצג סיכום של ביצועי הקמפיינים לפי קריטריון מיקום.
שדות | |
---|---|
resource_name |
שם המשאב של תצוגת המיקום. שמות המשאבים בתצוגת המיקום מופיעים בפורמט:
|
ProductBiddingCategoryConstant
קטגוריית בידינג של מוצרים.
שדות | |
---|---|
resource_name |
שם המשאב של קטגוריית הבידינג של המוצר. שמות המשאבים של קטגוריות בידינג למוצרים הם בפורמט:
|
level |
הרמה של קטגוריית הבידינג של המוצר. |
status |
הסטטוס של קטגוריית הבידינג של המוצר. |
id |
המזהה של קטגוריית הבידינג של המוצר. המזהה הזה זהה למזהה google_product_category כפי שמתואר במאמר הזה: https://support.google.com/merchants/answer/6324436. |
country_code |
קוד מדינה בן שתי אותיות באותיות רישיות של קטגוריית הבידינג של המוצר. |
product_bidding_category_constant_parent |
שם המשאב של קטגוריית הבידינג של המוצר הראשי. |
language_code |
קוד השפה של קטגוריית הבידינג של המוצר. |
localized_name |
ערך התצוגה של קטגוריית הבידינג של המוצר, שמותאם לשפה לפי language_code. |
ProductGroupView
תצוגה של קבוצת מוצרים.
שדות | |
---|---|
resource_name |
שם המשאב של תצוגת קבוצת המוצרים. שמות המשאבים בתצוגת קבוצת המוצרים הם בפורמט:
|
SearchAds360Field
שדה או משאב (אובייקט) ש-SearchAds360Service משתמש בהם.
שדות | |
---|---|
resource_name |
שם המשאב של הארטיפקט. שמות המשאבים של הארטיפקטים הם בפורמט:
|
category |
הקטגוריה של הארטיפקט. |
selectable_with[] |
השמות של כל המשאבים, הפלחים והמדדים שאפשר לבחור באמצעות הארטיפקט המתואר. |
attribute_resources[] |
השמות של כל המשאבים שאפשר לבחור באמצעות הארטיפקט המתואר. שדות מהמשאבים האלה לא מאפשרים לפלח מדדים כשהם נכללים בשאילתות חיפוש. השדה הזה מוגדר רק לארטיפקטים שהקטגוריה שלהם היא RESOURCE. |
metrics[] |
בשדה הזה מפורטים השמות של כל המדדים שאפשר לבחור באמצעות הארטיפקט המתואר כשמשתמשים בו בתנאי FROM. הוא מוגדר רק לארטיפקטים שהקטגוריה שלהם היא RESOURCE. |
segments[] |
בשדה הזה מפורטים השמות של כל הארטיפקטים, בין אם מדובר בפלח או במשאב אחר, שמפרטים מדדים כשהם כלולים בשאילתות חיפוש וכשהארטיפקט המתואר משמש בתנאי FROM. הוא מוגדר רק לארטיפקטים שהקטגוריה שלהם היא RESOURCE. |
enum_values[] |
הערכים שהאובייקט יכול לקבל אם הוא שדה מסוג ENUM. השדה הזה מוגדר רק לארטיפקטים בקטגוריה SEGMENT או ATTRIBUTE. |
data_type |
השדה הזה קובע אילו אופרטורים אפשר להשתמש בהם עם הארטיפקט בתנאי WHERE. |
name |
השם של הארטיפקט. |
selectable |
האם אפשר להשתמש באובייקט הארטיפקט בתנאי SELECT בשאילתות חיפוש. |
filterable |
אם אפשר להשתמש באובייקט הארטיפקט בתנאי WHERE בשאילתות חיפוש. |
sortable |
האם אפשר להשתמש באובייקט הארטיפקט בתנאי ORDER BY בשאילתות חיפוש. |
type_url |
כתובת ה-URL של ה-proto שמתאר את סוג הנתונים של הארטיפקט. |
is_repeated |
אם הארטיפקט של השדה חוזר על עצמו. |
ShoppingPerformanceView
תצוגת הביצועים של קמפיינים של שופינג. דוח שמספק נתונים סטטיסטיים של קמפיינים של שופינג שנצברו בכמה רמות של מאפייני מוצרים. ערכי המאפיינים של המוצרים מ-Merchant Center, כמו מותג, קטגוריה, מאפיינים מותאמים אישית, מצב המוצר וסוג המוצר, ישקפו את המצב של כל מאפיין נכון לתאריך ולשעה שבהם האירוע התואם תועד.
שדות | |
---|---|
resource_name |
שם המשאב של תצוגת הביצועים של שופינג. שמות המשאבים בתצוגת הביצועים של קמפיינים של שופינג הם בפורמט: |
UserList
רשימת משתמשים. זוהי רשימה של משתמשים שהלקוח יכול לטרגט.
שדות | |
---|---|
resource_name |
שם המשאב של רשימת המשתמשים. שמות המשאבים של רשימות המשתמשים הם בפורמט:
|
type |
סוג הרשימה. השדה הזה הוא לקריאה בלבד. |
id |
המזהה של רשימת המשתמשים. |
name |
השם של רשימת המשתמשים הזו. בהתאם ל-access_reason, ייתכן ששם רשימת המשתמשים לא יהיה ייחודי (לדוגמה, אם access_reason=SHARED) |
UserLocationView
תצוגה של מיקום המשתמש.
בתצוגה 'מיקום המשתמש' מוצגים כל המדדים המצטברים ברמת המדינה, בשורה אחת לכל מדינה. הדוח כולל דיווח על מדדים במיקום הפיזי בפועל של המשתמש, לפי מיקום גיאוגרפי מטורגט או לא מטורגט. אם נעשה שימוש בשדות אחרים של פלחים, יכול להיות שיופיעו יותר משורה אחת לכל מדינה.
שדות | |
---|---|
resource_name |
שם המשאב של תצוגת המיקום של המשתמש. שמות המשאבים בתצוגה UserLocation הם בפורמט:
|
country_criterion_id |
מזהה הקריטריון של המדינה. |
targeting_location |
מציין אם המיקום היה מטורגט או לא. |
כניסה
ביקור.
שדות | |
---|---|
resource_name |
שם המשאב של הביקור. שמות המשאבים של Visit הם בפורמט:
|
id |
המזהה של הביקור. |
criterion_id |
מזהה מילת המפתח ב-Search Ads 360. ערך של 0 מציין שמילות המפתח לא משויכות. |
merchant_id |
המזהה של חשבון המלאי ב-Search Ads 360 שמכיל את המוצר שלחצו עליו. המערכת של Search Ads 360 יוצרת את המזהה הזה כשמקשרים חשבון מלאי שטחי פרסום ב-Search Ads 360. |
ad_id |
מזהה המודעה. ערך של 0 מציין שהמודעה לא משויכת. |
click_id |
מחרוזת ייחודית לכל ביקור, שמועברת לדף הנחיתה כפרמטר של כתובת ה-URL של מזהה הקליק. |
visit_date_time |
חותמת הזמן של אירוע הביקור. חותמת הזמן היא לפי אזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'. |
product_id |
המזהה של המוצר שעליו לחץ המשתמש. |
product_channel |
ערוץ המכירות של המוצר שלחצו עליו: אונליין או מקומי. |
product_language_code |
השפה (ISO-639-1) שהוגדרה בפיד Merchant Center שמכיל נתונים על המוצר. |
product_store_id |
החנות שמוצגת במודעת המלאי של החנות המקומית שעליה בוצע הקליק. הערך הזה צריך להתאים למזהי החנויות שמשמשים בפיד המוצרים של החנויות המקומיות. |
product_country_code |
המדינה (בפורמט ISO-3166) שרשומה בפיד המלאי שמכיל את המוצר שעליו לחץ המשתמש. |
asset_id |
המזהה של הנכס שבו הייתה אינטראקציה במהלך אירוע הביקור. |
asset_field_type |
סוג השדה של הנכס באירוע הביקור. |
WebpageView
תצוגה של דף אינטרנט.
שדות | |
---|---|
resource_name |
שם המשאב של תצוגת דף האינטרנט. שמות המשאבים של תצוגת דף האינטרנט הם בפורמט:
|