بررسی اجمالی

کلاس کمکی برای ساخت فرهنگ لغت از پارامترها و مقادیر ضربه.

مثال ها:

id<GAITracker> t = // get a tracker.
[t send:[[[GAIDictionaryBuilder createEventWithCategory:@"EventCategory"
                                                 action:@"EventAction"
                                                  label:nil
                                                  value:nil]
    set:"dimension1" forKey:[GAIFields customDimensionForIndex:1]] build]];

این یک نوع ضربه رویداد را با پارامترهای مشخص شده و یک پارامتر ابعاد سفارشی ارسال می کند.
اگر می خواهید پارامتری را با تمام بازدیدها ارسال کنید، آن را مستقیماً روی GAITracker تنظیم کنید.

[t set:kGAIScreenName value:@"Home"];
[t send:[[GAIDictionaryBuilder createSocialWithNetwork:@"Google+"
                                                action:@"PlusOne"
                                                target:@"SOME_URL"] build]];
[t send:[[GAIDictionaryBuilder createSocialWithNetwork:@"Google+"
                                                action:@"Share"
                                                target:@"SOME_POST"] build]];
[t send:[[GAIDictionaryBuilder createSocialWithNetwork:@"Google+"
                                                action:@"HangOut"
                                                target:@"SOME_CIRCLE"]
    build]];

می‌توانید مقداری را که روی ردیاب تنظیم شده است با افزودن آن به فرهنگ لغت لغو کنید.

[t set:kGAIScreenName value:@"Home"];
[t send:...];
[t send[[[GAIDictionaryBuilder createEventWithCategory:@"click"
                                                action:@"popup"
                                                 label:nil
                                                 value:nil]
    set:@"popup title" forKey:kGAIScreenName] build]];

مقادیر تنظیم شده از طریق [ GAIDictionaryBuilder set] یا [ GAIDictionaryBuilder setAll] هر مقدار موجود در شی GAIDictionaryBuilder را لغو می کند (یعنی توسط [ GAIDictionaryBuilder createXYZ] مقداردهی اولیه شده است). به عنوان مثال

GAIDictionaryBuilder *m =
    GAIDictionaryBuilder createTimingWithCategory:@"category"
                                         interval:@0
                                             name:@"name"
                                            label:nil];
[t send:[m.set:@"10" forKey:kGAITimingVar] build];
[t send:[m.set:@"20" forKey:kGAITimingVar] build];

NSObject را به ارث می برد.

روش های نمونه
( GAIDictionaryBuilder *)	- setAll:
	تمام جفت‌های نام-مقدار را از پارامترها در این شی کپی می‌کند، بدون توجه به کلیدهایی که NSString نیستند و مقادیری که NSString یا NSNull نیستند. بیشتر...

(NSString *)	- گرفتن:
	مقدار پارامتر ورودی paramName یا صفر را اگر paramName وجود نداشته باشد برمی‌گرداند. بیشتر...

(NSMutableDictionary *)	- ساختن
	یک شی NSMutableDictionary را با تمام پارامترهای تنظیم شده در آن برگردانید. بیشتر...

( GAIDictionaryBuilder *)	- setCampaignParametersFromUrl:
	پارامترهای کمپین utm را به پارامتر کمپین تحلیلی تجزیه و ترجمه می کند و آنها را به صورت نقشه برمی گرداند. بیشتر...

( GAIDictionaryBuilder *)	- setProductAction:
	فیلد اقدام محصول را برای این ضربه تنظیم کنید. بیشتر...

( GAIDictionaryBuilder *)	- افزودن محصول:
	محصولی را به این موفقیت اضافه می کند. بیشتر...

( GAIDictionaryBuilder *)	- addProductImpression:impressionList:impressionSource:
	نمایش محصول را به این موفقیت اضافه کنید. بیشتر...

( GAIDictionaryBuilder *)	- addPromotion:
	یک تبلیغ به این موفقیت اضافه کنید. بیشتر...

روش های کلاس
("به جای آن از createScreenView استفاده کنید.")	+ ایجاد اپ ویو
	یک شی GAIDictionaryBuilder را با پارامترهای خاص یک بازدید برنامه برمی گرداند. بیشتر...

( GAIDictionaryBuilder *)	+ createScreenView
	یک شی GAIDictionaryBuilder را با پارامترهای خاص یک ضربه نمایشگر برمی گرداند. بیشتر...

( GAIDictionaryBuilder *)	+ createEventWithCategory:action:label:value:
	یک شی GAIDictionaryBuilder را با پارامترهای خاص یک رویداد برمی گرداند. بیشتر...

( GAIDictionaryBuilder *)	+ createExceptionWithDescription:withFatal:
	یک شی GAIDictionaryBuilder را با پارامترهای خاص یک ضربه استثنا برمی گرداند. بیشتر...

( GAIDictionaryBuilder *)	+ createItemWithTransactionId:name:sku:رده:قیمت:مقدار:currencyCode:
	یک شی GAIDictionaryBuilder را با پارامترهای خاص به یک آیتم برمی گرداند. بیشتر...

( GAIDictionaryBuilder *)	+ createSocialWithNetwork:action:target:
	یک شی GAIDictionaryBuilder را با پارامترهای خاص برای یک ضربه اجتماعی برمی گرداند. بیشتر...

( GAIDictionaryBuilder *)	+ createTimingWithCategory:interval:name:label:
	یک شی GAIDictionaryBuilder را با پارامترهای خاص یک ضربه زمان برمی گرداند. بیشتر...

( GAIDictionaryBuilder *)	+ createTransactionWithId:affiliation:revenue:tax:shipping:currencyCode:
	یک شی GAIDictionaryBuilder را با پارامترهای خاص برای یک ضربه تراکنش برمی گرداند. بیشتر...

مستندات روش

- ( GAIDictionaryBuilder *) setAll: (NSDictionary *) پارامترها

تمام جفت‌های نام-مقدار را از پارامترها در این شی کپی می‌کند، بدون توجه به کلیدهایی که NSString نیستند و مقادیری که NSString یا NSNull نیستند.

- (NSString *) دریافت کنید: (NSString *) نام پارامتر

مقدار پارامتر ورودی paramName یا صفر را اگر paramName وجود نداشته باشد برمی‌گرداند.

- (NSMutableDictionary *) ساخت

یک شی NSMutableDictionary را با تمام پارامترهای تنظیم شده در آن برگردانید.

- ( GAIDictionaryBuilder *) setCampaignParametersFromUrl: (NSString *) urlString

پارامترهای کمپین utm را به پارامتر کمپین تحلیلی تجزیه و ترجمه می کند و آنها را به صورت نقشه برمی گرداند.

مولفه های

پارامترها آدرس اینترنتی حاوی پارامترهای کمپین utm.

پارامترهای کمپین معتبر عبارتند از:

utm_id
utm_campaign
utm_content
utm_medium
utm_source
utm_term
dclid
gclid
gmob_t
آکلید
آنید

مثال: http://my.site.com/index.html?utm_campaign=wow&utm_source=source utm_campaign=wow&utm_source=source.

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

+ ( GAIDictionaryBuilder *) createAppView

یک شی GAIDictionaryBuilder را با پارامترهای خاص برای بازدید برنامه برمی‌گرداند.

توجه داشته باشید که با استفاده از این روش، نام صفحه نمایش برای بازدیدهای بعدی تنظیم نمی شود. برای این کار باید set:kGAIDescription value:<screenName> را در نمونه GAITracker فراخوانی کنید.

این روش منسوخ شده است. به جای آن از createScreenView استفاده کنید.

+ ( GAIDictionaryBuilder *) createScreenView

یک شی GAIDictionaryBuilder را با پارامترهای خاص یک ضربه نمایشگر برمی گرداند.

توجه داشته باشید که با استفاده از این روش، نام صفحه نمایش برای بازدیدهای بعدی تنظیم نمی شود. برای این کار باید set:kGAIDescription value:<screenName> را در نمونه GAITracker فراخوانی کنید.

+ ( GAIDictionaryBuilder *) createEventWithCategory:	(NSString *)	دسته بندی
عمل:	(NSString *)	عمل
برچسب:	(NSString *)	برچسب
ارزش:	(شماره NS *)	ارزش

یک شی GAIDictionaryBuilder را با پارامترهای خاص یک رویداد برمی گرداند.

+ ( GAIDictionaryBuilder *) createExceptionWithDescription:	(NSString *)	شرح
با مرگبار:	(شماره NS *)	کشنده

یک شی GAIDictionaryBuilder را با پارامترهای خاص یک ضربه استثنا برمی گرداند.

+ ( GAIDictionaryBuilder *) createItemWithTransactionId:	(NSString *)	شناسه تراکنش
نام:	(NSString *)	نام
sku:	(NSString *)	sku
دسته بندی:	(NSString *)	دسته بندی
قیمت:	(شماره NS *)	قیمت
تعداد:	(شماره NS *)	تعداد
کد ارز:	(NSString *)	کد ارز

یک شی GAIDictionaryBuilder را با پارامترهای خاص به یک آیتم برمی گرداند.

+ ( GAIDictionaryBuilder *) createSocialWithNetwork:	(NSString *)	شبکه
عمل:	(NSString *)	عمل
هدف:	(NSString *)	هدف

یک شی GAIDictionaryBuilder را با پارامترهای خاص برای یک ضربه اجتماعی برمی گرداند.

+ ( GAIDictionaryBuilder *) createTimingWithCategory:	(NSString *)	دسته بندی
فاصله زمانی:	(شماره NS *)	فاصله میلیس
نام:	(NSString *)	نام
برچسب:	(NSString *)	برچسب

یک شی GAIDictionaryBuilder را با پارامترهای خاص یک ضربه زمان برمی گرداند.

+ ( GAIDictionaryBuilder *) createTransactionWithId:	(NSString *)	شناسه تراکنش
وابستگی:	(NSString *)	وابستگی
درآمد:	(شماره NS *)	درآمد
مالیات:	(شماره NS *)	مالیات
حمل دریایی:	(شماره NS *)	حمل دریایی
کد ارز:	(NSString *)	کد ارز

یک شی GAIDictionaryBuilder را با پارامترهای خاص برای یک ضربه تراکنش برمی گرداند.

- ( GAIDictionaryBuilder *) setProductAction: ( GAIEcommerceProductAction *) محصول اکشن

فیلد اقدام محصول را برای این ضربه تنظیم کنید.

- ( GAIDictionaryBuilder *) addProduct: ( GAIEcommerceProduct *) تولید - محصول

محصولی را به این موفقیت اضافه می کند.

- ( GAIDictionaryBuilder *) addProductImpression:	( GAIEcommerceProduct *)	تولید - محصول
ImpressionList:	(NSString *)	نام
impressionSource:	(NSString *)	منبع

نمایش محصول را به این موفقیت اضافه کنید.

- ( GAIDictionaryBuilder *) addPromotion: ( GAIEcommercePromotion *) ترویج

یک تبلیغ به این موفقیت اضافه کنید.

مرجع کلاس GAIDictionaryBuilder

بررسی اجمالی

روش های نمونه

روش های کلاس

مستندات روش