באמצעות Google Analytics Management API יש גישה פרוגרמטית לחשבונות, לנכסים ולתצוגות מפורטות. מסמך זה מתאר כיצד להשתמש במשאבי API שונים כדי להגדיר את חשבון Google Analytics שלך.
מבוא
יש שני תרחישים נפוצים ש-Management API מטפל בהם בכל הנוגע להגדרת חשבון Google Analytics. הדרך הראשונה היא לקבל סיכום חשבון של עץ היררכי מלא של חשבונות, נכסים ותצוגות מפורטות. השלב השני הוא לבצע שינויים ספציפיים בהגדרה.
סיכומי חשבונות
נקודת הקצה סיכומים של חשבונות מספקת דרך קלה להצגת מידע קל לגבי חשבונות, נכסים ותצוגות מפורטות של משתמש מורשה ב-Google.
אפשר להשתמש בסיכומי החשבונות כדי ליצור אינדקס בהיררכיה של החשבונות. לרוב, יש אפליקציות שמשתלבות עם Google Analytics כדי לאפשר למשתמשים לבחור חשבון, נכס ותצוגה מפורטת. באמצעות בקשה יחידה ל-API, אפשר לאחזר את כל המידע הרלוונטי כדי ליצור בורר כזה. תוכלו לעיין בסייר השאילתות ובדוגמאות קוד ב-GitHub.
לקבלת פרטים ודוגמאות קוד, אפשר לעיין בהפניות המשאבים ובחומר העזר בנושא שיטות לרשימה בחשבון.
תצורת חשבון
בניגוד לתקצירי חשבונות כשמשתמשים בשיטת הרשימה של משאבים חשבון, נכס ותצוגה, ה-API מחזיר פרטים מלאים על כל משאב.
חשבונות
מכיוון שחשבונות הישות ברמה העליונה חשובים, לכל בקשת API ברמה נמוכה נדרש מספר חשבון. ה-API לניהול מאפשר רק את הפעולה רשימה בחשבונות. הערה חשובה בתגובה ל-API היא הנכס childlink שמספק את בקשת ה-API לכל נכסי האינטרנט הצאצאים.
נכסים
נקרא גם 'נכסי אינטרנט'. הישות ברמה השנייה חשובה מפני שכל איסוף הנתונים מתבצע ברמה הזו. לדוגמה, כשמוסיפים קוד מעקב לאתר או לאפליקציה לנייד, צריך לכלול מזהה שנראה כמו UA-XXXXX-Y. מזהה זה נקרא מזהה נכס או מזהה לצורכי מעקב, ומפריד בין הנתונים שנשמרים בחשבון Google Analytics. ניתן להשתמש ב-API כדי ליצור או לעדכן נכסים, וניתן לעיין במשאב הנכס כדי לקבל פרטים ודוגמאות של קוד.
צפיות
כרמה השלישית בהיררכיה של החשבון, צפיות (פרופילים) חשובות משום שזו הרמה שבה מתבצע הדיווח. ב-Core Reporting API, נעשה שימוש במזהה התצוגה המפורטת (הפרופיל) כפרמטר חשוב לציון התצוגה המפורטת לאחזור נתונים. בנוסף לרמת הדיווח על משאבים רבים אחרים המקושרים זה לזה או כצאצאים של משאב זה, לדוגמה, יעדים, ניסויים, דוחות ללא דגימה וקישורים למסננים. ניתן להשתמש ב-API כדי ליצור או לעדכן תצוגות מפורטות, ובמשאב התצוגה (פרופיל) ניתן למצוא פרטים ודוגמאות לקוד.
השלבים הבאים
אחרי שתקראו את המדריך הזה, חשוב להבין איך להשתמש ב-Management API כדי לעבור בין ישויות שונות בתצורות החשבון. במדריך הבא נסביר איך להשתמש ב-API כדי לבצע ניהול משתמשים.