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

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

بررسی اجمالی

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

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

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

NSNumber Index - شاخص بعد یا متریک سفارشی. این شاخص مبتنی بر 1 است.
NSString Value – مقدار بعد یا متریک سفارشی. در این مورد از معیارها، اگر متریک برای یک نوع ارز پیکربندی شده باشد، به عنوان یک عدد صحیح یا یک مقدار اعشاری با نقطه ثابت تجزیه خواهد شد.

تنظیم و ارسال مقادیر

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

// May return nil if a tracker has not yet been initialized with a property ID.
id tracker = [[GAI sharedInstance] defaultTracker];

// Set the custom dimension value on the tracker using its index.
[tracker set:[GAIFields customDimensionForIndex:1]
       value:@"Premium user"];

[tracker set:kGAIScreenName
       value:@"Home screen"];

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once, so it is set on the Map,
// not the tracker.

// Previous V3 SDK versions.
// [tracker send:[[[GAIDictionaryBuilder createAppView] set:@"premium"
//                                                   forKey:[GAIFields customDimensionForIndex:1]] build]];

// // SDK Version 3.08 and up.
[tracker send:[[[GAIDictionaryBuilder createScreenView] set:@"premium"
                                                     forKey:[GAIFields customDimensionForIndex:1]] build]];

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

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

// May return nil if a tracker has not yet been initialized with a property ID.
id tracker = [[GAI sharedInstance] defaultTracker];


// Set the custom metric to be incremented by 5 using its index.
[tracker set:[GAIFields customMetricForIndex:1]
       value:[[NSNumber numberWithInt:5] stringValue]];


[tracker set:kGAIScreenName
       value:@"Home screen"];

// Custom metric value is sent with this screen view.
// [tracker send:[[GAIDictionaryBuilder createAppView] build]];     // Previous V3 SDK versions.
[tracker send:[[GAIDictionaryBuilder createScreenView] build]];     // SDK Version 3.08 and up.

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

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

ملاحظات برای ابعاد سفارشی

مقادیر با محدوده کاربر و سطح جلسه برای بازدیدهای گذشته اعمال می شود

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

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

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

ملاحظات برای معیارهای سفارشی

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

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

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

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

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

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

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

@implementation myViewController

-(void)viewDidAppear
{
    id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker];  // Get the tracker object.
    [tracker set:[GAIFields customDimensionForIndex:1]
           value:@"premium"];
    [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 را ممنوع می کند. برای اطلاعات بیشتر، لطفاً به شرایط خدمات مراجعه کنید.