بررسی اجمالی
کلاس کمکی برای ساخت فرهنگ لغت از پارامترها و مقادیر ضربه.
مثال ها:
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: |
یک تبلیغ به این موفقیت اضافه کنید. بیشتر... | |
مستندات روش
- ( 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 *) | ترویج |
یک تبلیغ به این موفقیت اضافه کنید.