Google Analytics SDK עבור Android v3 (מדור קודם) - תחילת העבודה

במאמר הזה נסביר איך להתחיל להשתמש ב-Google Analytics SDK ל-Android v3.

לפני שתתחיל

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

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.