Google Tag Manager ל-iOS

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

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 Package Manager

   כדי להוסיף את 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…‎ (קובץ > חבילות Tag Manager > הוספת תלות בחבילה…).

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

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

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

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

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

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

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

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

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

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

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

   1. מעתיקים את הקובץ שהורד לתיקייה בשם container בתיקיית השורש של פרויקט XCode (בדרך כלל PROJECT_ROOT/container/GTM-XXXXXX.json).
   2. פותחים את Xcode.
   3. בתפריט קובץ, בוחרים באפשרות הוספת קבצים אל...
   4. בוחרים את התיקייה container.
   5. לוחצים על אפשרויות ומוודאים שהאפשרות יצירת הפניות לתיקיות מסומנת.
   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:

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

וגם:

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

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

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

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

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

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

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

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

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

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

   

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

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

כדי להפעיל תצוגות מקדימות של מאגרי תגים, צריך להגדיר את סכימת כתובות ה-URL של התצוגה המקדימה ב-Tag Manager ברשימת המאפיינים של הפרויקט. בקטע URL types (סוגי כתובות 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 מעביר אוטומטית את הרישום ל-verbose.

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

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

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

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

מידע נוסף על הגדרות מתקדמות