Google Tag Manager ל-iOS

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

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

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

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

בחלקים הבאים מפורטים השלבים להגדרה של Google Tag Manager ולשימוש בו באפליקציה ל-iOS.

1. מוסיפים את Tag Manager לפרויקט

1. מוסיפים את חבילת Tag Manager:

   CocoaPods

   כדי להוסיף את Tag Manager דרך CocoaPods:

   1. בטרמינל, מריצים את הפקודה הבאה:

      $ sudo gem install cocoapods
      

   2. שינוי לספריית הפרויקט.

   3. מריצים את הפקודה הבאה כדי ליצור קובץ בשם Podfile:

      $ pod init
      

   4. ב-Podfile, צריך להוסיף את הפרטים הבאים:

      pod 'GoogleTagManager', '~> 6.0'
      

   5. כדי להוריד ולהתקין בפרויקט את יחסי התלות של Tag Manager, מריצים את הפקודה הבאה:

      $ pod install
      

   מנהל חבילות SWIFT

   כדי להוסיף את Tag Manager דרך Swift Package Manager:

   1. אם מעבירים מפרויקט מבוסס CocoaPods, מריצים את הפקודה pod deintegrate כדי להסיר את CocoaPods מפרויקט Xcode. אפשר למחוק בבטחה את הקובץ .xcworkspace שנוצר ב-CocoaPods לאחר מכן. אם זו הפעם הראשונה שאתם מוסיפים את Firebase לפרויקט, אפשר להתעלם מהשלב הזה.
   2. ב-Xcode 12, מתקינים את ספריית Tag Manager על ידי מעבר אל File > Tag Manager Packages > Add Package Dependency...

   3. בהודעה שמופיעה, מזינים את המאגר של Tag Manager ב-GitHub:

      https://github.com/googleanalytics/google-tag-manager-ios-sdk.git
      

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

   5. מוסיפים את -ObjC ל-Other Linker דגלים ב-Build Settings של הפרויקט.

2. יוצרים מאגר תגים של iOS אם לחשבון Tag Manager אין כזה:

   1. נכנסים אל חשבון Tag Manager.
   2. בכרטיסייה חשבונות, בוחרים את מאגר ה-iOS.
   3. לוחצים על ניהול בסרגל הניווט העליון.
   4. בעמודה CONTAINER, לוחצים על הסמל '+' כדי ליצור מאגר תגים.
   5. נותנים שם למאגר התגים.
   6. בוחרים במאגר iOS.
   7. לוחצים על יצירה.

3. מורידים את מאגר התגים:

   1. נכנסים אל חשבון Tag Manager.
   2. בכרטיסייה חשבונות, בוחרים את מאגר ה-iOS.
   3. לוחצים על גרסאות בסרגל הניווט העליון.
   4. בוחרים את הגרסה של מאגר התגים שרוצים להוריד.

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

      הערה: שם הקובץ שהורדתם הוא מזהה מאגר התגים עם סיומת .json.

4. מוסיפים לפרויקט את מאגר התגים שהורדתם:

   1. מעתיקים את הקובץ שהורדתם לתיקייה בשם container ברמה הבסיסית (root) של הפרויקט ב-XCode (בדרך כלל PROJECT_ROOT/container/GTM-XXXXXX.json).
   2. פותחים את Xcode.
   3. בתפריט קובץ, בוחרים באפשרות הוספת קבצים אל...
   4. בוחרים את התיקייה container.
   5. לוחצים על Options (אפשרויות) ומוודאים שהאפשרות Create folder reference (יצירת הפניות לתיקייה) מסומנת.
   6. לוחצים על סיום

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
])

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

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

וגם:

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

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

Analytics.setUserProperty(food, forName: "favorite_food")

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

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

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

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

כדי לראות תצוגה מקדימה של מאגר, צריך ליצור כתובת URL לתצוגה מקדימה בממשק האינטרנט של Tag Manager:

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

6. לוחצים על יצירת קישור לתצוגה מקדימה של התחלת.

   

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

   יש לשמור את כתובת ה-URL של התצוגה המקדימה לשלבים מאוחרים יותר.

כדי להפעיל תצוגה מקדימה של קונטיינרים, צריך להגדיר את סכמה של כתובת ה-URL לתצוגה מקדימה של Tag Manager ברשימת המאפיינים של הפרויקט. בקטע סוגי כתובות URL בקובץ רשימת המאפיינים של האפליקציה, רושמים את מזהה כתובת ה-URL ואת סכמת כתובת ה-URL הבאים:

URL identifier: _your.package.name_
URL scheme: tagmanager.c._your.package.name_

איור 2: מוסיפים את סכמת כתובת ה-URL לתצוגה המקדימה של Tag Manager לקובץ רשימת הנכסים של האפליקציה.

הערה: your.package.name חייב להיות תואם לשם האפליקציה שמשמשת ליצירת כתובת ה-URL של התצוגה המקדימה (ראו איור 1).

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

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

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

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

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

הערה: בקונטיינרים לנייד, מאגר ברירת המחדל משמש לקביעת הגדרות ראשוניות של תגים, עד להורדת הקונטיינר בפעם הראשונה. אחרי שהאפליקציה מתחברת לאינטרנט ומורידה קונטיינר, היא אף פעם לא תשתמש שוב בקונטיינר שמוגדר כברירת מחדל. האפליקציות בודקות מדי פעם אם יש עדכונים לקונטיינרים, בדרך כלל כל 12 שעות.

מקורות מידע שקשורים לנושא

קוראים את הקטע Advanced configuration.