Search Ads 360 Reporting API החדש זמין עכשיו. כדי להתעדכן לגבי השיפורים והגרסאות שצפויים בקרוב, הצטרפו לקבוצת Google searchads-api-announcements.

דף זה תורגם על ידי Cloud Translation API.

user_location_view

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

משאבים משויכים
customer

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

פילוח משאבים
ad_group
קמפיין

שדות מהמשאבים שלמעלה, שנבחרים יחד עם המשאב הזה בתנאי ה-SELECT ו-WHERE, יפלח את המדדים.

שדות/פלחים/מדדים

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

האם user_location_view מצוין בתנאי FROM של השאילתה?

שדות משאב
country_criterion_id
resource_name
targeting_location

פלחים
ad_network_type
conversion_action
conversion_action_category
conversion_action_name
date
day_of_week
device
geo_target_city
geo_target_metro
geo_target_region
month
רבעון
week
שנה

מדדים
all_conversions
all_conversions_from_interactions_rate
all_conversions_value
average_cost
average_cpc
average_cpm
clicks
client_account_conversions
client_account_conversions_value
client_account_view_through_conversions
conversions
conversions_from_interactions_rate
conversions_value
cost_micros
cost_per_all_conversions
cost_per_conversion
cross_device_conversions
cross_device_conversions_value
ctr
חשיפות
interaction_event_types
interaction_rate
interactions
value_per_all_conversions
value_per_conversion

user_location_view.country_criterion_id
תיאור השדה	מזהה הקריטריון של המדינה.
קטגוריה	`ATTRIBUTE`
סוג הנתונים	`INT64`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

user_location_view.resource_name
תיאור השדה	שם המשאב בתצוגת המיקום של המשתמש. שמות המשאבים בתצוגת מיקום המשתמש מופיעים בפורמט: `customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}`
קטגוריה	`ATTRIBUTE`
סוג הנתונים	`RESOURCE_NAME`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	לא נכון
שדה	לא נכון

user_location_view.targeting_location
תיאור השדה	מציין אם המיקום היה מוצג במודעות או לא.
קטגוריה	`ATTRIBUTE`
סוג הנתונים	`BOOLEAN`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

‫segments.ad_network_type
תיאור השדה	סוג רשת המודעות.
קטגוריה	`SEGMENT`
סוג הנתונים	`ENUM CONTENT MIXED SEARCH SEARCH_PARTNERS UNKNOWN UNSPECIFIED YOUTUBE_SEARCH YOUTUBE_WATCH`
כאן מקלידים כתובת URL	`google.ads.searchads360.v0.enums.AdNetworkTypeEnum.AdNetworkType`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

segments.conversion_action
תיאור השדה	שם המשאב של פעולת ההמרה.
קטגוריה	`SEGMENT`
סוג הנתונים	`RESOURCE_NAME`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

segments.conversion_action_category
תיאור השדה	קטגוריית פעולת ההמרה.
קטגוריה	`SEGMENT`
סוג הנתונים	`ENUM ADD_TO_CART BEGIN_CHECKOUT BOOK_APPOINTMENT CONTACT CONVERTED_LEAD DEFAULT DOWNLOAD ENGAGEMENT GET_DIRECTIONS IMPORTED_LEAD LEAD OUTBOUND_CLICK PAGE_VIEW PHONE_CALL_LEAD PURCHASE QUALIFIED_LEAD REQUEST_QUOTE SIGNUP STORE_SALE STORE_VISIT SUBMIT_LEAD_FORM SUBSCRIBE_PAID UNKNOWN UNSPECIFIED`
כאן מקלידים כתובת URL	`google.ads.searchads360.v0.enums.ConversionActionCategoryEnum.ConversionActionCategory`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

segments.conversion_action_name
תיאור השדה	שם פעולת ההמרה.
קטגוריה	`SEGMENT`
סוג הנתונים	`STRING`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

segments.date
תיאור השדה	התאריך שבו המדדים חלים. הפורמט הוא yyyy-MM-dd, לדוגמה, 2018-04-17.
קטגוריה	`SEGMENT`
סוג הנתונים	`DATE`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

segments.day_of_week
תיאור השדה	יום בשבוע, למשל, MONDAY.
קטגוריה	`SEGMENT`
סוג הנתונים	`ENUM FRIDAY MONDAY SATURDAY SUNDAY THURSDAY TUESDAY UNKNOWN UNSPECIFIED WEDNESDAY`
כאן מקלידים כתובת URL	`google.ads.searchads360.v0.enums.DayOfWeekEnum.DayOfWeek`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

segments.device
תיאור השדה	המכשיר שאליו חלים המדדים.
קטגוריה	`SEGMENT`
סוג הנתונים	`ENUM CONNECTED_TV DESKTOP MOBILE OTHER TABLET UNKNOWN UNSPECIFIED`
כאן מקלידים כתובת URL	`google.ads.searchads360.v0.enums.DeviceEnum.Device`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

segments.geo_target_city
תיאור השדה	שם המשאב של קבוע היעד הגיאוגרפי שמייצג עיר.
קטגוריה	`SEGMENT`
סוג הנתונים	`RESOURCE_NAME`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

segments.geo_target_metro
תיאור השדה	שם המשאב של קבוע הטירגוט הגיאוגרפי שמייצג מטרופולין.
קטגוריה	`SEGMENT`
סוג הנתונים	`RESOURCE_NAME`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

segments.geo_target_region
תיאור השדה	שם המשאב של קבוע היעד הגיאוגרפי שמייצג אזור.
קטגוריה	`SEGMENT`
סוג הנתונים	`RESOURCE_NAME`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

segments.month
תיאור השדה	חודש מיוצג על ידי התאריך של היום הראשון בחודש. הפורמט הוא yyyy-MM-dd.
קטגוריה	`SEGMENT`
סוג הנתונים	`DATE`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

segments.quarter
תיאור השדה	הרבעון מיוצג על ידי התאריך של היום הראשון ברבעון. המערכת משתמשת בשנה הקלנדרית לרבעונים. לדוגמה, הרבעון השני של 2018 מתחיל ב-1 באפריל 2018. הפורמט הוא yyyy-MM-dd.
קטגוריה	`SEGMENT`
סוג הנתונים	`DATE`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

segments.week
תיאור השדה	שבוע מוגדר כיום שני עד יום ראשון, ונציג על ידי תאריך יום שני. בפורמט: yyyy-MM-dd.
קטגוריה	`SEGMENT`
סוג הנתונים	`DATE`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

segments.year
תיאור השדה	שנה, בפורמט yyyy.
קטגוריה	`SEGMENT`
סוג הנתונים	`INT32`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

metrics.all_conversions
תיאור השדה	המספר הכולל של המרות. המדד הזה כולל את כל ההמרות, ללא קשר לערך של include_in_conversions_metric.
קטגוריה	`METRIC`
סוג הנתונים	`DOUBLE`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

metrics.all_conversions_from_interactions_rate
תיאור השדה	כל ההמרות מאינטראקציות (בניגוד להמרות בעקבות צפייה) חלקי מספר האינטראקציות עם מודעות.
קטגוריה	`METRIC`
סוג הנתונים	`DOUBLE`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

metrics.all_conversions_value
תיאור השדה	הערך של כל ההמרות.
קטגוריה	`METRIC`
סוג הנתונים	`DOUBLE`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

metrics.average_cost
תיאור השדה	הסכום הממוצע שמשלמים על כל אינטראקציה. סכום זה מייצג את העלות הכוללת של המודעות לחלק למספר הכולל של האינטראקציות.
קטגוריה	`METRIC`
סוג הנתונים	`DOUBLE`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

metrics.average_cpc
תיאור השדה	העלות הכוללת של כל הקליקים חלקי המספר הכולל של הקליקים שהתקבלו. המדד הזה הוא ערך כספי, והוא מוחזר במטבע של הלקוח כברירת מחדל. פרמטר metrics_currency מופיע בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
קטגוריה	`METRIC`
סוג הנתונים	`DOUBLE`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

metrics.average_cpm
תיאור השדה	עלות ממוצעת לאלף חשיפות (CPM). המדד הזה הוא ערך כספי, והוא מוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
קטגוריה	`METRIC`
סוג הנתונים	`DOUBLE`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

metrics.clicks
תיאור השדה	מספר הקליקים.
קטגוריה	`METRIC`
סוג הנתונים	`INT64`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

metrics.client_account_conversions
תיאור השדה	מספר ההמרות בחשבון הלקוח. המדד הזה כולל רק פעולות המרה שהמאפיין include_in_client_account_conversions_metric מוגדר בהן כ-true. אם אתם משתמשים בבידינג מבוסס-המרות, שיטות הבידינג יבצעו אופטימיזציה להשגת ההמרות האלה.
קטגוריה	`METRIC`
סוג הנתונים	`DOUBLE`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

metrics.client_account_conversions_value
תיאור השדה	הערך של ההמרות בחשבון הלקוח. המדד הזה כולל רק פעולות המרה שהמאפיין include_in_client_account_conversions_metric מוגדר בהן כ-true. אם משתמשים בבידינג מבוסס המרות, המערכת תבצע אופטימיזציה להשגת ההמרות האלה.
קטגוריה	`METRIC`
סוג הנתונים	`DOUBLE`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

metrics.client_account_view_through_conversions
תיאור השדה	המספר הכולל של המרות בעקבות צפייה. המרות כאלה מתרחשות כשלקוח רואה מודעה של תמונה או מודעה של מדיה עשירה, ולאחר מכן משלים המרה באתר בלי ליצור אינטראקציה עם מודעה אחרת (למשל, לחיצה עליה).
קטגוריה	`METRIC`
סוג הנתונים	`INT64`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

metrics.conversions
תיאור השדה	מספר ההמרות. המדד הזה כולל רק פעולות המרה שהמאפיין include_in_conversions_metric מוגדר בהן כ-true. אם אתם משתמשים בבידינג מבוסס-המרות, שיטות הבידינג יבצעו אופטימיזציה להשגת ההמרות האלה.
קטגוריה	`METRIC`
סוג הנתונים	`DOUBLE`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

metrics.conversions_from_interactions_rate
תיאור השדה	מספר ממוצע של המרות שניתן להגיש עליהן הצעות מחיר (מאינטראקציה) לכל אינטראקציה כשירה. המדד הזה מראה את התדירות הממוצעת שבה אינטראקציה עם מודעה מובילה להמרה שניתן להגיש עליה הצעת מחיר.
קטגוריה	`METRIC`
סוג הנתונים	`DOUBLE`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

metrics.conversions_value
תיאור השדה	הסכום של ערכי ההמרות של ההמרות שכלולות בשדה 'המרות'. המדד הזה מועיל רק אם הזנת ערך לפעולות ההמרה.
קטגוריה	`METRIC`
סוג הנתונים	`DOUBLE`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

metrics.cost_micros
תיאור השדה	סך העלויות לקליק (CPC) והעלות לאלף חשיפות (CPM) במהלך התקופה הזו. המדד הזה הוא ערך כספי, והוא מוחזר במטבע של הלקוח כברירת מחדל. פרמטר metrics_currency מופיע בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
קטגוריה	`METRIC`
סוג הנתונים	`INT64`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

metrics.cost_per_all_conversions
תיאור השדה	העלות של האינטראקציות עם המודעות מחולקת במספר ההמרות.
קטגוריה	`METRIC`
סוג הנתונים	`DOUBLE`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

metrics.cost_per_conversion
תיאור השדה	העלות הממוצעת להמרה שעומדת בדרישות להצגת הצעות מחיר, לכל המרה שאפשר להגיש עליה הצעות מחיר.
קטגוריה	`METRIC`
סוג הנתונים	`DOUBLE`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

metrics.cross_device_conversions
תיאור השדה	המרות שמתרחשות כשלקוח לוחץ על מודעה במכשיר אחד, ולאחר מכן משלים המרה במכשיר או בדפדפן אחר. המרות חוצות-מכשירים כבר נכללות בעמודה all_conversions.
קטגוריה	`METRIC`
סוג הנתונים	`DOUBLE`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

metrics.cross_device_conversions_value
תיאור השדה	הסכום של הערך של המרות חוצות-מכשירים.
קטגוריה	`METRIC`
סוג הנתונים	`DOUBLE`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

metrics.ctr
תיאור השדה	מספר הקליקים שהמודעה מקבלת (קליקים) חלקי מספר הפעמים שהמודעה מוצגת (חשיפות).
קטגוריה	`METRIC`
סוג הנתונים	`DOUBLE`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

metrics.impressions
תיאור השדה	מספר הפעמים שהמודעה שלכם הופיעה בדף תוצאות חיפוש או באתר ברשת Google.
קטגוריה	`METRIC`
סוג הנתונים	`INT64`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

metrics.interaction_event_types
תיאור השדה	סוגי האינטראקציות בתשלום והאינטראקציות בחינם.
קטגוריה	`METRIC`
סוג הנתונים	`ENUM`
כאן מקלידים כתובת URL	`google.ads.searchads360.v0.enums.InteractionEventTypeEnum.InteractionEventType`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	לא נכון
שדה	True

metrics.interaction_rate
תיאור השדה	התדירות שבה אנשים יוצרים אינטראקציה עם המודעה אחרי שהיא הוצגה להם. המדד הזה מייצג את מספר האינטראקציות חלקי מספר הפעמים שהמודעה הוצגה.
קטגוריה	`METRIC`
סוג הנתונים	`DOUBLE`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

metrics.interactions
תיאור השדה	מספר האינטראקציות. אינטראקציה היא הפעולה העיקרית של המשתמש שמשויכת לפורמט המודעה – קליקים במקרה של מודעות טקסט ומודעות שופינג, צפיות במקרה של מודעות וידאו וכן הלאה.
קטגוריה	`METRIC`
סוג הנתונים	`INT64`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

metrics.value_per_all_conversions
תיאור השדה	הערך של כל ההמרות חלקי מספר כל ההמרות.
קטגוריה	`METRIC`
סוג הנתונים	`DOUBLE`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

metrics.value_per_conversion
תיאור השדה	הערך של המרה שניתן להגיש עליה הצעת מחיר חלקי מספר ההמרות שניתן להגיש עליהן הצעת מחיר. העמודה הזו מציגה את הערך הממוצע של כל אחת מההמרות שניתן להגיש עליהן הצעות מחיר.
קטגוריה	`METRIC`
סוג הנתונים	`DOUBLE`
כאן מקלידים כתובת URL	`N/A`
אפשר לסנן	True
שניתן לבחור	True
אפשר למיין	True
שדה	לא נכון

user_location_view

שדות/פלחים/מדדים

user_location_view.country_criterion_id

user_location_view.resource_name

user_location_view.targeting_location

‫segments.ad_network_type

segments.conversion_action

segments.conversion_action_category

segments.conversion_action_name

segments.date

segments.day_of_week

segments.device

segments.geo_target_city

segments.geo_target_metro

segments.geo_target_region

segments.month

segments.quarter

segments.week

segments.year

metrics.all_conversions

metrics.all_conversions_from_interactions_rate

metrics.all_conversions_value

metrics.average_cost

metrics.average_cpc

metrics.average_cpm

metrics.clicks

metrics.client_account_conversions

metrics.client_account_conversions_value

metrics.client_account_view_through_conversions

metrics.conversions

metrics.conversions_from_interactions_rate

metrics.conversions_value

metrics.cost_micros

metrics.cost_per_all_conversions

metrics.cost_per_conversion

metrics.cross_device_conversions

metrics.cross_device_conversions_value

metrics.ctr

metrics.impressions

metrics.interaction_event_types

metrics.interaction_rate

metrics.interactions

metrics.value_per_all_conversions

metrics.value_per_conversion