אינדקס
-
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, המשאב הזה כולל אסטרטגיות שנמצאות בבעלות של חשבונות ניהול של הלקוח ומשותפות עם הלקוח הזה, בנוסף לאסטרטגיות שנמצאות בבעלות של הלקוח הזה. המשאב הזה לא מספק מדדים, והוא חושף רק קבוצת משנה מוגבלת של מאפייני BiddingStrategy.
| שדות | |
|---|---|
resource_name |
השם של משאב שיטת הבידינג שאפשר לגשת אליו. שמות המשאבים של AccessibleBiddingStrategy הם מהצורה:
|
id |
המזהה של שיטת הבידינג. |
name |
השם של שיטת הבידינג. |
type |
הסוג של שיטת הבידינג. |
owner_customer_id |
המזהה של הלקוח שבבעלותו אסטרטגיית הבידינג. |
owner_descriptive_name |
descriptive_name של הלקוח שבבעלותו שיטת הבידינג. |
שדה איחוד אפשר להגדיר רק אחד מהם. הערך |
|
maximize_conversion_value |
שיטת בידינג אוטומטית שעוזרת להשיג את ערך ההמרה הגבוה ביותר מהקמפיינים במסגרת התקציב. |
maximize_conversions |
שיטת בידינג אוטומטית שעוזרת לכם להשיג כמה שיותר המרות בקמפיינים במסגרת התקציב שהגדרתם. |
target_cpa |
שיטת בידינג שבה המערכת מגדירה הצעות מחיר במטרה להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם. |
target_impression_share |
שיטת בידינג שמבצעת אופטימיזציה אוטומטית כדי להשיג אחוז מסוים של חשיפות. |
target_roas |
שיטת בידינג שעוזרת לכם למקסם את ההכנסות תוך שמירה על ערך ממוצע של יעד החזר על הוצאות פרסום (ROAS) שהגדרתם. |
target_spend |
שיטת בידינג שמגדירה את הצעות המחיר כדי לעזור לכם לקבל כמה שיותר קליקים במסגרת התקציב. |
MaximizeConversionValue
שיטת בידינג אוטומטית שעוזרת להשיג את ערך ההמרה הגבוה ביותר מהקמפיינים במסגרת התקציב.
| שדות | |
|---|---|
target_roas |
האפשרות 'יעד החזר על הוצאות פרסום'. אם מגדירים יעד החזר על הוצאות פרסום, שיטת הבידינג תמקסם את ההכנסות תוך שמירה על ערך ממוצע של יעד ההחזר על הוצאות הפרסום. אם יעד ההחזר על הוצאות הפרסום גבוה, יכול להיות ששיטת הבידינג לא תוכל לנצל את כל התקציב. אם לא תגדירו יעד החזר על הוצאות פרסום, שיטת הבידינג תנסה להשיג את ההחזר הכי גבוה על הוצאות הפרסום במסגרת התקציב. |
MaximizeConversions
שיטת בידינג אוטומטית שעוזרת לכם להשיג כמה שיותר המרות בקמפיינים במסגרת התקציב שהגדרתם.
| שדות | |
|---|---|
target_cpa |
האפשרות 'יעד עלות להמרה (CPA)'. זהו הסכום הממוצע שאתם רוצים להוציא על כל המרה. |
target_cpa_micros |
האפשרות 'יעד עלות להמרה (CPA)'. זהו הסכום הממוצע שאתם רוצים להוציא על כל המרה. |
TargetCpa
זוהי שיטת בידינג אוטומטית שמגדירה הצעות מחיר כדי לעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם.
| שדות | |
|---|---|
target_cpa_micros |
יעד עלות ממוצעת להמרה. היעד הזה צריך להיות גדול או שווה ליחידה המינימלית לחיוב, בהתאם למטבע של החשבון. |
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 הסופיות האפשריות אחרי כל ההפניות האוטומטיות דרך דומיין אחר של המודעה. |
final_app_urls[] |
רשימה של כתובות URL סופיות של אפליקציות שישמשו בנייד אם האפליקציה הספציפית מותקנת אצל המשתמש. |
final_mobile_urls[] |
רשימת כתובות הדפים הסופיות בנייד האפשריות אחרי כל ההפניות האוטומטיות בין דומיינים עבור המודעה. |
type |
סוג המודעה. |
id |
המזהה של המודעה. |
tracking_url_template |
תבנית כתובת ה-URL ליצירת כתובת URL למעקב. |
final_url_suffix |
הסיומת שבה משתמשים כשיוצרים כתובת URL סופית. |
display_url |
כתובת ה-URL שמופיעה בתיאור המודעה בפורמטים מסוימים של מודעות. |
name |
שם המודעה. הפרמטר הזה משמש רק לזיהוי המודעה. הערך הזה לא צריך להיות ייחודי והוא לא משפיע על המודעה שמוצגת. |
שדה איחוד 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). |
tracking_url_template |
תבנית כתובת ה-URL ליצירת כתובת URL למעקב. |
cpc_bid_micros |
הצעת המחיר המקסימלית לקליק (CPC). |
engine_status |
הסטטוס של קבוצת המודעות במנוע. |
final_url_suffix |
תבנית של כתובת URL להוספת פרמטרים לכתובת URL סופית. |
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 הוא הקישור בין קבוצת מודעות לבין קבוצת נכסים. יצירת AdGroupAssetSet מקשרת בין קבוצת נכסים לבין קבוצת מודעות.
| שדות | |
|---|---|
resource_name |
שם המשאב של קבוצת נכסי קבוצת המודעות. הפורמט של שמות המשאבים של קבוצות נכסים ברמת קבוצת המודעות הוא:
|
ad_group |
קבוצת המודעות שמערכת הנכסים הזו מקושרת אליה. |
asset_set |
קבוצת הנכסים שמקושרת לקבוצת המודעות. |
status |
הסטטוס של קבוצת הנכסים ברמת קבוצת המודעות. קריאה בלבד. |
AdGroupAudienceView
תצוגת קהל ברמת קבוצת המודעות. האפשרות הזו כוללת נתוני ביצועים מקהלים לפי תחומי עניין ומרשימות רימרקטינג עבור מודעות לרשת המדיה ומודעות לרשת YouTube, ומרשימות רימרקטינג עבור מודעות לרשת החיפוש (RLSA), שמצטברים ברמת הקהל.
| שדות | |
|---|---|
resource_name |
השם של משאב התצוגה של קהל ברמת קבוצת המודעות. שמות המשאבים של תצוגת הקהל של קבוצת המודעות הם מהצורה:
|
AdGroupBidModifier
מייצג מגביל של הצעת מחיר לקבוצת מודעות.
| שדות | |
|---|---|
resource_name |
שם המשאב של מגביל הצעת המחיר של קבוצת המודעות. שמות המשאבים של מגבילי הצעות המחיר לקבוצות של מודעות הם מהצורה:
|
bid_modifier |
המשנה של הצעת המחיר כשהקריטריון תואם. המשנה חייב להיות בטווח: 0.1 עד 10.0. הטווח הוא 1.0 עד 6.0 עבור PreferredContent. כדי לבטל את ההסכמה לסוג מכשיר מסוים, משתמשים בערך 0. |
שדה איחוד נדרש בפעולות יצירה החל מגרסה 5. הערך |
|
device |
קריטריון של מכשיר. |
AdGroupCriterion
קריטריון של קבוצת מודעות. בדוח ad_group_criterion מוחזרים רק קריטריונים שנוספו באופן מפורש לקבוצת המודעות.
| שדות | |
|---|---|
resource_name |
שם המשאב של קריטריון קבוצת המודעות. שמות המשאבים של קריטריונים של קבוצות מודעות הם מהצורה:
|
creation_time |
חותמת הזמן שבה נוצר הקריטריון הזה של קבוצת המודעות. חותמת הזמן היא באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss. |
status |
הסטטוס של הקריטריון. הסטטוס של הישות ad group criterion, שהוגדר על ידי הלקוח. הערה: דוחות ממשק המשתמש עשויים לכלול מידע נוסף שמשפיע על הזכאות של קריטריון להפעלה. במקרים מסוימים, קריטריון שהוסר ב-API עדיין יכול להופיע כקריטריון שמופעל בממשק המשתמש. לדוגמה, כברירת מחדל, הקמפיינים מוצגים למשתמשים בכל טווחי הגילאים, אלא אם הם מוחרגים. בממשק המשתמש, כל טווחי הגילאים יופיעו כ'מופעלים', כי הם עומדים בדרישות להצגת המודעות. אבל ב-AdGroupCriterion.status יופיע הערך 'הוסר', כי לא נוסף קריטריון חיובי. |
quality_info |
מידע על איכות הקריטריון. |
type |
סוג הקריטריון. |
labels[] |
שמות המשאבים של התוויות שמצורפות לקריטריון הזה של קבוצת המודעות. |
effective_labels[] |
השמות של המשאבים של התוויות האפקטיביות שמצורפות לקריטריון הזה של קבוצת המודעות. תווית יעילה היא תווית שעברה בירושה או שהוקצתה ישירות לקריטריון הזה של קבוצת המודעות. |
position_estimates |
הערכות לגבי הצעות מחיר לקריטריונים במיקומים שונים. |
final_urls[] |
רשימת כתובות ה-URL הסופיות האפשריות אחרי כל ההפניות האוטומטיות דרך דומיין אחר של המודעה. |
final_mobile_urls[] |
רשימת כתובות ה-URL הסופיות לניידים שאליהן יכולה להוביל ההפניה האוטומטית אחרי כל ההפניות האוטומטיות דרך דומיין אחר. |
url_custom_parameters[] |
רשימת המיפויים שמשמשת להחלפת תגים של פרמטרים מותאמים אישית ב- |
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 |
ההצעה המשוערת לקליק שנדרשת כדי שהמודעה תוצג בראש הדף הראשון של תוצאות החיפוש. |
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 סופיות אפשריות אחרי כל ההפניות האוטומטיות בין דומיינים. |
final_mobile_urls[] |
רשימה של כתובות URL סופיות אפשריות לניידים אחרי כל ההפניות האוטומטיות בין דומיינים. |
url_custom_parameters[] |
רשימת מיפויים שתשמש להחלפת תגי פרמטרים של כתובות URL בהתאמה אישית ב-tracking_url_template, ב-final_urls או ב-final_mobile_urls. |
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 למעקב. |
final_url_suffix |
תבנית כתובת 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 |
שם המשאב של התצוגה של השילובים המובילים של קבוצת הנכסים. שמות המשאבים של התצוגה 'השילוב המוביל של נכסים בקבוצת נכסים' הם בפורמט: `"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). בשיטות בידינג בחשבונות ניהול, זהו המטבע שהמפרסם הגדיר כשנוצרה שיטת הבידינג. לשירות לקוחות, זהו קוד המטבע של הלקוח. המדדים של שיטת הבידינג מדווחים במטבע הזה. השדה הזה הוא לקריאה בלבד. |
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 יוצא משימוש בגרסה v1. במקום זאת, צריך להשתמש ב-creation_time. |
creation_time |
חותמת הזמן שבה הקמפיין הזה נוצר. חותמת הזמן היא באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss. |
last_modified_time |
התאריך והשעה שבהם הקמפיין הזה שונה לאחרונה. התאריך והשעה הם באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss.ssssss. |
feed_types[] |
סוגי הפידים שמצורפים ישירות לקמפיין הזה. |
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, כלומר הקמפיין יפעל ללא הגבלת זמן. כדי להגדיר קמפיין קיים לפעולה ללא הגבלת זמן, צריך להגדיר את השדה הזה ל-2037-12-30. |
final_url_suffix |
סיומת שמשמשת לצירוף פרמטרים של שאילתות לדפי נחיתה שמוצגים עם מעקב מקביל. |
url_expansion_opt_out |
המאפיין הזה מציין שהמשתמש ביטל את ההסכמה להרחבת כתובות ה-URL לכתובות URL ממוקדות יותר. אם ההסכמה בוטלה (true), המערכת תטרגט רק את כתובות ה-URL הסופיות בקבוצת הנכסים או את כתובות ה-URL שצוינו בפידים של פרטי העסק או בפידים של Google Merchant Center של המפרסם. אם בוחרים באפשרות הזו (false), הטירגוט יתבצע לדומיין כולו. אפשר להגדיר את השדה הזה רק בקמפיינים למיקסום ביצועים, שבהם ערך ברירת המחדל הוא false. |
שדה איחוד השיטה צריכה להיות שיטת בידינג כוללת (שנוצרה באמצעות השירות BiddingStrategy) או שיטת בידינג רגילה שמוטמעת בקמפיין. הערך |
|
bidding_strategy |
שם המשאב של שיטת הבידינג הכוללת שבה נעשה שימוש בקמפיין. |
manual_cpa |
שיטת בידינג רגילה של עלות ידנית להמרה. שיטת בידינג ידנית שמאפשרת למפרסם להגדיר את הצעת המחיר לכל פעולה שהמפרסם מציין. התמיכה זמינה רק לקמפיינים לקידום עסקים מקומיים. |
manual_cpc |
שיטת בידינג רגילה של עלות ידנית לקליק. הגשת הצעות מחיר ידנית על בסיס קליקים, שבה המשתמש משלם על כל קליק. |
manual_cpm |
שיטת בידינג רגילה של בידינג ידני לפי עלות לאלף חשיפות. שיטה ידנית להגשת הצעות מחיר על בסיס חשיפות, שבה המשתמש משלם על כל אלף חשיפות. |
maximize_conversions |
שיטת הבידינג הרגילה 'מקסימום המרות' שממקסמת באופן אוטומטי את מספר ההמרות במסגרת התקציב. |
maximize_conversion_value |
אסטרטגיית בידינג רגילה מסוג 'מקסימום ערך המרות' שמגדירה הצעות מחיר באופן אוטומטי כדי להפיק את ההכנסה המקסימלית במסגרת התקציב. |
target_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 |
חובה. קוד השפה שמציין את שפת הדומיין, למשל 'en'. |
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, ורשימות רימרקטינג עבור מודעות לרשת החיפוש (RLSA), שמצטברים לפי קמפיין וקריטריון קהל. בתצוגה הזו נכללים רק קהלים שמצורפים ברמת הקמפיין.
| שדות | |
|---|---|
resource_name |
שם המשאב של תצוגת הקהל של הקמפיין. הפורמט של שמות המשאבים של תצוגת הקהל ברמת הקמפיין הוא:
|
CampaignBudget
תקציב הקמפיין.
| שדות | |
|---|---|
resource_name |
שם המשאב של תקציב הקמפיין. הפורמט של שמות המשאבים של תקציבי הקמפיינים הוא:
|
delivery_method |
שיטת הצגת המודעות שקובעת את קצב ניצול התקציב של הקמפיין. אם לא מציינים ערך בפעולת יצירה, ברירת המחדל היא STANDARD. |
period |
התקופה שבה התקציב ינוצל. אם לא מציינים ערך, ברירת המחדל היא DAILY. |
amount_micros |
סכום התקציב במטבע המקומי של החשבון. הסכום מצוין במיליוניות, כאשר מיליון שווה ליחידת מטבע אחת. ההוצאה החודשית מוגבלת ל-30.4 כפול הסכום הזה. |
CampaignCriterion
קריטריון של קמפיין.
| שדות | |
|---|---|
resource_name |
שם המשאב של קריטריון הקמפיין. הפורמט של שמות המשאבים של קריטריונים לקמפיין הוא:
|
display_name |
השם המוצג של הקריטריון. המערכת מתעלמת מהשדה הזה בשינויים. |
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 |
מחרוזת ייחודית של הביקור שההמרה משויכת אליו, שמועברת לדף הנחיתה כפרמטר של כתובת אתר של מזהה הקליק. |
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 |
כמות הפריטים שתועדה בהמרה, כפי שנקבעה על ידי פרמטר כתובת ה-URL qty. המפרסם אחראי לאכלוס הפרמטר באופן דינמי (למשל מספר הפריטים שנמכרו בהמרה), אחרת ערך ברירת המחדל הוא 1. |
conversion_revenue_micros |
ההכנסה המותאמת במיקרו לאירוע ההמרה. המטבע הזה יהיה תמיד המטבע של החשבון שבו מוצגות המודעות. |
floodlight_original_revenue |
ההכנסה המקורית שלא השתנתה שמשויכת לאירוע ב-Floodlight (במטבע של הדוח הנוכחי), לפני השינויים בהוראות המטבע ב-Floodlight. |
floodlight_order_id |
מזהה ההזמנה ב-Floodlight שסופק על ידי המפרסם לצורך ההמרה. |
status |
הסטטוס של ההמרה, ENABLED או REMOVED. |
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 |
המטבע שבו מתנהל החשבון. מערכת Google תומכת בחלק מקודי המטבע בתקן 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 |
ייצוג מחרוזת של אזור הזמן של הלקוח במאגר Common Locale Data Repository (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, כפי שמתואר במאמר הזה: 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, כפי שמתואר במאמר הזה: 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 של פרוטו שמתאר את סוג הנתונים של הארטיפקט. |
is_repeated |
האם הארטיפקט של השדה חוזר. |
ShoppingPerformanceView
תצוגת ביצועים של שופינג. הדוח מספק נתונים סטטיסטיים של קמפיינים של שופינג, שנצברים בכמה רמות של מאפייני מוצרים. ערכי המאפיינים של המוצרים מ-Merchant Center, כמו מותג, קטגוריה, מאפיינים מותאמים אישית, מצב מוצר וסוג מוצר, ישקפו את המצב של כל מאפיין נכון לתאריך ולשעה שבהם האירוע המתאים נרשם.
| שדות | |
|---|---|
resource_name |
שם המשאב של תצוגת נתוני הביצועים של שופינג. הפורמט של שמות המשאבים של תצוגת נתוני הביצועים של שופינג הוא: |
UserList
רשימת משתמשים. זוהי רשימה של משתמשים שלקוח יכול לטרגט.
| שדות | |
|---|---|
resource_name |
שם המשאב של רשימת המשתמשים. שמות המשאבים של רשימות המשתמשים הם מהצורה:
|
type |
סוג הרשימה. השדה הזה הוא לקריאה בלבד. |
id |
המזהה של רשימת המשתמשים. |
name |
השם של רשימת המשתמשים הזו. יכול להיות ששם רשימת המשתמשים לא יהיה ייחודי (לדוגמה, אם access_reason=SHARED), בהתאם ל-access_reason. |
UserLocationView
תצוגת מיקום של משתמש.
התצוגה 'מיקום המשתמש' כוללת את כל המדדים שמצטברים ברמת המדינה, שורה אחת לכל מדינה. בעמודה הזו מוצגים מדדי הביצועים במיקום הפיזי בפועל של המשתמש, לפי מיקום גיאוגרפי מטורגט או לא מטורגט. אם נעשה שימוש בשדות אחרים של פלחים, יכול להיות שתקבלו יותר משורה אחת לכל מדינה.
| שדות | |
|---|---|
resource_name |
שם המשאב של תצוגת המיקום של המשתמש. שמות המשאבים של התצוגה המפורטת UserLocation הם מהצורה:
|
country_criterion_id |
מזהה הקריטריון של המדינה. |
targeting_location |
מציין אם המיקום היה מיקום גיאוגרפי למיקוד או לא. |
כניסה
ביקור.
| שדות | |
|---|---|
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_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 |
שם המשאב של התצוגה של דף האינטרנט. שמות המשאבים של תצוגות דפי אינטרנט הם מהצורה:
|