Google Tag Manager ל-Android

מפתחים יכולים להשתמש ב-Google Tag Manager כדי להטמיע ולנהל תגי מדידה ופיקסלים באפליקציות לנייד, בלי שתצטרכו ליצור מחדש קבצים בינאריים של אפליקציות ולשלוח אותם מחדש לזירות מסחר של אפליקציות. מפתחים שעובדים עם Google Analytics for Firebase SDK יכולים להוסיף בקלות את Tag Manager כדי לנהל את ההטמעה ולבצע שינויים בה, גם לאחר שליחת האפליקציה.

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

דרישות מוקדמות

לפני שמתחילים:

בקטעים הבאים מוסבר איך להגדיר את Google Tag Manager ולהשתמש בו באפליקציה ל-Android.

1. הוספת Google Tag Manager לפרויקט

  1. בקובץ Gradle של המודול (בדרך כלל app/build.gradle), מוסיפים את התלות הבאה בספריית Tag Manager:

    dependencies {
      // ...
      compile 'com.google.android.gms:play-services-tagmanager:18.0.4'
    }
    
  2. נכנסים לחשבון Tag Manager.

  3. בוחרים מאגר תגים לנייד.

  4. לוחצים על גרסאות בסרגל הניווט העליון.

  5. לחץ על גרסת כלי הקיבול שבה ברצונך להשתמש.

  6. לוחצים על הורדה.

  7. יוצרים את התיקייה app/src/main/assets/containers אם היא לא קיימת. מעתיקים את הקונטיינר שהורדתם לתיקייה.

2. רישום אירועים ומשתנים ביומן

Tag Manager משתמש באירועים, בפרמטרים ובמאפייני משתמשים שנרשמו על ידי Google Analytics for Firebase SDK כדי להפעיל וליצור תגים שהגדרתם ב-Google Tag Manager.

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

הגדרת משתנים ב-Tag Manager

כדי לתעד את הערך של הפרמטרים של האירועים ושל מאפייני המשתמשים לשימוש ב-Google Tag Manager, אפשר להגדיר משתנים בממשק של Tag Manager.

לדוגמה, אפשר לתעד באפליקציה את האירוע המותאם אישית הבא:

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

לאחר מכן תוכלו להגדיר משתנים חדשים של פרמטרים של אירועים ב-Tag Manager באופן הבא כדי לתעד את הערכים image_name ו-full_text parameter:

  • שם משתנה: שם תמונה
  • סוג משתנה: פרמטר אירוע
  • שם מפתח של פרמטר אירוע: image_name

וגם:

  • שם המשתנה: טקסט מלא
  • סוג משתנה: פרמטר אירוע
  • שם מפתח של פרמטר אירוע: full_text

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

mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);

לאחר מכן תוכלו להגדיר משתנה חדש של מאפיין משתמש ב-Firebase ב-Google Tag Manager כדי לתעד את הערך favorite_food:

  • שם המשתנה: האוכל המועדף
  • סוג משתנה: מאפיין משתמש ב-Firebase
  • שם מפתח של פרמטר אירוע: favorite_food

לשנות ולחסום אירועים

Tag Manager מאפשר לשנות ולחסום אירועים לפני שהם מתועדים ב-Google Analytics for Firebase SDK. שינוי של אירועים יכול לעזור לכם להוסיף, להסיר או לשנות את הערכים של פרמטרים של אירועים, או לשנות את שמות האירועים בלי עדכונים לאפליקציה. אירועים שלא חסומים יתועדו על ידי ה-SDK של Google Analytics for Firebase.

אירועים ומאפייני משתמשים מסוימים גם מתועדים ב-Google Analytics for Firebase SDK. אפשר להשתמש באירועים ובמאפיינים שנאספים באופן אוטומטי ב-Tag Manager בלי להוסיף קוד. עם זאת, אי אפשר לחסום אותו.

3. שליחת אירועים

משתנים של שמות אירועים ב-Firebase, משתנים של פרמטרים של אירועים ב-Firebase ומשתנים אחרים משמשים להגדרת טריגרים. תנאי ההפעלה נבדקים בכל פעם שרושמים אירוע ב-Firebase. כברירת מחדל, אירועים של Google Analytics for Firebase מופעלים באופן אוטומטי. ניתן להוסיף תג של Google Analytics for Firebase ב-Tag Manager כדי לחסום שליחה של אירועים ל-Google Analytics.

4. תצוגה מקדימה, ניפוי באגים ופרסום של מאגר התגים

לפני פרסום גרסה של מאגר התגים, מומלץ להציג אותו בתצוגה מקדימה כדי לוודא שהוא פועל כראוי. Google Tag Manager מאפשר להציג גרסאות של הקונטיינר בתצוגה מקדימה באמצעות יצירת קישורים וקודי QR בממשק האינטרנט ושימוש בהם לפתיחת האפליקציה. ניתן גם להפעיל מצב רישום מפורט ביומן כדי לנפות באגים בכל התנהגות לא צפויה.

תצוגה מקדימה של מאגר התגים

לפני שמציגים תצוגה מקדימה של מאגר תגים, צריך ליצור כתובת URL לתצוגה מקדימה בממשק האינטרנט של Google Tag Manager. לשם כך, בוחרים את הגרסה של מאגר התגים שרוצים להציג בתצוגה מקדימה, ואז בוחרים באפשרות Preview (תצוגה מקדימה). יש לשמור את כתובת ה-URL של התצוגה המקדימה לשלבים מאוחרים יותר.

כתובות URL לתצוגה מקדימה זמינות בחלון התצוגה המקדימה של ממשק האינטרנט של Tag Manager
איור 1: כתובת ה-URL לתצוגה מקדימה של ממשק האינטרנט של Tag Manager.

כדי לראות תצוגה מקדימה של מאגר התגים (אם אתם משתמשים ב-Android Studio, מדלגים לשלב 3):

  1. הוסף את פעילות התצוגה המקדימה הזו לקובץ AndroidManifest:

    <!--  Add preview activity. -->
    <activity
      android:name="com.google.android.gms.tagmanager.TagManagerPreviewActivity"
      android:noHistory="true"> <!-- optional, removes previewActivity from activity stack. -->
      <intent-filter>
        <data android:scheme="tagmanager.c.com.example.app" />
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE"/>
      </intent-filter>
    </activity>
    
  2. שנה את השורה הזו כך שתכלול את שם החבילה של האפליקציה:

    <data android:scheme="tagmanager.c.com.example.app"/>
    
  3. בממשק האינטרנט של Google Tag Manager, יוצרים קישור לתצוגה מקדימה:

    1. נכנסים לחשבון Tag Manager.
    2. בוחרים מאגר תגים לנייד.
    3. לוחצים על גרסאות בסרגל הניווט העליון.
    4. לוחצים על Actions > Preview בגרסת הקונטיינר שרוצים להציג תצוגה מקדימה שלו.
    5. הזן את שם החבילה של האפליקציה.
    6. לוחצים על יצירת קישור להתחלת התצוגה המקדימה.
  4. מפסיקים את האפליקציה ומשתמשים בקישור לתצוגה המקדימה או בקוד ה-QR שנוצרו כדי להפעיל אותה.

  5. כדי לצאת ממצב התצוגה המקדימה, לוחצים על קישור שנוצר על ידי האפשרות Generate end Preview link (יצירת קישור לסיום תצוגה מקדימה) בממשק האינטרנט.

מאגר לניפוי באגים

כדי לפתור בעיות בהטמעת הקונטיינר, צריך להפעיל רישום מפורט ביומן:

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

פרסום מאגר התגים

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

השלבים הבאים

קוראים את הגדרות מתקדמות.