פיט פריסלה, תומך למפתחים של Google Analytics – יולי 2013
מסמך זה עוסק ב-SuperProxy של Google Analytics ומסביר כיצד להתחיל לעבוד, להשתמש בתכונות ספציפיות ונדון בשיקולים חשובים.
מבוא
שרת ה-SuperProxy של Google Analytics מאפשר לשתף באופן ציבורי את נתוני הדיווח שלך ב-Google Analytics. אפשר להשתמש בו כדי להפעיל ווידג'טים ומרכזי בקרה בהתאמה אישית, לשנות תגובות לפורמטים שונים, לבצע בדיקות ועוד הרבה יותר.
שרת ה-SuperProxy של Google Analytics פועל עם ממשק ה-API הראשי לדיווח, עם ממשק ה-API לדיווח בזמן אמת ועם ממשק ה-API של דיווח משפכים מרובי-ערוצים.
תכונות עיקריות:
- לשתף באופן ציבורי את הנתונים שלכם ב-Google Analytics.
- משתמשים בשרת ה-proxy כדי להפעיל מרכזי בקרה בהתאמה אישית.
- המרה לקובץ CSV, טבלת נתונים, TSV.
- המערכת תומכת בתאריכים יחסיים (למשל, 7 הימים האחרונים).
- מתבצע רענון אוטומטי של נתוני הדוח.
- שמירה במטמון – תגובות מהירות וניצול יעיל של המכסות.
איך זה עובד
אפשר ליצור שאילתה לנתוני Google Analytics, ונתוני הדיווח הספציפיים יהיו זמינים באופן ציבורי בכתובת URL חדשה שתהיה לך אפשרות לשתף. כל מי שנכנס לכתובת ה-URL מקבל גישה לנתוני הדיווח בלי לדרוש הרשאה כלשהי.
לדוגמה, אפשר ליצור שאילתה כדי לאחזר את 10 הדפדפנים המובילים על סמך צפיות בדף בשבוע האחרון, ושאילתה אחת לגבי מספר הסשנים אתמול וכן הלאה. אתם מחליטים אילו שאילתות אתם רוצים להפוך לציבוריים ובאיזו תדירות תרצו שהנתונים יתעדכנו, ושרת-העל של Google Analytics יטפל בכל השאר.
טיפ: אפשר להשתמש ב-Query Explorer כדי ליצור דוחות ואז להעתיק את Query URI כדי להשתמש בו עם שרת ה-Super proxy של Google Analytics
הגדרה ויצירה של שאילתה
שרת ה-SuperProxy של Google Analytics הוא אפליקציית אינטרנט שפועלת בסביבת Google App Engine. אפשר להוריד את האפליקציה ולפרוס אותה בעזרת סדרת הוראות פשוטה.
ניהול משתמשים
שרת ה-SuperProxy של Google Analytics כולל ממשק פשוט לניהול משתמשים שניתן להשתמש בו כדי להוסיף משתמשים. כל משתמש יוכל רק להציג ולנהל שאילתות API שהוא יוצר.
רק אדמינים יכולים לנהל משתמשים. כדי להוסיף משתמש חדש:
- בממשק הניהול של SuperProxy של Google Analytics (למשל,
https://your-application-id.appspot.com/admin), לוחצים על הלחצן Manage Users (ניהול משתמשים). - בדף Manage Users, מזינים את כתובת האימייל של המשתמש שרוצים להוסיף ולוחצים על הלחצן Add User. המשתמש יתווסף, אבל לא תהיה לו גישה עד שהוא יפעיל את החשבון.
- מבקשים מהמשתמש להפעיל את החשבון שלו על ידי כניסה
לדף
/admin/activate. למשל,https://your-application-id.appspot.com/admin/activate. כדי שההפעלה תעבוד, הם צריכים להיכנס לחשבון Google שמשויך לכתובת האימייל שהוספת. - לאחר שהמשתמש יפעיל את החשבון, הוא יוכל להיכנס לדף
/admin, לאשר גישה לחשבון Google Analytics שלו ולהתחיל ליצור שאילתות API משלו.
משתמשים עם הרשאת אדמין
מנהלי מערכת של שרת proxy ב-Google Analytics מתווספים באמצעות מסוף הניהול של App Engine. כל משתמש שיתווסף דרך המסוף הזה, בכל תפקיד, יהיה אדמין.
אדמינים יכולים להציג ולנהל את שאילתות ה-API של המשתמשים.
הגבלות על דומיינים
במקרים מסוימים, ייתכן שתרצה לנצל את התכונות המוצעות על ידי שרת ה-SuperProxy של Google Analytics, אבל אינך רוצה להגדיר נתונים כציבוריים מעבר לקבוצה מסוימת של משתמשים או דומיין. כברירת מחדל, בכל אפליקציה חינמית שמתארחת ב-App Engine, כל מי שמחובר לחשבון Google יכול לגשת לנקודות הקצה הציבוריות שלך.
אם תרצו להגביל עוד יותר את הגישה לאפליקציה, עליכם להטמיע את שכבת האימות שלכם מול SuperProxy ב-Google Analytics או להשתמש ב-G Suite, שמאפשר להגביל אפליקציה למשתמשים שמנוהלים על ידי הדומיין שלכם. לפרטים נוספים, ראו הגדרת האימות של האפליקציה.
שיקולים בנוגע למכסה
שרת ה-SuperProxy של Google Analytics עוזר לחסוך במכסות על ידי הצגת נתוני דיווח מהמטמון/מאגר הנתונים. עם זאת, הגדרה של מרווחי רענון קצרים עדיין עלולה לגרום לניצול מהיר של המכסה. כדי להימנע מכך, צריך לרענן את השאילתות במרווחי זמן סבירים לסוג הנתונים המבוקשים.
App Engine
מגבלות ברירת המחדל למכסות באפליקציות של App Engine הן נדיבות, וסביר להניח שהן יספיקו לרוב התרחישים לדוגמה. עם זאת, אפשר להפעיל את החיוב כדי להגדיל או להסיר את מגבלות ברירת המחדל. לפרטים נוספים אפשר לעיין במאמר מכסות ל-App Engine.
מעקב אחר קהילות ובעיות
פורום SuperProxy של Google Analytics הוא קבוצת דיון שבה אפשר לשאול שאלות, לשתף רעיונות ולקבל משוב על הפרויקטים המדהימים שלך.
הכלי למעקב אחר בעיות מאפשר לדווח על בעיות ובקשות להוספת תכונות, ולעקוב אחריהן.