דף זה תורגם על ידי Cloud Translation API.

Google Tag Manager ל-Android

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

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

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

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

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

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

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

בקובץ Gradle של המודול (בדרך כלל app/build.gradle), מוסיפים את התלות הבאה בספריית Tag Manager:
```
dependencies {
  // ...
  compile 'com.google.android.gms:play-services-tagmanager:18.1.1'
}
```
נכנסים לחשבון Tag Manager.
בוחרים מאגר נייד.
לוחצים על Versions (גרסאות) בסרגל הניווט העליון.
לוחצים על גרסת הקונטיינר שבה רוצים להשתמש.
לוחצים על הורדה.
יוצרים את התיקייה app/src/main/assets/containers אם היא לא קיימת. מעתיקים את הקונטיינר שהורדתם לתיקייה.

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

מערכת Tag Manager משתמשת באירועים, בפרמטרים ובמאפייני משתמשים שמתועדים ביומן על ידי ה-SDK של Google Analytics for Firebase כדי להפעיל ולבנות את התגים שהגדרתם ב-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

וגם:

Variable Name: Full Text
סוג המשתנה: פרמטר של אירוע
שם מפתח הפרמטר של האירוע: full_text

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

mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);

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

שם המשתנה: Favorite Food
סוג המשתנה: מאפיין משתמש ב-Firebase
שם מפתח הפרמטר של האירוע: favorite_food

שינוי וחסימה של אירועים

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

ה-SDK של Google Analytics for Firebase מתעד גם באופן אוטומטי אירועים ומאפייני משתמש מסוימים. אתם יכולים להשתמש באירועים ובמאפיינים שנאספים באופן אוטומטי ב-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. לשם כך, בוחרים את הגרסה של מאגר התגים שרוצים להציג בתצוגה המקדימה ואז בוחרים באפשרות תצוגה מקדימה. שומרים את כתובת ה-URL של התצוגה המקדימה לשלבים הבאים.

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

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

מוסיפים לקובץ 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>

משנים את השורה הזו כך שתכלול את שם החבילה של האפליקציה:
```
<data android:scheme="tagmanager.c.com.example.app"/>
```
בממשק האינטרנט של Google Tag Manager, יוצרים קישור לתצוגה המקדימה:
1. נכנסים לחשבון Tag Manager.
2. בוחרים מאגר נייד.
3. לוחצים על Versions (גרסאות) בסרגל הניווט העליון.
4. לוחצים על Actions > Preview בגרסה של הקונטיינר שרוצים להציג בתצוגה מקדימה.
5. מזינים את שם החבילה של האפליקציה.
6. לוחצים על Generate begin preview link.
מפסיקים את האפליקציה ומשתמשים בקישור התצוגה המקדימה או בקוד ה-QR שנוצרו כדי להפעיל את האפליקציה.
כדי לצאת ממצב התצוגה המקדימה, לוחצים על קישור שנוצר באמצעות האפשרות יצירת קישור לתצוגה המקדימה של הסוף בממשק האינטרנט.

קונטיינר לניפוי באגים

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

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

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

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

השלבים הבאים

הגדרה מתקדמת