نظرة عامة

فئة مساعدة لإنشاء قاموس لمعلمات وقيم النتائج.

أمثلة:

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:
	أضِف ترويجًا إلى هذه النتيجة. المزيد...

طرق الفئة
("استخدِم createScreenView بدلاً من ذلك").	+ createAppView
	تعرِض كائن GAIDictionaryBuilder مع مَعلمات خاصة بنتيجة appview. المزيد...

(GAIDictionaryBuilder *)	+ createScreenView
	تعرض كائن GAIDictionaryBuilder مع مَعلمات خاصة بنتيجة مشاهدة صفحة في التطبيق. المزيد...

(GAIDictionaryBuilder *)	+ createEventWithCategory:action:label:value:
	لعرض كائن GAIDictionaryBuilder مع مَعلمات خاصة بنتيجة حدث. المزيد...

(GAIDictionaryBuilder *)	+ createExceptionWithDescription:withFatal:
	تعرض كائن GAIDictionaryBuilder مع مَعلمات خاصة بنتيجة استثناء. المزيد...

(GAIDictionaryBuilder *)	+ createItemWithTransactionId:name:sku:category:price:quantity:currencyCode:
	تعرِض كائن GAIDictionaryBuilder مع مَعلمات خاصة بنتيجة عنصر. المزيد...

(GAIDictionaryBuilder *)	+ createSocialWithNetwork:action:target:
	تعرِض كائن GAIDictionaryBuilder مع معلمات خاصة بنتيجة اجتماعية. المزيد...

(GAIDictionaryBuilder *)	+ createTimingWithCategory:interval:name:label:
	تعرض كائن GAIDictionaryBuilder مع مَعلمات خاصة بنتيجة توقيت. المزيد...

(GAIDictionaryBuilder *)	+ createTransactionWithId:affiliation:revenue:tax:shipping:currencyCode:
	تعرِض كائن GAIDictionaryBuilder مع مَعلمات خاصة بنتيجة معاملة. المزيد...

توثيق المنهج

- (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 *) عرض ترويجي

أضِف ترويجًا إلى هذه النتيجة.

مرجع الصف GAIDictionaryBuilder

نظرة عامة

طرق المثيل

طرق الفئة

توثيق المنهج