پیکربندی پیشرفته - iOS SDK

این سند نمای کلی برخی از ویژگی های پیکربندی پیشرفته Google Analytics SDK برای iOS نسخه 2 را ارائه می دهد.

بررسی اجمالی

Google Analytics SDK برای iOS از دو کلاس برای مدیریت وضعیت جهانی پیاده‌سازی و ارسال داده‌ها به سرورهای Google Analytics استفاده می‌کند.

  • GAI - تک‌تنه‌ای که وضعیت جهانی پیاده‌سازی شما را کنترل می‌کند، از جمله دریافت اشیاء جدید GAITracker ، و همچنین تنظیمات انصراف در سطح برنامه و تنظیمات ارسال.
  • GAITracker – کلاسی که از آن داده ها را به Google Analytics ارسال می کنید. ردیاب های متعددی را می توان نمونه سازی کرد، یکی در هر شناسه دارایی منحصر به فرد.

استفاده از ردیاب های متعدد

از نسخه 2 SDK، می‌توانید از چندین ردیاب در یک پیاده‌سازی استفاده کنید، یکی برای هر شناسه ردیابی منحصربه‌فرد. همه ردیاب‌ها دارای وضعیت جهانی یکسانی هستند که توسط singleton 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 معین استفاده می‌کند. اندازه‌گیری استثنای کشف نشده از ردیاب پیش‌فرض مشخص‌شده در نمونه 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;