Google Analytics SDK for Android v2 (מדור קודם) - סקירה כללית

Google Analytics SDK ל-Android מאפשר למפתחים לאסוף בקלות נתוני מעורבות של משתמשים מהאפליקציות שלהם. במסמך הזה נספק סקירה כללית של הערך של ה-SDK ומדריך לתחילת העבודה עם מדידת האפליקציה שלכם באמצעות מזהה נכס יחיד ו-EasyMonitor.

מבוא

ה-SDK של Google Analytics ל-Android מקל על מפתחים לאסוף בקלות נתוני מעורבות של משתמשים מהאפליקציות שלהם. לאחר מכן המפתחים יכולים להשתמש בדוחות של Google Analytics כדי למדוד:

  • מספר המשתמשים הפעילים שמשתמשים באפליקציות שלהם.
  • מאיפה בעולם משתמשים באפליקציה.
  • אימוץ תכונות מסוימות ושימוש בהן.
  • עסקאות ורכישות מתוך האפליקציה.
  • המספר והסוג של קריסות האפליקציה.
  • ומדדים שימושיים רבים נוספים.

בנוסף, Google Analytics SDK ל-Android מספק כלים למעקב אחר ההצלחה של קמפיינים שיווקיים לנייד, באמצעות תמונה מקצה לקצה של הביצועים של הערוצים השיווקיים, החל מההתקנות ב-Google Play, דרך עסקאות ורכישות מתוך האפליקציה.

לפני שתתחיל

לפני שמתחילים להטמיע את ה-SDK, חשוב לוודא שהתנאים הבאים מתקיימים:

תחילת העבודה

יש שלושה שלבים לתחילת העבודה עם ה-SDK:

  1. עדכון AndroidManifest.xml
  2. הוספת שיטות EasyMonitor
  3. יוצרים קובץ analytics.xml

אחרי שתבצעו את השלבים האלה, תוכלו למדוד את הנתונים הבאים באמצעות 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, כמו בדוגמה הבאה:

/**
 * An example Activity in your app with Analytics
 * implemented.
 */
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().activityStart(this); // Add this method.
  }

  @Override
  public void onStop() {
    super.onStop();
    ... // The rest of your onStop() code.
    EasyTracker.getInstance().activityStop(this); // Add this method.
  }
}

שימו לב שכדי להפעיל את השיטות של Easytracker יש צורך ב-Context. בדוגמה שלמעלה, השורה הבאה: 

EasyTracker.getInstance.activityStart(this);

מגדיר את ההקשר. עם זאת, אם אתם צריכים לבצע שיחות דרך Easytracker בכיתות או בשיטות אחרות, תחילה עליכם לקרוא לשיטה setContext(Context ctx) של Easytracker:

// Set Context before using EasyTracker. Note that the SDK will
// use the application context.
EasyTracker.getInstance().setContext(this);

// EasyTracker is now ready for use.

3. המערכת יוצרת את הקובץ analytics.xml

בגרסה 2 של Google Analytics SDK ל-Android, אפשרויות התצורה מנוהלות מקובץ משאב XML שנקרא analytics.xml במדריך הזה. תצטרכו ליצור את הקובץ הזה בספרייה res/values של הפרויקט ולהוסיף את המזהה לצורכי מעקב. הדוגמה הבאה מראה איך להוסיף את המזהה לצורכי מעקב, ולהפעיל מדידה של Activity ושל חריגים:

<?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 מופיעה רשימה מלאה של הפרמטרים שבהם אפשר להשתמש כדי להגדיר את ההטמעה.

כל הכבוד! האפליקציה שלך מוגדרת עכשיו לשליחת נתונים אל Google Analytics.

השלבים הבאים

תוכל לבצע הרבה יותר פעולות באמצעות Google Analytics, כולל מדידת קמפיינים, תשלומים ועסקאות בתוך האפליקציה ואירועים של אינטראקציות עם משתמשים. מומלץ לעיין במדריכים הבאים למפתחים כדי ללמוד איך להוסיף את התכונות האלה להטמעה:

  • הגדרות מתקדמות – מידע נוסף על אפשרויות הגדרה מתקדמות, כולל שימוש במספר כלי מעקב.
  • מדידת קמפיינים – כאן מוסבר איך להטמיע את מדידת הקמפיינים כדי להבין אילו ערוצים וקמפיינים מובילים להתקנות של האפליקציה.
  • מדידת אירועים – כאן מוסבר איך למדוד את מעורבות המשתמשים בתוכן אינטראקטיבי כמו לחצנים, סרטונים ומדיה אחרת באמצעות אירועים.
  • Measurement In-App Payments – איך מודדים תשלומים ועסקאות מתוך האפליקציה.
  • תזמוני משתמש – למד כיצד למדוד תזמוני משתמש באפליקציה כדי למדוד זמני טעינה, מעורבות עם מדיה ועוד.
  • פרמטרים של Analytics.xml – הרשימה המלאה של פרמטרים של הגדרות analytics.xml.