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

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

effective_labels[]

string

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

engine_id

string

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

engine_status

AdGroupAdEngineStatus

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

last_modified_time

string

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

AdGroupAdEffectiveLabel

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

שדות
resource_name

string

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

ad_group_ad

string

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

label

string

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

owner_customer_id

int64

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

AdGroupAdLabel

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

שדות
resource_name

string

שם המשאב של תווית המודעה של קבוצת המודעות. שמות המשאבים של תוויות המודעות של קבוצות המודעות הם בפורמט: customers/{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, וכן רשימות רימרקטינג עבור מודעות לרשת החיפוש (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. הטווח של PreferredContent הוא 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

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

effective_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 אין מספיק מידע כדי לקבוע ערך.

AdGroupCriterionEffectiveLabel

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

שדות
resource_name

string

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

ad_group_criterion

string

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

label

string

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

owner_customer_id

int64

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

AdGroupCriterionLabel

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

שדות
resource_name

string

שם המשאב של תווית הקריטריון של קבוצת המודעות. שמות המשאבים של תוויות הקריטריונים של קבוצות המודעות הם בפורמט: customers/{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 סופיות לנייד אחרי כל ההפניות האוטומטיות בין דומיינים. כברירת מחדל, כתובות ה-URL בקמפיינים למיקסום הביצועים עומדות בדרישות להרחבה, אלא אם בוחרים לבטל את ההסכמה לכך.

status

AssetGroupStatus

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

path1

string

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

path2

string

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

ad_strength

AdStrength

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

AssetGroupAsset

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

שדות
resource_name

string

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

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

asset_group

string

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

asset

string

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

field_type

AssetFieldType

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

status

AssetLinkStatus

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

AssetGroupAssetCombinationData

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

שדות
asset_combination_served_assets[]

AssetUsage

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

AssetGroupListingGroupFilter

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

שדות
resource_name

string

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

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

asset_group

string

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

id

int64

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

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

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

id

int64

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

name

string

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

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

effective_currency_code

string

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

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

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

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

render_type

CustomColumnRenderType

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

לקוח

לקוח.

שדות
resource_name

string

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

customers/{customer_id}

conversion_tracking_setting

ConversionTrackingSetting

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

account_type

AccountType

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

double_click_campaign_manager_setting

DoubleClickCampaignManagerSetting

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

account_status

AccountStatus

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

last_modified_time

string

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

engine_id

string

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

status

CustomerStatus

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

creation_time

string

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

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

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

שדות
resource_name

string

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

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

GeoTargetConstant

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

שדות
resource_name

string

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

geoTargetConstants/{geo_target_constant_id}

status

GeoTargetConstantStatus

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

id

int64

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

name

string

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

country_code

string

קוד המדינה בתקן ISO-3166-1 alpha-2 שמשויך ליעד.

target_type

string

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

canonical_name

string

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

parent_geo_target

string

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

geoTargetConstants/{parent_geo_target_constant_id}

KeywordView

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

שדות
resource_name

string

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

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

תווית

תווית.

שדות
resource_name

string

שם המשאב. שמות המשאבים של התוויות מופיעים בפורמט: customers/{customer_id}/labels/{label_id}

status

LabelStatus

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

text_label

TextLabel

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

id

int64

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

name

string

שם התווית.

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

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

LanguageConstant

שפה.

שדות
resource_name

string

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

languageConstants/{criterion_id}

id

int64

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

code

string

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

name

string

השם המלא של השפה באנגלית, למשל, '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

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

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

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

selectable_with[]

string

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

attribute_resources[]

string

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

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

metrics[]

string

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

segments[]

string

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

enum_values[]

string

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

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

data_type

SearchAds360FieldDataType

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

name

string

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

selectable

bool

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

filterable

bool

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

sortable

bool

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

type_url

string

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

is_repeated

bool

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

ShoppingPerformanceView

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

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

UserLocationView

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

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

שדות
resource_name

string

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

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

country_criterion_id

int64

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

targeting_location

bool

מציין אם המיקום היה מוצג במודעות או לא.

כניסה

ביקור.

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