דף זה תורגם על ידי 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.
בוחרים מאגר נייד.
לוחצים על גרסאות בסרגל הניווט העליון.
לוחצים על גרסת הקונטיינר שבה רוצים להשתמש.
לוחצים על הורדה.
יוצרים את התיקייה 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:

שם המשתנה: שם התמונה
Variable Type (סוג משתנה): פרמטר של אירוע
שם המפתח של פרמטר האירוע: image_name

וגם:

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

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

mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);

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

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

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

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

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

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

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

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

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

השלבים הבאים

הגדרה מתקדמת