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

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

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

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

קבוצת מודעות

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

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

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

int64

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

string

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

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

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

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

int64

הצעת המחיר המקסימלית לקליק (CPC).
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

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

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 לתוכן מועדף. יש להשתמש בספרה 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

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

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

המזהה של ה-ListGroupFilter.
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 מופיעים בפורמט הבא: `"customers/{customer_id}/assetGroupTopIntegrationViews/{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

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

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

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

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

ברירת המחדל היא 'STANDARD' אם היא לא מוגדרת בפעולת יצירה.
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

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

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

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

לקוח

לקוח.

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

ייצוג מחרוזת נפוץ של נתוני מיקום (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, כמו 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

תצוגת מגדר המשאב term_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

קוד מדינה בן 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

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

SearchAds360Fields/{name}
category

SearchAds360FieldCategory

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

string

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

string

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

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

string

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

string

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

string

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

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

SearchAds360FieldDataType

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

string

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

bool

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

bool

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

bool

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

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