במאמר הזה נסביר איך להתחיל להשתמש ב-Google Analytics SDK ל-Android v3.
לפני שתתחיל
לפני שתטמיעו את ה-SDK, עליכם לוודא שיש לכם:
- Android Developer SDK (זמין ל-Windows, ל-Mac OS X ול-Linux)
- Google Analytics SDK ל-Android v3 (עם
libGoogleAnalyticsServices.jar
כלול בספריית/libs
ובנתיב ה-build של הפרויקט) - אפליקציה ל-Android שבה אפשר להשתמש כדי להטמיע את Google Analytics
- לפחות נכס אחד ותצוגת אפליקציה (פרופיל) אחד של Google Analytics שאליהם יש לשלוח נתונים מהאפליקציה שלך
תחילת העבודה
יש שלושה שלבים לתחילת העבודה עם ה-SDK:
אחרי שתבצעו את השלבים האלה, תוכלו למדוד את הנתונים הבאים באמצעות Google Analytics:
- התקנות של אפליקציות
- משתמשים פעילים ומידע דמוגרפי
- מסכים ומעורבות משתמשים
- קריסות וחריגים
1. מתבצע עדכון של AndroidManifest.xml
מעדכנים את הקובץ AndroidManifest.xml
על ידי הוספת ההרשאות הבאות:
<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
2. הוספת שיטות Easytracker
מוסיפים את שיטות השליחה לשיטות onStart()
ו-onStop()
של כל אחת מ-Activities
, כמו בדוגמה הבאה:
package com.example.app; import android.app.Activity; import com.google.analytics.tracking.android.EasyTracker; /** * An example Activity using Google Analytics and EasyTracker. */ public class myTrackedActivity extends Activity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); } @Override public void onStart() { super.onStart(); ... // The rest of your onStart() code. EasyTracker.getInstance(this).activityStart(this); // Add this method. } @Override public void onStop() { super.onStop(); ... // The rest of your onStop() code. EasyTracker.getInstance(this).activityStop(this); // Add this method. } }
3. המערכת יוצרת את הקובץ analytics.xml
כשמשתמשים ב-EasyMonitor, הגדרות התצורה הגלובליות מנוהלות באמצעות משאבים שמוגדרים ב-XML. יוצרים קובץ בשם analytics.xml
בספריית res/values
של הפרויקט ומוסיפים את המשאבים הבאים:
<?xml version="1.0" encoding="utf-8" ?> <resources> <!--Replace placeholder ID with your tracking ID--> <string name="ga_trackingId">UA-XXXX-Y</string> <!--Enable automatic activity tracking--> <bool name="ga_autoActivityTracking">true</bool> <!--Enable automatic exception tracking--> <bool name="ga_reportUncaughtExceptions">true</bool> </resources>
יכול להיות שבודק איתור השגיאות בקוד יזהיר אתכם לגבי השימוש בקו המפריד ('-')
במזהה המעקב. אפשר להסתיר את האזהרה על ידי הוספת מאפיינים לתג <resources>
:
<resources xmlns:tools="http://schemas.android.com/tools" tools:ignore="TypographyDashes">
בחומר העזר בנושא פרמטרים של analytics.xml מופיעה רשימה מלאה של הפרמטרים שבהם אפשר להשתמש כדי להגדיר את ההטמעה. בהתאם לדרישות של האפליקציות, יכול להיות שתרצו לשנות את תקופת השליחה כדי לוודא שאתם שולחים היטים כמו שצריך. לדוגמה, אם אתם רוצים לראות נתונים בזמן אמת, כדאי להגדיר אותו לערך נמוך, כמו 5 שניות.
כל הכבוד! האפליקציה שלך מוגדרת עכשיו לשליחת נתונים אל Google Analytics.
השלבים הבאים
תוכל לבצע הרבה יותר פעולות באמצעות Google Analytics, כולל מדידת קמפיינים, תשלומים ועסקאות בתוך האפליקציה ואירועים של אינטראקציות עם משתמשים.
המדריכים הבאים למפתחים כוללים פרטים נוספים על הטמעת התכונות של Google Analytics באפליקציה:
- מדידת אירועים – כאן מוסבר איך למדוד את מעורבות המשתמשים בתוכן אינטראקטיבי כמו לחצנים, סרטונים ומדיה אחרת באמצעות אירועים.
- Measurement In-App Payments – איך מודדים תשלומים ועסקאות מתוך האפליקציה.
- מדידת קמפיינים – כאן מוסבר איך להטמיע את מדידת הקמפיינים כדי להבין אילו ערוצים וקמפיינים מובילים להתקנות של האפליקציה.
- תזמוני משתמש – למד כיצד למדוד תזמוני משתמש באפליקציה כדי למדוד זמני טעינה, מעורבות עם מדיה ועוד.
- הגדרות מתקדמות – מידע נוסף על אפשרויות הגדרה מתקדמות, כולל שימוש במספר כלי מעקב.
-
פרמטרים של Analytics.xml – אפשר לראות את הרשימה המלאה של פרמטרים של הגדרות
analytics.xml
.