Package google.ads.searchads360.v0.resources

אינדקס

AccessibleBiddingStrategy

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

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

שדות
resource_name

string

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

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

int64

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

string

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

BiddingStrategyType

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

int64

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

string

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

שדה איחוד 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

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

TargetImpressionShare

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

שדות
location

TargetImpressionShareLocation

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

int64

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

int64

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

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

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

string

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

string

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

string

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

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

string

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

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

string

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

string

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

int64

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

string

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

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

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

אסור לכלול תווים של null (נקודת קוד 0x0), פיד שורה NL (נקודת קוד 0xA) או תו חזרה לתחילת השורה (נקודת קוד 0xD).
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.ssssss'.
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

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

int64

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

AdGroupAsset

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

שדות
resource_name

string

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

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

string

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

string

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

AssetLinkStatus

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

AdGroupAssetSet

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

שדות
resource_name

string

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

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

string

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

string

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

AssetSetLinkStatus

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

AdGroupAudienceView

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

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

DeviceInfo

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

AdGroupCriterion

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

שדות
resource_name

string

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

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

string

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

AdGroupCriterionStatus

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

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

int64

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

string

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

bool

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

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

double

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

int64

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

int64

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

AdGroupCriterionEngineStatus

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

string

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

string

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

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

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

KeywordInfo

מילת מפתח.
listing_group

ListingGroupInfo

קבוצת כרטיסי מוצר.
age_range

AgeRangeInfo

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

GenderInfo

מגדר.
user_list

UserListInfo

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

WebpageInfo

דף אינטרנט
location

LocationInfo

מיקום.

PositionEstimates

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

שדות
top_of_page_cpc_micros

int64

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

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

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

int64

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

AdGroupEffectiveLabel

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

שדות
resource_name

string

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

string

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

string

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

int64

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

AdGroupLabel

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

שדות
resource_name

string

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

string

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

string

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

int64

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

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.ssssss'.
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 Top Combination הם בפורמט: ‎"customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"‎
asset_group_top_combinations[]

AssetGroupAssetCombinationData

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

AssetSet

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

שדות
id

int64

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

string

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

customers/{customer_id}/assetSets/{asset_set_id}

AssetSetAsset

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

שדות
resource_name

string

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

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

string

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

string

הנכס שאליו הנכס שהוגדר על ידי נכס מסוים מקושר.
status

AssetSetAssetStatus

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

קהל

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

שדות
resource_name

string

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

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

int64

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

string

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

string

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

BiddingStrategy

שיטת בידינג.

שדות
resource_name

string

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

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

BiddingStrategyStatus

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

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

BiddingStrategyType

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

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

string

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

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

string

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

string

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

BiddingStrategyType

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

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

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

string

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

FrequencyCapEntry

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

SelectiveOptimization

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

OptimizationGoalSetting

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

TrackingSetting

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

string

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

AssetFieldType

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

string

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

string

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

string

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

string

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

bool

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

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

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

string

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

ManualCpa

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

ManualCpc

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

ManualCpm

שיטת בידינג רגילה לפי עלות לאלף חשיפות (CPM) בשיטה ידנית. בידינג ידני מבוסס-חשיפות שבו המשתמש משלם על כל אלף חשיפות.
maximize_conversions

MaximizeConversions

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

MaximizeConversionValue

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

TargetCpa

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

TargetImpressionShare

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

TargetRoas

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

TargetSpend

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

PercentCpc

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

TargetCpm

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

DynamicSearchAdsSetting

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

שדות
domain_name

string

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

string

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

bool

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

GeoTargetTypeSetting

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

שדות
positive_geo_target_type

PositiveGeoTargetType

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

NegativeGeoTargetType

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

NetworkSettings

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

שדות
target_search_network

bool

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

bool

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

bool

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

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

המערכת מתעלמת מהשדה הזה בפעולות שינוי (mutate).
type

CriterionType

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

CampaignCriterionStatus

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

string

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

int64

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

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

float

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

bool

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

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

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

KeywordInfo

מילת מפתח.
location

LocationInfo

מיקום.
device

DeviceInfo

מכשיר.
age_range

AgeRangeInfo

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

GenderInfo

מגדר.
user_list

UserListInfo

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

LanguageInfo

שפה.
webpage

WebpageInfo

דף אינטרנט.
location_group

LocationGroupInfo

קבוצת מיקום

CampaignEffectiveLabel

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

שדות
resource_name

string

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

string

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

string

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

int64

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

CampaignLabel

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

שדות
resource_name

string

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

string

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

string

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

int64

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

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

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

int64

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

string

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

string

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

ProductChannel

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

string

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

string

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

string

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

AttributionType

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

string

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

string

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

string

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

int64

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

int64

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

int64

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

string

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

ConversionStatus

הסטטוס של ההמרה: 'מופעל' או 'הוסר'.
asset_id

int64

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

AssetFieldType

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

ConversionAction

פעולת המרה.

שדות
resource_name

string

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

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

string

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

ConversionActionStatus

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

ConversionActionType

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

ConversionActionCategory

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

ValueSettings

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

AttributionModelSettings

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

FloodlightSettings

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

int64

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

string

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

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

bool

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

string

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

bool

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

bool

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

int64

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

string

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

AttributionModelSettings

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

שדות
attribution_model

AttributionModel

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

DataDrivenModelStatus

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

FloodlightSettings

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

שדות
activity_group_tag

string

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

string

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

int64

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

ValueSettings

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

שדות
default_value

double

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

string

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

bool

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

ConversionCustomVariable

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

שדות
resource_name

string

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

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

int64

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

string

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

string

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

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

שדות
floodlight_variable_type

FloodlightVariableType

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

FloodlightVariableDataType

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

ConversionTrackingSetting

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

שדות
accepted_customer_data_terms

bool

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

ConversionTrackingStatus

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

bool

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

string

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

int64

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

int64

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

int64

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

CustomColumn

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

שדות
resource_name

string

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

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

int64

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

string

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

string

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

CustomColumnValueType

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

bool

הערך True מופיע כאשר העמודה בהתאמה אישית מפנה למאפיין אחד או יותר.
references_metrics

bool

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

bool

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

string

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

CustomColumnRenderType

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

לקוח

לקוח.

שדות
resource_name

string

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

customers/{customer_id}
conversion_tracking_setting

ConversionTrackingSetting

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

AccountType

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

DoubleClickCampaignManagerSetting

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

AccountStatus

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

string

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

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

שדות
resource_name

string

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

string

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

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

CustomerStatus

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

string

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

bool

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

קריאה בלבד.
level

int64

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

string

ייצוג מחרוזת נפוץ של נתוני מיקום (CLDR) של אזור הזמן של הלקוח, לדוגמה, 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

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

bool

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

ListingGroupFilterDimension

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

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

ProductBiddingCategory

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

ProductBrand

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

ProductChannel

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

ProductCondition

מצב המוצר.
product_custom_attribute

ProductCustomAttribute

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

ProductItemId

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

ProductType

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

ProductBiddingCategory

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

שדות
level

ListingGroupFilterBiddingCategoryLevel

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

int64

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

המזהה הזה זהה למזהה google_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

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

SearchAds360Fields/{name}
category

SearchAds360FieldCategory

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

string

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

string

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

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

string

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

string

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

string

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

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

SearchAds360FieldDataType

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

string

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

bool

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

bool

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

bool

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

string

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

bool

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

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

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

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}