הגדרה מתקדמת – iOS SDK

במסמך הזה מפורטות כמה מהתכונות המתקדמות של Google Analytics SDK ל-iOS v2.

סקירה

ב-Google Analytics SDK ל-iOS נעשה שימוש בשני סיווגים כדי לנהל את המצב הגלובלי של ההטמעה ולשלוח נתונים לשרתים של Google Analytics.

  • GAI – סינגלטון שמטפל במצב הגלובלי של ההטמעה, כולל קבלת אובייקטים חדשים של GAITracker, וכן הגדרות של ביטול ההסכמה ברמת האפליקציה ושליחת ההודעות.
  • GAITracker – הכיתה שממנה שולחים נתונים אל Google Analytics. אפשר ליצור כמה כלי מעקב, אחד לכל מזהה נכס ייחודי.

שימוש במספר כלי מעקב

החל מגרסה 2 של ה-SDK, ניתן להשתמש בכמה כלי מעקב בהטמעה אחת, אחד לכל מזהה מעקב ייחודי. כל מכשירי המעקב חולקים את אותה מצב גלובלי שבו נמצא הסינגלטון של GAI.

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

#import "RootViewController.h"
#import "GAI.h"

@interface RootViewController ()

@end

@implementation RootViewController
{
- (void)viewDidLoad {
  [super viewDidLoad];

  // Send a screen view to the first property.
  id tracker1 = [[GAI sharedInstance] trackerWithTrackingId:@"UA-XXXX-Y"];
  [tracker1 sendView:@"/HomeScreen"];

  // Send another screen view to the second property.
  id tracker2 = [[GAI sharedInstance] trackerWithTrackingId:@"UA-XXXX-Z"];
  [tracker2 sendView:@"Home"];
}

@end

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

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

מכשיר מעקב שמוגדר כברירת מחדל

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

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

// Get default tracker.
id myDefault = [GAI sharedInstance].defaultTracker;

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

// Get a new tracker.
id newTracker = [[GAI sharedInstance]trackerWithTrackingId:@"UA-NEW-TRACKING-ID");

// Set the new tracker as the default tracker, globally.
[GAI sharedInstance].defaultTracker = newTracker;

דגימות

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

לדוגמה, כדי להטמיע דגימה בצד הלקוח בשיעור של 50%, משתמשים בקוד הבא:

// Set a sample rate of 50%.
[tracker setSampleRate:50.0];  // Sample rate is a double.

ביטול הסכמה ברמת האפליקציה

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

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

// Get the app-level opt out preference.
if ([GAI sharedInstance].optOut) {
  ... // Alert the user they have opted out.
}

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


// Set the app-level opt out preference.
[[GAI sharedInstance].setOptOut = YES];

בדיקה וניפוי באגים

Google Analytics SDK ל-iOS מספק מצב ניפוי באגים שמדפיס ביומנים מידע שימושי לגבי הנתונים שנשלחים ל-Google Analytics.

// Enable debug mode.
[GAI sharedInstance].debug = YES;