סקירה

מחלקת עזרה ליצירת מילון של פרמטרים וערכי היטים.

דוגמאות:

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, או nil אם paramName אינו קיים. עוד...

(NSMutableDictionary *)	- בנייה
	החזר אובייקט NSMutableDictionary עם כל הפרמטרים מוגדרים בו. עוד...

(GAIDictionaryBuilder *)	– setCampaignParametersFromUrl:
	ניתוח ותרגום של פרמטרים של מנטר התנועה של Urchin בקמפיין לפרמטר של קמפיין Google Analytics ומחזיר אותם כמפה. עוד...

(GAIDictionaryBuilder *)	– setProductAction:
	מגדירים את השדה של פעולת המוצר עבור ההיט הזה. עוד...

(GAIDictionaryBuilder *)	- addProduct:
	הוספת מוצר להיט הזה. עוד...

(GAIDictionaryBuilder *)	– addProductImpression:impressionList:impressionSource:
	צריך להוסיף להיט הזה חשיפה של מוצר. עוד...

(GAIDictionaryBuilder *)	- addPromotion:
	הוסף קידום להיט הזה. עוד...

שיטות בכיתה
("במקום זאת, יש להשתמש ב-createScreenView.")	+ createAppView
	מחזירה אובייקט GAIDictionaryBuilder עם פרמטרים הספציפיים להיט של צפייה באפליקציה. עוד...

(GAIDictionaryBuilder *)	+ createScreenView
	מחזירה אובייקט GAIDictionaryBuilder עם פרמטרים הספציפיים להיט צפייה במסך. עוד...

(GAIDictionaryBuilder *)	+ createEventWithCategory:action:label:value:
	מחזירה אובייקט GAIDictionaryBuilder עם פרמטרים הספציפיים להיט אירוע. עוד...

(GAIDictionaryBuilder *)	+ createSpendWithDescription: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 *) קבל: (NSString *) paramName

מחזירה את הערך של פרמטר הקלט paramName, או nil אם paramName אינו קיים.

- build של (NSMutableDictionary *)

החזר אובייקט NSMutableDictionary עם כל הפרמטרים מוגדרים בו.

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

ניתוח ותרגום של פרמטרים של מנטר התנועה של Urchin בקמפיין לפרמטר של קמפיין Google Analytics ומחזיר אותם כמפה.

פרמטרים

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 עם פרמטרים הספציפיים להיט של צפייה באפליקציה.

שים לב ששימוש בשיטה הזו לא תגדיר את שם המסך עבור היטים של מעקב. לשם כך, צריך לקרוא ל-set:kGAIDescription value:<screenName> במכונה GAITracker.

השיטה הזו הוצאה משימוש. במקום זאת, צריך להשתמש ב-createScreenView.

+ (GAIDictionaryBuilder *) createScreenView

מחזירה אובייקט GAIDictionaryBuilder עם פרמטרים הספציפיים להיט צפייה במסך.

שים לב ששימוש בשיטה הזו לא תגדיר את שם המסך עבור היטים של מעקב. לשם כך, צריך לקרוא ל-set:kGAIDescription value:<screenName> במכונה GAITracker.

+ (GAIDictionaryBuilder *) createEventWithCategory:	(NSString *)	category
פעולה:	(NSString *)	פעולה
label:	(NSString *)	תווית
value:	(NSNumber *)	value

מחזירה אובייקט GAIDictionaryBuilder עם פרמטרים הספציפיים להיט אירוע.

+ (GAIDictionaryBuilder *) createOriginWithDescription:	(NSString *)	description [תיאור]
withFatal:	(NSNumber *)	קטלני

מחזירה אובייקט GAIDictionaryBuilder עם פרמטרים הספציפיים להיט חריג.

+ (GAIDictionaryBuilder *) createItemWithTransactionId:	(NSString *)	transactionId
שם:	(NSString *)	name
מק"ט:	(NSString *)	מק"ט
קטגוריה:	(NSString *)	category
מחיר:	(NSNumber *)	price
כמות:	(NSNumber *)	quantity
currencyCode:	(NSString *)	currencyCode (קוד מטבע)

מחזירה אובייקט GAIDictionaryBuilder עם פרמטרים הספציפיים להיט פריט.

+ (GAIDictionaryBuilder *) createSocialWithNetwork:	(NSString *)	network
פעולה:	(NSString *)	פעולה
יעד:	(NSString *)	target [יעד]

מחזירה אובייקט GAIDictionaryBuilder עם פרמטרים הספציפיים להיט ברשת חברתית.

+ (GAIDictionaryBuilder *) createTimingWithCategory:	(NSString *)	category
מרווח:	(NSNumber *)	intervalMillis
שם:	(NSString *)	name
label:	(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 *) addProductImpr:	(GAIEcommerceProduct *)	מוצר
רשימת חשיפות:	(NSString *)	name
מקור החשיפה:	(NSString *)	source

צריך להוסיף להיט הזה חשיפה של מוצר.

- (GAIDictionaryBuilder *) addPromotion: (GAIEcommercePromotion *) מבצע

הוסף קידום להיט הזה.

חומר עזר למחלקה של GAIDictionaryBuilder

סקירה

שיטות של מכונות

שיטות בכיתה

תיעוד השיטה