Package google.ads.searchads360.v0.resources

אינדקס

AccessibleBiddingStrategy

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

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

שדות
resource_name

string

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

customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}

id

int64

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

name

string

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

type

BiddingStrategyType

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

owner_customer_id

int64

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

owner_descriptive_name

string

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

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

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

maximize_conversion_value

MaximizeConversionValue

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

maximize_conversions

MaximizeConversions

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

target_cpa

TargetCpa

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

target_impression_share

TargetImpressionShare

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

target_roas

TargetRoas

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

target_spend

TargetSpend

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

MaximizeConversionValue

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

שדות
target_roas

double

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

MaximizeConversions

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

שדות
target_cpa

int64

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

target_cpa_micros

int64

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

TargetCpa

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

שדות
target_cpa_micros

int64

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

TargetImpressionShare

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

שדות
location

TargetImpressionShareLocation

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

location_fraction_micros

int64

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

cpc_bid_ceiling_micros

int64

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

TargetRoas

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

שדות
target_roas

double

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

TargetSpend

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

שדות
target_spend_micros
(deprecated)

int64

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

cpc_bid_ceiling_micros

int64

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

מודעה.

שדות
resource_name

string

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

customers/{customer_id}/ads/{ad_id}

final_urls[]

string

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

final_app_urls[]

FinalAppUrl

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

final_mobile_urls[]

string

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

type

AdType

סוג המודעה.

id

int64

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

tracking_url_template

string

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

final_url_suffix

string

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

display_url

string

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

name

string

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

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

SearchAds360TextAdInfo

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

expanded_text_ad

SearchAds360ExpandedTextAdInfo

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

responsive_search_ad

SearchAds360ResponsiveSearchAdInfo

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

product_ad

SearchAds360ProductAdInfo

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

expanded_dynamic_search_ad

SearchAds360ExpandedDynamicSearchAdInfo

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

קבוצת מודעות

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

שדות
resource_name

string

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

customers/{customer_id}/adGroups/{ad_group_id}

status

AdGroupStatus

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

type

AdGroupType

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

ad_rotation_mode

AdGroupAdRotationMode

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

creation_time

string

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

targeting_setting

TargetingSetting

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

labels[]

string

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

effective_labels[]

string

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

engine_id

string

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

start_date

string

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

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

end_date

string

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

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

language_code

string

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

last_modified_time

string

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

id

int64

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

name

string

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

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

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

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

tracking_url_template

string

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

cpc_bid_micros

int64

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

engine_status

AdGroupEngineStatus

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

final_url_suffix

string

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

AdGroupAd

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

שדות
resource_name

string

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

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

status

AdGroupAdStatus

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

ad

Ad

המודעה.

creation_time

string

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

labels[]

string

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

effective_labels[]

string

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

engine_id

string

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

engine_status

AdGroupAdEngineStatus

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

last_modified_time

string

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

AdGroupAdEffectiveLabel

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

שדות
resource_name

string

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

ad_group_ad

string

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

label

string

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

owner_customer_id

int64

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

AdGroupAdLabel

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

שדות
resource_name

string

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

ad_group_ad

string

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

label

string

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

owner_customer_id

int64

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

AdGroupAsset

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

שדות
resource_name

string

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

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

ad_group

string

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

asset

string

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

status

AssetLinkStatus

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

AdGroupAssetSet

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

שדות
resource_name

string

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

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

ad_group

string

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

asset_set

string

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

status

AssetSetLinkStatus

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

AdGroupAudienceView

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

שדות
resource_name

string

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

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

AdGroupBidModifier

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

שדות
resource_name

string

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

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

bid_modifier

double

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

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

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

device

DeviceInfo

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

AdGroupCriterion

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

שדות
resource_name

string

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

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

creation_time

string

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

status

AdGroupCriterionStatus

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

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

quality_info

QualityInfo

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

type

CriterionType

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

labels[]

string

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

effective_labels[]

string

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

position_estimates

PositionEstimates

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

final_urls[]

string

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

final_mobile_urls[]

string

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

url_custom_parameters[]

CustomParameter

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

engine_id

string

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

last_modified_time

string

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

criterion_id

int64

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

ad_group

string

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

negative

bool

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

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

bid_modifier

double

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

cpc_bid_micros

int64

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

effective_cpc_bid_micros

int64

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

engine_status

AdGroupCriterionEngineStatus

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

final_url_suffix

string

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

tracking_url_template

string

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

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

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

keyword

KeywordInfo

מילת מפתח.

listing_group

ListingGroupInfo

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

age_range

AgeRangeInfo

טווח גילאים.

gender

GenderInfo

מגדר.

user_list

UserListInfo

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

webpage

WebpageInfo

דף אינטרנט

location

LocationInfo

מיקום.

PositionEstimates

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

שדות
top_of_page_cpc_micros

int64

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

QualityInfo

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

שדות
quality_score

int32

ציון האיכות.

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

AdGroupCriterionEffectiveLabel

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

שדות
resource_name

string

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

ad_group_criterion

string

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

label

string

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

owner_customer_id

int64

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

AdGroupCriterionLabel

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

שדות
resource_name

string

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

ad_group_criterion

string

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

label

string

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

owner_customer_id

int64

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

AdGroupEffectiveLabel

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

שדות
resource_name

string

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

ad_group

string

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

label

string

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

owner_customer_id

int64

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

AdGroupLabel

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

שדות
resource_name

string

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

ad_group

string

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

label

string

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

owner_customer_id

int64

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

AgeRangeView

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

שדות
resource_name

string

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

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

נכס

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

שדות
resource_name

string

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

customers/{customer_id}/assets/{asset_id}

type

AssetType

סוג הנכס.

final_urls[]

string

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

final_mobile_urls[]

string

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

url_custom_parameters[]

CustomParameter

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

status

AssetStatus

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

creation_time

string

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

last_modified_time

string

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

id

int64

מזהה הנכס.

name

string

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

tracking_url_template

string

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

final_url_suffix

string

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

engine_status

AssetEngineStatus

סטטוס המנוע של נכס.

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

YoutubeVideoAsset

נכס מסוג סרטון ב-YouTube.

image_asset

ImageAsset

נכס תמונות.

text_asset

TextAsset

נכס טקסט.

callout_asset

UnifiedCalloutAsset

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

page_feed_asset

UnifiedPageFeedAsset

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

mobile_app_asset

MobileAppAsset

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

call_asset

UnifiedCallAsset

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

call_to_action_asset

CallToActionAsset

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

location_asset

UnifiedLocationAsset

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

AssetGroup

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

שדות
resource_name

string

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

customers/{customer_id}/assetGroups/{asset_group_id}

id

int64

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

campaign

string

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

name

string

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

final_urls[]

string

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

final_mobile_urls[]

string

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

status

AssetGroupStatus

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

path1

string

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

path2

string

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

ad_strength

AdStrength

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

AssetGroupAsset

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

שדות
resource_name

string

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

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

asset_group

string

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

asset

string

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

field_type

AssetFieldType

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

status

AssetLinkStatus

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

AssetGroupAssetCombinationData

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

שדות
asset_combination_served_assets[]

AssetUsage

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

AssetGroupListingGroupFilter

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

שדות
resource_name

string

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

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

asset_group

string

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

id

int64

המזהה של ListingGroupFilter.

type

ListingGroupFilterType

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

vertical

ListingGroupFilterVertical

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

case_value

ListingGroupFilterDimension

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

parent_listing_group_filter

string

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

path

ListingGroupFilterDimensionPath

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

AssetGroupSignal

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

שדות
resource_name

string

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

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

asset_group

string

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

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

AudienceInfo

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

AssetGroupTopCombinationView

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

שדות
resource_name

string

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

asset_group_top_combinations[]

AssetGroupAssetCombinationData

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

AssetSet

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

שדות
id

int64

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

resource_name

string

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

customers/{customer_id}/assetSets/{asset_set_id}

AssetSetAsset

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

שדות
resource_name

string

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

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

asset_set

string

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

asset

string

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

status

AssetSetAssetStatus

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

קהל

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

שדות
resource_name

string

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

customers/{customer_id}/audiences/{audience_id}

id

int64

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

name

string

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

description

string

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

BiddingStrategy

שיטת בידינג.

שדות
resource_name

string

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

customers/{customer_id}/biddingStrategies/{bidding_strategy_id}

status

BiddingStrategyStatus

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

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

type

BiddingStrategyType

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

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

currency_code

string

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

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

id

int64

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

name

string

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

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

effective_currency_code

string

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

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

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

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

campaign_count

int64

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

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

non_removed_campaign_count

int64

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

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

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

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

enhanced_cpc

EnhancedCpc

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

maximize_conversion_value

MaximizeConversionValue

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

maximize_conversions

MaximizeConversions

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

target_cpa

TargetCpa

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

target_impression_share

TargetImpressionShare

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

target_outrank_share

TargetOutrankShare

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

target_roas

TargetRoas

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

target_spend

TargetSpend

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

קמפיין

קמפיין.

שדות
resource_name

string

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

customers/{customer_id}/campaigns/{campaign_id}

status

CampaignStatus

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

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

serving_status

CampaignServingStatus

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

bidding_strategy_system_status

BiddingStrategySystemStatus

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

ad_serving_optimization_status

AdServingOptimizationStatus

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

advertising_channel_type

AdvertisingChannelType

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

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

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

advertising_channel_sub_type

AdvertisingChannelSubType

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

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

url_custom_parameters[]

CustomParameter

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

real_time_bidding_setting

RealTimeBiddingSetting

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

network_settings

NetworkSettings

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

dynamic_search_ads_setting

DynamicSearchAdsSetting

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

shopping_setting

ShoppingSetting

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

geo_target_type_setting

GeoTargetTypeSetting

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

effective_labels[]

string

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

labels[]

string

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

bidding_strategy_type

BiddingStrategyType

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

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

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

accessible_bidding_strategy

string

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

frequency_caps[]

FrequencyCapEntry

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

selective_optimization

SelectiveOptimization

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

optimization_goal_setting

OptimizationGoalSetting

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

tracking_setting

TrackingSetting

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

engine_id

string

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

excluded_parent_asset_field_types[]

AssetFieldType

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

create_time

string

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

creation_time

string

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

last_modified_time

string

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

feed_types[]

AssetSetType

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

id

int64

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

name

string

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

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

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

tracking_url_template

string

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

campaign_budget

string

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

start_date

string

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

end_date

string

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

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

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

manual_cpc

ManualCpc

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

manual_cpm

ManualCpm

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

maximize_conversions

MaximizeConversions

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

maximize_conversion_value

MaximizeConversionValue

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

target_cpa

TargetCpa

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

target_impression_share

TargetImpressionShare

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

target_roas

TargetRoas

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

target_spend

TargetSpend

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

percent_cpc

PercentCpc

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

target_cpm

TargetCpm

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

DynamicSearchAdsSetting

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

שדות
domain_name

string

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

language_code

string

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

use_supplied_urls_only

bool

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

GeoTargetTypeSetting

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

שדות
positive_geo_target_type

PositiveGeoTargetType

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

negative_geo_target_type

NegativeGeoTargetType

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

NetworkSettings

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

שדות
target_search_network

bool

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

target_content_network

bool

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

target_partner_search_network

bool

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

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

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

type

CriterionType

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

status

CampaignCriterionStatus

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

last_modified_time

string

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

criterion_id

int64

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

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

bid_modifier

float

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

negative

bool

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

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

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

keyword

KeywordInfo

מילת מפתח.

location

LocationInfo

מיקום.

device

DeviceInfo

מכשיר.

age_range

AgeRangeInfo

טווח גילאים.

gender

GenderInfo

מגדר.

user_list

UserListInfo

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

language

LanguageInfo

שפה.

webpage

WebpageInfo

דף אינטרנט.

location_group

LocationGroupInfo

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

CampaignEffectiveLabel

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

שדות
resource_name

string

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

campaign

string

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

label

string

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

owner_customer_id

int64

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

CampaignLabel

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

שדות
resource_name

string

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

campaign

string

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

label

string

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

owner_customer_id

int64

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

CartDataSalesView

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

שדות
resource_name

string

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

המרה

המרה.

שדות
resource_name

string

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

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

id

int64

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

criterion_id

int64

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

merchant_id

int64

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

ad_id

int64

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

click_id

string

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

visit_id

int64

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

advertiser_conversion_id

string

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

product_id

string

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

product_channel

ProductChannel

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

product_language_code

string

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

product_store_id

string

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

product_country_code

string

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

attribution_type

AttributionType

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

conversion_date_time

string

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

conversion_last_modified_date_time

string

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

conversion_visit_date_time

string

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

conversion_quantity

int64

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

conversion_revenue_micros

int64

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

floodlight_original_revenue

int64

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

floodlight_order_id

string

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

status

ConversionStatus

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

asset_id

int64

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

asset_field_type

AssetFieldType

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

ConversionAction

פעולת המרה.

שדות
resource_name

string

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

customers/{customer_id}/conversionActions/{conversion_action_id}

creation_time

string

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

status

ConversionActionStatus

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

type

ConversionActionType

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

category

ConversionActionCategory

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

value_settings

ValueSettings

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

attribution_model_settings

AttributionModelSettings

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

floodlight_settings

FloodlightSettings

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

id

int64

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

name

string

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

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

primary_for_goal

bool

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

owner_customer

string

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

include_in_client_account_conversions_metric

bool

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

include_in_conversions_metric

bool

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

click_through_lookback_window_days

int64

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

app_id

string

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

AttributionModelSettings

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

שדות
attribution_model

AttributionModel

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

data_driven_model_status

DataDrivenModelStatus

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

FloodlightSettings

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

שדות
activity_group_tag

string

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

activity_tag

string

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

activity_id

int64

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

ValueSettings

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

שדות
default_value

double

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

default_currency_code

string

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

always_use_default_value

bool

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

ConversionCustomVariable

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

שדות
resource_name

string

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

customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}

id

int64

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

name

string

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

tag

string

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

status

ConversionCustomVariableStatus

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

owner_customer

string

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

family

ConversionCustomVariableFamily

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

cardinality

ConversionCustomVariableCardinality

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

floodlight_conversion_custom_variable_info

FloodlightConversionCustomVariableInfo

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

custom_column_ids[]

int64

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

FloodlightConversionCustomVariableInfo

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

שדות
floodlight_variable_type

FloodlightVariableType

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

floodlight_variable_data_type

FloodlightVariableDataType

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

ConversionTrackingSetting

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

שדות
accepted_customer_data_terms

bool

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

conversion_tracking_status

ConversionTrackingStatus

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

enhanced_conversions_for_leads_enabled

bool

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

google_ads_conversion_customer

string

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

conversion_tracking_id

int64

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

google_ads_cross_account_conversion_tracking_id

int64

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

cross_account_conversion_tracking_id

int64

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

CustomColumn

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

שדות
resource_name

string

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

customers/{customer_id}/customColumns/{custom_column_id}

id

int64

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

name

string

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

description

string

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

value_type

CustomColumnValueType

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

references_attributes

bool

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

references_metrics

bool

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

queryable

bool

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

referenced_system_columns[]

string

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

render_type

CustomColumnRenderType

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

לקוח

לקוח.

שדות
resource_name

string

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

customers/{customer_id}

conversion_tracking_setting

ConversionTrackingSetting

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

account_type

AccountType

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

double_click_campaign_manager_setting

DoubleClickCampaignManagerSetting

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

account_status

AccountStatus

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

last_modified_time

string

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

engine_id

string

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

status

CustomerStatus

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

creation_time

string

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

manager_id

int64

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

manager_descriptive_name

string

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

sub_manager_id

int64

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

sub_manager_descriptive_name

string

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

associate_manager_id

int64

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

associate_manager_descriptive_name

string

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

account_level

AccountLevelType

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

id

int64

מזהה הלקוח.

descriptive_name

string

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

currency_code

string

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

time_zone

string

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

tracking_url_template

string

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

final_url_suffix

string

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

auto_tagging_enabled

bool

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

manager

bool

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

CustomerAsset

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

שדות
resource_name

string

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

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

asset

string

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

status

AssetLinkStatus

הסטטוס של הנכס הדיגיטלי של הלקוח.

CustomerAssetSet

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

שדות
resource_name

string

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

customers/{customer_id}/customerAssetSets/{asset_set_id}

asset_set

string

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

customer

string

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

status

AssetSetLinkStatus

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

CustomerClient

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

שדות
resource_name

string

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

applied_labels[]

string

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

customers/{customer_id}/labels/{label_id}

status

CustomerStatus

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

client_customer

string

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

hidden

bool

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

קריאה בלבד.

level

int64

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

time_zone

string

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

test_account

bool

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

manager

bool

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

descriptive_name

string

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

currency_code

string

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

id

int64

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

DoubleClickCampaignManagerSetting

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

שדות
advertiser_id

int64

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

network_id

int64

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

time_zone

string

אזור הזמן של הרשת ב-Campaign Manager שמשויך ללקוח הזה, בפורמט של מסד הנתונים של אזורי הזמן של IANA, כמו 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/{owner_customer_id}/labels/{label_id}

status

LabelStatus

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

text_label

TextLabel

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

id

int64

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

name

string

שם התווית.

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

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

LanguageConstant

שפה.

שדות
resource_name

string

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

languageConstants/{criterion_id}

id

int64

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

code

string

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

name

string

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

targetable

bool

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

ListingGroupFilterDimension

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

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

ProductBiddingCategory

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

product_brand

ProductBrand

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

product_channel

ProductChannel

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

product_condition

ProductCondition

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

product_custom_attribute

ProductCustomAttribute

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

product_item_id

ProductItemId

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

product_type

ProductType

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

ProductBiddingCategory

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

שדות
level

ListingGroupFilterBiddingCategoryLevel

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

id

int64

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

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

ProductBrand

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

שדות
value

string

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

ProductChannel

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

שדות
channel

ListingGroupFilterProductChannel

ערך המיקום.

ProductCondition

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

שדות
condition

ListingGroupFilterProductCondition

הערך של התנאי.

ProductCustomAttribute

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

שדות
index

ListingGroupFilterCustomAttributeIndex

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

value

string

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

ProductItemId

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

שדות
value

string

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

ProductType

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

שדות
level

ListingGroupFilterProductTypeLevel

הרמה של הסוג.

value

string

הערך של הסוג.

ListingGroupFilterDimensionPath

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

שדות
dimensions[]

ListingGroupFilterDimension

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

LocationView

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

שדות
resource_name

string

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

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

ProductBiddingCategoryConstant

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

שדות
resource_name

string

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

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

level

ProductBiddingCategoryLevel

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

status

ProductBiddingCategoryStatus

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

id

int64

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

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

country_code

string

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

product_bidding_category_constant_parent

string

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

language_code

string

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

localized_name

string

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

ProductGroupView

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

שדות
resource_name

string

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

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

SearchAds360Field

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

שדות
resource_name

string

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

SearchAds360Fields/{name}

category

SearchAds360FieldCategory

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

selectable_with[]

string

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

attribute_resources[]

string

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

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

metrics[]

string

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

segments[]

string

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

enum_values[]

string

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

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

data_type

SearchAds360FieldDataType

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

name

string

שם הארטיפקט.

selectable

bool

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

filterable

bool

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

sortable

bool

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

type_url

string

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

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=SHARED), בהתאם ל-access_reason.

UserLocationView

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

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

שדות
resource_name

string

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

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

country_criterion_id

int64

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

targeting_location

bool

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

כניסה

ביקור.

שדות
resource_name

string

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

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

id

int64

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

criterion_id

int64

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

merchant_id

int64

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

ad_id

int64

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

click_id

string

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

visit_date_time

string

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

product_id

string

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

product_channel

ProductChannel

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

product_language_code

string

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

product_store_id

string

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

product_country_code

string

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

asset_id

int64

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

asset_field_type

AssetFieldType

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

WebpageView

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

שדות
resource_name

string

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

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