מדידת קמפיינים – Android SDK v2 (מדור קודם)

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

סקירה

מדידת קמפיינים ב-Google Analytics יכולה לעזור לכם לשפר את הערך של ערוצי השיווק שלכם, כי היא מאפשרת לשייך קמפיינים ומקורות תנועה לפעילות המשתמשים באפליקציה.

ב-Google Analytics SDK ל-Android יש כמה סוגים של מדידת קמפיינים:

  • מדידת קמפיינים ב-Google Play - הצגת הקמפיינים, האתרים והאפליקציות שהפנו משתמש לדף של האפליקציה בחנות Google Play כדי להוריד את האפליקציה שלך.
  • מדידת קמפיינים כלליים - הצגת קמפיינים או מקורות תנועה שגרמו להפעלה של האפליקציה שלך היא הותקנה.
  • מדידה של הפניות - אפשרות לראות איזה מקור תנועה מפנה, כמו אתרים או אפליקציות אחרות, הפעיל את האפליקציה שלך אחרי שהיא הותקנה.

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

מדידת קמפיינים ב-Google Play

מדידת הקמפיינים ב-Google Play מאפשרת לך לראות אילו קמפיינים ומקורות תנועה שולחים משתמשים להוריד את האפליקציה שלך מחנות Google Play. אנחנו ממליצים לכל המפתחים להטמיע את מדידת הקמפיינים בחנות Google Play.

איך עובדת מדידת הקמפיינים ב-Google Play

מדידת הקמפיינים בחנות Google Play מסתמכת על שימוש בפרמטרים של קמפיין כדי להעביר מידע על קמפיינים ומקורות תנועה לאפליקציה בזמן ההורדה שלה מחנות Google Play.

בהמשך מופיע תיאור מקצה לקצה של אופן הפעולה של מדידת קמפיינים ב-Google Play:

  1. משתמש לוחץ על קישור ממודעה, מאתר או מאפליקציה, שמעביר אותו לדף האפליקציה שלך בחנות Google Play. הקישור מתויג עם פרמטרים של קמפיין.
  2. לאחר שהמשתמש יוריד ויתקין את האפליקציה, חנות Google Play תשדר במכשיר Intent מסוג INSTALL_REFERRER שכולל את אותם פרמטרים של הקמפיין.
  3. לאחר מכן האפליקציה תגיב ל-Intent הזה באמצעות האובייקט BroadcastReceiver שמסופק בהמשך, תקרא את הפרמטרים של הקמפיין ותשתמש בהם כדי לעדכן את פרטי הקמפיין ב-Google Analytics.

הטמעת מדידת קמפיינים של Google Play

כדי להטמיע מדידה של קמפיינים בחנות Google Play:

‫1. הוספת BroadcastReceiver חדש לקובץ AndroidManifest.xml

הBroadcastReceiver הבא מאפשר לאפליקציה שלך להגיב לשידור ה-Intent של INSTALL_REFERRER מחנות Google Play כשהאפליקציה מותקנת. הוסיפו אותו לקובץ AndroidManifest.xml באופן הבא:

<!-- Used for install referral measurement-->
<service android:name="com.google.analytics.tracking.android.CampaignTrackingService"/>
<receiver android:name="com.google.analytics.tracking.android.CampaignTrackingReceiver" android:exported="true">
  <intent-filter>
    <action android:name="com.android.vending.INSTALL_REFERRER" />
  </intent-filter>
</receiver>

‫2. הוספת פרמטרים של קמפיינים לקישורים בחנות Google Play

פרמטרים של קמפיין משמשים להעברת מידע על הקמפיין או על מקור התנועה שהפנו משתמש לדף האפליקציה בחנות Google Play אל ההטמעה של Google Analytics באפליקציה.

על מנת ללמוד כיצד ליצור מחרוזת פרמטר של קמפיין, ניתן להשתמש בכלי ליצירת כתובות URL של Google Play, או לעיין בקטע ההפניה פרמטרים של קמפיין.

אחרי שיוצרים את מחרוזת הפרמטר של הקמפיין, צריך להוסיף אותה לכתובות ה-URL בחנות Google Play בתור הערך של הפרמטר referrer, כמו בדוגמה הזו: 

https://play.google.com/store/apps/details?id=com.example.app
&referrer=utm_source%3Dgoogle
%26utm_medium%3Dcpc
%26utm_term%3Drunning%252Bshoes
%26utm_content%3DdisplayAd1
%26utm_campaign%3Dshoe%252Bcampaign

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

מדידת קמפיינים כלליים

ניתן להשתמש במדידה כללית של הקמפיין כדי לשייך קמפיין או מקור תנועה למשתמש אחרי שהוא כבר התקין את האפליקציה.

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

יישום מדידה כללית של קמפיינים

כדי להגדיר ערכי קמפיין לקמפיין כללי, צריך לקרוא לפונקציה setCampaign() ולהעביר מחרוזת פרמטר של קמפיין כארגומנט.

הטמעה אופיינית עשויה לבצע קריאה אל setCampaign() כשהאפליקציה מופעלת, ולבדוק את הכוונה שהפעילה אותה, כדי לראות אם קיימים פרמטרים חוקיים של הקמפיין:

public class SampleActivity extends Activity {

  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Get the intent that started this Activity.
    Intent intent = this.getIntent();
    Uri uri = intent.getData();

    // Call setContext() here so that we can access EasyTracker
    // to update campaign information before calling activityStart().
    EasyTracker.getInstance().setContext(this);

    if (intent.getData() != null) {
      EasyTracker.getTracker().setCampaign(uri.getPath());
    }
    ... // The rest of your onCreate() code.
  }

  @Override
  public void onStart() {
    super.onStart();
    EasyTracker.getInstance().activityStart(this);
    ... // The rest of your onStart() code.
  }


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

מדידת הפניות

מדידת ההפניות דומה לסוגים אחרים של מדידת קמפיינים, בכך שהיא מאפשרת למדוד מקור מפנה שהפעיל את האפליקציה במכשיר של משתמש. עם זאת, מדידת ההפניות משתמשת במחרוזת פשוטה כמו "google.com" או "myOtherApp", במקום במחרוזת של פרמטרים של קמפיין.

כשמגדירים מקור מפנה, כמו 'google.com', מאפיין המקור מוגדר ל-'google.com', והמאפיין 'אמצעי הגעה לאתר' מוגדר באופן מרומז כ-'referrer'

בדומה למדידת קמפיין, הגדרה של מקור מפנה תגרום כברירת מחדל לכך שהקריאה הבאה שתשלח תתחיל פעילות חדשה באתר.

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

public class SampleActivity extends Activity {

  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Get the intent that started this Activity.
    Intent intent = this.getIntent();
    Uri uri = intent.getData();

    // Call setContext() here so that we can access EasyTracker
    // to update campaign information before activityStart() is called.
    EasyTracker.getInstance().setContext(this);

    if (uri != null) {
      if(uri.getQueryParmeter("utm_source") != null) {    // Use campaign parameters if avaialble.
        EasyTracker.getTracker().setCampaign(uri.getPath());
      } else if (uri.getQueryParameter("referrer") != null) {    // Otherwise, try to find a referrer parameter.
        EasyTracker.getTracker().setReferrer(uri.getQueryParameter("referrer"));
      }
    }
  }


  @Override
    public void onStart() {
    super.onStart();
    EasyTracker.getInstance().activityStart(this);
    ... // The rest of your onStart() code.
  }


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

בעיות מוכרות

  • ה-Javadoc של CampaignTrackingReceiver משתמש בנתיב מחלקה שגוי בדוגמת השימוש שלו. כדי להבין מה השימוש הנכון, אפשר לעיין במאמר הטמעה של מדידת קמפיינים ב-Google Play.
  • ניתן לציין רק מחלקה אחת של BroadcastReceiver לכל אפליקציה. אם עליך לשלב שני או יותר BroadcastReceivers מערכות SDK שונות, עליך ליצור מחלקה BroadcastReceiver משלך שתקבל את כל השידורים ותקרא ל-BroadcastReceivers המתאים לכל סוג שידור.
  • מדידת קמפיינים ב-Google Play לא תומכת בשלב זה בהתקנות מאתר למכשיר שמקורן בחנות Play באינטרנט.

פרמטרים של קמפיין

פרמטרים של קמפיינים משמשים להעברת מידע על מקורות התנועה ועל הקמפיינים שמביאים משתמשים לאפליקציה שלך.

  • במדידה כללית של הקמפיין, מחרוזת פרמטר לא מקודדת של קמפיין מועברת כארגומנט ל-setCampaign() .
  • בכלי למדידת קמפיינים ב-Google Play, פרמטר referrer עם מחרוזת מקודדת של פרמטר קמפיין מצורף לכל כתובת URL שמפנה לדף של האפליקציה בחנות Play.

הדוגמה הבאה היא מחרוזת חוקית ולא מקודדת של קמפיין, שאפשר להשתמש בה למדידה כללית של קמפיין:

"utm_campaign=my_campaign&utm_source=google&utm_medium=cpc&utm_term=my_keyword&utm_content=ad_variation1"

הטבלה הבאה מציגה את הרשימה המלאה של הפרמטרים הזמינים של הקמפיין, שניתן להשתמש בהם ב-Google Play או במדידה כללית של הקמפיין.

פרמטר תיאור דוגמאות
utm_campaign שם הקמפיין; משמש לניתוח של מילות מפתח כדי לזהות קידום מכירות של מוצר ספציפי או קמפיין אסטרטגי utm_campaign=spring_sale
utm_source מקור הקמפיין; משמש לזיהוי מנוע חיפוש, ניוזלטר או מקור אחר utm_source=google
utm_medium אמצעי ההגעה לאתר בקמפיין; משמש לזיהוי אמצעי הגעה לאתר, כמו אימייל או עלות לקליק (CPC) utm_medium=cpc
utm_term מונח של קמפיין; משמש לחיפוש בתשלום כדי לספק את מילות המפתח למודעות utm_term=running+shoes
utm_content תוכן הקמפיין. משמש לבדיקות A/B ולמודעות שמטורגטות לפי תוכן כדי להבדיל בין מודעות או קישורים שמפנים לאותה כתובת URL utm_content=logolink
utm_content=textlink
gclid פרמטר התיוג האוטומטי של Google Ads; משמש למדידה של Google Ads. הערך הזה נוצר באופן דינמי ואין לשנות אותו אף פעם.

הכלי ליצירת כתובות URL של Google Play

בעזרת הכלי ליצירת כתובות URL של Google Play, אפשר ליצור כתובות URL למדידת קמפיינים ב-Google Play.