Package google.ads.searchads360.v0.resources

אינדקס

AccessibleBiddingStrategy

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

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

שדות
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

Description_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

יעד ההוצאות שבו יש לקבל מקסימום קליקים. מגיש הצעות מחיר מסוג TargetSpend ינסה להוציא את הסכום הקטן יותר מהערך הזה או את סכום ההוצאות הטבעי של ויסות נתונים. אם לא מגדירים תקציב, היעד ישמש כיעד להוצאות. השדה הזה הוצא משימוש ולא ניתן להשתמש בו יותר. אפשר לקרוא פרטים נוספים בכתובת 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 הסופיות האפשריות לאחר כל ההפניות האוטומטיות בדומיינים של המודעה.
type

AdType

סוג המודעה.
id

int64

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

string

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

string

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

SearchAds360TextAdInfo

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

SearchAds360ExpandedTextAdInfo

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

SearchAds360ResponsiveSearchAdInfo

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

SearchAds360ProductAdInfo

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

SearchAds360ExpandedDynamicSearchAdInfo

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

AdGroup

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

שדות
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

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

string

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

string

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

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

string

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

פורמט: 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.sssss".
id

int64

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

string

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

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

היא חייבת להכיל פחות מ-255 תווים ברוחב מלא מסוג UTF-8.

היא לא יכולה להכיל תווים מסוג null (נקודת קוד 0x0), פיד שורה של NL (נקודת קוד 0xA) או תווים של חזרה לתחילת השורה (נקודת קוד 0xD).
cpc_bid_micros

int64

הצעת המחיר המקסימלית לקליק.
engine_status

AdGroupEngineStatus

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

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.sssss".
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.sssss".

AdGroupAdLabel

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

שדות
resource_name

string

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

string

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

string

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

AdGroupAsset

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

שדות
resource_name

string

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

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

string

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

string

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

AssetLinkStatus

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

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. הטווח הוא 1.0 עד 6.0 עבור PreferredContent. כדי לבטל את ההסכמה לסוג מכשיר מסוים, צריך להקיש על 0.

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

נדרש בפעולות יצירה שמתחילות ב-V5. 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

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

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

QualityInfo

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

CriterionType

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

string

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

PositionEstimates

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

string

הרשימה של כתובות ה-URL הסופיות האפשריות לאחר כל ההפניות האוטומטיות בדומיינים של המודעה.
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.sssss".
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

הצעת המחיר האפקטיבית לקליק.
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 מספיק מידע כדי לקבוע ערך.

AdGroupCriterionLabel

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

שדות
resource_name

string

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

string

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

string

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

AdGroupLabel

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

שדות
resource_name

string

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

string

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

string

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

AgeRangeView

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

שדות
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 סופיות אפשריות לאחר כל ההפניות האוטומטיות בדומיינים שונים.
status

AssetStatus

סטטוס הנכס.
creation_time

string

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

string

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

int64

מזהה הנכס.
name

string

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

string

תבנית של כתובת URL ליצירת כתובת 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 כשירות להרחבה אלא אם בוחרים שלא להשתמש בהן.
status

AssetGroupStatus

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

string

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

string

החלק השני של הטקסט שעשוי להופיע כמצורף לכתובת ה-URL המוצגת במודעה. אפשר להגדיר את השדה הזה רק כשמוגדר נתיב 1.
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

שם המשאב בתצוגת השילוב העליון של קבוצת הנכסים. שמות המשאבים של תצוגות מפורטות מובילים בשילוב נכסים של AssetGroup הם בפורמט הבא:
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

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

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

int64

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

string

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

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

string

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

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

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

השדה הזה הוא לקריאה בלבד.
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

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

string

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

BiddingStrategyType

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

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

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

string

שם המשאב של AccessibleBiddingStrategy, תצוגה לקריאה בלבד של המאפיינים הלא מוגבלים של שיטת הבידינג הכוללת המצורפת, שזוהו על ידי 'bidding_strategy'. ריק, אם לא הוגדרה שיטה כוללת לקמפיין. מאפייני שיטה ללא הגבלה זמינים לכל הלקוחות שאיתם השיטה משותפת, והם נקראים מהמשאב AccessibleBiddingStrategy. לעומת זאת, מאפיינים מוגבלים זמינים רק ללקוח שמוגדר כבעלים של האסטרטגיה ולמנהלים שלו. ניתן לקרוא מאפיינים מוגבלים רק מהמשאב Biddingאסטרטגיה.
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. במקום זאת, צריך להשתמש בקובץ create_time.
creation_time

string

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

string

התאריך והשעה שבהם הקמפיין הזה השתנה לאחרונה. התאריך והשעה מופיעים באזור הזמן של הלקוח ובפורמט "yyyy-MM-dd HH:mm:ss.sssss".
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, כלומר הקמפיין יפעל ללא הגבלת זמן. כדי להגדיר קמפיין קיים כך שיפעל ללא הגבלת זמן, צריך להגדיר את השדה הזה כ-30.12.2037.
final_url_suffix

string

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

bool

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

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

שיטת הבידינג הכוללת צריכה להיות שיטת בידינג כוללת (נוצרה באמצעות שירות Biddingאסטרטגיה) או רגילה, שמוטמעת בקמפיין. 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

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

TargetImpressionShare

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

TargetRoas

שיטת בידינג רגילה לפי יעד החזר על הוצאות הפרסום שממקסמת באופן אוטומטי את ההכנסות תוך עמידה בערך הממוצע של יעד החזר על הוצאות פרסום (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. האפשרות הזו זמינה רק בחלק מחשבונות השותפים של Google.

OptimizationGoalSetting

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

שדות
optimization_goal_types[]

OptimizationGoalType

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

SelectiveOptimization

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

שדות
conversion_actions[]

string

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

ShoppingSetting

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

שדות
feed_label

string

תווית פיד של מוצרים שייכללו בקמפיין. אפשר להגדיר רק מאפיין אחד (feed_label) או sales_country. אם משתמשים בשדה sales_country, מזינים את קודי המדינות באותו פורמט, למשל 'XX', בשדה feed_label. אחרת, אפשר להשתמש בכל מחרוזת שמשמשת כתווית פיד ב-Google Merchant Center.
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

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

ברירת המחדל היא 'רגיל' אם לא צוין בפעולת יצירה.
period

BudgetPeriod

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

int64

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

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.sssss".
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

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

CampaignLabel

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

שדות
resource_name

string

שם המשאב. שמות המשאבים של תוויות הקמפיין מופיעים בפורמט הבא: customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}
campaign

string

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

string

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

CartDataSalesView

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

שדות
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

מחרוזת ייחודית, עבור הביקור שאליו משויכת ההמרה, מועברת לדף הנחיתה כפרמטר של כתובת אתר של מזהה קליק.
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

כמות הפריטים שתועדה על ידי ההמרה, כפי שנקבעת באמצעות הפרמטר qty url. המפרסם אחראי לאכלוס דינמי של הפרמטר (למשל, מספר הפריטים שנמכרו בהמרה), אחרת ברירת המחדל שלו היא 1.
conversion_revenue_micros

int64

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

int64

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

string

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

ConversionStatus

הסטטוס של ההמרה, 'מופעלת' או 'הוסרה'.
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

אם הביט הראשי_for_goal של פעולת ההמרה מוגדר כ-False, לא ניתן להגיש הצעות מחיר לפעולת ההמרה בכל הקמפיינים, ללא קשר ליעד ההמרה 'לקוח' או ליעד ההמרה שהוגדר לקמפיין. עם זאת, יעדי המרה מותאמים אישית לא מצייתים ל-primary_for_goal, כך שאם לקמפיין יש יעד המרה מותאם אישית שהוגדר עם primary_for_goal = פעולת המרה false, עדיין ניתן להגיש הצעת מחיר על פעולת ההמרה הזו. כברירת מחדל, אם הפרמטר לא מוגדר, הפרמטר primary_for_goal יהיה True. בגרסה 9, אפשר להגדיר את primary_for_goal כ-FALSE רק לאחר יצירה באמצעות פעולת 'עדכון', כי הוא לא מוצהר כאופציונלי.
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

סוג מודל השיוך (Attribution) של פעולת ההמרה הזו.
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 או שווה ל-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

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

לקוח/ה

לקוח.

שדות
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.sssss".
engine_id

string

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

CustomerStatus

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

string

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

int64

המזהה של הלקוח.
descriptive_name

string

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

string

המטבע שבו החשבון פועל. יש תמיכה בקבוצת משנה של קודי מטבע בתקן 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

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

שדות
resource_name

string

שם המשאב של הלקוח של הלקוח. שמות משאבי הלקוח של הלקוח מופיעים בתבנית הבאה: 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

ייצוג של מחרוזת נתוני Locale Data Repository (CLDR) של אזור הזמן של הלקוח, לדוגמה, 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 Time Zone, למשל 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

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

שדות
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/{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

השם המלא של השפה באנגלית, לדוגמה, "אנגלית (ארה"ב)", "ספרדית" וכו'.
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_product_category, כפי שמתואר במאמר הזה: 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_product_category, כפי שמתואר במאמר הזה: https://support.google.com/merchants/answer/6324436.
country_code

string

קוד מדינה בן שתי אותיות רישיות של קטגוריית הצעת המחיר של המוצר.
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

שם המשאב של פריט המידע שנוצר בתהליך הפיתוח (Artifact). שמות של משאבי Artifact הם בתבנית:

SearchAds360Fields/{name}
category

SearchAds360FieldCategory

הקטגוריה של פריט המידע שנוצר בתהליך הפיתוח (Artifact).
selectable_with[]

string

השמות של כל המשאבים, הפלחים והמדדים שניתן לבחור באמצעות פריט המידע שנוצר בתהליך הפיתוח (Artifact) המתואר.
attribute_resources[]

string

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

השדה הזה מוגדר רק לפריטי מידע שנוצרו בתהליך הפיתוח (Artifact) שהקטגוריה שלהם היא Resource.
metrics[]

string

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

string

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

string

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

השדה הזה מוגדר רק עבור פריטי מידע שנוצרו בתהליך הפיתוח (Artifact) של הקטגוריה SEGMENT או ATTRIBUTE.
data_type

SearchAds360FieldDataType

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

string

השם של פריט המידע שנוצר בתהליך הפיתוח (Artifact).
selectable

bool

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

bool

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

bool

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

string

כתובת ה-URL של פרוטו שמתאר את סוג הנתונים של פריט המידע שנוצר בתהליך הפיתוח (Artifact).
is_repeated

bool

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

ShoppingPerformanceView

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

שדות
resource_name

string

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

UserList

רשימת משתמשים. זוהי רשימה של משתמשים שהלקוח עשוי לטרגט.

שדות
resource_name

string

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

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

UserListType

סוג הרשימה הזו.

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

int64

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

string

השם של רשימת המשתמשים הזו. בהתאם ל-access_reason שלו, ייתכן ששם רשימת המשתמשים לא יהיה ייחודי (לדוגמה, אם access_reason=SHARED)

כניסה

ביקור.

שדות
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}