Google Tag Manager ל-iOS

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

    1. אם ההעברה מפרויקט שמבוסס על CocoaPods, מריצים את pod deintegrate כדי להסיר את CocoaPods מפרויקט ה-Xcode. בהמשך אפשר למחוק בבטחה את הקובץ .xcworkspace שנוצר על ידי CocoaPods. אם זו הפעם הראשונה שאתם מוסיפים את Firebase לפרויקט, אפשר להתעלם מהשלב הזה.
    2. ב-Xcode 12, מתקינים את ספריית Tag Manager על ידי מעבר אל קובץ > חבילות 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 בפרויקט.

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

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

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

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

לאחר מכן תוכלו להגדיר משתנים חדשים של 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:

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

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

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

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

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

URL identifier: _your.package.name_
URL scheme: tagmanager.c._your.package.name_
עליך לרשום את סכמת כתובת ה-URL של התצוגה המקדימה של Tag Manager בקובץ רשימת הנכסים של האפליקציה.
איור 2: הוספת סכימת כתובת ה-URL של התצוגה המקדימה של Tag Manager לקובץ רשימת המאפיינים של האפליקציה.

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

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

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

מאגר הפרסום

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

קרא את תצורה מתקדמת.