نظرة عامة
فئة مساعدة لإنشاء قاموس لمعلمات وقيم النتائج.
أمثلة:
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 *) | - get: |
تعرض قيمة مَعلمة الإدخال paramName، أو nil في حال عدم توفّر paramName. المزيد... | |
(NSMutableDictionary *) | - إنشاء |
عرض كائن NSMutableDictionary مع جميع المُعلَّمات المحدَّدة في هذا. المزيد... | |
(GAIDictionaryBuilder *) | - setCampaignParametersFromUrl: |
تحليل مَعلمات حملة نظام مراقبة الزيارات من Urchin وترجمتها إلى مَعلمة حملة "إحصاءات Google" وعرضها كخريطة المزيد... | |
(GAIDictionaryBuilder *) | - setProductAction: |
اضبط حقل إجراء المنتج لهذه النتيجة. المزيد... | |
(GAIDictionaryBuilder *) | - addProduct: |
تُضيف منتجًا إلى هذه النتيجة. المزيد... | |
(GAIDictionaryBuilder *) | - addProductImpression:impressionList:impressionSource: |
أضِف مرة ظهور منتج إلى هذه النتيجة. المزيد... | |
(GAIDictionaryBuilder *) | - addpromotion: |
أضِف ترويجًا إلى هذه النتيجة. المزيد... | |
توثيق المنهج
- (GAIDictionaryBuilder *) setAll: | (NSDictionary *) | params |
يتم نسخ جميع أزواج الاسم والقيمة من المَعلمات إلى هذا الكائن، مع تجاهل أي مفاتيح ليست NSString وأي قيم ليست NSString أو NSNull.
- (NSString *) get: | (NSString *) | paramName |
تعرض قيمة مَعلمة الإدخال paramName، أو nil في حال عدم توفّر paramName.
- إصدار (NSMutableDictionary *) |
عرض كائن NSMutableDictionary مع جميع المُعلَّمات المحدَّدة في هذا.
- (GAIDictionaryBuilder *) setCampaignParametersFromUrl: | (NSString *) | urlString |
تحليل مَعلمات حملة نظام مراقبة الزيارات من Urchin وترجمتها إلى مَعلمة حملة "إحصاءات Google" وعرضها كخريطة
- المَعلمات
-
params عنوان URL يحتوي على معلمات حملة نظام مراقبة الزيارات من Urchin
مَعلمات الحملة الصالحة هي:
- utm_id
- utm_campaign
- utm_content
- utm_medium
- utm_source
- utm_term
- dclid
- gclid
- gmob_t
- aclid
- anid
مثال: http://my.site.com/index.html?utm_campaign=wow&utm_source=source utm_campaign=wow&utm_source=source.
لمزيد من المعلومات عن وضع العلامات التلقائي ووضع العلامات يدويًّا، اطّلِع على مزايا وضع العلامات التلقائي.
+ (GAIDictionaryBuilder *) createAppView |
تعرِض كائن GAIDictionaryBuilder مع مَعلمات خاصة بنتيجة appview.
تجدر الإشارة إلى أنّ استخدام هذه الطريقة لن يؤدّي إلى ضبط اسم الشاشة لنتائج المتابعة. لتنفيذ ذلك، تحتاج إلى طلب set:kGAIDescription:<screenName> على مثيل GAITracker.
تم إيقاف هذه الطريقة نهائيًا. يُرجى استخدام createScreenView بدلاً من ذلك.
+ (GAIDictionaryBuilder *) createScreenView |
تعرض كائن GAIDictionaryBuilder مع مَعلمات خاصة بنتيجة مشاهدة صفحة في التطبيق.
تجدر الإشارة إلى أنّ استخدام هذه الطريقة لن يؤدّي إلى ضبط اسم الشاشة لنتائج المتابعة. لتنفيذ ذلك، تحتاج إلى طلب set:kGAIDescription:<screenName> على مثيل GAITracker.
+ (GAIDictionaryBuilder *) createEventWithCategory: | (NSString *) | category | |
الإجراء: | (NSString *) | الإجراء | |
التسمية: | (NSString *) | التصنيف | |
value: | (NSNumber *) | القيمة | |
لعرض كائن GAIDictionaryBuilder مع مَعلمات خاصة بنتيجة حدث.
+ (GAIDictionaryBuilder *) createExceptionWithDescription: | (NSString *) | description | |
withFatal: | (NSNumber *) | فادح | |
تعرض كائن GAIDictionaryBuilder مع مَعلمات خاصة بنتيجة استثناء.
+ (GAIDictionaryBuilder *) createItemWithTransactionId: | (NSString *) | transactionId | |
الاسم: | (NSString *) | name | |
SKU: | (NSString *) | SKU | |
الفئة: | (NSString *) | category | |
السعر: | (NSNumber *) | price | |
الكمية: | (NSNumber *) | quantity | |
currencyCode: | (NSString *) | currencyCode | |
تعرِض كائن GAIDictionaryBuilder مع مَعلمات خاصة بنتيجة عنصر.
+ (GAIDictionaryBuilder *) createSocialWithNetwork: | (NSString *) | الشبكة | |
الإجراء: | (NSString *) | الإجراء | |
الهدف: | (NSString *) | الهدف | |
تعرِض كائن GAIDictionaryBuilder مع معلمات خاصة بنتيجة اجتماعية.
+ (GAIDictionaryBuilder *) createTimingWithCategory: | (NSString *) | category | |
الفاصل الزمني: | (NSNumber *) | intervalMillis | |
الاسم: | (NSString *) | name | |
التسمية: | (NSString *) | label | |
تعرض كائن GAIDictionaryBuilder مع مَعلمات خاصة بنتيجة توقيت.
+ (GAIDictionaryBuilder *) createTransactionWithId: | (NSString *) | transactionId | |
affiliation: | (NSString *) | affiliation | |
الإيرادات: | (NSNumber *) | revenue | |
الضريبة: | (NSNumber *) | tax | |
الشحن: | (NSNumber *) | shipping | |
currencyCode: | (NSString *) | currencyCode | |
تعرِض كائن GAIDictionaryBuilder مع مَعلمات خاصة بنتيجة معاملة.
- (GAIDictionaryBuilder *) setProductAction: | (GAIEcommerceProductAction *) | productAction |
اضبط حقل إجراء المنتج لهذه النتيجة.
- (GAIDictionaryBuilder *) addProduct: | (GAIEcommerceProduct *) | المنتَج |
تُضيف منتجًا إلى هذه النتيجة.
- (GAIDictionaryBuilder *) addProductimpression: | (GAIEcommerceProduct *) | المنتَج | |
قائمة مرات الظهور: | (NSString *) | name | |
مرات الظهور: | (NSString *) | المصدر | |
أضِف مرة ظهور منتج إلى هذه النتيجة.
- (GAIDictionaryBuilder *) addpromo: | (GAIEcommercePromotion *) | عرض ترويجي |
أضِف ترويجًا إلى هذه النتيجة.