Package google.ads.searchads360.v0.resources

אינדקס

AccessibleBiddingStrategy

מייצג תצוגה של אסטרטגיות בידינג שנמצאות בבעלות הלקוח ומשותפות איתו.

בניגוד ל-BiddingStrategy, המשאב הזה כולל אסטרטגיות שנמצאות בבעלות של חשבונות ניהול של הלקוח ומשותפות עם הלקוח הזה, בנוסף לאסטרטגיות שנמצאות בבעלות של הלקוח הזה. המשאב הזה לא מספק מדדים, והוא חושף רק קבוצת משנה מוגבלת של מאפייני BiddingStrategy.

שדות
resource_name

string

שם המשאב של שיטת הבידינג שאפשר לגשת אליה. שמות המשאבים של AccessibleBiddingStrategy הם בפורמט:

customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}
id

int64

המזהה של שיטת הבידינג.
name

string

השם של שיטת הבידינג.
type

BiddingStrategyType

הסוג של שיטת הבידינג.
owner_customer_id

int64

המזהה של הלקוח שבבעלותו אסטרטגיית הבידינג.
owner_descriptive_name

string

‫descriptive_name של הלקוח שבבעלותו שיטת הבידינג.

שדה איחוד scheme. תכנית הבידינג.

אפשר להגדיר רק אחד. הערך scheme יכול להיות רק אחד מהבאים:
maximize_conversion_value

MaximizeConversionValue

שיטת בידינג אוטומטית שעוזרת להשיג את ערך ההמרה הגבוה ביותר מהקמפיינים במסגרת התקציב.
maximize_conversions

MaximizeConversions

שיטת בידינג אוטומטית שעוזרת לכם להשיג כמה שיותר המרות בקמפיינים במסגרת התקציב.
target_cpa

TargetCpa

שיטת בידינג שבה המערכת מגדירה הצעות מחיר במטרה להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם.
target_impression_share

TargetImpressionShare

שיטת בידינג שמבצעת אופטימיזציה אוטומטית כדי להשיג אחוז מסוים של חשיפות.
target_roas

TargetRoas

שיטת בידינג שעוזרת לכם למקסם את ההכנסות תוך שמירה על ערך ממוצע של יעד החזר על הוצאות פרסום (ROAS) שהגדרתם.
target_spend

TargetSpend

שיטת בידינג שמגדירה את הצעות המחיר כדי לעזור לכם לקבל כמה שיותר קליקים במסגרת התקציב.

MaximizeConversionValue

שיטת בידינג אוטומטית שעוזרת להשיג את ערך ההמרה הגבוה ביותר מהקמפיינים במסגרת התקציב.

שדות
target_roas

double

האפשרות 'יעד החזר על הוצאות פרסום'. אם מגדירים יעד החזר על הוצאות פרסום, שיטת הבידינג תמקסם את ההכנסות תוך שמירה על ערך ממוצע של יעד ההחזר על הוצאות הפרסום. אם יעד ההחזר על הוצאות הפרסום גבוה, יכול להיות ששיטת הבידינג לא תוכל לנצל את כל התקציב. אם לא תגדירו יעד החזר על הוצאות פרסום, שיטת הבידינג תנסה להשיג את ההחזר הכי גבוה על הוצאות הפרסום במסגרת התקציב.

MaximizeConversions

שיטת בידינג אוטומטית שעוזרת לכם להשיג כמה שיותר המרות בקמפיינים במסגרת התקציב.

שדות
target_cpa

int64

האפשרות 'יעד עלות להמרה (CPA)'. זהו הסכום הממוצע שאתם רוצים להוציא על כל רכישה.
target_cpa_micros

int64

האפשרות 'יעד עלות להמרה (CPA)'. זהו הסכום הממוצע שאתם רוצים להוציא על כל רכישה.

TargetCpa

זוהי שיטת בידינג אוטומטית שמגדירה הצעות מחיר כדי לעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם.

שדות
target_cpa_micros

int64

יעד עלות ממוצעת להמרה. היעד הזה צריך להיות גדול מהיחידה המינימלית לחיוב או שווה לה, בהתאם למטבע שמוגדר בחשבון.

TargetImpressionShare

שיטת בידינג אוטומטית שמגדירה הצעות מחיר כך שאחוז מסוים של מודעות לרשת החיפוש יוצגו בראש הדף הראשון (או במיקום אחר שמטרגטים).

שדות
location

TargetImpressionShareLocation

המיקום המטורגט בדף תוצאות החיפוש.
location_fraction_micros

int64

השבר שנבחר של המודעות שיוצגו במיקום המטורגט במיקרו. לדוגמה, 1% שווה ל-10,000.
cpc_bid_ceiling_micros

int64

הצעת המחיר המקסימלית לקליק שהמערכת לבידינג אוטומטי יכולה להגדיר. זהו שדה חובה שהמפרסם מזין, שבו מוגדרת התקרה ומצוין במיקרו-מיקומים מקומיים.

TargetRoas

שיטת בידינג אוטומטית שעוזרת למקסם את ההכנסות תוך שמירה על ערך ממוצע של יעד החזר על הוצאות פרסום (ROAS) שהגדרתם.

שדות
target_roas

double

ההכנסה שנבחרה (על סמך נתוני ההמרות) לכל יחידת הוצאה.

TargetSpend

שיטת בידינג אוטומטית שמגדירה את הצעות המחיר כדי לעזור לכם לקבל כמה שיותר קליקים במסגרת התקציב.

שדות
target_spend_micros
(deprecated)

int64

יעד ההוצאות שבו רוצים להשיג מקסימום קליקים. מגיש הצעות מחיר לפי יעד הוצאות ינסה להוציא את הסכום הנמוך מבין שני הערכים האלה: הערך הזה או סכום ההוצאות שמוגבל באופן טבעי. אם לא מציינים יעד הוצאות, המערכת משתמשת בתקציב כהוצאה היעד. השדה הזה הוצא משימוש ואין להשתמש בו יותר. פרטים נוספים זמינים בכתובת https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html.
cpc_bid_ceiling_micros

int64

תקרת הצעות המחיר שניתן להגדיר בשיטת הבידינג. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי שיטת הבידינג.

מודעה.

שדות
resource_name

string

שם המשאב של המודעה. שמות המשאבים של המודעות מופיעים בפורמט:

customers/{customer_id}/ads/{ad_id}
final_urls[]

string

רשימת כתובות ה-URL הסופיות האפשריות אחרי כל ההפניות האוטומטיות בין דומיינים של המודעה.
final_app_urls[]

FinalAppUrl

רשימה של כתובות URL סופיות של אפליקציות שישמשו בנייד אם האפליקציה הספציפית מותקנת אצל המשתמש.
final_mobile_urls[]

string

רשימת כתובות הדפים הסופיות בנייד האפשריות אחרי כל ההפניות האוטומטיות בין דומיינים עבור המודעה.
type

AdType

סוג המודעה.
synthetic_content_info

SyntheticContentInfo

מידע על תוכן סינתטי במודעה. רק מודעות עם סוגי מודעות ספציפיים עומדות בדרישות לעדכונים באמצעות השדה synthetic_content_info.

הערכים המותרים של AdType: * HTML5_UPLOAD_AD * DYNAMIC_HTML5_AD * IMAGE_AD
id

int64

המזהה של המודעה.
tracking_url_template

string

תבנית של כתובת URL ליצירת כתובת URL למעקב.
final_url_suffix

string

הסיומת שבה משתמשים כשיוצרים כתובת URL סופית.
display_url

string

כתובת ה-URL שמופיעה בתיאור המודעה בפורמטים מסוימים של מודעות.
name

string

שם המודעה. הוא משמש רק לזיהוי המודעה. השם לא צריך להיות ייחודי והוא לא משפיע על המודעה שמוצגת.
שדה איחוד ad_data. פרטים שרלוונטיים לסוג המודעה. חובה להגדיר בדיוק ערך אחד. הערך ad_data יכול להיות רק אחד מהבאים:
text_ad

SearchAds360TextAdInfo

פרטים שקשורים למודעת טקסט.
expanded_text_ad

SearchAds360ExpandedTextAdInfo

פרטים שקשורים למודעת טקסט מורחבת. מודעות טקסט מורחבות הוצאו משימוש. במקום זאת, אתם צריכים להשתמש ב-SearchAds360ResponsiveSearchAd.
responsive_search_ad

SearchAds360ResponsiveSearchAdInfo

פרטים שקשורים למודעה רספונסיבית לרשת החיפוש.
product_ad

SearchAds360ProductAdInfo

פרטים שקשורים למודעת מוצר.
expanded_dynamic_search_ad

SearchAds360ExpandedDynamicSearchAdInfo

פרטים שקשורים למודעה דינמית מורחבת לרשת החיפוש.

קבוצת מודעות

קבוצת מודעות.

שדות
resource_name

string

שם המשאב של קבוצת המודעות. הפורמט של שמות המשאבים של קבוצות המודעות הוא:

customers/{customer_id}/adGroups/{ad_group_id}
status

AdGroupStatus

הסטטוס של קבוצת המודעות.
type

AdGroupType

הסוג של קבוצת המודעות.
ad_rotation_mode

AdGroupAdRotationMode

המצב של סבב המודעות בקבוצת המודעות.
creation_time

string

חותמת הזמן שבה נוצרה קבוצת המודעות הזו. חותמת הזמן היא באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss.
targeting_setting

TargetingSetting

הגדרה לטירגוט תכונות קשורות.
labels[]

string

שמות המשאבים של התוויות שמצורפות לקבוצת המודעות הזו.
effective_labels[]

string

שמות המשאבים של תוויות יעילות שמצורפות לקבוצת המודעות הזו. תווית יעילה היא תווית שעברה בירושה או שהוקצתה ישירות לקבוצת המודעות הזו.
engine_id

string

המזהה של קבוצת המודעות בחשבון החיצוני של מנוע החיפוש. השדה הזה מיועד רק לחשבונות שאינם חשבונות Google Ads, למשל Yahoo Japan,‏ Microsoft,‏ Baidu וכו'. לגבי ישות ב-Google Ads, צריך להשתמש במקום זאת ב-ad_group.id.
start_date

string

התאריך שבו קבוצת המודעות הזו מתחילה להציג מודעות. כברירת מחדל, קבוצת המודעות מתחילה לפעול עכשיו או בתאריך ההתחלה שהוגדר לה, לפי המאוחר מביניהם. אם השדה הזה מוגדר, קבוצת המודעות מתחילה לפעול בתחילת התאריך שצוין באזור הזמן של הלקוח. השדה הזה זמין רק לחשבונות שער של Microsoft Advertising ו-Facebook.

פורמט: YYYY-MM-DD דוגמה: 2019-03-14
end_date

string

התאריך שבו הצגת המודעות בקבוצת המודעות מסתיימת. כברירת מחדל, קבוצת המודעות מסתיימת בתאריך הסיום של קבוצת המודעות. אם השדה הזה מוגדר, קבוצת המודעות מסתיימת בסוף התאריך שצוין באזור הזמן של הלקוח. השדה הזה זמין רק לחשבונות שער של Microsoft Advertising ו-Facebook.

פורמט: YYYY-MM-DD דוגמה: 2019-03-14
language_code

string

השפה של המודעות ומילות המפתח בקבוצת מודעות. השדה הזה זמין רק לחשבונות Microsoft Advertising. מידע נוסף: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage
last_modified_time

string

התאריך והשעה שבהם קבוצת המודעות הזו שונתה לאחרונה. התאריך והשעה הם באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss.ssssss.
id

int64

המזהה של קבוצת המודעות.
name

string

השם של קבוצת המודעות.

חובה למלא את השדה הזה כשיוצרים קבוצות מודעות חדשות.

הוא צריך להכיל פחות מ-255 תווים ברוחב מלא בתקן UTF-8.

הוא לא יכול להכיל תווי null (מיקום תו 0x0), מעבר שורה NL (מיקום תו 0xA) או חזרה לתחילת השורה (מיקום תו 0xD).
tracking_url_template

string

תבנית של כתובת URL ליצירת כתובת URL למעקב.
cpc_bid_micros

int64

הצעת המחיר המקסימלית לקליק (CPC). השדה הזה משמש כשיטת הבידינג האפקטיבית של קבוצת המודעות היא עלות ידנית לקליק. השדה הזה לא רלוונטי ויתעלמו ממנו אם בקמפיין של קבוצת המודעות מוגדרת שיטת בידינג כוללת.
engine_status

AdGroupEngineStatus

הסטטוס של קבוצת המודעות במנוע.
final_url_suffix

string

תבנית של כתובת URL להוספת פרמטרים לכתובת URL סופית.

AdGroupAd

מודעה בקבוצת מודעות.

שדות
resource_name

string

שם המשאב של המודעה. הפורמט של שמות משאבים של מודעות בקבוצת מודעות הוא:

customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}
status

AdGroupAdStatus

הסטטוס של המודעה.
ad

Ad

המודעה.
creation_time

string

חותמת הזמן שבה נוצרה המודעה ad_group_ad. התאריך והשעה הם באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss.ssssss.
labels[]

string

שמות המשאבים של התוויות שמצורפות למודעה בקבוצת המודעות הזו.
effective_labels[]

string

שמות המשאבים של התוויות האפקטיביות שמצורפות למודעה הזו. תווית אפקטיבית היא תווית שעברה בירושה או שהוקצתה ישירות למודעה הזו.
engine_id

string

המזהה של המודעה בחשבון מנוע החיפוש החיצוני. השדה הזה מיועד רק לחשבונות Search Ads 360, למשל Yahoo Japan,‏ Microsoft,‏ Baidu וכו'. לגבי ישות שאינה Search Ads 360, צריך להשתמש במקום זאת ב-ad_group_ad.ad.id.
engine_status

AdGroupAdEngineStatus

סטטוס נוסף של המודעה בחשבון מנוע החיפוש החיצוני. סטטוסים אפשריים (בהתאם לסוג החשבון החיצוני) כוללים את האפשרויות "פעיל", "כשיר", "בהמתנה לבדיקה" וכו'.
last_modified_time

string

התאריך והשעה שבהם בוצע השינוי האחרון במודעה הזו בקבוצת המודעות. התאריך והשעה הם באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss.ssssss.

AdGroupAdEffectiveLabel

קשר בין מודעה בקבוצת מודעות לבין תווית יעילה. תווית יעילה היא תווית שעברה בירושה או שהוקצתה ישירות למודעה הזו בקבוצת המודעות.

שדות
resource_name

string

שם המשאב של התווית האפקטיבית של מודעה בקבוצת מודעות. שמות המשאבים של התווית האפקטיבית של מודעה בקבוצת מודעות הם מהצורה: customers/{owner_customer_id}/adGroupAdEffectiveLabels/{ad_group_id}~{ad_id}~{label_id}
ad_group_ad

string

מודעה בקבוצת מודעות שהתווית האפקטיבית מצורפת אליה.
label

string

התווית האפקטיבית שהוקצתה למודעה בקבוצת המודעות.
owner_customer_id

int64

המזהה של הלקוח שהוא הבעלים של התווית בתוקף.

AdGroupAdLabel

קשר בין מודעה בקבוצת מודעות לבין תווית.

שדות
resource_name

string

שם המשאב של תווית המודעה בקבוצת המודעות. שמות המשאבים של תוויות המודעות ברמת קבוצת המודעות הם מהצורה: customers/{owner_customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}
ad_group_ad

string

מודעה בקבוצת מודעות שהתווית מצורפת אליה.
label

string

התווית שהוקצתה למודעה בקבוצת המודעות.
owner_customer_id

int64

המזהה של הלקוח שהוא הבעלים של התווית.

AdGroupAsset

קישור בין קבוצת מודעות לבין נכס.

שדות
resource_name

string

שם המשאב של נכס קבוצת המודעות. שמות המשאבים של AdGroupAsset הם בפורמט:

customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}
ad_group

string

חובה. קבוצת המודעות שהנכס מקושר אליה.
asset

string

חובה. הנכס שמקושר לקבוצת המודעות.
status

AssetLinkStatus

הסטטוס של הנכס ברמת קבוצת המודעות.

AdGroupAssetSet

‫AdGroupAssetSet הוא הקישור בין קבוצת מודעות לבין קבוצת נכסים. יצירת קישורים מסוג AdGroupAssetSet מקשרת בין קבוצת נכסים לבין קבוצת מודעות.

שדות
resource_name

string

שם המשאב של קבוצת נכסי קבוצת המודעות. שמות המשאבים של קבוצות נכסים של קבוצות מודעות הם מהצורה:

customers/{customer_id}/adGroupAssetSets/{ad_group_id}~{asset_set_id}
ad_group

string

קבוצת המודעות שאליה מקושרת קבוצת הנכסים הזו.
asset_set

string

קבוצת הנכסים שמקושרת לקבוצת המודעות.
status

AssetSetLinkStatus

הסטטוס של קבוצת הנכסים ברמת קבוצת המודעות. קריאה בלבד.

AdGroupAudienceView

תצוגת קהל ברמת קבוצת המודעות. האפשרות הזו כוללת נתוני ביצועים מקהלים לפי תחומי עניין ומרשימות רימרקטינג עבור מודעות לרשת המדיה ומודעות לרשת YouTube, ומרשימות רימרקטינג עבור מודעות לרשת החיפוש (RLSA), שמצטברים ברמת הקהל.

שדות
resource_name

string

השם של משאב התצוגה של קהל ברמת קבוצת המודעות. שמות המשאבים של תצוגת הקהל ברמת קבוצת המודעות הם מהצורה:

customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

AdGroupBidModifier

מייצג התאמת הצעת מחיר לקבוצת מודעות.

שדות
resource_name

string

שם המשאב של מגביל הצעת המחיר של קבוצת המודעות. שמות המשאבים של התאמות הצעות המחיר לקבוצות מודעות הם מהצורה:

customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}
bid_modifier

double

המשנה של הצעת המחיר כשהקריטריון תואם. המשנה חייב להיות בטווח: 0.1 עד 10.0. כדי לבטל את ההסכמה לסוג מכשיר מסוים, משתמשים בערך 0.

שדה איחוד criterion. הקריטריון של מגביל הצעת המחיר הזה לקבוצת מודעות.

חובה בפעולות יצירה החל מגרסה 5. הערך criterion יכול להיות רק אחד מהבאים:
device

DeviceInfo

קריטריון מכשיר.

AdGroupCriterion

קריטריון של קבוצת מודעות. בדוח ad_group_criterion מוחזרים רק קריטריונים שנוספו באופן מפורש לקבוצת המודעות.

שדות
resource_name

string

שם המשאב של קריטריון קבוצת המודעות. שמות המשאבים של קריטריונים של קבוצות מודעות הם מהצורה:

customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
creation_time

string

חותמת הזמן שבה נוצר הקריטריון הזה של קבוצת המודעות. חותמת הזמן היא באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss.
status

AdGroupCriterionStatus

הסטטוס של הקריטריון.

הסטטוס של הישות ad group criterion, שהוגדר על ידי הלקוח. הערה: דוחות ממשק המשתמש עשויים לכלול מידע נוסף שמשפיע על הזכאות של קריטריון להפעלה. במקרים מסוימים, קריטריון שהוסר ב-API עדיין יכול להופיע כקריטריון שמופעל בממשק המשתמש. לדוגמה, כברירת מחדל, הקמפיינים מוצגים למשתמשים בכל טווחי הגילאים, אלא אם הם מוחרגים. בממשק המשתמש יוצג כל טווח גילאים כ'מופעל', כי המשתמשים בטווחים האלה עומדים בדרישות לצפייה במודעות. אבל ב-AdGroupCriterion.status יוצג הערך 'הוסר', כי לא נוסף קריטריון חיובי.
quality_info

QualityInfo

מידע לגבי איכות הקריטריון.
type

CriterionType

סוג הקריטריון.
labels[]

string

שמות המשאבים של התוויות שמצורפות לקריטריון הזה של קבוצת המודעות.
effective_labels[]

string

השמות של המשאבים של התוויות האפקטיביות שמצורפות לקריטריון הזה של קבוצת המודעות. תווית יעילה היא תווית שעברה בירושה או שהוקצתה ישירות לקריטריון הזה של קבוצת המודעות.
position_estimates

PositionEstimates

הערכות לגבי הצעות מחיר לקריטריונים במיקומים שונים.
final_urls[]

string

רשימת כתובות ה-URL הסופיות האפשריות אחרי כל ההפניות האוטומטיות בין דומיינים של המודעה.
final_mobile_urls[]

string

רשימת כתובות ה-URL הסופיות לניידים שאליהן יכולה להוביל ההפניה האוטומטית אחרי כל ההפניות האוטומטיות דרך דומיין אחר.
url_custom_parameters[]

CustomParameter

רשימת המיפויים שמשמשת להחלפת תגי פרמטרים מותאמים אישית ב-tracking_url_template, ב-final_urls או ב-mobile_final_urls.
engine_id

string

המזהה של קריטריון לקבוצת מודעות בחשבון החיצוני של מנוע החיפוש. השדה הזה מיועד רק לחשבונות שאינם חשבונות Google Ads, למשל Yahoo Japan,‏ Microsoft,‏ Baidu וכו'. לגבי ישות של Google Ads, צריך להשתמש במקום זאת ב-ad_group_criterion.criterion_id.
last_modified_time

string

התאריך והשעה שבהם הקריטריון הזה של קבוצת המודעות שונה לאחרונה. התאריך והשעה הם באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss.ssssss.
criterion_id

int64

המזהה של הקריטריון.
ad_group

string

קבוצת המודעות שאליה משתייך הקריטריון.
negative

bool

האם לטרגט (false) את הקריטריון או להחריג (true) אותו.

אי אפשר לשנות את השדה הזה. כדי להפוך קריטריון מחיובי לשלילי, צריך להסיר אותו ואז להוסיף אותו מחדש.
bid_modifier

double

המשנה של הצעת המחיר כשהקריטריון תואם. המשנה חייב להיות בטווח: 0.1 עד 10.0. רוב סוגי הקריטריונים לטירגוט תומכים בשינויים.
cpc_bid_micros

int64

הצעת המחיר לקליק (CPC).
effective_cpc_bid_micros

int64

הצעת המחיר בפועל לקליק (CPC).
engine_status

AdGroupCriterionEngineStatus

הסטטוס במנוע החיפוש של קריטריון לקבוצת מודעות.
final_url_suffix

string

תבנית של כתובת URL להוספת פרמטרים לכתובת ה-URL הסופית.
tracking_url_template

string

תבנית של כתובת URL ליצירת כתובת URL למעקב.

שדה איחוד criterion. הקריטריון של קבוצת המודעות.

חובה להגדיר בדיוק אחד מהם. הערך criterion יכול להיות רק אחד מהבאים:
keyword

KeywordInfo

מילת מפתח.
listing_group

ListingGroupInfo

קבוצה של כרטיסי מוצר.
age_range

AgeRangeInfo

טווח גילאים.
gender

GenderInfo

מגדר.
user_list

UserListInfo

רשימת משתמשים.
webpage

WebpageInfo

דף אינטרנט
location

LocationInfo

מיקום.

PositionEstimates

הערכות לגבי הצעות מחיר לקריטריונים במיקומים שונים.

שדות
top_of_page_cpc_micros

int64

ההצעה המשוערת לקליק שנדרשת כדי שהמודעה תוצג בראש הדף הראשון של תוצאות החיפוש.

QualityInfo

מאגר לפרטי האיכות של קריטריון של קבוצת מודעות.

שדות
quality_score

int32

ציון האיכות.

יכול להיות שהשדה הזה לא יאוכלס אם ל-Google אין מספיק מידע כדי לקבוע ערך.

AdGroupCriterionEffectiveLabel

קשר בין קריטריון של קבוצת מודעות לבין תווית יעילה. תווית יעילה היא תווית שעברה בירושה או שהוקצתה ישירות לקריטריון הזה של קבוצת המודעות.

שדות
resource_name

string

שם המשאב של התווית האפקטיבית של קריטריון לקבוצת מודעות. שמות המשאבים של התוויות האפקטיביות של קריטריון של קבוצת מודעות הם מהצורה: customers/{owner_customer_id}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterion_id}~{label_id}
ad_group_criterion

string

הקריטריון של קבוצת המודעות שאליו מצורפת התווית האפקטיבית.
label

string

התווית האפקטיבית שהוקצתה לקריטריון של קבוצת המודעות.
owner_customer_id

int64

המזהה של הלקוח שהוא הבעלים של התווית בתוקף.

AdGroupCriterionLabel

קשר בין קריטריון של קבוצת מודעות לבין תווית.

שדות
resource_name

string

שם המשאב של התווית של קריטריון קבוצת המודעות. שמות המשאבים של תוויות של קריטריונים של קבוצות מודעות הם מהצורה: customers/{owner_customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}
ad_group_criterion

string

הקריטריון של קבוצת המודעות שאליו מצורפת התווית.
label

string

התווית שהוקצתה לקריטריון של קבוצת המודעות.
owner_customer_id

int64

המזהה של הלקוח שהוא הבעלים של התווית.

AdGroupEffectiveLabel

קשר בין קבוצת מודעות לבין תווית יעילה. תווית יעילה היא תווית שעברה בירושה או שהוקצתה ישירות לקבוצת המודעות הזו.

שדות
resource_name

string

שם המשאב של התווית האפקטיבית של קבוצת המודעות. שמות המשאבים של התוויות האפקטיביות של קבוצות המודעות הם מהצורה: customers/{owner_customer_id}/adGroupEffectiveLabels/{ad_group_id}~{label_id}
ad_group

string

קבוצת המודעות שאליה מצורפת התווית האפקטיבית.
label

string

התווית האפקטיבית שהוקצתה לקבוצת המודעות.
owner_customer_id

int64

המזהה של הלקוח שהוא הבעלים של התווית בתוקף.

AdGroupLabel

קשר בין קבוצת מודעות לתווית.

שדות
resource_name

string

שם המשאב של תווית קבוצת המודעות. שמות המשאבים של תוויות קבוצות המודעות הם מהצורה: customers/{owner_customer_id}/adGroupLabels/{ad_group_id}~{label_id}
ad_group

string

קבוצת המודעות שאליה מצורפת התווית.
label

string

התווית שהוקצתה לקבוצת המודעות.
owner_customer_id

int64

המזהה של הלקוח שהוא הבעלים של התווית.

AgeRangeView

תצוגה של טווח גילאים.

המדד הזה מייצג את התצוגה של מדדי הביצועים של לקוח (כמו חשיפות וקליקים) שמצטברים לפי טווח גילאים. כל הנתונים הסטטיסטיים נצברים ברמת קבוצת המודעות.

הערה: אפשר לפלח מדדים לפי טווח גילאים באמצעות age_range_view או לפי מגדר באמצעות gender_view, אבל Search Ads 360 API לא תומך בפילוח מדדים לפי טווח גילאים ומגדר בו-זמנית בשאילתה אחת. אין תמיכה בניתוח הביצועים בשילוב של שני המאפיינים ב-Search Ads 360 API.

שדות
resource_name

string

שם המשאב של תצוגת טווח הגילאים. שמות המשאבים של תצוגת טווח הגילאים הם מהצורה:

customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}

נכס

נכס הוא חלק ממודעה שאפשר לשתף בכמה מודעות. יכול להיות שמדובר בתמונה (ImageAsset), בסרטון (YoutubeVideoAsset) וכו'. אי אפשר לשנות נכסים דיגיטליים או להסיר אותם. כדי להפסיק את הצגת הנכס, מסירים אותו מהישות שמשתמשת בו.

שדות
resource_name

string

שם המשאב של הנכס. שמות המשאבים של הנכסים הם מהצורה:

customers/{customer_id}/assets/{asset_id}
type

AssetType

סוג הנכס.
final_urls[]

string

רשימה של כתובות URL סופיות אפשריות אחרי כל ההפניות האוטומטיות דרך דומיין אחר.
final_mobile_urls[]

string

רשימה של כתובות URL סופיות אפשריות לנייד אחרי כל ההפניות האוטומטיות בין דומיינים.
url_custom_parameters[]

CustomParameter

רשימת מיפויים שתשמש להחלפת תגי פרמטרים של כתובות URL בהתאמה אישית ב-tracking_url_template, ב-final_urls או ב-final_mobile_urls.
status

AssetStatus

הסטטוס של הנכס.
creation_time

string

חותמת הזמן שבה נוצר הנכס הזה. חותמת הזמן היא באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss.
last_modified_time

string

התאריך והשעה שבהם הנכס הזה השתנה לאחרונה. התאריך והשעה הם באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss.ssssss.
synthetic_content_info

SyntheticContentInfo

מידע על תוכן סינתטי בנכס. אפשר לעדכן באמצעות השדה synthetic_content_info רק נכסים עם סוגי נכסים ספציפיים.

הערכים המותרים של AssetType: * IMAGE * MEDIA_BUNDLE * YOUTUBE_VIDEO
id

int64

מזהה הנכס.
name

string

שם אופציונלי של הנכס.
tracking_url_template

string

תבנית של כתובת URL ליצירת כתובת URL למעקב.
final_url_suffix

string

תבנית של כתובת URL להוספת פרמטרים לכתובות של דפי נחיתה שמוצגים עם מעקב מקביל.
engine_status

AssetEngineStatus

סטטוס המנוע של נכס.
שדה איחוד asset_data. הסוג הספציפי של הנכס. הערך asset_data יכול להיות רק אחד מהבאים:
youtube_video_asset

YoutubeVideoAsset

נכס וידאו ב-YouTube.
image_asset

ImageAsset

נכס תמונות.
text_asset

TextAsset

נכס טקסט.
callout_asset

UnifiedCalloutAsset

נכס יתרונות מרכזיים מאוחד.
page_feed_asset

UnifiedPageFeedAsset

נכס מאוחד של פיד דפי נחיתה.
mobile_app_asset

MobileAppAsset

נכס אפליקציה לנייד.
call_asset

UnifiedCallAsset

נכס התקשרות מאוחד.
call_to_action_asset

CallToActionAsset

נכס קריאה לפעולה.
location_asset

UnifiedLocationAsset

נכס מיקום מאוחד.

AssetGroup

קבוצת נכסים. האובייקט AssetGroupAsset משמש לקישור נכס לקבוצת הנכסים. האות AssetGroupSignal משמש לשיוך אות לקבוצת נכסים.

שדות
resource_name

string

שם המשאב של קבוצת הנכסים. הפורמט של שמות המשאבים של קבוצות הנכסים הוא:

customers/{customer_id}/assetGroups/{asset_group_id}
id

int64

המזהה של קבוצת הנכסים.
campaign

string

הקמפיין שאליו משויכת קבוצת הנכסים הזו. הנכס שמקושר לקבוצת הנכסים.
name

string

חובה. השם של קבוצת הנכסים. חובה. האורך המינימלי הוא 1 והאורך המקסימלי הוא 128. הוא חייב להיות ייחודי במסגרת הקמפיין.
final_urls[]

string

רשימה של כתובות URL סופיות אחרי כל ההפניות האוטומטיות בין דומיינים. בקמפיינים למיקסום הביצועים, כתובות ה-URL כשירות להרחבה כברירת מחדל, אלא אם משביתים את האפשרות הזו.
final_mobile_urls[]

string

רשימה של כתובות URL סופיות לניידים אחרי כל ההפניות האוטומטיות בין דומיינים. בקמפיינים למיקסום הביצועים, כתובות ה-URL כשירות להרחבה כברירת מחדל, אלא אם משביתים את האפשרות הזו.
status

AssetGroupStatus

הסטטוס של קבוצת הנכסים.
path1

string

החלק הראשון של הטקסט שעשוי להופיע כתוספת לכתובת ה-URL שמוצגת במודעה.
path2

string

החלק השני של הטקסט שעשוי להופיע כתוספת לכתובת ה-URL שמוצגת במודעה. אפשר להגדיר את השדה הזה רק אם השדה path1 מוגדר.
ad_strength

AdStrength

חוזק המודעה הכולל של קבוצת הנכסים הזו.

AssetGroupAsset

‫AssetGroupAsset הוא הקישור בין נכס לקבוצת נכסים. הוספה של AssetGroupAsset מקשרת נכס לקבוצת נכסים.

שדות
resource_name

string

השם של משאב הנכס בקבוצת הנכסים. שם משאב הנכס של קבוצת הנכסים הוא מהצורה:

customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}
asset_group

string

קבוצת הנכסים שאליה נכס קבוצת הנכסים הזה מקושר.
asset

string

הנכס שאליו מקושר הנכס הזה בקבוצת הנכסים.
field_type

AssetFieldType

תיאור המיקום של הנכס בקבוצת הנכסים. לדוגמה: HEADLINE, ‏ YOUTUBE_VIDEO וכו'
status

AssetLinkStatus

הסטטוס של הקישור בין נכס לקבוצת נכסים.

AssetGroupAssetCombinationData

נתונים על שילובים של נכסים בקבוצת נכסים

שדות
asset_combination_served_assets[]

AssetUsage

נכסים שמוצגים.

AssetGroupListingGroupFilter

‫AssetGroupListingGroupFilter מייצג צומת בעץ של מסנני קבוצות של כרטיסי מוצר בקבוצת נכסים.

שדות
resource_name

string

שם המשאב של מסנן קבוצות של כרטיסי מוצר בנכסים דיגיטליים. שם המשאב של מסנן קבוצות של כרטיסי מוצר בנכסים דיגיטליים הוא מהצורה:

customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}
asset_group

string

קבוצת הנכסים שאליה משתייך המסנן הזה של קבוצות של כרטיסי מוצר בנכסים דיגיטליים.
id

int64

המזהה של ListingGroupFilter.
type

ListingGroupFilterType

הסוג של צומת מסנן של קבוצת כרטיסי מוצר.
vertical

ListingGroupFilterVertical

התחום שהעץ הנוכחי של הצמתים מייצג. כל הצמתים באותו עץ חייבים להיות שייכים לאותו תחום.
case_value

ListingGroupFilterDimension

ערך המאפיין שבאמצעותו קבוצה של כרטיסי מוצר זו מצמצמת את קבוצה של כרטיסי מוצר ברמת ההורה. לא מוגדר לקבוצת הבסיס.
parent_listing_group_filter

string

שם המשאב של חלוקת המשנה של קבוצת כרטיסי המוצר ברמת ההורה. ערך Null לצומת המסנן של קבוצת כרטיסי המוצר ברמת השורש.
path

ListingGroupFilterDimensionPath

נתיב המאפיינים שמגדיר את המסנן הזה של קבוצה של כרטיסי מוצר.

AssetGroupSignal

‫AssetGroupSignal מייצג אות בקבוצת נכסים. האותות עוזרים לקמפיין למיקסום הביצועים לזהות את המשתמשים שהסיכוי שהם ישלימו המרות הוא הגבוה ביותר. מיקסום ביצועים משתמש באות כדי לחפש אנשים חדשים עם כוונת רכישה דומה או חזקה יותר, וכך להשיג יותר המרות בחיפוש, ברשת המדיה, בווידאו ועוד.

שדות
resource_name

string

שם המשאב של האות לזיהוי קהלים ברמת קבוצת הנכסים. שם המשאב של האותות לזיהוי קהלים ברמת קבוצת הנכסים הוא מהצורה:

customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}
asset_group

string

קבוצת הנכסים שאליה משתייך האות הזה של קבוצת הנכסים.
שדה איחוד signal. האות של קבוצת הנכסים. הערך signal יכול להיות רק אחד מהבאים:
audience

AudienceInfo

האות לזיהוי קהלים שבו יש להשתמש בקמפיין למיקסום הביצועים.

AssetGroupTopCombinationView

תצוגה של שילובי הנכסים המובילים בקבוצת הנכסים.

שדות
resource_name

string

שם המשאב של תצוגת השילובים המובילים של קבוצת הנכסים. שמות המשאבים של התצוגה 'השילובים המובילים של קבוצת נכסים' הם מהצורה: `"customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"
asset_group_top_combinations[]

AssetGroupAssetCombinationData

השילובים המובילים של נכסים שהוצגו יחד.

AssetSet

קבוצת נכסים שמייצגת אוסף של נכסים. משתמשים ב-AssetSetAsset כדי לקשר נכס לקבוצת הנכסים.

שדות
id

int64

המזהה של קבוצת הנכסים.
resource_name

string

שם המשאב של קבוצת הנכסים. שמות המשאבים של קבוצות הנכסים הם מהצורה:

customers/{customer_id}/assetSets/{asset_set_id}

AssetSetAsset

‫AssetSetAsset הוא הקישור בין נכס לבין קבוצת נכסים. הוספת AssetSetAsset מקשרת נכס לקבוצת נכסים.

שדות
resource_name

string

שם המשאב של הנכס בקבוצת הנכסים. שמות המשאבים של נכסים בקבוצת נכסים הם מהצורה:

customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}
asset_set

string

קבוצת הנכסים שאליה מקשר הנכס הזה שהוגדר על ידי נכס.
asset

string

הנכס שאליו מקשר הנכס הזה של קבוצת הנכסים.
status

AssetSetAssetStatus

הסטטוס של נכס קבוצת הנכסים. קריאה בלבד.

קהל

קהל הוא אפשרות יעילה לטירגוט שמאפשרת ליצור חפיפה בין מאפייני פילוח שונים, כמו מידע דמוגרפי מפורט וקהלים עם תחום עניין משותף, וכך ליצור קהלים שמייצגים קטעים של פילוחי היעד.

שדות
resource_name

string

שם המשאב של הקהל. שמות הקהלים מופיעים בתבנית:

customers/{customer_id}/audiences/{audience_id}
id

int64

המזהה של הקהל.
name

string

חובה. שם הקהל. המזהה צריך להיות ייחודי לכל הקהלים. האורך המינימלי הוא 1 והאורך המקסימלי הוא 255.
description

string

תיאור של הקהל הזה.

BiddingStrategy

שיטת בידינג.

שדות
resource_name

string

השם של משאב שיטת הבידינג. שמות המשאבים של שיטות הבידינג הם מהצורה:

customers/{customer_id}/biddingStrategies/{bidding_strategy_id}
status

BiddingStrategyStatus

הסטטוס של שיטת הבידינג.

השדה הזה הוא לקריאה בלבד.
type

BiddingStrategyType

הסוג של שיטת הבידינג. יוצרים שיטת בידינג על ידי הגדרת תוכנית הבידינג.

השדה הזה הוא לקריאה בלבד.
currency_code

string

המטבע שבו משתמשים בשיטת הבידינג (קוד מטבע בן 3 אותיות לפי תקן ISO 4217).

בשיטות בידינג בחשבונות ניהול, אפשר להגדיר את המטבע הזה בזמן היצירה. ברירת המחדל היא המטבע של חשבון הניהול. אי אפשר להגדיר את השדה הזה כשמציגים מודעות ללקוחות. כל שיטות הבידינג בחשבון להצגת מודעות משתמשות במטבע של החשבון הזה. בכל המקרים, השדה effective_currency_code מחזיר את המטבע שבו נעשה שימוש בשיטה.
id

int64

המזהה של שיטת הבידינג.
name

string

השם של שיטת הבידינג. לכל שיטות הבידינג בחשבון צריך להיות שם ייחודי.

אורך המחרוזת הזו צריך להיות בין 1 ל-255, כולל, בבייטים של UTF-8 (אחרי חיתוך רווחים).
effective_currency_code

string

המטבע שבו משתמשים בשיטת הבידינג (קוד מטבע בן 3 אותיות לפי תקן ISO 4217).

בשיטות בידינג בחשבונות לקוח ניהוליים, זהו המטבע שהמפרסם הגדיר כשנוצרה שיטת הבידינג. לשירות לקוחות, זהו קוד המטבע של הלקוח.

המדדים של שיטת הבידינג מדווחים במטבע הזה.

השדה הזה הוא לקריאה בלבד.
campaign_count

int64

מספר הקמפיינים שמשויכים לשיטת הבידינג הזו.

השדה הזה הוא לקריאה בלבד.
non_removed_campaign_count

int64

מספר הקמפיינים שלא הוסרו שמשויכים לשיטת הבידינג הזו.

השדה הזה הוא לקריאה בלבד.

שדה איחוד scheme. תכנית הבידינג.

אפשר להגדיר רק אחד. הערך scheme יכול להיות רק אחד מהבאים:
enhanced_cpc

EnhancedCpc

שיטת בידינג שמעלה את הצעות המחיר על קליקים שיש סיכוי גבוה יותר שיובילו להמרה ומורידה את הצעות המחיר על קליקים שיש סיכוי נמוך יותר שיובילו להמרה.
maximize_conversion_value

MaximizeConversionValue

שיטת בידינג אוטומטית שעוזרת להשיג את ערך ההמרה הגבוה ביותר מהקמפיינים במסגרת התקציב.
maximize_conversions

MaximizeConversions

שיטת בידינג אוטומטית שעוזרת לכם להשיג כמה שיותר המרות בקמפיינים במסגרת התקציב.
target_cpa

TargetCpa

שיטת בידינג שבה המערכת מגדירה הצעות מחיר במטרה להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם.
target_impression_share

TargetImpressionShare

שיטת בידינג שמבצעת אופטימיזציה אוטומטית כדי להשיג אחוז מסוים של חשיפות.
target_outrank_share

TargetOutrankShare

שיטת בידינג שמגדירה הצעות מחיר על סמך החלק היחסי של מכרזים שבהם המפרסם צריך להיות מדורג מעל מתחרה ספציפי. השדה הזה הוצא משימוש. יצירת שיטת בידינג חדשה באמצעות השדה הזה או צירוף שיטות בידינג לקמפיין באמצעות השדה הזה ייכשלו. מותר לבצע שינויים בשיטות בידינג שכבר יש בהן נתונים של התוכנית הזו.
target_roas

TargetRoas

שיטת בידינג שעוזרת לכם למקסם את ההכנסות תוך שמירה על ערך ממוצע של יעד החזר על הוצאות פרסום (ROAS) שהגדרתם.
target_spend

TargetSpend

שיטת בידינג שמגדירה את הצעות המחיר כדי לעזור לכם לקבל כמה שיותר קליקים במסגרת התקציב.

קמפיין

קמפיין.

שדות
resource_name

string

שם המשאב של הקמפיין. שמות המשאבים של הקמפיינים הם מהצורה:

customers/{customer_id}/campaigns/{campaign_id}
status

CampaignStatus

הסטטוס של הקמפיין.

כשמוסיפים קמפיין חדש, סטטוס ברירת המחדל שלו הוא 'מופעל'.
serving_status

CampaignServingStatus

סטטוס הצגת המודעות בקמפיין.
bidding_strategy_system_status

BiddingStrategySystemStatus

הסטטוס של שיטת הבידינג שהוגדרה לקמפיין.
ad_serving_optimization_status

AdServingOptimizationStatus

סטטוס האופטימיזציה של הצגת המודעות בקמפיין.
advertising_channel_type

AdvertisingChannelType

יעד ההצגה העיקרי של המודעות בקמפיין. אפשר לשפר את אפשרויות הטירגוט בnetwork_settings.

חובה למלא את השדה הזה כשיוצרים קמפיינים חדשים.

אפשר להגדיר את האפשרות הזו רק כשיוצרים קמפיינים. אי אפשר לשנות את השדה אחרי שהקמפיין נוצר.
advertising_channel_sub_type

AdvertisingChannelSubType

הוספת פרטים אופציונלית ל-advertising_channel_type. צריך להיות תת-סוג חוקי של סוג הערוץ הראשי.

אפשר להגדיר את האפשרות הזו רק כשיוצרים קמפיינים. אחרי שיוצרים את הקמפיין, אי אפשר לשנות את השדה הזה.
url_custom_parameters[]

CustomParameter

רשימת המיפויים שמשמשת להחלפת תגי פרמטרים מותאמים אישית ב-tracking_url_template, ב-final_urls או ב-mobile_final_urls.
real_time_bidding_setting

RealTimeBiddingSetting

הגדרות של בידינג בזמן אמת, תכונה שזמינה רק בקמפיינים שמטרגטים את רשת Ad Exchange.
network_settings

NetworkSettings

הגדרות הרשת של הקמפיין.
dynamic_search_ads_setting

DynamicSearchAdsSetting

ההגדרה לשליטה במודעות דינמיות לרשת החיפוש (DSA).
shopping_setting

ShoppingSetting

ההגדרה לשליטה בקמפיינים של שופינג.
geo_target_type_setting

GeoTargetTypeSetting

ההגדרה של טירגוט גיאוגרפי של מודעות.
effective_labels[]

string

שמות המשאבים של תוויות אפקטיביות שמצורפות לקמפיין הזה. תווית אפקטיבית היא תווית שעברה בירושה או שהוקצתה ישירות לקמפיין הזה.
labels[]

string

שמות המשאבים של התוויות שמצורפות לקמפיין הזה.
bidding_strategy_type

BiddingStrategyType

הסוג של שיטת הבידינג.

אפשר ליצור שיטת בידינג על ידי הגדרת תוכנית הבידינג ליצירת שיטת בידינג רגילה, או על ידי הגדרת השדה bidding_strategy ליצירת שיטת בידינג כוללת.

השדה הזה הוא לקריאה בלבד.
accessible_bidding_strategy

string

שם המשאב של AccessibleBiddingStrategy, תצוגה לקריאה בלבד של המאפיינים הלא מוגבלים של שיטת הבידינג הכוללת המצורפת, שמזוהה על ידי bidding_strategy. הערך ריק אם הקמפיין לא משתמש בשיטה משותפת. מאפיינים של אסטרטגיה ללא הגבלות זמינים לכל הלקוחות שאיתם משתפים את האסטרטגיה, והם נקראים מהמשאב AccessibleBiddingStrategy. לעומת זאת, מאפיינים מוגבלים זמינים רק ללקוח הבעלים של האסטרטגיה ולמנהלים שלו. אפשר לקרוא מאפיינים מוגבלים רק מהמשאב BiddingStrategy.
frequency_caps[]

FrequencyCapEntry

רשימה שמגבילה את התדירות שבה כל משתמש יראה את המודעות בקמפיין הזה.
selective_optimization

SelectiveOptimization

הגדרת האופטימיזציה הסלקטיבית לקמפיין הזה, שכוללת קבוצה של פעולות המרה שהמערכת תבצע עליהן אופטימיזציה בקמפיין הזה. התכונה הזו רלוונטית רק לקמפיינים לקידום אפליקציות שמוגדר בהם הערך MULTI_CHANNEL כ-AdvertisingChannelType והערך APP_CAMPAIGN או APP_CAMPAIGN_FOR_ENGAGEMENT כ-AdvertisingChannelSubType.
optimization_goal_setting

OptimizationGoalSetting

הגדרת יעד האופטימיזציה של הקמפיין הזה, שכוללת קבוצה של סוגי יעדי אופטימיזציה.
tracking_setting

TrackingSetting

הגדרות ברמת הקמפיין למעקב אחר מידע.
engine_id

string

המזהה של הקמפיין בחשבון מנוע החיפוש החיצוני. השדה הזה מיועד רק לחשבונות שאינם חשבונות Google Ads, למשל Yahoo Japan,‏ Microsoft,‏ Baidu וכו'. לגבי ישות של Google Ads, צריך להשתמש במקום זאת ב-campaign.id.
excluded_parent_asset_field_types[]

AssetFieldType

סוגי שדות הנכסים שצריך להחריג מהקמפיין הזה. הקמפיין הזה לא יקבל בירושה מהרמה העליונה קישורי נכסים עם סוגי השדות האלה.
create_time

string

חותמת הזמן שבה הקמפיין הזה נוצר. חותמת הזמן היא באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss. השדה create_time יוצא משימוש בגרסה 1. במקום זאת, צריך להשתמש ב-creation_time.
creation_time

string

חותמת הזמן שבה הקמפיין הזה נוצר. חותמת הזמן היא באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss.
last_modified_time

string

התאריך והשעה שבהם הקמפיין הזה השתנה לאחרונה. התאריך והשעה הם באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss.ssssss.
feed_types[]

AssetSetType

סוגי הפידים שמצורפים ישירות לקמפיין הזה.
id

int64

מזהה הקמפיין.
name

string

השם של מסע הפרסום.

חובה למלא את השדה הזה כשיוצרים קמפיינים חדשים.

הוא לא יכול להכיל תווי null (מיקום תו 0x0), מעבר שורה NL (מיקום תו 0xA) או חזרה לתחילת השורה (מיקום תו 0xD).
tracking_url_template

string

תבנית של כתובת URL ליצירת כתובת URL למעקב.
campaign_budget

string

שם המשאב של תקציב הקמפיין.
start_date

string

התאריך שבו הקמפיין התחיל להציג מודעות באזור הזמן של הלקוח, בפורמט YYYY-MM-DD.
end_date

string

היום האחרון של הקמפיין באזור הזמן של הלקוח שמציג את המודעות, בפורמט YYYY-MM-DD. בזמן היצירה, ברירת המחדל היא 2037-12-30, כלומר הקמפיין יפעל ללא הגבלת זמן. כדי להגדיר קמפיין קיים לפעול ללא הגבלת זמן, צריך להגדיר את השדה הזה ל-2037-12-30.
final_url_suffix

string

סיומת שמשמשת לצירוף פרמטרים של שאילתה לדפי נחיתה שמוצגים עם מעקב מקביל.
url_expansion_opt_out

bool

הערך true מציין שהמשתמש ביטל את ההסכמה להרחבת כתובות ה-URL לכתובות URL ממוקדות יותר. אם ההסכמה בוטלה (true), המערכת תטרגט רק את כתובות ה-URL הסופיות בקבוצת הנכסים או את כתובות ה-URL שצוינו בפידים של פרטי העסק או ב-Google Merchant Center של המפרסם. אם בוחרים באפשרות הזו (false), הטירגוט יתבצע לדומיין כולו. אפשר להגדיר את השדה הזה רק בקמפיינים למיקסום ביצועים, שבהם ערך ברירת המחדל הוא false.

שדה איחוד campaign_bidding_strategy. שיטת הבידינג של הקמפיין.

השיטה צריכה להיות שיטת בידינג כוללת (שנוצרה באמצעות השירות BiddingStrategy) או שיטה רגילה שמוטמעת בקמפיין. הערך campaign_bidding_strategy יכול להיות רק אחד מהבאים:
bidding_strategy

string

שם המשאב של שיטת הבידינג הכוללת שבה נעשה שימוש בקמפיין.
manual_cpa

ManualCpa

שיטת בידינג רגילה של בידינג לפי עלות המרה. שיטת בידינג ידנית שמאפשרת למפרסם להגדיר את הצעת המחיר לכל פעולה שהמפרסם מציין. התמיכה זמינה רק לקמפיינים של Google בעלי מקצוע.
manual_cpc

ManualCpc

שיטת בידינג רגילה של בידינג ידני לפי עלות לקליק. בידינג ידני מבוסס-קליקים שבו המשתמש משלם על כל קליק.
manual_cpm

ManualCpm

שיטת בידינג רגילה של עלות ידנית לאלף חשיפות. הגשת הצעות מחיר ידנית על בסיס חשיפות, שבה המשתמש משלם על כל אלף חשיפות.
maximize_conversions

MaximizeConversions

שיטת בידינג רגילה לפי מקסימום המרות, שבה המערכת מגדירה הצעות מחיר באופן אוטומטי כדי להשיג כמה שיותר המרות במסגרת התקציב.
maximize_conversion_value

MaximizeConversionValue

אסטרטגיית בידינג רגילה לפי מקסימום ערך המרות, שמגדירה הצעות מחיר באופן אוטומטי כדי למקסם את ההכנסות במסגרת התקציב.
target_cpa

TargetCpa

שיטת בידינג רגילה לפי יעד עלות להמרה (CPA), שבה המערכת מגדירה הצעות מחיר באופן אוטומטי כדי לעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה שהגדרתם.
target_impression_share

TargetImpressionShare

בידינג לפי יעד נתח חשיפות שיטת בידינג אוטומטית שמגדירה הצעות מחיר כדי להשיג אחוז חשיפות נבחר.
target_roas

TargetRoas

שיטת בידינג לפי יעד החזר על הוצאות הפרסום (ROAS) שממקסמת באופן אוטומטי את ההכנסות תוך שמירה על יעד ספציפי של החזר על הוצאות פרסום (ROAS).
target_spend

TargetSpend

שיטת בידינג רגילה לפי יעד הוצאות שמגדירה באופן אוטומטי את הצעות המחיר כדי לעזור לכם לקבל כמה שיותר קליקים במסגרת התקציב.
percent_cpc

PercentCpc

שיטת בידינג רגילה לפי אחוז מהעלות לקליק, שבה הצעות המחיר הן חלק קטן מהמחיר המפורסם של מוצר או שירות מסוימים.
target_cpm

TargetCpm

שיטת בידינג שמבצעת אופטימיזציה אוטומטית של העלות לאלף חשיפות.

DynamicSearchAdsSetting

ההגדרה לשליטה במודעות דינמיות לרשת החיפוש (DSA).

שדות
domain_name

string

חובה. שם דומיין האינטרנט שההגדרה הזו מייצגת, למשל google.com או www.google.com.
language_code

string

חובה. קוד השפה שמציין את השפה של הדומיין, למשל 'en'.
use_supplied_urls_only

bool

האם הקמפיין משתמש רק בכתובות URL שסופקו על ידי המפרסם.

GeoTargetTypeSetting

מייצג אוסף של הגדרות שקשורות לטירגוט גיאוגרפי של מודעות.

שדות
positive_geo_target_type

PositiveGeoTargetType

ההגדרה שמשמשת לטירגוט גיאוגרפי חיובי בקמפיין הספציפי הזה.
negative_geo_target_type

NegativeGeoTargetType

ההגדרה שמשמשת לטירגוט גיאוגרפי שלילי בקמפיין הזה.

NetworkSettings

הגדרות הרשת של הקמפיין.

שדות
target_search_network

bool

האם המודעות יוצגו באתרים ברשת שותפי החיפוש של Google (נדרש שגם target_google_search יהיה true).
target_content_network

bool

האם המודעות יוצגו במיקומי מודעות ספציפיים ברשת המדיה של Google. מציינים את מיקומי המודעות באמצעות קריטריון מיקום המודעה.
target_partner_search_network

bool

האם המודעות יוצגו ברשת השותפים. האפשרות הזו זמינה רק בחלק מחשבונות השותפים. אלא אם קיבלתם הוראה להשתמש בשדה הזה, סביר להניח שהוא לא רלוונטי לחשבון שלכם. ההגדרה הזו לא קובעת אם המודעות יוצגו ברשת שותפי החיפוש של Google. כדי לעשות זאת, צריך להשתמש בהגדרה target_search_network.

OptimizationGoalSetting

הגדרת יעד האופטימיזציה של הקמפיין הזה, שכוללת קבוצה של סוגי יעדי אופטימיזציה.

שדות
optimization_goal_types[]

OptimizationGoalType

רשימת סוגי יעדי האופטימיזציה.

SelectiveOptimization

הגדרת האופטימיזציה הסלקטיבית לקמפיין הזה, שכוללת קבוצה של פעולות המרה שהמערכת תבצע עליהן אופטימיזציה בקמפיין הזה. התכונה הזו רלוונטית רק לקמפיינים לקידום אפליקציות שמוגדר בהם הערך MULTI_CHANNEL כ-AdvertisingChannelType והערך APP_CAMPAIGN או APP_CAMPAIGN_FOR_ENGAGEMENT כ-AdvertisingChannelSubType.

שדות
conversion_actions[]

string

הקבוצה שנבחרה של שמות משאבים של פעולות המרה לאופטימיזציה של הקמפיין הזה.

ShoppingSetting

ההגדרה לקמפיינים של שופינג. ההגדרה הזו מגדירה את קבוצת המוצרים שאפשר לפרסם בקמפיין, ואת אופן האינטראקציה של הקמפיין הזה עם קמפיינים אחרים של שופינג.

שדות
feed_label

string

תווית הפיד של המוצרים שרוצים לכלול בקמפיין. תוויות פיד תקינות יכולות להכיל עד 20 תווים, כולל אותיות רישיות, מספרים, מקפים וקווים תחתונים. אם השתמשתם בעבר בפורמט המופסק sales_country של קוד המדינה בן שתי האותיות (XX), עכשיו צריך להשתמש בשדה feed_label. מידע נוסף זמין במאמר העזרה בנושא תווית פיד.
use_vehicle_inventory

bool

האם לטרגט מלאי של מודעות למכירת רכבים.
merchant_id

int64

מספר החשבון ב-Merchant Center. חובה למלא את השדה הזה כשיוצרים פעולות. השדה הזה הוא קבוע בקמפיינים של שופינג.
sales_country

string

מדינת המכירה של המוצרים שרוצים לכלול בקמפיין.
campaign_priority

int32

העדיפות של הקמפיין. לקמפיינים עם עדיפות גבוהה יותר (מספר נמוך יותר) יש עדיפות על פני קמפיינים עם עדיפות נמוכה יותר. השדה הזה נדרש לקמפיינים של שופינג, והערכים האפשריים בו הם בין 0 ל-2, כולל. השדה הזה הוא אופציונלי בקמפיינים חכמים לשופינג, אבל אם הוא מוגדר, הערך שלו חייב להיות 3.
enable_local

bool

האם לכלול מוצרים בחנויות מקומיות.

TrackingSetting

הגדרות ברמת הקמפיין למעקב אחר מידע.

שדות
tracking_url

string

כתובת ה-URL שמשמשת למעקב דינמי.

CampaignAsset

קישור בין קמפיין לנכס.

שדות
resource_name

string

שם המשאב של נכס הקמפיין. שמות המשאבים של CampaignAsset הם מהצורה:

customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}
status

AssetLinkStatus

הסטטוס של נכס הקמפיין.
campaign

string

הקמפיין שהנכס מקושר אליו.
asset

string

הנכס שמקושר לקמפיין.

CampaignAssetSet

CampaignAssetSet הוא הקישור בין קמפיין לבין קבוצת נכסים. הוספה של CampaignAssetSet מקשרת קבוצת נכסים לקמפיין.

שדות
resource_name

string

שם המשאב של קבוצת הנכסים של הקמפיין. שמות המשאבים של נכסים בקבוצת נכסים הם מהצורה:

customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}
campaign

string

הקמפיין שאליו מקושרת קבוצת הנכסים הזו.
asset_set

string

קבוצת הנכסים שמקושרת לקמפיין.
status

AssetSetLinkStatus

הסטטוס של הנכס בקבוצת הנכסים של הקמפיין. קריאה בלבד.

CampaignAudienceView

תצוגת קהל ברמת הקמפיין. כולל נתוני ביצועים מתחומי עניין ומרשימות רימרקטינג עבור מודעות ברשת המדיה וברשת YouTube, ורשימות רימרקטינג עבור מודעות לרשת החיפוש (RLSA), שמצטברים לפי קמפיין וקריטריון קהל. בתצוגה הזו נכללים רק קהלים שמצורפים ברמת הקמפיין.

שדות
resource_name

string

שם המשאב של התצוגה של קהל הקמפיין. הפורמט של שמות המשאבים של תצוגת הקהל ברמת הקמפיין הוא:

customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}

CampaignBudget

תקציב הקמפיין.

שדות
resource_name

string

שם המשאב של תקציב הקמפיין. שמות המשאבים של תקציבי הקמפיינים הם מהצורה:

customers/{customer_id}/campaignBudgets/{campaign_budget_id}
delivery_method

BudgetDeliveryMethod

שיטת הצגת המודעות שקובעת את קצב ניצול התקציב של הקמפיין.

אם לא מציינים ערך בפעולת יצירה, ברירת המחדל היא STANDARD.
period

BudgetPeriod

התקופה שבמהלכה התקציב ינוצל. אם לא מציינים ערך, ברירת המחדל היא DAILY.
amount_micros

int64

הסכום היומי הממוצע שהקמפיין יוציא. השדה הזה משמש כשהתקציב של הקמפיין period מוגדר לערך DAILY, שהוא ברירת המחדל.

הסכום מצוין במיליוניות במטבע המקומי של החשבון. מיליון מיקרו שווה ליחידת מטבע אחת. ההוצאה החודשית בפועל מוגבלת לסכום היומי הזה כפול 30.4.

השדה הזה בלעדי לשדה total_amount_micros. צריך להגדיר רק אחד מהמאפיינים amount_micros או total_amount_micros.

CampaignCriterion

קריטריון של קמפיין.

שדות
resource_name

string

שם המשאב של קריטריון הקמפיין. הפורמט של שמות המשאבים של קריטריונים לקמפיין הוא:

customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}
display_name

string

השם המוצג של הקריטריון.

המערכת מתעלמת מהשדה הזה בשינויים.
type

CriterionType

סוג הקריטריון.
status

CampaignCriterionStatus

הסטטוס של הקריטריון.
last_modified_time

string

התאריך והשעה שבהם שונה לאחרונה הקריטריון הזה לקמפיין. התאריך והשעה הם באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss.ssssss.
criterion_id

int64

המזהה של הקריטריון.

המערכת מתעלמת מהשדה הזה במהלך שינוי.
bid_modifier

float

המשנה של הצעות המחיר כשהקריטריון תואם. המשנה חייב להיות בטווח: 0.1 עד 10.0. רוב סוגי הקריטריונים לטירגוט תומכים בשינויים. כדי לבטל את ההסכמה לסוג מכשיר מסוים, משתמשים בערך 0.
negative

bool

האם לטרגט (false) את הקריטריון או להחריג (true) אותו.

שדה איחוד criterion. קריטריון הקמפיין.

חובה להגדיר בדיוק אחד מהם. הערך criterion יכול להיות רק אחד מהבאים:
keyword

KeywordInfo

מילת מפתח.
location

LocationInfo

מיקום.
device

DeviceInfo

מכשיר.
age_range

AgeRangeInfo

טווח גילאים.
gender

GenderInfo

מגדר.
user_list

UserListInfo

רשימת משתמשים.
language

LanguageInfo

שפה.
webpage

WebpageInfo

דף אינטרנט.
location_group

LocationGroupInfo

קבוצה לפי מיקום

CampaignEffectiveLabel

מייצג קשר בין קמפיין לבין תווית יעילה. תווית אפקטיבית היא תווית שעברה בירושה או שהוקצתה ישירות לקמפיין הזה.

שדות
resource_name

string

שם המשאב. שמות המשאבים של CampaignEffectivelabel הם מהצורה: customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}
campaign

string

הקמפיין שאליו מצורפת התווית הפעילה.
label

string

התווית האפקטיבית שהוקצתה לקמפיין.
owner_customer_id

int64

המזהה של הלקוח שהוא הבעלים של התווית האפקטיבית.

CampaignLabel

מייצג קשר בין קמפיין לתווית.

שדות
resource_name

string

שם המשאב. שמות המשאבים של תוויות הקמפיינים הם מהצורה: customers/{owner_customer_id}/campaignLabels/{campaign_id}~{label_id}
campaign

string

הקמפיין שאליו התווית מצורפת.
label

string

התווית שהוקצתה לקמפיין.
owner_customer_id

int64

המזהה של הלקוח שהוא הבעלים של התווית.

CartDataSalesView

תצוגת מכירות לפי נתוני עגלות קניות.

אם הטמעתם המרות עם נתונים מעגלות קניות (CwCD), תוכלו לראות מידע על המוצרים שנרכשו. מדדי ביצועים כמו הכנסות, רווח ברוטו, מדדי לידים/מכירות צולבות וכו', ומאפיינים של Merchant Center כמו מותג, קטגוריה וכו', זמינים למוצרים שמוגדרים בפיד מלאי ונמכרים כתוצאה ממודעות Google. לרכישות שמשויכות לקליקים על מודעות שופינג, אפשר לראות יחד את המאפיינים של המוצרים שעליהם לחצו ושל המוצרים שנמכרו.

שדות
resource_name

string

שם המשאב של תצוגת המכירות של נתוני עגלות הקניות. שמות המשאבים של תצוגת המכירות של נתוני עגלות הקניות הם בפורמט: customers/{customer_id}/cartDataSalesView

המרה

המרה.

שדות
resource_name

string

שם המשאב של ההמרה. שמות משאבי ההמרות הם מהצורה:

customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}
id

int64

המזהה של ההמרה
criterion_id

int64

מזהה קריטריון ב-Search Ads 360. ערך של 0 מציין שהקריטריון לא משויך.
merchant_id

int64

מזהה חשבון המלאי ב-Search Ads 360 שמכיל את המוצר שלחצו עליו. מערכת Search Ads 360 יוצרת את המזהה הזה כשמקשרים חשבון מלאי ב-Search Ads 360.
ad_id

int64

מזהה המודעה. ערך של 0 מציין שהמודעה לא משויכת.
click_id

string

מחרוזת ייחודית של הביקור שההמרה משויכת אליו, שמועברת לדף הנחיתה כפרמטר של כתובת ה-URL של מזהה הקליק.
visit_id

int64

מזהה הביקור ב-Search Ads 360 שההמרה משויכת אליו.
advertiser_conversion_id

string

בהמרות אופליין, זהו מזהה שמסופק על ידי המפרסמים. אם המפרסם לא מציין מזהה כזה, מערכת Search Ads 360 יוצרת מזהה. עבור המרות אונליין, הערך הזה שווה לערך בעמודה id או בעמודה floodlight_order_id, בהתאם להוראות של המפרסם לגבי Floodlight.
product_id

string

המזהה של המוצר שעליו לחץ המשתמש.
product_channel

ProductChannel

ערוץ המכירות של המוצר שלחצו עליו: אונליין או מקומי.
product_language_code

string

השפה (ISO-639-1) שהוגדרה בפיד Merchant Center שמכיל נתונים על המוצר.
product_store_id

string

החנות שמוצגת במודעת המלאי של החנות המקומית שעליה לחץ המשתמש. המזהה הזה צריך להיות זהה למזהים של החנויות שמופיעים בפיד המוצרים של החנויות המקומיות.
product_country_code

string

המדינה (בפורמט ISO-3166) שרשומה בפיד המלאי שמכיל את המוצר שעליו לחץ המשתמש.
attribution_type

AttributionType

למה ההמרה משויכת: ביקור או מילת מפתח + מודעה.
conversion_date_time

string

חותמת הזמן של אירוע ההמרה.
conversion_last_modified_date_time

string

חותמת הזמן של הפעם האחרונה שבה ההמרה שונתה.
conversion_visit_date_time

string

חותמת הזמן של הביקור שההמרה משויכת אליו.
conversion_quantity

int64

כמות הפריטים שתועדה בהמרה, כפי שנקבעה על ידי פרמטר כתובת ה-URL ‏qty. המפרסם אחראי לאכלוס הפרמטר באופן דינמי (למשל מספר הפריטים שנמכרו בהמרה), אחרת ערך ברירת המחדל הוא 1.
conversion_revenue_micros

int64

ההכנסה המותאמת במיקרו לאירוע ההמרה. המטבע הזה יהיה תמיד המטבע של חשבון להצגת מודעות.
floodlight_original_revenue

int64

ההכנסה המקורית שלא השתנתה שמשויכת לאירוע ב-Floodlight (במטבע של הדוח הנוכחי), לפני השינויים בהוראות המטבע ב-Floodlight.
floodlight_order_id

string

מזהה ההזמנה ב-Floodlight שסופק על ידי המפרסם להמרה.
status

ConversionStatus

הסטטוס של ההמרה, ENABLED או REMOVED.
asset_id

int64

המזהה של הנכס שהייתה איתו אינטראקציה במהלך אירוע ההמרה.
asset_field_type

AssetFieldType

סוג השדה של נכס באירוע ההמרה.

ConversionAction

פעולת המרה.

שדות
resource_name

string

שם המשאב של פעולת ההמרה. שמות המשאבים של פעולות ההמרה הם מהצורה:

customers/{customer_id}/conversionActions/{conversion_action_id}
creation_time

string

חותמת הזמן של יצירת הפעילות ב-Floodlight, בפורמט ISO 8601.
status

ConversionActionStatus

הסטטוס של פעולת ההמרה הזו לגבי צבירה של אירועי המרה.
type

ConversionActionType

הסוג של פעולת ההמרה הזו.
category

ConversionActionCategory

הקטגוריה של ההמרות שמדווחות עבור פעולת ההמרה הזו.
value_settings

ValueSettings

הגדרות שקשורות לערך של אירועי המרה שמשויכים לפעולת ההמרה הזו.
attribution_model_settings

AttributionModelSettings

הגדרות שקשורות למודל השיוך של פעולת ההמרה הזו.
floodlight_settings

FloodlightSettings

הגדרות Floodlight לסוגי המרות ב-Floodlight.
id

int64

המזהה של פעולת ההמרה.
name

string

השם של פעולת ההמרה.

חובה למלא את השדה הזה כשיוצרים פעולות המרה חדשות.
primary_for_goal

bool

אם הביט primary_for_goal של פעולת המרה הוא false, אי אפשר להגיש הצעות מחיר על פעולת ההמרה הזו בכל הקמפיינים, בלי קשר ליעד ההמרה של הלקוח או ליעד ההמרה של הקמפיין. עם זאת, יעדי המרה מותאמים אישית לא מתייחסים לערך primary_for_goal, ולכן אם בקמפיין מוגדר יעד המרה מותאם אישית עם פעולת המרה שמוגדרת כ-primary_for_goal = false, עדיין אפשר להגיש הצעות מחיר על פעולת ההמרה הזו. אם לא מגדירים את הפרמטר primary_for_goal, ברירת המחדל היא true. בגרסה 9, אפשר להגדיר את הערך של primary_for_goal כ-false רק אחרי היצירה באמצעות פעולת update, כי הוא לא מוצהר כאופציונלי.
owner_customer

string

שם המשאב של הלקוח שהוא הבעלים של פעולת ההמרה, או null אם זו פעולת המרה שהוגדרה על ידי המערכת.
include_in_client_account_conversions_metric

bool

האם פעולת ההמרה הזו צריכה להיכלל במדד client_account_conversions.
include_in_conversions_metric

bool

האם פעולת ההמרה הזו צריכה להיכלל במדד 'המרות'.
click_through_lookback_window_days

int64

מספר הימים המקסימלי שיכול לחלוף בין אינטראקציה (לדוגמה, קליק) לבין אירוע המרה.
app_id

string

מזהה האפליקציה של פעולת המרה באפליקציה.

AttributionModelSettings

הגדרות שקשורות למודל השיוך של פעולת ההמרה הזו.

שדות
attribution_model

AttributionModel

סוג מודל השיוך של פעולת ההמרה הזו.
data_driven_model_status

DataDrivenModelStatus

הסטטוס של מודל השיוך מבוסס-הנתונים לפעולת ההמרה.

FloodlightSettings

הגדרות שקשורות לפעולת המרה ב-Floodlight.

שדות
activity_group_tag

string

מחרוזת שמשמשת לזיהוי קבוצת פעילות ב-Floodlight כשמדווחים על המרות.
activity_tag

string

מחרוזת שמשמשת לזיהוי פעילות ב-Floodlight כשמדווחים על המרות.
activity_id

int64

המזהה של פעילות ב-Floodlight ב-DoubleClick Campaign Manager‏ (DCM).

ValueSettings

הגדרות שקשורות לערך של אירועי המרה שמשויכים לפעולת ההמרה הזו.

שדות
default_value

double

הערך שבו יש להשתמש כשאירועי המרה של פעולת ההמרה הזו נשלחים עם ערך לא תקין, לא מותר או חסר, או כשפעולת ההמרה הזו מוגדרת להשתמש תמיד בערך ברירת המחדל.
default_currency_code

string

קוד המטבע שבו יש להשתמש כשאירועי המרה של פעולת ההמרה הזו נשלחים עם קוד מטבע לא תקין או חסר, או כשפעולת ההמרה הזו מוגדרת להשתמש תמיד בערך ברירת המחדל.
always_use_default_value

bool

ההגדרה הזו קובעת אם להשתמש בערך ברירת המחדל ובקוד ברירת המחדל של המטבע במקום בערך ובקוד המטבע שצוינו באירועי ההמרה עבור פעולת ההמרה הזו.

ConversionCustomVariable

משתנה מותאם אישית של המרה. מידע נוסף על מדדים ומאפיינים מותאמים אישית של Floodlight בממשק החדש של Search Ads 360 זמין בכתובת https://support.google.com/sa360/answer/13567857

שדות
resource_name

string

שם המשאב של המשתנה המותאם אישית להמרה. שמות המשאבים של משתני המרה מותאמים אישית הם מהצורה:

customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}
id

int64

המזהה של משתנה מותאם אישית להמרה.
name

string

חובה. השם של המשתנה המותאם אישית להמרה. השם צריך להיות ייחודי. האורך המקסימלי של השם הוא 100 תווים. אסור שיהיו רווחים מיותרים לפני ואחרי.
tag

string

חובה. התג של משתנה מותאם אישית להמרה. התג צריך להיות ייחודי ולהתחיל בתו 'u' שאחריו מופיע מספר שהוא 100 או פחות. לדוגמה: "u4".
status

ConversionCustomVariableStatus

הסטטוס של המשתנה המותאם אישית להמרות לצורך צבירה של אירועי המרה.
owner_customer

string

שם המשאב של הלקוח שבבעלותו המשתנה המותאם אישית של ההמרה.
family

ConversionCustomVariableFamily

המשפחה של משתנה ההמרה המותאם אישית.
cardinality

ConversionCustomVariableCardinality

העוצמה של משתנה ההמרה המותאם אישית.
floodlight_conversion_custom_variable_info

FloodlightConversionCustomVariableInfo

שדות למשתנים מותאמים אישית של המרות Floodlight ב-Search Ads 360.
custom_column_ids[]

int64

מזהי העמודות בהתאמה אישית שמשתמשות במשתנה המותאם אישית הזה של ההמרה.

FloodlightConversionCustomVariableInfo

מידע על משתנים מותאמים אישית של המרות Floodlight ב-Search Ads 360.

שדות
floodlight_variable_type

FloodlightVariableType

סוג המשתנה של Floodlight שמוגדר ב-Search Ads 360.
floodlight_variable_data_type

FloodlightVariableDataType

סוג הנתונים של משתנה Floodlight שהוגדר ב-Search Ads 360.

ConversionTrackingSetting

אוסף של הגדרות ברמת הלקוח שקשורות למעקב המרות ב-Search Ads 360.

שדות
accepted_customer_data_terms

bool

האם הלקוח אישר את התנאים לאיסוף נתוני לקוחות ושימוש בהם. אם משתמשים במעקב המרות ברמת חשבון ניהול, הערך הזה עובר בירושה מחשבון הניהול. השדה הזה הוא לקריאה בלבד. מידע נוסף זמין בכתובת https://support.google.com/adspolicy/answer/7475709.
conversion_tracking_status

ConversionTrackingStatus

סטטוס מעקב ההמרות. העמודה הזו מציינת אם הלקוח משתמש במעקב המרות, ומי הבעלים של מעקב ההמרות של הלקוח הזה. אם הלקוח הזה משתמש במעקב המרות ברמת חשבון ניהול, הערך שיוחזר יהיה שונה בהתאם ל-login-customer-id של הבקשה.
enhanced_conversions_for_leads_enabled

bool

האם הלקוח הסכים לשימוש בהמרות משופרות לצורך שיוך ללידים. אם משתמשים במעקב המרות ברמת חשבון ניהול, הערך הזה עובר בירושה מחשבון הניהול. השדה הזה הוא לקריאה בלבד.
google_ads_conversion_customer

string

שם המשאב של הלקוח שבו נוצרות ומנוהלות ההמרות. השדה הזה הוא לקריאה בלבד.
conversion_tracking_id

int64

מזהה מעקב ההמרות שמשמש בחשבון הזה. המזהה הזה לא מציין אם הלקוח משתמש במעקב המרות (הסטטוס conversion_tracking_status כן מציין זאת). השדה הזה הוא לקריאה בלבד.
google_ads_cross_account_conversion_tracking_id

int64

מזהה מעקב ההמרות של חשבון הניהול של הלקוח. הערך הזה מוגדר כשהלקוח מביע הסכמה להפעלת מעקב המרות, והוא מבטל את הערך של conversion_tracking_id. אפשר לנהל את השדה הזה רק דרך ממשק המשתמש של Google Ads. השדה הזה הוא לקריאה בלבד.
cross_account_conversion_tracking_id

int64

מזהה מעקב ההמרות של חשבון הניהול של הלקוח. הערך הזה מוגדר כשהלקוח מפעיל מעקב המרות ברמת חשבון ניהול, והוא מבטל את הערך של conversion_tracking_id.

CustomColumn

עמודה בהתאמה אישית. אפשר לעיין במאמר בנושא עמודות בהתאמה אישית ב-Search Ads 360 בכתובת https://support.google.com/sa360/answer/9633916

שדות
resource_name

string

שם המשאב של העמודה המותאמת אישית. הפורמט של שמות המשאבים של עמודות בהתאמה אישית הוא:

customers/{customer_id}/customColumns/{custom_column_id}
id

int64

המזהה של העמודה בהתאמה אישית.
name

string

שם שהמשתמש נתן לעמודה בהתאמה אישית.
description

string

תיאור שהמשתמש מגדיר לעמודה המותאמת אישית.
value_type

CustomColumnValueType

סוג ערך התוצאה של העמודה בהתאמה אישית.
references_attributes

bool

הערך True אם העמודה המותאמת אישית מתייחסת למאפיין אחד או יותר.
references_metrics

bool

הערך הוא True אם העמודה המותאמת אישית מתייחסת למדד אחד או יותר.
queryable

bool

הערך הוא True אם העמודה בהתאמה אישית זמינה לשימוש בשאילתה של SearchAds360Service.Search ו-SearchAds360Service.SearchStream.
referenced_system_columns[]

string

רשימת עמודות המערכת שאליהן מפנה העמודה בהתאמה אישית הזו. לדוגמה, בעמודה מותאמת אישית 'סכום החשיפות והקליקים' יש הפניה לעמודות מערכת של {"metrics.clicks", "metrics.impressions"}.
render_type

CustomColumnRenderType

איך צריך לפרש את ערך התוצאה של העמודה בהתאמה אישית.

לקוח

לקוח.

שדות
resource_name

string

שם המשאב של הלקוח. שמות המשאבים של הלקוחות הם מהצורה:

customers/{customer_id}
conversion_tracking_setting

ConversionTrackingSetting

הגדרת מעקב ההמרות של לקוח.
account_type

AccountType

סוג חשבון מנוע החיפוש, לדוגמה, Google Ads,‏ Microsoft Advertising,‏ Yahoo Japan,‏ Baidu,‏ Facebook,‏ Engine Track וכו'.
double_click_campaign_manager_setting

DoubleClickCampaignManagerSetting

הגדרה של DoubleClick Campaign Manager ‏ (DCM) עבור לקוח ניהול.
account_status

AccountStatus

סטטוס החשבון, למשל: מופעל, מושהה, הוסר וכו'.
last_modified_time

string

התאריך והשעה שבהם בוצע השינוי האחרון בפרטי הלקוח. התאריך והשעה הם באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss.ssssss.
engine_id

string

המזהה של החשבון בחשבון המנוע החיצוני.
status

CustomerStatus

הסטטוס של הלקוח.
creation_time

string

חותמת הזמן שבה הלקוח הזה נוצר. חותמת הזמן היא באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss.
manager_id

int64

מספר הלקוח של חשבון הניהול. הערך 0 מציין שללקוח אין חשבון ניהול ב-SA360.
manager_descriptive_name

string

השם התיאורי של חשבון הניהול.
sub_manager_id

int64

מספר הלקוח של חשבון הניהול המשני. ערך של 0 מציין שללקוח אין חשבון ניהול משני ב-SA360.
sub_manager_descriptive_name

string

השם התיאורי של חשבון הניהול המשני.
associate_manager_id

int64

מספר הלקוח של חשבון ניהול משני לשותפים. ערך של 0 מציין שללקוח אין חשבון ניהול משני לשותפים ב-SA360.
associate_manager_descriptive_name

string

השם התיאורי של חשבון ניהול משני לשותפים.
account_level

AccountLevelType

רמת החשבון של הלקוח: חשבון ניהול, חשבון ניהול משני, חשבון ניהול משני לשותפים, חשבון שירות.
id

int64

מזהה הלקוח.
descriptive_name

string

שם תיאורי אופציונלי של הלקוח, לא ייחודי.
currency_code

string

המטבע שבו מתנהלת הפעילות בחשבון. מערכת Google תומכת בחלק מקודי המטבע בתקן ISO 4217.
time_zone

string

מזהה אזור הזמן המקומי של הלקוח.
tracking_url_template

string

תבנית של כתובת URL ליצירת כתובת URL למעקב מפרמטרים.
final_url_suffix

string

תבנית כתובת ה-URL להוספת פרמטרים לכתובת ה-URL הסופית.
auto_tagging_enabled

bool

האם התיוג האוטומטי מופעל עבור הלקוח.
manager

bool

האם הלקוח הוא חשבון ניהול.

CustomerAsset

קישור בין לקוח לבין נכס.

שדות
resource_name

string

שם המשאב של נכס הלקוח. שמות המשאבים של CustomerAsset הם מהצורה:

customers/{customer_id}/customerAssets/{asset_id}~{field_type}
asset

string

חובה. הנכס שמקושר ללקוח.
status

AssetLinkStatus

הסטטוס של נכס הלקוח.

CustomerAssetSet

‫CustomerAssetSet הוא הקישור בין לקוח לבין קבוצת נכסים. הוספה של CustomerAssetSet מקשרת בין קבוצת נכסים לבין לקוח.

שדות
resource_name

string

שם המשאב של קבוצת נכסי הלקוח. שמות המשאבים של נכסים בקבוצת נכסים הם מהצורה:

customers/{customer_id}/customerAssetSets/{asset_set_id}
asset_set

string

קבוצת הנכסים שמקושרת ללקוח.
customer

string

הלקוח שאליו מקושרת קבוצת הנכסים הזו.
status

AssetSetLinkStatus

הסטטוס של הנכס של קבוצת הנכסים של הלקוח. קריאה בלבד.

CustomerClient

קישור בין הלקוח שצוין לבין לקוח אחר. האובייקט CustomerClients קיים רק עבור לקוחות ניהול. כל הלקוחות הישירים והעקיפים כלולים, וגם חשבון הניהול עצמו.

שדות
resource_name

string

שם המשאב של לקוח הלקוח. שמות המשאבים של CustomerClient הם בפורמט: customers/{customer_id}/customerClients/{client_customer_id}
applied_labels[]

string

שמות המשאבים של התוויות שבבעלות הלקוח ששולח את הבקשה, שמוחלות על לקוח הקמפיין. שמות המשאבים של התוויות הם מהצורה:

customers/{customer_id}/labels/{label_id}
status

CustomerStatus

הסטטוס של הלקוח. קריאה בלבד.
client_customer

string

שם המשאב של לקוח שמקושר ללקוח הנתון. קריאה בלבד.
hidden

bool

השדה מציין אם החשבון מוסתר.

קריאה בלבד.
level

int64

המרחק בין הלקוח לבין הלקוח שצוין. בקישור עצמי, ערך הרמה יהיה 0. קריאה בלבד.
time_zone

string

ייצוג מחרוזת של אזור הזמן של הלקוח במאגר CLDR (Common Locale Data Repository). לדוגמה, America/Los_Angeles. קריאה בלבד.
test_account

bool

העמודה מציינת אם חשבון הלקוח הוא חשבון בדיקה. קריאה בלבד.
manager

bool

מציין אם חשבון הלקוח הוא חשבון ניהול. קריאה בלבד.
descriptive_name

string

שם תיאורי של הלקוח. קריאה בלבד.
currency_code

string

קוד המטבע (לדוגמה, USD,‏ EUR) של הלקוח. קריאה בלבד.
id

int64

המזהה של הלקוח. קריאה בלבד.

DoubleClickCampaignManagerSetting

הגדרה של DoubleClick Campaign Manager ‏ (DCM) עבור לקוח ניהול.

שדות
advertiser_id

int64

המזהה של המפרסם ב-Campaign Manager שמשויך ללקוח הזה.
network_id

int64

המזהה של רשת Campaign Manager שמשויכת ללקוח הזה.
time_zone

string

אזור הזמן של הרשת ב-Campaign Manager שמשויך ללקוח הזה, בפורמט של מסד הנתונים של אזורי הזמן של IANA, כמו America/New_York.

DynamicSearchAdsSearchTermView

תצוגה של מונחי חיפוש של מודעות דינמיות לרשת החיפוש.

שדות
resource_name

string

שם המשאב של תצוגת מונחי החיפוש של מודעות דינמיות לרשת החיפוש. שמות המשאבים של תצוגת מונחי החיפוש של מודעות דינמיות לרשת החיפוש הם מהצורה:

customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}
landing_page

string

כתובת דף הנחיתה שנבחרה באופן דינמי לחשיפה.

השדה הזה הוא לקריאה בלבד.

GenderView

משאב של תצוגת מגדר. המדד הזה מייצג את מדדי הביצועים של לקוח שמצטברים לפי מגדר. כל הנתונים הסטטיסטיים נצברים ברמת קבוצת המודעות.

הערה: אפשר לפלח מדדים לפי טווח גילאים באמצעות age_range_view או לפי מגדר באמצעות gender_view, אבל Search Ads 360 API לא תומך בפילוח מדדים לפי טווח גילאים ומגדר בו-זמנית בשאילתה אחת. אין תמיכה בניתוח הביצועים בשילוב של שני המאפיינים ב-Search Ads 360 API.

שדות
resource_name

string

שם המשאב של תצוגת המגדר. שמות המשאבים של תצוגת המגדר הם מהצורה:

customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}

GeoTargetConstant

קבוע של מיקוד גיאוגרפי.

שדות
resource_name

string

שם המשאב של קבוע היעד הגיאוגרפי. שמות המשאבים של קבועי מיקום גיאוגרפי לטירגוט הם מהצורה:

geoTargetConstants/{geo_target_constant_id}
status

GeoTargetConstantStatus

הסטטוס של קבוע המיקוד הגיאוגרפי.
id

int64

המזהה של הקבוע של הטירגוט הגיאוגרפי.
name

string

שם קבוע של מיקוד גיאוגרפי באנגלית.
country_code

string

קוד המדינה בפורמט ISO-3166-1 alpha-2 שמשויך ליעד.
target_type

string

סוג הטירגוט הקבוע של המיקוד הגיאוגרפי.
canonical_name

string

השם המלא באנגלית, שכולל את שם היעד, שם ההורה והמדינה.
parent_geo_target

string

שם המשאב של קבוע היעד הגיאוגרפי של ההורה. שמות המשאבים של קבועי מיקום גיאוגרפי לטירגוט הם מהצורה:

geoTargetConstants/{parent_geo_target_constant_id}

KeywordView

תצוגת מילות מפתח.

שדות
resource_name

string

שם המשאב של תצוגת מילות המפתח. שמות המשאבים של תצוגת מילות המפתח הם מהצורה:

customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

תווית

תווית.

שדות
resource_name

string

שם המשאב. שמות המשאבים של התוויות הם מהצורה: customers/{owner_customer_id}/labels/{label_id}
status

LabelStatus

הסטטוס של התווית. קריאה בלבד.
text_label

TextLabel

סוג של תווית שבה מוצג טקסט על רקע צבעוני.
id

int64

המזהה של התווית. קריאה בלבד.
name

string

שם התווית.

כשיוצרים תווית חדשה, חובה למלא את השדה הזה.

אורך המחרוזת צריך להיות בין 1 ל-80, כולל.

LanguageConstant

שפה.

שדות
resource_name

string

שם המשאב של הקבוע של השפה. שמות המשאבים של קבועי השפה הם מהצורה:

languageConstants/{criterion_id}
id

int64

המזהה של קבוע השפה.
code

string

קוד השפה, למשל en_US,‏ en_AU,‏ es,‏ fr וכו'.
name

string

השם המלא של השפה באנגלית, לדוגמה, 'English (US)',‏ 'Spanish' וכו'.
targetable

bool

האם אפשר לטרגט את השפה.

ListingGroupFilterDimension

מאפייני כרטיסי מוצר למסנן קבוצות של כרטיסי מוצר בנכסים דיגיטליים.

שדות
שדה איחוד dimension. תמיד מופיע מימד מאחד מהסוגים הבאים. הערך dimension יכול להיות רק אחד מהבאים:
product_bidding_category

ProductBiddingCategory

קטגוריית הבידינג של מוצר.
product_brand

ProductBrand

המותג של המוצר.
product_channel

ProductChannel

המיקום של מוצר למכירה.
product_condition

ProductCondition

מצב המוצר במבצע.
product_custom_attribute

ProductCustomAttribute

מאפיין מותאם אישית של מוצר במבצע.
product_item_id

ProductItemId

מזהה הפריט של מוצר במבצע.
product_type

ProductType

סוג מבצע על מוצר.

ProductBiddingCategory

רכיב אחד של קטגוריית בידינג ברמה מסוימת. קטגוריות ברמה העליונה הן ברמה 1, קטגוריות המשנה שלהן ברמה 2 וכן הלאה. בשלב הזה אנחנו תומכים בעד 5 רמות. המשתמש צריך לציין סוג מאפיין שמציין את רמת הקטגוריה. כל המקרים של אותה חלוקת משנה חייבים להיות מאותו סוג מאפיין (רמת הקטגוריה).

שדות
level

ListingGroupFilterBiddingCategoryLevel

מציין את הרמה של הקטגוריה בטקסונומיה.
id

int64

המזהה של קטגוריית הבידינג על המוצר.

המזהה הזה שווה למזהה של מאפיין קטגוריית המוצר ב-Google, כפי שמתואר במאמר הזה: https://support.google.com/merchants/answer/6324436

ProductBrand

המותג של המוצר.

שדות
value

string

ערך המחרוזת של מותג המוצר.

ProductChannel

המיקום של מוצר למכירה.

שדות
channel

ListingGroupFilterProductChannel

ערך המיקום.

ProductCondition

מצב המוצר בהצעה.

שדות
condition

ListingGroupFilterProductCondition

ערך התנאי.

ProductCustomAttribute

מאפיין מותאם אישית של מוצר במבצע.

שדות
index

ListingGroupFilterCustomAttributeIndex

מציין את האינדקס של המאפיין המותאם אישית.
value

string

ערך המחרוזת של מאפיין מותאם אישית של המוצר.

ProductItemId

מזהה הפריט של מוצר במבצע.

שדות
value

string

הערך של המזהה.

ProductType

סוג מבצע על מוצר.

שדות
level

ListingGroupFilterProductTypeLevel

הרמה של הסוג.
value

string

הערך של הסוג.

ListingGroupFilterDimensionPath

הנתיב להגדרת מאפיינים שמגדירים מסנן של קבוצה של כרטיסי מוצר.

שדות
dimensions[]

ListingGroupFilterDimension

הנתיב המלא של המאפיינים דרך ההיררכיה של מסנני קבוצות של כרטיסי מוצר (לא כולל צומת הבסיס) אל מסנן קבוצה של כרטיסי מוצר זה.

LocationView

בתצוגת מיקום מוצג סיכום של ביצועי הקמפיינים לפי קריטריון מיקום.

שדות
resource_name

string

שם המשאב של תצוגת המיקום. שמות המשאבים של תצוגת המיקום הם מהצורה:

customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}

ProductBiddingCategoryConstant

קטגוריית בידינג על מוצר.

שדות
resource_name

string

שם המשאב של קטגוריית הבידינג על המוצר. שמות המשאבים של קטגוריות הבידינג על מוצרים הם מהצורה:

productBiddingCategoryConstants/{country_code}~{level}~{id}
level

ProductBiddingCategoryLevel

הרמה של קטגוריית הבידינג על המוצר.
status

ProductBiddingCategoryStatus

הסטטוס של קטגוריית הבידינג על המוצר.
id

int64

המזהה של קטגוריית הבידינג על המוצר.

המזהה הזה מקביל למזהה של מאפיין קטגוריית המוצר ב-Google, כפי שמתואר במאמר הזה: https://support.google.com/merchants/answer/6324436.
country_code

string

קוד מדינה בן 2 אותיות רישיות של קטגוריית הבידינג על המוצר.
product_bidding_category_constant_parent

string

שם המשאב של קטגוריית הבידינג של מוצר האב.
language_code

string

קוד השפה של קטגוריית הבידינג על המוצר.
localized_name

string

ערך התצוגה של קטגוריית הבידינג של המוצר, שעבר לוקליזציה בהתאם ל-language_code.

ProductGroupView

תצוגה של קבוצת מוצרים.

שדות
resource_name

string

שם המשאב של התצוגה של קבוצת המוצרים. שמות המשאבים של תצוגת קבוצת מוצרים הם מהצורה:

customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

SearchAds360Field

שדה או משאב (ארטיפקט) שנמצאים בשימוש ב-SearchAds360Service.

שדות
resource_name

string

שם המשאב של הארטיפקט. שמות המשאבים של הארטיפקטים הם מהצורה:

SearchAds360Fields/{name}
category

SearchAds360FieldCategory

הקטגוריה של הארטיפקט.
selectable_with[]

string

השמות של כל המשאבים, הפלחים והמדדים שאפשר לבחור באמצעות הארטיפקט המתואר.
attribute_resources[]

string

השמות של כל המשאבים שאפשר לבחור באמצעות הארטיפקט המתואר. כשכוללים בשאילתות חיפוש שדות מהמשאבים האלה, המדדים לא מפולחים.

השדה הזה מוגדר רק לארטיפקטים שהקטגוריה שלהם היא RESOURCE.
metrics[]

string

בשדה הזה מפורטים השמות של כל המדדים שאפשר לבחור כשמשתמשים בארטיפקט המתואר במשפט FROM. המאפיין הזה מוגדר רק לארטיפקטים שהקטגוריה שלהם היא RESOURCE.
segments[]

string

בשדה הזה מופיעים השמות של כל הארטיפקטים, בין אם מדובר בפלח או במשאב אחר, שמגדירים מדדים של פלח כשהם נכללים בשאילתות חיפוש וכשהארטיפקט המתואר נמצא בשימוש בסעיף FROM. המאפיין הזה מוגדר רק לארטיפקטים שהקטגוריה שלהם היא RESOURCE.
enum_values[]

string

הערכים שהארטיפקט יכול לקבל אם הוא שדה מסוג ENUM.

השדה הזה מוגדר רק לארטיפקטים בקטגוריה SEGMENT או ATTRIBUTE.
data_type

SearchAds360FieldDataType

השדה הזה קובע את האופרטורים שאפשר להשתמש בהם עם הארטיפקט בסעיפי WHERE.
name

string

שם הארטיפקט.
selectable

bool

האם ניתן להשתמש בארטיפקט במשפט SELECT בשאילתות חיפוש.
filterable

bool

האם אפשר להשתמש בארטיפקט במשפט WHERE בשאילתות חיפוש.
sortable

bool

האם ניתן להשתמש בארטיפקט במשפט ORDER BY בשאילתות חיפוש.
type_url

string

כתובת ה-URL של קובץ ה-proto שמתאר את סוג הנתונים של הארטיפקט.
is_repeated

bool

האם הארטיפקט של השדה חוזר.

ShoppingPerformanceView

תצוגת ביצועים בקניות.

הדוח מספק נתונים סטטיסטיים מצטברים של קמפיינים לשופינג וקמפיינים למיקסום הביצועים בכמה רמות של מאפייני מוצרים. הערכים של מאפייני המוצרים מ-Merchant Center, כמו מותג, קטגוריה, מאפיינים מותאמים אישית, מצב מוצר וסוג מוצר, ישקפו את המצב של כל מאפיין נכון לתאריך ולשעה שבהם האירוע המתאים נרשם.

יכול להיות שמספר החשיפות והקליקים שshopping_performance_view מחזיר לגביהם נתונים סטטיסטיים יהיה שונה מהמספרים בדוחות הקמפיין. shopping_performance_view מציג חשיפות וקליקים על מוצרים שמופיעים במודעות, בעוד שדוחות הקמפיין מציגים חשיפות וקליקים על המודעות עצמן. בהתאם לפורמט, במודעה יכולים להופיע אפס עד כמה מוצרים, ולכן יכול להיות שהמספרים לא יהיו זהים.

בממשק המשתמש של Search Ads 360, אפשר לשלוח שאילתות לגבי חשיפות וקליקים של מוצרים שמופיעים במודעות על ידי בחירת עמודה מתוך 'מאפייני מוצר' בכלי הדוחות. לדוגמה, בחירה בעמודה 'מותג' שקולה לבחירה באפשרות segments.product_brand.

שדות
resource_name

string

שם המשאב של תצוגת הביצועים בקניות. הפורמט של שמות המשאבים של תצוגת הביצועים בקניות הוא: customers/{customer_id}/shoppingPerformanceView

UserList

רשימת משתמשים. זוהי רשימה של משתמשים שלקוח יכול לטרגט. המפתח הייחודי של רשימת משתמשים מורכב מהשדות הבאים: id. שימו לב שגם הערך של name צריך להיות ייחודי לרשימות משתמשים שבבעלות לקוח מסוים, למעט במקרים מסוימים שבהם הערך של access_reason מוגדר כ-SHARED. אם השם לא ייחודי, תופיע השגיאה: UserListError.INVALID_NAME.

שדות
resource_name

string

שם המשאב של רשימת המשתמשים. שמות המשאבים של רשימות המשתמשים הם מהצורה:

customers/{customer_id}/userLists/{user_list_id}
type

UserListType

סוג הרשימה.

השדה הזה הוא לקריאה בלבד.
id

int64

המזהה של רשימת המשתמשים.
name

string

השם של רשימת המשתמשים הזו. ייחודי לכל רשימת משתמשים, למעט במקרים מסוימים שבהם רשימת משתמשים עם אותו שם מוגדרת עם access_reason כ-SHARED.

UserLocationView

תצוגת מיקום משתמש.

התצוגה 'מיקום המשתמש' כוללת את כל המדדים שמצטברים ברמת המדינה, שורה אחת לכל מדינה. בעמודה הזו מוצגים מדדי הביצועים במיקום הפיזי בפועל של המשתמש, לפי מיקום גיאוגרפי מטורגט או לא מטורגט. אם נעשה שימוש בשדות אחרים של פלחים, יכול להיות שתקבלו יותר משורה אחת לכל מדינה.

שדות
resource_name

string

שם המשאב של התצוגה 'מיקום המשתמש'. שמות המשאבים של התצוגה המפורטת UserLocation הם מהצורה:

customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}
country_criterion_id

int64

מזהה הקריטריון של המדינה.
targeting_location

bool

מציין אם המיקום היה מיקום גיאוגרפי למיקוד או לא.

כניסה

ביקור.

שדות
resource_name

string

שם המשאב של הביקור. הפורמט של שמות המשאבים של ביקורים הוא:

customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}
id

int64

המזהה של הביקור.
criterion_id

int64

מזהה של מילת המפתח ב-Search Ads 360. ערך של 0 מציין שמילת המפתח לא משויכת.
merchant_id

int64

מזהה חשבון המלאי ב-Search Ads 360 שמכיל את המוצר שלחצו עליו. מערכת Search Ads 360 יוצרת את המזהה הזה כשמקשרים חשבון מלאי ב-Search Ads 360.
ad_id

int64

מזהה המודעה. ערך של 0 מציין שהמודעה לא משויכת.
click_id

string

מחרוזת ייחודית לכל ביקור שמועברת לדף הנחיתה כפרמטר של מזהה הקליק בכתובת ה-URL.
visit_date_time

string

חותמת הזמן של אירוע הביקור. חותמת הזמן היא באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss.
product_id

string

המזהה של המוצר שעליו לחץ המשתמש.
product_channel

ProductChannel

ערוץ המכירות של המוצר שלחצו עליו: אונליין או מקומי.
product_language_code

string

השפה (ISO-639-1) שהוגדרה בפיד Merchant Center שמכיל נתונים על המוצר.
product_store_id

string

החנות שמוצגת במודעת המלאי של החנות המקומית שעליה לחץ המשתמש. המזהה הזה צריך להיות זהה למזהים של החנויות שמופיעים בפיד המוצרים של החנויות המקומיות.
product_country_code

string

המדינה (בפורמט ISO-3166) שרשומה בפיד המלאי שמכיל את המוצר שעליו לחץ המשתמש.
asset_id

int64

מזהה הנכס שהייתה אינטראקציה איתו במהלך אירוע הביקור.
asset_field_type

AssetFieldType

סוג השדה של הנכס של אירוע הביקור.

WebpageView

תצוגה של דף אינטרנט.

שדות
resource_name

string

שם המשאב של התצוגה של דף האינטרנט. שמות המשאבים של תצוגות דפי אינטרנט הם מהצורה:

customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}