ابعاد و معیارهای سفارشی - iOS SDK

این راهنمای توسعه‌دهنده نحوه پیاده‌سازی ابعاد و معیارهای سفارشی با استفاده از Google Analytics SDK برای iOS نسخه 2 را شرح می‌دهد.

بررسی اجمالی

وقتی یک بعد سفارشی یا مقدار متریک را با استفاده از Google Analytics SDK برای iOS تنظیم می‌کنید، آن مقدار به عنوان پارامتر با ضربه بعدی ارسال می‌شود. این مقادیر را می توان برای هر نوع ضربه گوگل آنالیتیکس، از جمله نماهای صفحه، رویدادها، تراکنش های تجارت الکترونیک، زمان بندی کاربر و تعاملات اجتماعی اعمال کرد.

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

  1. بعد یا متریک سفارشی را با استفاده از رابط وب Google Analytics تعریف کنید.
    فهرست، نام و دامنه ابعاد یا متریک سفارشی را در بخش تنظیمات ویژگی رابط وب تنظیم کنید.
    با نحوه تعریف یک بعد یا متریک سفارشی آشنا شوید .
  2. کد را برای تنظیم و جمع‌آوری ابعاد سفارشی و مقادیر متریک پیاده‌سازی کنید.
    کدی را به برنامه خود اضافه کنید تا ابعاد یا مقادیر متریک سفارشی را برای بازدیدهای Google Analytics خود در شاخص هایی که در مرحله قبل تعریف کرده اید تنظیم کنید.

در ادامه این مقاله نحوه پیاده‌سازی کد برای تنظیم و ارسال ابعاد سفارشی یا مقادیر متریک به Google Analytics توضیح داده می‌شود.

ابعاد سفارشی

مقادیر ابعاد سفارشی را می توان در همه انواع ضربه های Google Analytics تنظیم کرد. یک مقدار ابعاد سفارشی را درست قبل از تماس ارسالی که می‌خواهید مقدار روی آن اعمال شود، تنظیم کنید.

محدوده تعریف‌شده بعد سفارشی در زمان پردازش تعیین می‌کند که کدام بازدیدهای اضافی ممکن است با آن مقدار مرتبط باشد.

این فیلدها برای تنظیم مقدار ابعاد سفارشی مورد نیاز هستند:

  • NSNumber Index – نمایه تعریف ابعاد سفارشی. این شاخص مبتنی بر 1 است.
  • NSString Value – مقدار بعد سفارشی.

تنظیم مقدار ابعاد سفارشی

برای تنظیم یک مقدار ابعاد سفارشی، قبل از تماس ارسالی که می‌خواهید مقدار را با آن مرتبط کنید، setCustom:dimension: را فراخوانی کنید:

// Get the tracker object.
id tracker = [[GAI sharedInstance].defaultTracker;

// Set the dimension value for index 1.
[tracker setCustom:1
         dimension:@"myValue"];

// Dimension value is associated and sent with this hit.
[tracker sendView:screenName];

ملاحظات پیاده سازی

این بخش ملاحظات دیگری را که باید هنگام اجرای یک بعد سفارشی در نظر داشته باشید، تشریح می کند.

محدوده کاربر و سطح جلسه حریص هستند

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

برای مثال، اگر از نوع عضویت به عنوان یک بعد سفارشی در سطح کاربر استفاده می‌کنید، و کاربر عضویت خود را در میانه جلسه ارتقا می‌دهد، ممکن است بخواهید قبل از تنظیم مقدار ابعاد سفارشی جدید، جلسه جدیدی را شروع کنید. این تضمین می کند که بازدیدهای قبل از ارتقاء با مقدار عضویت قدیمی مرتبط می شوند، در حالی که بازدیدهای جدید با مقدار جدید مرتبط خواهند بود.

ابعاد سفارشی و فیلترهای نمایش (نمایه).

مقادیر ابعاد سفارشی کاربر یا سطح جلسه همچنان برای همه بازدیدها در جلسات فعلی و/یا آینده اعمال می‌شود، حتی اگر بازدیدی که با آن ارسال می‌شود از یک نمای (نمایه) فیلتر شده باشد.

هنگام فیلتر کردن یک مقدار ابعاد سفارشی، بازدیدها با توجه به محدوده آن مقدار ابعاد سفارشی فیلتر می شوند.

درباره نحوه تعامل فیلترها و مقادیر ابعاد سفارشی هنگام پردازش داده‌هایتان بیشتر بدانید .

تنظیم مقادیر با اندازه گیری خودکار صفحه

برای اعمال یک مقدار ابعاد سفارشی به نمای صفحه ارسال شده از طریق اندازه‌گیری خودکار صفحه، مقدار را در روش viewDidAppear: کنترل‌کننده view تنظیم کنید. برای مثال، فایل .m کنترلر view شما ممکن است به شکل زیر باشد:

#import "myViewController.h"
#import "GAI.h"

@implementation myViewController

-(void)viewDidAppear
{
    id tracker = [[GAI sharedInstance].defaultTracker;  // Get the tracker object.
    [tracker setCustom:1
             dimension:@"myValue"];  // Set the custom dimension value.
    [super viewDidAppear:animated]   // Custom dimension value will be sent with the screen view.

}

// The remainder of the implementation is omitted.

اطلاعات شناسایی شخصی (PII) را به عنوان مقادیر ارسال نکنید

شرایط خدمات Google Analytics ارسال هرگونه اطلاعات شناسایی شخصی (PII) به سرورهای Google Analytics را ممنوع می کند. برای اطلاعات بیشتر، لطفاً به شرایط خدمات مراجعه کنید.

معیارهای سفارشی

در حالی که ابعاد سفارشی باید به دقت برای بازدیدهای خاص اعمال شوند و با دامنه مدیریت شوند، بازدیدی که یک سنجه سفارشی برای آن اعمال می‌شود، عموماً بر گزارش‌دهی تأثیر نمی‌گذارد، و بنابراین هر زمان که مقدار متریک مشخص شد، می‌توان آنها را تنظیم کرد.

این فیلدها برای تنظیم یک مقدار متریک سفارشی مورد نیاز هستند:

  • NSInteger Index - شاخص تعریف متریک سفارشی.
  • NSNumber Value – مقدار معیار سفارشی. ارزش ها ممکن است منفی باشند.

تنظیم یک مقدار متریک سفارشی

برای تنظیم یک مقدار متریک سفارشی، قبل از ارسال تماس دیگری setCustom:metric: تماس بگیرید:

// Get the tracker object.
id tracker = [GAI sharedInstance].defaultTracker;

// Increment the metric at index 1.
[tracker setCustom:1
            metric:[NSNumber numberWithLongLong:1]];

// Metric value sent with this hit.
[tracker sendView:screenName];

یا برای تنظیم یک متریک سفارشی ارز:

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

// Create a dictionary for hit params.
NSDictionary *params = [[NSDictionary alloc] initWithObjectsAndKeys:
    @"Product Page", @"&cd",
   // Set currency value to custom metric slot 1.
   // Currency values may be fixed decimal.
    @"24.99", @"&cm1", nil];

// Send the custom metric value with a screen view.
[tracker send:@"appview"
       params:params];

ملاحظات پیاده سازی

بخش زیر ملاحظات دیگری را که باید هنگام برنامه ریزی یک بعد سفارشی یا اجرای متریک در نظر داشته باشید، تشریح می کند.

مقادیر متریک سفارشی در گزارش ها جمع می شوند

مقادیر متریک سفارشی مانند سایر معیارهای از پیش تعریف شده در Google Analytics در گزارش ها جمع می شوند. در نتیجه، برای افزایش مجموع متریک در گزارش های خود، یک مقدار متریک سفارشی 1 تعیین می کنید.

معیارهای سفارشی و فیلترهای نمایش (نمایه).

اگرچه معمولاً مقادیر متریک سفارشی را می‌توان هر زمان که مناسب باشد تنظیم کرد، از تنظیم مقادیر متریک سفارشی روی بازدیدهایی که احتمالاً از نماهای شما (نمایه‌ها) فیلتر می‌شوند، خودداری کنید. اگر یک بازدید با فیلتر نما (نمایه) فیلتر شود، هر مقدار متریک سفارشی مرتبط نیز فیلتر خواهد شد. درباره ابعاد و معیارهای سفارشی و فیلترهای مشاهده (نمایه) بیشتر بیاموزید .