Google Analytics SDK for iOS v2 (Legacy) - نمای کلی

Google Analytics SDK برای iOS جمع آوری داده های تعامل کاربر را از برنامه های خود برای توسعه دهندگان آسان می کند. این سند یک نمای کلی از ارزش SDK و همچنین راهنمایی برای شروع اندازه‌گیری برنامه شما با استفاده از یک شناسه دارایی واحد و EasyTracker ارائه می‌کند.

معرفی

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

  • تعداد کاربران فعالی که از برنامه های خود استفاده می کنند.
  • از کجای دنیا این اپلیکیشن در حال استفاده است.
  • پذیرش و استفاده از ویژگی های خاص.
  • خریدها و تراکنش های درون برنامه ای
  • تعداد و نوع برنامه از کار می افتد.
  • و بسیاری از معیارهای مفید دیگر.

قبل از اینکه شروع کنی

قبل از شروع اجرای SDK، مطمئن شوید که موارد زیر را دارید:

شروع شدن

سه مرحله برای شروع کار با SDK وجود دارد:

  1. هدرها و کتابخانه ها را به پروژه خود اضافه کنید
  2. ردیاب را مقداردهی اولیه کنید
  3. اندازه گیری صفحه نمایش را اضافه کنید

پس از انجام این مراحل، می‌توانید موارد زیر را با Google Analytics اندازه‌گیری کنید:

  • نصب برنامه
  • کاربران فعال و جمعیت شناسی
  • صفحه نمایش و تعامل کاربر
  • خرابی ها و استثناها

1. اضافه کردن فایل های هدر و پیکربندی پروژه خود

Google Analytics را برای iOS SDK دانلود کنید و این فایل ها را از بسته SDK به برنامه خود اضافه کنید:

  • GAI.h
  • GAITracker.h
  • GAITrackedViewController.h
  • GAITransaction.h
  • GAITransactionItem.h
  • libGoogleAnalytics.a

Google Analytics SDK از چارچوب‌های CoreData و SystemConfiguration استفاده می‌کند، بنابراین باید موارد زیر را به کتابخانه‌های پیوندی هدف برنامه خود اضافه کنید:

  • libGoogleAnalytics.a
  • CoreData.framework
  • SystemConfiguration.framework

2. مقداردهی اولیه ردیاب

برای مقداردهی اولیه ردیاب، هدر GAI.h در فایل .m delegate برنامه خود وارد کنید و این کد را به application:didFinishLaunchingWithOptions: متد:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  // Optional: automatically send uncaught exceptions to Google Analytics.
  [GAI sharedInstance].trackUncaughtExceptions = YES;
  // Optional: set Google Analytics dispatch interval to e.g. 20 seconds.
  [GAI sharedInstance].dispatchInterval = 20;
  // Optional: set debug to YES for extra debugging information.
  [GAI sharedInstance].debug = YES;
  // Create tracker instance.
  id<GAITracker> tracker = [[GAI sharedInstance] trackerWithTrackingId:@"UA-YOUR-TRACKING-ID"];

}

id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker];

توجه داشته باشید که در مثال بالا، "UA-YOUR-TRACKING-ID" در اینجا یک مکان نگهدار برای شناسه ردیابی است که هنگام ایجاد نمای برنامه Google Analytics خود (نمایه) به شما اختصاص داده شده است. اگر فقط از یک شناسه ردیابی در برنامه خود استفاده می کنید، بهترین روش استفاده از روش ردیاب پیش فرض است.

3. اجرای اندازه گیری صفحه نمایش

برای اندازه‌گیری خودکار نماها در برنامه‌تان، از کنترل‌کننده‌های view خود بخواهید GAITrackedViewController گسترش دهند، یک کلاس راحت که UIViewController گسترش می‌دهد، و نام view را برای هر View Controller در گزارش‌های خود ارائه کنید. هر بار که آن نما بارگیری می شود، یک نمای صفحه برای Google Analytics ارسال می شود.

به عنوان مثال، فرض کنید یک نمای «درباره» دارید که می‌خواهید با هدر view controller اندازه‌گیری کنید که به شکل زیر است:

@interface AboutViewController : UIViewController

شما این هدر را به روز می کنید تا بگویید:

#import "GAITrackedViewController.h"

@interface AboutViewController : GAITrackedViewController

همچنین باید نام view را برای استفاده در گزارش های Google Analytics خود ارائه دهید. یک مکان خوب برای قرار دادن این روش، روش مقداردهی اولیه view controller است، اگر دارید، یا روش viewDidAppear:

- (void)viewDidAppear:(BOOL)animated {
  [super viewDidAppear:animated];
  self.trackedViewName = @"About Screen";
}
}

تا زمانی که trackedViewName قبل از sendView: تنظیم شود، اندازه‌گیری خودکار صفحه انجام می‌شود. هر زمان که نما ظاهر شد، یک تماس با sendView: با نام view ارائه شده ایجاد می شود.

برای کسب اطلاعات بیشتر درباره اندازه‌گیری صفحه، به راهنمای برنامه‌نویس Screens مراجعه کنید.

تبریک می گویم! اکنون برنامه شما برای ارسال داده به Google Analytics تنظیم شده است.

مراحل بعدی

با Google Analytics می‌توانید کارهای بیشتری انجام دهید، از جمله اندازه‌گیری کمپین‌ها، پرداخت‌ها و تراکنش‌های درون‌برنامه، و رویدادهای تعامل با کاربر. برای یادگیری نحوه افزودن این ویژگی ها به پیاده سازی خود، به راهنمای توسعه دهنده زیر مراجعه کنید:

  • پیکربندی پیشرفته - درباره گزینه های پیکربندی پیشرفته، از جمله استفاده از ردیاب های متعدد بیشتر بدانید.
  • اندازه‌گیری کمپین‌ها – نحوه اجرای اندازه‌گیری کمپین را بیاموزید تا بفهمید کدام کانال‌ها و کمپین‌ها باعث نصب اپلیکیشن می‌شوند.
  • اندازه‌گیری رویدادها – یاد بگیرید که چگونه تعامل کاربر را با محتوای تعاملی مانند دکمه‌ها، ویدیوها و سایر رسانه‌ها با استفاده از رویدادها اندازه‌گیری کنید.
  • اندازه گیری پرداخت های درون برنامه ای – نحوه اندازه گیری پرداخت ها و تراکنش های درون برنامه ای را بیاموزید.
  • زمان‌بندی کاربر – نحوه اندازه‌گیری زمان‌بندی کاربر در برنامه خود را برای اندازه‌گیری زمان بارگذاری، تعامل با رسانه و موارد دیگر بیاموزید.