הדיווח בפלטפורמה של מפות Google כולל קבוצה של דוחות ויזואליים מוגדרים מראש של נתוני שימוש, מכסות ונתוני חיוב בסיסיים ב-API במסוף Google Cloud. תוכלו להשתמש בדוחות האלה כדי לבדוק את מספר הקריאות שביצעתם ל-API, עד כמה אתם קרובים למכסות השימוש ב-API ולעקוב אחרי השימוש בחיוב לאורך זמן.
סוגי הדוחות:
- דוחות שימוש: מדווח על מספר הבקשות שהפרויקט שלח לממשקי ה-API של הפלטפורמה של מפות Google באמצעות פרטי הכניסה שמשויכים לפרויקט.
- דוחות מכסות: שימוש במכסות בדוחות בתרשימים שאפשר לקבץ בבקשות לדקה. המגבלות הנוכחיות במכסות של ממשקי ה-API שנבחרו מוצגות בטבלאות שמתחת לתרשימי השימוש במכסות.
- דוחות חיוב: דיווח על עלויות לאורך זמן כתרשים קו מוערם. צפייה במכסה בחודש הנוכחי, כולל זיכויים שהוחלו לפי שימוש ספציפי, וכן העלות הצפויה הכוללת לכל החודש הנוכחי.
- דוחות מעורבות: מספקים תובנות עסקיות לגבי האינטראקציות של המשתמשים עם האפליקציות שלכם למפות.
במאמר סטטוס ודוחות של תגובה תוכלו למצוא רשימה מלאה של הסטטוסים של התגובות וקודי התגובות שמגדירים אם בקשה תופיע בדוחות Usage , Quota ו/או Billing.
צפייה בדוחות על השימוש, המכסות והחיוב בפלטפורמה של מפות Google באמצעות מסוף Cloud.
דוחות שימוש
השימוש מבוסס על מספר הבקשות בפרויקט לממשקי ה-API של הפלטפורמה של מפות Google באמצעות פרטי הכניסה שמשויכים לפרויקט. הבקשות כוללות בקשות שבוצעו בהצלחה, בקשות שגורמות לשגיאות בחיבור לשרת ובקשות שמובילות לשגיאות לקוח. פרטי הכניסה כוללים מפתחות API ומזהי לקוח (לפרויקטים בתוכנית Premium ובפרויקטים של תוכנית Premium). למידע נוסף, ראו סקירה כללית של תוכנית הפרימיום ומידע על השימוש במזהה לקוח.
מדדי השימוש מוצגים בטבלאות (בקשות, שגיאות וזמן אחזור) ובתרשימים (תנועה, שגיאות וזמן אחזור). למטרות מעקב:
All APIs: אפשר לסנן ולקבץ את מדדי השימוש לכל ממשקי ה-API באופן הבא:
- סינון לפי תקופה ו-API.
- הצגת תעבורת הנתונים, השגיאות וזמן האחזור בקיבוץ לפי קוד תגובה, API ופרטי כניסה.
API ספציפי: אפשר לסנן ולקבץ את מדדי השימוש לפי ממשק API ספציפי בדרכים הבאות:
- סינון לפי תקופה, גרסאות API, פרטי כניסה ושיטות.
- הצגת תעבורת הנתונים, השגיאות וזמן האחזור בקיבוץ לפי קוד תגובה, שיטת וגרסה של API ופרטי כניסה.
דף מרכז הבקרה של ממשקי API ושירותים
במרכז הבקרה של ממשקי ה-API והשירותים תוכלו לראות סקירה כללית של מדדי השימוש בכל ממשקי ה-API שהופעלו בפרויקט שלכם: ממשקי ה-API של הפלטפורמה של מפות Google וממשקי API ושירותים אחרים.
הדף מרכז שליטה כולל שלושה תרשימים וטבלה. אפשר לסנן את השימוש שמוצג בתרשימים ובטבלאות על ידי בחירת תקופה של שעה אחת עד 30 הימים האחרונים.
בתרשים תנועה מוצג השימוש בשאילתות לשנייה (QPS) לכל API.
בתרשים Errors מוצג אחוז הבקשות שהובילו לשגיאות בכל API.
בתרשים זמן אחזור מוצג זמן האחזור החציוני של הבקשות לכל API.
מתחת לתרשימים מוצגת טבלה עם פירוט של ממשקי ה-API והשירותים שמופעלים. הבקשות הן מספר הבקשות (בתקופת הזמן שנבחרה). השגיאות הן מספר הבקשות שהובילו לשגיאות. זמן האחזור (זמן אחזור בינוני ואחוזון) הוא זמן האחזור של הבקשות האלה.
כדי לגשת לדף מרכז הבקרה של ממשקי ה-API והשירותים:
- פותחים את הדף 'בורר פרויקטים' במסוף Cloud:
- בוחרים את הפרויקט הרצוי. יופיע הדף של מרכז הבקרה של ממשקי API ושירותים.
אם הדף לא מופיע, לוחצים על הלחצן בתפריט ואז על APIs & Services (ממשקי API ושירותים).
למידע נוסף, ראו מעקב אחר השימוש ב-API.
דף הסקירה הכללית של מפות Google
הדף Overview (סקירה כללית) של מפות Google כולל טבלה עם פירוט של ממשקי ה-API שהופעלו ובקשות השימוש ב-30 הימים האחרונים. בקשות לפי API מוצגות גם בפורמט של תרשים. תרשים החיוב מציג את החיוב הנוכחי ואת השימוש הכולל ב-3 החודשים האחרונים.
כדי לגשת לדף 'סקירה כללית של הפלטפורמה של מפות Google':
- פותחים את הדף 'הפלטפורמה של מפות Google' במסוף Cloud:
- בתפריט הימני, לוחצים על סקירה כללית.
הדף 'ממשקי API ושירותים' בפלטפורמה של מפות Google
הדף APIs & Services במפות Google מכיל רשת של משבצות שמייצגות את ממשקי ה-API, ערכות ה-SDK ושירותים אחרים שזמינים לפרויקט. בכל משבצת, אפשר להפעיל או להשבית את השירות על ידי בחירת האפשרות Enable או Disable, וניתן לגשת לפרטי פרטי הכניסה, לmetrics ולמדריכים למשתמשים עבור ממשקי API שמופעלים. אפשר גם להשתמש במסנני הדפים כדי להציג שירותים מופעלים או מושבתים וקטגוריות שירות אחרות.
כדי לגשת לדף 'ממשקי API ושירותים' בפלטפורמה של מפות Google:
- פותחים את הדף 'הפלטפורמה של מפות Google' במסוף Cloud:
- בתפריט הימני בוחרים באפשרות APIs & Services.
דף המדדים במפות Google
בדף Metrics במפות Google מוצגים שלושה תרשימים: תנועה, שגיאות וזמן אחזור חציוני. אפשר לקבץ את נתוני השימוש בתרשימים לפי מחלקה של קוד תגובה, API, שיטת API, פרטי כניסה, פלטפורמה ודומיין.
מתחת לתרשימים, הדף Metrics כולל טבלת ממשקי API שמציגה בקשות, שגיאות וזמן אחזור לממשקי ה-API שבחרתם.
באמצעות התפריט הנפתח של ה-API בראש הדף ואפשרויות הקיבוץ והסינון שבחלונית השמאלית, תוכלו לקבץ ולסנן את מדדי השימוש המוצגים על ידי בחירת ממשקי API, פרטי כניסה, מחלקות קוד תגובה, סוג פלטפורמה ו/או דומיין ספציפיים או מרובים. אפשר גם לבחור תקופה (שעה אחת עד 30 הימים האחרונים) ורמת פירוט (לשנייה או ליום) למדדי השימוש המוצגים.
בתמונות הבאות מוצגים מסנני פלטפורמה ו-דומיין ל-API יחיד כשקיבוץ לפי פלטפורמה ו-דומיין נבחרים ברשימה הנפתחת Grouped by:
כדי לגשת לדף 'מדדי ה-API של הפלטפורמה של מפות Google':
- פותחים את הדף 'הפלטפורמה של מפות Google' במסוף Cloud:
- בתפריט הימני, לוחצים על מדדים.
דיווח על פרטי כניסה
אפשר לסנן ולקבץ מדדים לפי פרטי הכניסה ששימשו לטעינת ה-API.
הפורמט של פרטי הכניסה | משמעות |
---|---|
שם מפתח לדוגמה, 'מפתח אפליקציה לנייד' |
השתמשנו במפתח API כדי לטעון את ה-API באמצעות ?key=... : שמות המפתחות מופיעים במסוף של מפות Google בקטע Keys & Credentials. |
מספר הפרויקט לדוגמה, 'project_number:123456', כאשר 123456 הוא מספר הפרויקט. |
אם פרטי הכניסה האלה מופיעים בשתי דרכים:
|
תרשימים של קודי תגובה
בתרשימים Traffic לפי קוד תגובה ושגיאה לפי קוד תגובה מפצלים את השימוש לפי מחלקה של קוד תגובת HTTP. בטבלה הזו מוצג המיפוי בין סטטוס התגובה של Google Maps Platform API לבין מחלקה של קוד תגובת HTTP:
סטטוס ה-API של מפות Google | סיווג של קוד תגובת HTTP – דוח שימוש (2xx, 3xx, 4xx, 5xx) |
הערות |
---|---|---|
אישור | 2xx | התשובה הצליחה. זוהי בקשה לחיוב והיא תנצל מכסה. |
אישור | 3xx | התשובה הצליחה. זוהי בקשה לחיוב והיא תנצל מכסה. לדוגמה, בקשות שבוצעו בהצלחה של תמונה של מקום מחזירות הפניה אוטומטית מסוג 302 לתמונה שאליה מתבצעת ההפניה. |
DATA_NOT_AVAILABLE | 4xx(1) | תגובה מוצלחת שמציינת שאין נתונים זמינים
לגבי מיקומי הקלט. זוהי בקשה לחיוב והיא תנצל מכסה. |
ZERO_RESULTS | 4xx(1) | תשובה מוצלחת לא החזירה תוצאה. זוהי בקשה לחיוב והיא תנצל מכסה. |
NOT_FOUND | 4xx(1) | לגבי
Directions API,
ההודעה הזו מציינת שלא ניתן היה לבצע קידוד גיאוגרפי של לפחות אחד מהמיקומים שצוינו
במקור הבקשה, ביעד או בציוני הדרך שלה. לגבי Places API ההודעה הזו מציינת שהמיקום המקושר (place_id) לא נמצא במסד הנתונים של Places. זוהי בקשה לחיוב והיא תנצל מכסה. |
INVALID_REQUEST (ערך פרמטר לא חוקי), MAX_WAYPOINTS_EXCEEDED, MAX_ROUTE_LENGTH_EXCEEDED ועוד. |
4xx | שגיאה שנגרמה בגלל ערך פרמטר לא חוקי. לקבלת פרטים נוספים
אפשר לעיין בתשובה מה-API. זוהי בקשה לחיוב והיא תנצל מכסה. |
REQUEST_DENIED | 4xx | שגיאת לקוח שנגרמת כתוצאה משגיאת אימות, משגיאת גישה ועוד. לפרטים נוספים, אפשר לעיין בתשובה שהתקבלה מה-API. |
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, Resource_EXHAUSTED, rateLimitExceeded, DailyLimitExceeded, userRateLimit exceededed |
4xx | שגיאת לקוח שנגרמה עקב בקשות רבות מדי לכל פרק זמן מותר. אפשר לנסות שוב את הבקשה במועד מאוחר יותר. לפרטים נוספים, אפשר לעיין בתשובה שהתקבלה מה-API. |
INVALID_REQUEST (פרמטר לא חוקי או חסר, שגיאת ניתוח או אימות בקשה) | 4xx | שגיאת לקוח שנגרמה עקב בקשה לא חוקית. לקבלת פרטים נוספים אפשר לעיין בתשובה מה-API. |
NOT_FOUND (404) | 4xx | ב-Geolocation API,
ההודעה הזו מציינת שערכי הקלט לא מספיקים כדי ליצור הערכת מיקום. ב-Roads API, ההודעה הזו מציינת שלא ניתן היה להצמיד את הקלט לכבישים בצורה סבירה. זוהי בקשה לחיוב והיא תנצל מכסה. |
UNKNOWN_ERROR | 5xx | שגיאה בחיבור לשרת שמציינת שלא ניתן להמשיך בבקשה: שגיאה פנימית, שירות עומס יתר, לא זמין, תם הזמן הקצוב לתפוגה ועוד. |
1
כדי לשפר את העקביות בדיווח על קודי שגיאות, ממשקי ה-API של הפלטפורמה של מפות Google
מעבירים:
1) מסיווג של קוד תגובת HTTP 2xx ל-4xx
סטטוסים של ה-API של מפות Google: DATA_NOT_AVAILABLE , NOT_FOUND ,
ZERO_RESULTS - סטטוס,
2) ממחלקה של קוד תגובת HTTP 2xx ל-4xx
בסטטוסים של קוד ה-API של מפות Google: REQUEST_DENIED , OVER_DAILY_LIMIT ,
OVER_QUERY_LIMIT , dailyLimitExceeded , סטטוס של HTTP}, dailyLimitExceeded , rateLimitExceeded , 2xx /userRateLimitExceeded 5xx UNKNOWN_ERROR
תוכלו לראות את שני קודי התגובה במהלך תקופת המעבר. קודי תגובה שמוחזרים בתשובות מה-API של מפות Google לא משתנים.
מוודאים שהעלייה ב-4xx או ב-5xx במדדי הפלטפורמה של מפות Google קשורה להעברה הזו באמצעות בדיקה איזה קוד תגובה מדויק עולה ב-Metrics Explorer (מידע נוסף על השימוש ב-Google Cloud Monitoring לפלטפורמה של מפות Google).
|
למידע נוסף על קודי סטטוס והודעות שגיאה, עיינו בתיעוד התגובות של ה-API הרצוי (לדוגמה, Geocoding Responses או Directions Response).
פרמטר של פתרונות הפלטפורמה של מפות Google
הפלטפורמה של מפות Google מספקת סוגים רבים של קוד לדוגמה כדי לעזור לכם להתחיל לעבוד במהירות. לדוגמה, אפשר להשתמש ב-Quick Builder במסוף Cloud, לפעול לפי המדריכים להטמעה של הפתרונות וללמוד מ-codelabs.
כדי להבין את השימוש ואת הדרכים לשיפור הפתרונות שלנו, Google כוללת את פרמטר השאילתה solution_channel
בקריאות ל-API כדי לאסוף מידע על השימוש בקוד לדוגמה:
- הפרמטר
solution_channel
של השאילתה נכלל כברירת מחדל בקוד לדוגמה של הפתרון. - פרמטר השאילתה מחזיר ל-Google את ניתוח הנתונים לגבי השימוש בפתרון, כדי לשפר את איכות הפתרונות באיטרציות עתידיות.
- כדי לבטל את ההסכמה, אפשר למחוק את הפרמטר
של השאילתה
solution_channel
ואת הערך שלו מקוד לדוגמה. - לא צריך לשמור את הפרמטר. הסרת הפרמטר של השאילתה לא משפיעה על הביצועים.
- פרמטר השאילתה משמש רק לצורך דיווח לדוגמה על השימוש בקוד.
- פרמטר השאילתה נפרד מכל ניתוח ודיווח ספציפיים ל-API. כלומר, הסרת הפרמטר מהקוד לדוגמה של הפתרון לא משביתה את הדיווח הפנימי על JavaScript API של מפות Google.
דוחות מכסות
במכסות מגדירים מגבלות על מספר הבקשות שהפרויקט יכול לשלוח לממשקי ה-API של הפלטפורמה של מפות Google. אפשר להגביל את הבקשות בשלוש דרכים: ליום, לדקה ולכל משתמש לדקה. רק בקשות ובקשות שבוצעו בהצלחה וגורמות לשגיאות בחיבור לשרת נספרות כחלק מהמכסה. בקשות שהאימות נכשל בהן לא נכללות במכסה.
המכסות מוצגות בתרשימים בדף Quotas במסוף Cloud, ואפשר לקבץ אותו בבקשות לדקה. המגבלות הקיימות של ממשקי ה-API שנבחרו מוצגות בטבלאות מתחת לתרשימים של השימוש במכסות.
כדי לקבל את ערך המכסה לדקה של כל מוצר ב-GMP API, אפשר להשתמש במחשבון הזה.
דף המכסות במפות Google
בדף Quotas במפות Google מוצגות המגבלות על המכסות וצריכת המכסות של ה-API הספציפי שבחרתם.
בתרשים השימוש במכסות במסוף Google Cloud מוצגת תעבורת הנתונים הכוללת של מפתחות ה-API ומזהי הלקוח. תעבורת הנתונים של Client-ID זמינה גם בתרשים המדדים במסוף Cloud.
בדף מוצגות רק בקשות שצורכות מכסה: בקשות שבוצעו בהצלחה (OK
, ZERO_RESULTS
, DATA_NOT_AVAILABLE
) ובקשות שגורמות לשגיאות בחיבור לשרת (NOT_FOUND
, INVALID_REQUEST/INVALID_VALUE
(ערך פרמטר לא חוקי), UNKNOWN_ERROR
).
בקשות שגורמות לשגיאות בצד הלקוח – אימות, הרשאה ושגיאות של ארגומנטים לא חוקיים (REQUEST_DENIED
, OVER_QUERY_LIMIT
, INVALID_REQUEST
(פרמטר לא חוקי, שגיאה בניתוח בקשה)) – לא צורכות מכסה ולא מוצגות.
יחידת המכסה היא בקשה לרוב ממשקי ה-API של הפלטפורמה של מפות Google (API של מפות Google, Street View Static API, Geocoding API, Directions API, Places API, Time Zone API, Geolocation API ו-Elevation API), אבל יש כמה יוצאים מן הכלל:
- ב-Destination Matrix API, יחידת המכסה היא רכיב שהוא צמד של נקודת מוצא ויעד.
- ב-Maps JavaScript API, יחידת המכסה היא טעינת מפה.
- ב-SDK של מפות Google ל-Android וב-SDK של מפות Google ל-iOS, יחידת המכסה היא בקשת Street View או טעינת פנורמה. טעינות של מפות זמינות ללא תשלום והן לא נכללות במכסה.
כדי לגשת לדף המכסות בפלטפורמה של מפות Google:
- פותחים את הדף 'הפלטפורמה של מפות Google' במסוף Cloud:
- בתפריט הימני, בוחרים באפשרות Quotas.
- בוחרים API מהרשימה הנפתחת של ה-API.
יחידות מכסה
בטבלה הזו מוצגת יחידת המכסה של ממשקי ה-API של הפלטפורמה של מפות Google.
API של הפלטפורמה של מפות Google | יחידת מכסה |
---|---|
מפות | |
SDK של מפות ל-Android | פנורמה אחת |
SDK של מפות ל-iOS | פנורמה אחת |
Map Tiles API | בקשה אחת |
API של תצוגה אווירית של מפות Google | בקשה אחת |
Maps Static API | בקשה אחת |
Maps JavaScript API | טעינת מפה אחת |
Street View Static API | בקשה אחת |
Maps Embed API | טעינת מפה אחת |
מסלולים | |
Routes API (Compute Routes) | בקשה אחת |
Routes API (מטריצת נתיב של Compute) | רכיב 1 (צמד מקור-יעד) |
Directions API | בקשה אחת |
Distance Matrix API | רכיב 1 (צמד מקור-יעד) |
Roads API | בקשה אחת |
API לאופטימיזציה של מסלולים | בקשה אחת |
מקומות | |
Places API | בקשה אחת |
Address Validation API | בקשה אחת |
Geocoding API | בקשה אחת |
Geolocation API | בקשה אחת |
Time Zone API | בקשה אחת |
סביבה | |
Air Quality API (CurrentConditions ו-HeatmapTile) | בקשה אחת |
Air Quality API (היסטוריה) | דף אחד |
Pollen API | בקשה אחת |
Solar API | בקשה אחת |
דוחות חיוב
צפייה בדוח החיוב
דוחות חיוב על השימוש במוצרים של הפלטפורמה של מפות Google זמינים במסוף Google Cloud. מידע נוסף זמין במאמר חיוב.
כדי לגשת לדוחות החיוב:
- פותחים את הדף 'בורר פרויקטים' במסוף Cloud:
- בוחרים פרויקט.
- לוחצים על לחצן התפריט ואז בוחרים באפשרות חיוב.
- אם יש לכם כמה חשבונות לחיוב, לוחצים על Go to linked billing account כדי לפתוח את הדף Overview של החשבון המקושר לחיוב.
- בתפריט הימני בוחרים באפשרות Reports כדי לפתוח את דף Reports של החיוב של החשבון לחיוב שקישרתם.
הסבר על המבנה של תרשים דוח החיוב
בדוחות החיוב מוצגת העלות לאורך זמן בתרשים קו מוערם. בתצוגת ברירת המחדל מוצגות העלויות היומיות לפי שימוש ספציפי בחודש הנוכחי, כשהן מקובצות לפי פרויקט (לכל המוצרים), כולל זיכויים שהוחלו לפי שימוש ספציפי והעלות הצפויה הכוללת לכל החודש הנוכחי. כל שורה בתרשים (וכל שורה בטבלה המסכמת) תואמים לפרויקט, ומדורגים לפי גובה העלות בסדר יורד. מידע נוסף על פירוש התרשים של דוח החיוב
טיפ: ניתוח השימוש והעלות לכל מק"ט
כדי להבין בצורה מדויקת יותר את פרטי מודל התמחור של תשלום לפי שימוש ואיך הוא משפיע על ההטמעה, כדאי לבחון את השימוש והעלות לפי מק"ט.
כדי לשנות את תצוגת הדוח כך שיוצגו פריטים לפי מק"ט:
- בחלונית שמשמאל לתרשים, מרחיבים את המסנן Group by.
- בוחרים באפשרות מק"ט.
המסננים הזמינים האחרים של דוחות החיוב כוללים את Time range, Projects, Products, SKUs ו-Locations, שמאפשרים לסנן לפי המקומות שמהם נשלחות בקשות ה-API.
כדי לסווג את מקור השימוש בנוסף למוצר, צריך לקבץ את דוחות החיוב לפי אחד מהערכים הרשומים. שלושת המפתחות שקשורים לממשקי API של הפלטפורמה של מפות Google הם goog-maps-api-key-suffix (ארבעת התווים האחרונים של מפתח API), goog-maps-platform-type (הפלטפורמה: Android, iOS, JavaScript או שירות אינטרנט) ו-goog-maps-channel (ערך מספרי מוגדר לערוץ משאילתת API). מידע נוסף על סינון וקיבוץ
כדי להחריג זיכויים ספציפיים לשימוש, מבטלים את הסימון של התיבה Include credits in cost בחלונית השמאלית כדי לשנות את תצוגת התרשים.
מעקב אחרי הצריכה והגבלה
כדי לעזור לכם לתכנן את התקציב ולשלוט בעלויות, תוכלו לבצע את הפעולות הבאות:
- מגדירים התראת תקציב כדי לעקוב אחרי הגידול של ההוצאה בסכום מסוים. הגדרת התקציב לא מגבילה את השימוש ב-API, אלא רק כשסכום ההוצאות מתקרב לסכום שצוין.
להגביל את השימוש היומי ב-API, כדי לנהל את עלות השימוש בממשקי API שניתנים לחיוב. אפשר להגביל את ההוצאות על ידי הגדרת מכסות לבקשות ליום. אפשר להשתמש במשוואה פשוטה כדי לקבוע את המכסה היומית שלכם, בהתאם לסכום שאתם רוצים להוציא. לדוגמה: (הוצאה חודשית / מחיר לכל מק"ט) חלקי 30 = מכסה יומית של בקשות (לממשק API אחד).
מעקב אחר שימוש בכל ערוץ
כדי לעקוב אחרי השימוש בערוצים מספריים, צריך להוסיף את הפרמטר 'channel' לבקשות ה-API. ערכי הערוצים הקבילים היחידים הם מספרים בין 0-999. הנה כמה דוגמאות:
- Geocoding Web Service API
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1
- JavaScript API של מפות Google
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap" async defer></script>
כדאי לעקוב אחרי השימוש בערוץ ישירות בדוח החיוב. הערוצים יופיעו בקטע תוויות כ-goog-maps-channel.
כדי לסנן את דוח החיוב לפי מק"ט וערוץ
- משתמשים במסנן Group by כדי להגדיר מק"ט.
- בוחרים את סמן הטקסט Labels.
- לוחצים על התפריט הנפתח Key ובוחרים באפשרות goog-maps-channel.
- לוחצים על התפריט הנפתח ערך ובוחרים את הערוצים המספריים שרוצים לסנן.
אפשר לקבץ לפי מקש תווית goog-maps-channel כדי לראות את העלות שנוצרת לפי כל ערוץ.
אחרי שמטמיעים בבקשות את נתוני השימוש בערוץ, ייתכן שיהיה עיכוב קצר (עד 24 שעות) עד שהנתונים ישתקפו בדוח החיוב.
ייצוא נתוני החיוב ל-BigQuery
אתם יכולים גם לייצא את נתוני החיוב ל-BigQuery.
BigQuery Export מאפשר לייצא באופן אוטומטי נתונים מפורטים של חיוב ב-Cloud (כמו נתוני אומדנים של שימוש ועלות) באופן אוטומטי במהלך היום ל מערך נתונים נבחר ב-BigQuery. לאחר מכן אפשר לגשת לנתוני החיוב מ-BigQuery כדי לקבל ניתוח מפורט. כך אפשר לקבל שכבת פירוט נוספת לגבי מקור השימוש שלכם בפלטפורמה של מפות Google.
אם אתם רוצים להתחיל לעבוד עם ייצוא ל-BigQuery ולשלוח שאילתות על הנתונים, אתם יכולים לנסות את השאילתה לדוגמה שלמטה. לפני הרצת השאילתה הזו, צריך:
- מפעילים בחשבון את החיוב ואת ייצוא החיובים ב-BigQuery.
- פורמט הטבלה הוא PROJECT_ID.DATASET_NAME.gcp_billing_exportv1BILLING_ACCOUNT_ID כאשר:
- PROJECT_ID הוא מזהה הפרויקט בפועל (למשל, 'my-project-123456').
- DATASET_NAME הוא השם של מערך הנתונים שיצרתם (למשל, SampleDataSet).
- BILLING_ACCOUNT_ID הוא קובץ עזר של מספר החשבון לחיוב שלך,
עם הקידומת 'gcp_billing_exportv1'. לאחר מכן יש לשנות את מקפים (-) לקווים תחתונים (_).
לדוגמה, מספר החשבון לחיוב 123456-7890AB-CDEF01 יהפוך להיות
gcp_billing_export_v1_123456_789AB_CDEF01
.
#standardSQL
SELECT Date(usage_start_time, "America/Los_Angeles") AS billing_day,
invoice.month AS invoice_month,
service.description AS service,
sku.description AS sku,
(
SELECT l.value
FROM Unnest(labels) AS l
WHERE l.KEY = 'goog-maps-channel' ) AS goog_maps_channel,
Round(Sum(usage.amount), 2) AS usage_amount,
usage.unit AS usage_unit,
Round(Sum(cost), 2) AS cost,
cost_type,
currency
FROM PROJECT_ID.DATASET_NAME.gcp_billing_export_v1_BILLING_ACCOUNT_ID
WHERE invoice.month = '202002' -- Change the invoice month with the same format as the example.
GROUP BY billing_day,
invoice_month,
service,
sku,
goog_maps_channel,
usage_unit,
cost_type,
currency
ORDER BY billing_day,
service,
sku
מקורות מידע שקשורים לנושא
חיוב ב-Cloud:
- יצירה, שינוי וסגירה של חשבון לחיוב ב-Cloud
- שינוי הגדרות החיוב של פרויקט
- הצגת דוחות החיוב ומגמות השינוי בעלויות
- הגדרת תקציבים והתראות לגבי תקציבים
- הגבלת השימוש ב-API
סטטוס התגובה והדוחות
בטבלה הבאה מוצג מיפוי בין הסטטוס של Maps API, קוד תגובת HTTP שמוחזר בתשובות של Maps API וסיווג של קוד תגובת HTTP בדוח השימוש, ומציין אם הבקשה תואמת מופיעה בדוחות Usage, Quota ו-Billing.
דוח השימוש במדדי הפלטפורמה של מפות Google מספק רמת פירוט של HTTP response code class
. אם אתם צריכים רמת פירוט גבוהה יותר, תוכלו לעיין במאמר קודי סטטוס תגובה שמופיעים במעקב אחרי השימוש בפלטפורמה של מפות Google.
קודי תגובה שזמינים בתשובות מה-API של מפות Google | זמין בדוח השימוש | דיווח ל | |||
---|---|---|---|---|---|
סטטוס ה-API של מפות Google | קוד תגובת HTTP | מחלקה של קוד תגובת HTTP | Usage | מכסה | חיוב |
אישור | 200, 204, 302 |
2xx, 3xx |
כן | כן | כן |
DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS |
200, 404 |
4xx1 | כן | כן | כן |
INVALID_REQUEST (ערך פרמטר לא חוקי), MAX_ROUTE_LENGTH_EXCEEDED, MAX_WAYPOINTS_EXCEEDED, וכו' |
200, 400 |
4xx | כן | כן | כן |
INVALID_REQUEST (פרמטר לא חוקי/חסר, שגיאה בניתוח בקשה) | 200, 400 |
4xx | כן | לא | לא |
REQUEST_DENIED | 200, 400, 403 |
4xx1 | כן | לא | לא |
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, Resource_EXHAUSTED, DailyLimitExceeded, rateLimitExceeded, userRateLimitExceed |
200, 403, 429 |
4xx1 | כן | לא | לא |
UNKNOWN_ERROR | 200, 500, 503 |
5xx1 | כן | כן | לא |
1
כדי לשפר את העקביות בדיווח על קודי שגיאות, ממשקי ה-API של הפלטפורמה של מפות Google
מעבירים:
1) מסיווג של קוד תגובת HTTP 2xx ל-4xx
סטטוסים של ה-API של מפות Google: DATA_NOT_AVAILABLE , NOT_FOUND ,
ZERO_RESULTS - סטטוס,
2) ממחלקה של קוד תגובת HTTP 2xx ל-4xx
בסטטוסים של קוד ה-API של מפות Google: REQUEST_DENIED , OVER_DAILY_LIMIT ,
OVER_QUERY_LIMIT , dailyLimitExceeded , סטטוס של HTTP}, dailyLimitExceeded , rateLimitExceeded , 2xx /userRateLimitExceeded 5xx UNKNOWN_ERROR
תוכלו לראות את שני קודי התגובה במהלך תקופת המעבר. קודי תגובה שמוחזרים בתשובות מה-API של מפות Google לא משתנים.
מוודאים שהעלייה ב-4xx או ב-5xx במדדי הפלטפורמה של מפות Google קשורה להעברה הזו באמצעות בדיקה איזה קוד תגובה מדויק עולה ב-Metrics Explorer (מידע נוסף על השימוש ב-Google Cloud Monitoring לפלטפורמה של מפות Google).
|
דוחות מעורבות
מדדים עסקיים
הפלטפורמה של מפות Google מספקת לכם תובנות על האינטראקציה של המשתמשים עם המפות שלכם. התובנות האלה כוללות מדדי התעניינות עיקריים כמו צפיות במפה או אינטראקציות עם נקודת עניין. אפשר לנתח את התובנות האלה כדי לגלות מיקומים פופולריים לצורכי פרסום ושיווק, או כדי לבצע אופטימיזציה של חוויית המשתמש.
יכולות הדיווח של תובנות עסקיות כוללות:
- הצגת תמונת מצב כללית של תובנות עסקיות כדי לראות בקצרה מגמות מרכזיות בתובנות עסקיות
- ניתוח נתונים של מדד ספציפי במסוף כדי להתעמק בהבנה של המדדים בצורה מפורטת יותר
- ייצוא מדדים לקובץ CSV כדי לנתח את נתוני התובנות העסקיות בכלי המועדף עליכם לניתוח עסקי
מדדי המעורבות הזמינים כוללים:
- צפיות במפה: מעקב אחר צפיות במפה כתוצאה מהזזה, משינוי מרחק התצוגה או מהטיות. צפיות במפה מחושבות לפי מיקוד על בסיס שבועי (ראשון עד שבת, לפי שעון החוף המערבי של ארה"ב). נתונים חדשים מתפרסמים מדי שבוע ביום רביעי הראשון לאחר תקופת התצפית.
המשתמשים יכולים לצפות בתובנות עסקיות בדף המדדים במסוף Cloud. צריך להפעיל בפרויקט את API JavaScript של מפות Google.
אפשר לנתח את מדדי ההתעניינות ישירות במסוף בעזרת היכולות 'סינון' ו'קיבוץ לפי', כדי להתעמק במדדים בצורה מפורטת יותר. לדוגמה, תוכלו לסנן לפי אזור ספציפי כדי לראות את המגמות של תצוגות המפה רק במיקודים באותו אזור. מצד שני, יכול להיות שתרצו לקבץ לפי אזור ספציפי כדי לצבור אינטראקציות בתוך אותו אזור.
המשתמשים יכולים לייצא את כל קבוצת הנתונים או תצוגה מסוננת לקובץ CSV כדי לנתח את הנתונים לעומק בכלי המועדף עליכם לניתוח עסקי. אפשר להוריד עד 90 יום בכל פעם, והורדות שמכילות יותר מ-60,000 תאים ייחתכו. ייצוא הנתונים של תצוגות המפה לקובץ CSV עשוי להימשך מספר דקות, בהתאם לטווח הזמן שנבחר.
מדדי התובנות העסקיות עוברים אנונימיזציה, ולכן משקפים רק את המגמות הכוללות של המעורבות עם המפות שלכם. ייתכן שמספרים נמוכים של פריטים יעוגלו לאפס, וכתוצאה מכך תוכן של ערכים חריגים יצטמצם.
אפשר לשלוט בגישה לתובנות עסקיות של הפרויקט ב-Cloud במסוף Google Cloud באמצעות ההרשאה של מפות Google Analytics. בעלי הפרויקט מקבלים את ההרשאה הזו כברירת מחדל ויכולים להקצות גישה למשתמשים אחרים לפי הצורך.
אין להשתמש בתובנות עסקיות כדי להעריך את עלויות השימוש. מידע נוסף על השימוש זמין בדוחות השימוש.
Locator Plus
למשתמשי Locator Plus, מרכז הבקרה של ניתוח הנתונים עוזר לנתח ולהפיק תובנות מהנתונים. כך תוכלו לקבל תמונה ברורה לגבי מידת המעורבות של הקונים במאתר החנויות. בעזרת הנתונים משבוע לשבוע הביצועים תוכלו למדוד את הביצועים שלכם משבוע לשבוע, כולל מספר הצפיות, מספר האינטראקציות עם חיפוש Google ופרטי המקום ושיעור ההתעניינות הכולל. בנוסף, במרכז הבקרה מוצגות נקודות השוואה חשובות להשוואה בין ההטמעה שלכם לבין קמעונאים אחרים.
- נכנסים לקטע Locator Plus במסוף Google Cloud.
- נכנסים לקטע Engagement Reports במסוף Google Cloud כדי להציג את מרכז הבקרה של ניתוח הנתונים.
דוח ההשוואה לשוק מאפשר להשוות את הנתונים שלכם לנתונים נצברים בתעשייה מחברות אחרות שמשתפות את הנתונים שלהן. ההשוואה מספקת הקשר חשוב, עוזרת להגדיר יעדים משמעותיים, לקבל תובנות לגבי המגמות בתחום ולהבין את הביצועים שלכם בהשוואה למתחרים.
כדי לראות את נתוני הבנצ'מרק, נתוני המעורבות שלכם כלולים באופן אנונימי בנקודות ההשוואה של Google. כדי לבטל את ההצגה של נתוני המעורבות גם בדוחות ההשוואה לשוק וגם לכלול אותם באופן אנונימי בדוחות ההשוואה לשוק, אתם יכולים להגיש כרטיס תמיכה. בדרך כלל, כרטיס התמיכה יטופל בתוך 3 ימים.