כמפתחים, תוכלו להשתמש ב-Google Tag Manager כדי להטמיע ולנהל תגים ופיקסלים למדידה באפליקציות לנייד, בלי ליצור מחדש קבצים בינאריים של אפליקציות ולשלוח אותם מחדש לזירות מסחר של אפליקציות. מפתחים שעובדים עם ה-SDK של Google Analytics for Firebase יכולים להוסיף בקלות את Tag Manager כדי לקבל עזרה בניהול ההטמעה ובביצוע שינויים בה, גם לאחר שליחת האפליקציה.
מפתחים יכולים לתעד אירועים חשובים ולהחליט מאוחר יותר אילו תגים או פיקסלים להפעיל.
דרישות מוקדמות
- במסוף של Firebase, הוסף את האפליקציה אל הפרויקט ב-Firebase.
- מגדירים את Google Analytics לאפליקציה, כולל הפעלת Google Analytics בפרויקט Firebase והוספה של Google Analytics for Firebase SDK לאפליקציה.
- יוצרים חשבון Tag Manager.
- מגדירים מאגר תגים של Tag Manager.
בקטעים הבאים מוסבר איך להגדיר את Google Tag Manager ולהשתמש בו באפליקציה ל-iOS.
1. הוספת Tag Manager לפרויקט
מוסיפים את החבילה של Tag Manager:
CocoaPods
כדי להוסיף את Tag Manager דרך CocoaPods:
במסוף, מריצים את הפקודה הבאה:
$ sudo gem install cocoapods
עוברים לספריית הפרויקט.
מריצים את הפקודה הבאה כדי ליצור קובץ בשם
Podfile
:$ pod init
ב-
Podfile
, יש להוסיף את הפרטים הבאים:pod 'GoogleTagManager', '~> 6.0'
מריצים את הפקודה הבאה כדי להוריד ולהתקין בפרויקט יחסי תלות של Tag Manager:
$ pod install
מנהל חבילות Swift
כדי להוסיף את Tag Manager דרך מנהל החבילות של Swift:
- אם ההעברה מפרויקט שמבוסס על CocoaPods, מריצים את
pod deintegrate
כדי להסיר את CocoaPods מפרויקט ה-Xcode. בהמשך אפשר למחוק בבטחה את הקובץ.xcworkspace
שנוצר על ידי CocoaPods. אם זו הפעם הראשונה שאתם מוסיפים את Firebase לפרויקט, אפשר להתעלם מהשלב הזה. - ב-Xcode 12, מתקינים את ספריית Tag Manager על ידי מעבר אל קובץ > חבילות Tag Manager > הוספת תלות בחבילה...
בהודעה שמופיעה, מזינים את המאגר של Tag Manager ב-GitHub:
https://github.com/googleanalytics/google-tag-manager-ios-sdk.git
בוחרים את הגרסה של Tag Manager שבה רוצים להשתמש. לפרויקטים חדשים, מומלץ להשתמש בגרסה האחרונה של Tag Manager.
מוסיפים את
-ObjC
ל-Other Linker Flags בהגדרות ה-Build בפרויקט.
יוצרים מאגר תגים ל-iOS אם בחשבון Tag Manager אין מאגר כזה:
- נכנסים לחשבון Tag Manager.
- לוחצים על אדמין בסרגל הניווט העליון.
- בעמודה CONTAINER לוחצים על התפריט הנפתח ובוחרים באפשרות CREATE CONTAINER.
- מזינים שם למאגר.
- בוחרים מאגר תגים iOS.
- בוחרים את ה-SDK של Firebase (iOS).
- לוחצים על יצירה.
מורידים את מאגר התגים:
- נכנסים לחשבון Tag Manager.
- בוחרים את מאגר ה-iOS.
- לוחצים על גרסאות בסרגל הניווט העליון.
לוחצים על פעולות > הורדה בגרסה של מאגר התגים שנבחר.
מוסיפים לפרויקט את מאגר התגים שהורדתם:
- מעתיקים את הקובץ שהורדתם לתיקייה בשם
container
ברמה הבסיסית (root) של פרויקט XCode (בדרך כללPROJECT_ROOT/container/GTM-XXXXXX.json
). - פותחים את Xcode.
- בתפריט קובץ בוחרים באפשרות הוספת קבצים אל...
- בוחרים את התיקייה
container
. - לוחצים על Options ומוודאים שהתיבה Create Folder Reference מסומנת.
- לוחצים על סיום.
- מעתיקים את הקובץ שהורדתם לתיקייה בשם
2. רישום אירועים ומשתנים
Tag Manager משתמש באירועים, בפרמטרים ובמאפייני משתמשים שמתועדים ב-Google Analytics for Firebase SDK כדי להפעיל וליצור תגים שהגדרתם ב-Google Tag Manager.
במסמכי התיעוד למפתחים של Firebase מוסבר איך לרשום אירועים ולהגדיר מאפייני משתמשים.
הגדרת משתנים ב-Tag Manager
כדי לתעד את הערך של הפרמטרים של האירועים ושל מאפייני המשתמש לשימוש ב-Google Tag Manager, אפשר להגדיר משתנים בממשק של Tag Manager.
לדוגמה, אפשר לתעד באפליקציה את האירוע המותאם אישית הבא:
Analytics.logEvent("share_image", parameters: [
"image_name": name,
"full_text": text
])
לאחר מכן תוכלו להגדיר משתנים חדשים של Event Parameter ב-Tag Manager כדי לתעד את הערכים image_name
ו-full_text parameter
:
- שם משתנה: שם תמונה
- סוג משתנה: פרמטר אירוע
- שם מפתח של פרמטר אירוע:
image_name
וגם:
- שם המשתנה: טקסט מלא
- סוג משתנה: פרמטר אירוע
- שם מפתח של פרמטר אירוע:
full_text
באופן דומה, אפשר להגדיר באפליקציה את מאפיין המשתמש הבא:
Analytics.setUserProperty(food, forName: "favorite_food")
לאחר מכן תוכלו להגדיר משתנה חדש של מאפיין משתמש ב-Google Tag Manager כדי לתעד את הערך favorite_food
:
- שם משתנה: אוכל מועדף
- סוג משתנה: מאפיין משתמש ב-Firebase
- שם מפתח של פרמטר אירוע:
favorite_food
לשנות ולחסום אירועים
Tag Manager מאפשר לשנות ולחסום אירועים לפני שהם מתועדים ב-Google Analytics for Firebase SDK. שינוי של אירועים יכול לעזור לכם להוסיף, להסיר או לשנות ערכים של פרמטרים של אירועים, או לשנות שמות של אירועים ללא עדכוני אפליקציה. אירועים שלא ייחסמו יתועדו על ידי ה-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. תצוגה מקדימה, ניפוי באגים ופרסום של מאגר התגים
לפני פרסום גרסה של מאגר התגים מומלץ להציג אותו בתצוגה מקדימה כדי לוודא שהוא פועל כראוי. Tag Manager מאפשר להציג תצוגה מקדימה של הגרסאות של מאגר התגים על ידי יצירת קישורים וקודי QR בממשק האינטרנט של Tag Manager, ושימוש בהם לפתיחת האפליקציה.
תצוגה מקדימה של מאגר התגים
כדי לראות תצוגה מקדימה של מאגר תגים, צריך ליצור כתובת URL לתצוגה מקדימה בממשק האינטרנט של Tag Manager:
- נכנסים לחשבון Tag Manager.
- בוחרים מאגר לניידים.
- לוחצים על גרסאות בסרגל הניווט העליון.
- לוחצים על פעולות > תצוגה מקדימה בגרסה של מאגר התגים שרוצים להציג בתצוגה מקדימה.
- מזינים את שם החבילה של האפליקציה.
לוחצים על יצירת קישור להתחלת התצוגה המקדימה.
יש לשמור את כתובת ה-URL של התצוגה המקדימה לשלבים מאוחרים יותר.
כדי להפעיל תצוגות מקדימות של מאגרי תגים, צריך להגדיר את סכמת כתובת ה-URL של התצוגה המקדימה של Tag Manager ברשימת הנכסים של הפרויקט. בקטע סוגי כתובות URL בקובץ רשימת המאפיינים של האפליקציה, רשום את מזהה כתובת ה-URL ואת סכימת כתובת ה-URL הבאים:
URL identifier: _your.package.name_
URL scheme: tagmanager.c._your.package.name_
כדי לראות תצוגה מקדימה של מאגר הטיוטה באפליקציה, עוצרים את האפליקציה ופותחים את כתובת ה-URL של התצוגה המקדימה באמולטור או במכשיר פיזי.
מאגר לניפוי באגים
כשמפעילים את האפליקציה בסימולטור או במצב תצוגה מקדימה, Tag Manager הופך את הרישום מילולי למשמעותי באופן אוטומטי.
מאגר הפרסום
אחרי שאתם צופים בתצוגה מקדימה של מאגר התגים ומוודאים שהוא פועל, תוכלו לפרסם אותו. לאחר פרסום מאגר התגים, הגדרות התגים שלכם יהיו זמינות למשתמשי האפליקציות לנייד.
מקורות מידע שקשורים לנושא
קרא את תצורה מתקדמת.