תגי 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. לוחצים על משתנה ללא שם כדי להזין את שם המשתנה שם המסך.
  6. בוחרים באפשרות Data Layer Variable (משתנה של שכבת נתונים) בתור סוג המשתנה.
  7. מזינים את screenName בתור שם המשתנה של שכבת הנתונים ומגדירים את ערך ברירת המחדל מסך לא ידוע.
  8. לוחצים על Create Variable (יצירת משתנה).

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

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

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

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

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

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 בתור שם המשתנה של שכבת הנתונים ומגדירים את ערך ברירת המחדל של הסרטון כ-unknown video.
  8. לוחצים על Create Variable (יצירת משתנה).

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

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

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

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

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

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

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

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

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

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

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

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

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. דחיפת אירועים, טרנזקציות ופריטים לשכבת הנתונים.

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

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

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

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

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

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

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

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

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

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

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

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

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

// 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]}];
}

למידע נוסף על השימוש ב-Google Tag Manager SDK ל-Android לצורך הטמעת תכונות של מסחר אלקטרוני משופר של Universal Analytics, קראו את המאמר מסחר אלקטרוני משופר.

משתני שכבות של נתוני מסחר אלקטרוני נתמכים

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

משתני עסקה

שם משתנה התיאור תיאור נדרש
transactionId מזהה עסקה ייחודי מחרוזת כן
transactionAffiliation שותף או חנות מחרוזת לא
transactionTotal הערך הכולל של העסקה מחרוזת לא
transactionTax סכום המס של העסקה מחרוזת לא
transactionShipping עלות המשלוח של העסקה מחרוזת לא
transactionCurrency מטבע העסקה מחרוזת לא
transactionProducts רשימת פריטים שנרכשו בעסקה מערך של משתני פריטים. לא

משתנים של פריטים

שם משתנה התיאור תיאור נדרש
name שם המוצר מחרוזת כן
sku מק"ט של המוצר מחרוזת לא
category קטגוריית המוצר מחרוזת לא
price מחיר המוצר מחרוזת לא
currency סוג המטבע של price מחרוזת לא
quantity כמות הפריטים מחרוזת לא

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

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