תגי Universal Analytics

כדי להפעיל שינויים בזמן הריצה בהטמעה של Google Analytics, לא מחייבים אתכם לבנות מחדש את הבינארי של האפליקציה ולשלוח אותו מחדש לזירות מסחר, להטמיע את Universal Analytics (UA) באפליקציה באמצעות Google Tag Manager (GTM).

במדריך הזה מוסבר איך להשתמש בתגי Universal Analytics Google Tag Manager SDK ל-iOS מאפשר:

שליחת צפיות במסך

כדי לשלוח צפייה במסך בכל פעם שפותחים מסך חדש את האפליקציה שלכם ל-Google Analytics:

  1. יוצרים משתנה של שם מסך.
  2. יצירת מסך פתוח טריגר לאירוע.
  3. יצירת Universal Analytics תג צפייה במסך.
  4. אירוע בדחיפה של מסך פתוח ואת שם המסך לשכבת הנתונים.

1. יצירת משתנה של שם מסך

כדי ליצור משתנה של שם מסך ב-GTM:

  1. נכנסים אל Google Tag Manager. חשבון.
  2. בוחרים מאגר תגים לנייד.
  3. בסרגל הניווט הימני לוחצים על משתנים.
  4. בקטע משתנים בהגדרת המשתמש, לוחצים על חדש.
  5. לוחצים על Untitled Variable (משתנה ללא שם) כדי להזין את שם המשתנה screen name.
  6. בוחרים את Data Layer Variable (משתנה של שכבת נתונים) כסוג המשתנה.
  7. מזינים את screenName בתור שם המשתנה של שכבת הנתונים ומגדירים את הערך ערך ברירת המחדל unknown screen.
  8. לוחצים על Create Variable (יצירת משתנה).

2. יצירת טריגר לאירוע במסך פתוח

ליצור טריגר ב-GTM שיפעיל את תג צפייה במסך של Universal Analytics:

  1. נכנסים אל Google Tag Manager. חשבון.
  2. בוחרים מאגר תגים לנייד.
  3. בסרגל הניווט שבצד ימין, לוחצים על טריגרים.
  4. לוחצים על הסמל ליצירת קובץ חדש.
  5. לוחצים על Untitled Trigger (טריגר ללא שם) כדי להזין את שם הטריגר OpenScreenEvent.
  6. בוחרים אירוע מותאם אישית.
  7. בקטע Fire On, מזינים את התנאי הבא:

    טריגר שיופעל כשהאירוע יהיה שווה ל-openScreen

  8. לוחצים על Create Trigger (יצירת טריגר).

3. יצירת תג צפייה במסך של Universal Analytics

כדי ליצור תג צפייה במסך של Universal Analytics שמופעל על ידי אירוע מסך פתיחה:

  1. נכנסים אל Google Tag Manager. חשבון.
  2. בוחרים מאגר תגים לנייד.
  3. בסרגל הניווט שמשמאל, לוחצים על Tags (תגים).
  4. לוחצים על הסמל ליצירת קובץ חדש.
  5. לוחצים על תג ללא שם כדי להזין את שם התג Open Screen.
  6. בוחרים את המוצר Google Analytics.
  7. מזינים את המזהה לצורכי מעקב.
  8. בוחרים באפשרות צפייה באפליקציה בתור סוג המעקב.
  9. לוחצים על הגדרות נוספות.
  10. לוחצים על שדות להגדרה.
  11. לוחצים שוב על + הוספת שדה כדי להוסיף את השדות הבאים:

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

  12. לוחצים על המשך.
  13. בקטע Fire On (הפעלה), לוחצים על Custom (בהתאמה אישית).
  14. בוחרים את הטריגר המותאם אישית OpenScreenEvent.
  15. לוחצים על שמירה.
  16. לוחצים על Create Tag.

4. דחיפת אירוע מסך פתוח ו שם המסך לשכבת הנתונים

הוסף קוד לאפליקציה כדי לדחוף אירוע openScreen ו screenName בשכבת הנתונים, לדוגמה:

//  ViewController.m
//  Push an 'openScreen' event to the data layer.
//
#import "ViewController.h"
#import "TAGDataLayer.h"
#import "TAGManager.h"

@implementation ViewController

- (void)viewDidAppear {
    [super viewDidAppear];

    // NOTE: A GTM container should already have been opened, otherwise events
    //     pushed to the DataLayer will not fire tags in that container.
    TAGDataLayer *dataLayer = [TAGManager instance].dataLayer;

    [dataLayer push:@{@"event": @"openScreen",          // Event, name of Open Screen Event.
                      @"screenName": @"Home Screen"}];  // Name of the screen name field, screen name value.
}

// Rest of the ViewController implementation

@end

שליחת אירועים

כדי לשלוח אירוע ל-Google Analytics כשמשתמש מקיים אינטראקציה עם פקדים בממשק המשתמש או תוכן באפליקציה:

  1. (אופציונלי) יוצרים משתני אירועים.
  2. יוצרים טריגר לאירוע.
  3. יוצרים תג מעקב אירועים של Universal Analytics.
  4. דחיפת ערך של משתנה אירוע ואירוע לשכבת הנתונים.

בשלבים הבאים מוסבר איך אירוע נשלח ל-Google Analytics כשמשתמש מתחיל הפעלת סרטון.

1. (אופציונלי) יצירת משתני אירועים

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

כדי ליצור משתנה של שם סרטון ב-GTM:

  1. נכנסים אל חשבון Google Tag Manager.
  2. בוחרים מאגר תגים לנייד.
  3. בסרגל הניווט הימני לוחצים על משתנים.
  4. בקטע משתנים בהגדרת המשתמש, לוחצים על חדש.
  5. לוחצים על משתנה ללא שם כדי להזין את שם המשתנה שם הסרטון.
  6. בוחרים את Data Layer Variable (משתנה של שכבת נתונים) כסוג המשתנה.
  7. מזינים את videoName בתור שם המשתנה של שכבת הנתונים ומגדירים את ערך ברירת המחדל הוא סרטון לא ידוע.
  8. לוחצים על Create Variable (יצירת משתנה).

2. יצירת טריגר לאירוע

כדי ליצור טריגר לאירוע ב-GTM שיפעיל את תג מעקב האירועים של Universal Analytics:

  1. נכנסים אל Google Tag Manager. חשבון.
  2. בוחרים מאגר תגים לנייד.
  3. בסרגל הניווט שבצד ימין, לוחצים על טריגרים.
  4. לוחצים על הסמל ליצירת קובץ חדש.
  5. לוחצים על Untitled Trigger (טריגר ללא שם) כדי להזין את שם הטריגר VideoPlayEvent.
  6. בוחרים אירוע מותאם אישית.
  7. בקטע Fire On, מזינים את התנאי הבא:

    טריגר שיופעל כשהאירוע יהיה שווה ל-videoPlay.

  8. לוחצים על Create Trigger (יצירת טריגר).

3. יוצרים תג מעקב אירועים של Universal Analytics

כדי ליצור תג מעקב אירועים של Universal Analytics שמופעל על ידי video play event (אירוע הפעלת וידאו):

  1. נכנסים אל Google Tag Manager. חשבון.
  2. בוחרים מאגר תגים לנייד.
  3. בסרגל הניווט שמשמאל, לוחצים על Tags (תגים).
  4. לוחצים על הסמל ליצירת קובץ חדש.
  5. לוחצים על תג ללא שם כדי להזין את שם התג אירוע הפעלת סרטון.
  6. בוחרים את המוצר Google Analytics.
  7. מזינים את המזהה לצורכי מעקב.
  8. בוחרים באפשרות אירוע בתור סוג המעקב.
  9. מזינים את הפרמטרים הבאים למעקב אחר אירועים:

    יש להזין את הפרמטרים הבאים של מעקב: קטגוריה: סרטון, פעולה: הפעלה ותווית: סרטון

  10. לוחצים על הגדרות נוספות.
  11. לוחצים על שדות להגדרה.
  12. לוחצים שוב על + הוספת שדה כדי להוסיף את השדות הבאים:

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

  13. לוחצים על המשך.
  14. בקטע Fire On (הפעלה), לוחצים על Custom (בהתאמה אישית).
  15. בוחרים את הטריגר המותאם אישית VideoPlayEvent.
  16. לוחצים על שמירה.
  17. לוחצים על Create Tag.

4. דחיפת ערך של משתנה אירוע ואירוע לשכבת נתונים

כתיבת קוד כדי לדחוף אירוע videoPlay ו videoName בשכבת הנתונים, לדוגמה:

//  VideoPlayer.m
//  Push a 'videoPlay' event to the data layer.
//
#import "TAGDataLayer.h"
#import "TAGManager.h"
#import "Video.h"
#import "VideoPlayer.h"

@implementation VideoPlayer
// Called when a user initiates a video playback.
- (void)onPlay:(Video *)video {

    TAGDataLayer *dataLayer = [TAGManager instance].dataLayer;

    // This call assumes the container has already been opened, otherwise events
    // pushed to the DataLayer will not fire tags in that container.
    [dataLayer push:@{@"event": @"videoPlay",          // Event, name of Video Play Event.
                      @"videoName": video.title,       // Additional data layer variables used by the event tag.
                      @"screenName": @"Home Screen"}];

    [self play:video];
}

// Rest of the implementation
@end


שליחת פירוט עסקאות

כשמשתמש משלים רכישה מתוך האפליקציה, כדי לשלוח את העסקה וגם הפריטים המשויכים ל-Google Analytics:

  1. יוצרים טריגר לעסקה.
  2. יצירת Universal Analytics תג עסקה.
  3. אירוע עסקה ב-push, עסקה ו-items בשכבת נתונים.

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

1. יצירת טריגר לעסקה

כדי ליצור טריגר לעסקה ב-GTM שיפעיל את תג עסקה של Universal Analytics:

  1. נכנסים אל Google Tag Manager. חשבון.
  2. בוחרים מאגר תגים לנייד.
  3. בסרגל הניווט שבצד ימין, לוחצים על טריגרים.
  4. לוחצים על הסמל ליצירת קובץ חדש.
  5. לוחצים על Untitled Trigger (טריגר ללא שם) כדי להזין את שם הטריגר TransactionCompleted.
  6. בוחרים אירוע מותאם אישית.
  7. בקטע Fire On, מזינים את התנאי הבא:

    טריגר שיופעל כשהאירוע יהיה שווה לעסקה.

  8. לוחצים על Create Trigger (יצירת טריגר).

2. יצירה של תג עסקה של Universal Analytics

כדי ליצור תג עסקה של Universal Analytics שמופעל על ידי אירוע עסקה:

  1. נכנסים אל Google Tag Manager. חשבון.
  2. בוחרים מאגר תגים לנייד.
  3. בסרגל הניווט שמשמאל, לוחצים על Tags (תגים).
  4. לוחצים על הסמל ליצירת קובץ חדש.
  5. לוחצים על ללא שם תג כדי להזין את שם התג העסקה הושלמה.
  6. בוחרים את המוצר Google Analytics.
  7. מזינים את המזהה לצורכי מעקב.
  8. בוחרים באפשרות עסקה בתור סוג המעקב.
  9. לוחצים על הגדרות נוספות.
  10. לוחצים על שדות להגדרה.
  11. לוחצים שוב על + הוספת שדה כדי להוסיף את השדות הבאים:

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

  12. לוחצים על המשך.
  13. בקטע Fire On (הפעלה), לוחצים על Custom (בהתאמה אישית).
  14. בוחרים את הטריגר המותאם אישית TransactionCompleted.
  15. לוחצים על שמירה.
  16. לוחצים על Create Tag.

3. אירוע Push של עסקה, עסקה ופריטים לשכבת הנתונים

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

// Called when a user completes a transaction.
- (void)onPurchaseCompleted:(Purchase *)purchase {

  TAGDataLayer *dataLayer = [TAGManager instance].dataLayer;

  // An array to store dictionaries of item data.
  NSMutableArray *purchasedItems = [NSMutableArray array];

  // Push item data into dictionaries and store in the purchasedItems array.
  // Note that item.price and item.quantity must be of type NSString.
  for (id item in purchase.items) {
    [purchasedItems addObject:@{@"name": item.name,
                                @"sku": item.sku,
                                @"category": item.category,
                                @"price": item.price,
                                @"currency": @"USD",
                                @"quantity": item.quantity}];
  }

  // This call assumes the container has already been opened, otherwise events
  // pushed to the DataLayer will not fire tags in that container.
  // Note that purchase.tax, purchase.shipping, and purchase.total must be of type NSString.
  [dataLayer push:@{@"event": @"transaction",                  // Event, name of Transaction Event.
                    @"transactionId": purchase.transactionId,  // Additional fields required by the tag.
                    @"transactionTotal": purchase.total,
                    @"transactionAffiliation": @"In-app Store",
                    @"transactionTax": purchase.tax,
                    @"transactionShipping": purchase.shipping,
                    @"transactionCurrency": @"USD",
                    @"transactionProducts": purchasedItems}];

  // Since the data layer is persistent, you should reset fields to [NSNull null] after
  // you are done pushing the transaction.
  [dataLayer push:@{@"transactionId": [NSNull null],
                    @"transactionTotal": [NSNull null],
                    @"transactionAffiliation": [NSNull null],
                    @"transactionTax": [NSNull null],
                    @"transactionShipping": [NSNull null],
                    @"transactionCurrency": [NSNull null],
                    @"transactionProducts": [NSNull null]}];
}