ข้อมูลอ้างอิงคลาส GAIDictionaryBuilder

ภาพรวม

คลาสตัวช่วยสำหรับสร้างพจนานุกรมของพารามิเตอร์และค่า Hit


ตัวอย่างเช่น

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

ซึ่งจะส่งประเภท Event Hit พร้อมพารามิเตอร์ที่ระบุและพารามิเตอร์มิติข้อมูลที่กำหนดเอง
หากต้องการส่งพารามิเตอร์ที่มี Hit ทั้งหมด ให้ตั้งค่าใน 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:
 แยกวิเคราะห์และแปลพารามิเตอร์แคมเปญ UTM เป็นพารามิเตอร์แคมเปญ Analytics และแสดงผลเป็นแผนที่ เพิ่มเติม...
 
(GAIDictionaryBuilder *)- setProductAction:
 กำหนดช่องการดำเนินการเกี่ยวกับผลิตภัณฑ์สำหรับ Hit นี้ เพิ่มเติม...
 
(GAIDictionaryBuilder *)- addProduct:
 เพิ่มผลิตภัณฑ์ไปยัง Hit นี้ เพิ่มเติม...
 
(GAIDictionaryBuilder *)- addProductImpression:impressionList:impressionSource:
 เพิ่มการแสดงผลผลิตภัณฑ์ลงใน Hit นี้ เพิ่มเติม...
 
(GAIDictionaryBuilder *)- addPromotion:
 เพิ่มโปรโมชันให้กับ Hit นี้ เพิ่มเติม...
 

วิธีการของชั้นเรียน

("ใช้ createScreenView แทน")+ createAppView
 แสดงผลออบเจ็กต์ GAIDictionaryBuilder ที่มีพารามิเตอร์ที่เฉพาะเจาะจงสําหรับ Hit ของ AppView เพิ่มเติม...
 
(GAIDictionaryBuilder *)+ createScreenView
 แสดงผลออบเจ็กต์ GAIDictionaryBuilder ที่มีพารามิเตอร์ที่เฉพาะเจาะจงสําหรับ Hit ของการดูหน้าจอ เพิ่มเติม...
 
(GAIDictionaryBuilder *)+ createEventWithCategory:action:label:value:
 แสดงผลออบเจ็กต์ GAIDictionaryBuilder ที่มีพารามิเตอร์ที่เฉพาะเจาะจงสําหรับ Event Hit เพิ่มเติม...
 
(GAIDictionaryBuilder *)+ createExceptionWithDescription:withFatal:
 แสดงผลออบเจ็กต์ GAIDictionaryBuilder ที่มีพารามิเตอร์ที่เฉพาะเจาะจงสําหรับ Hit ของข้อยกเว้น เพิ่มเติม...
 
(GAIDictionaryBuilder *)+ createItemWithTransactionId:name:sku:category:price:quantity:currencyCode:
 แสดงผลออบเจ็กต์ GAIDictionaryBuilder ที่มีพารามิเตอร์ที่เฉพาะเจาะจงสําหรับ Hit ของรายการ เพิ่มเติม...
 
(GAIDictionaryBuilder *)+ createSocialWithNetwork:action:target:
 แสดงผลออบเจ็กต์ GAIDictionaryBuilder ที่มีพารามิเตอร์ที่เจาะจงสําหรับ Hit ของโซเชียล เพิ่มเติม...
 
(GAIDictionaryBuilder *)+ createTimingWithCategory:interval:name:label:
 แสดงผลออบเจ็กต์ GAIDictionaryBuilder ที่มีพารามิเตอร์ที่เฉพาะเจาะจงสําหรับ Hit ตามเวลา เพิ่มเติม...
 
(GAIDictionaryBuilder *)+ createTransactionWithId:affiliation:revenue:tax:shipping:currencyCode:
 แสดงผลออบเจ็กต์ GAIDictionaryBuilder ที่มีพารามิเตอร์ที่เฉพาะเจาะจงสําหรับ Hit ของธุรกรรม เพิ่มเติม...
 

เอกสารประกอบของเมธอด

- (GAIDictionaryBuilder *) setAll: (พจนานุกรม *) params

คัดลอกคู่ชื่อ-ค่าทั้งหมดจากพารามิเตอร์ลงในออบเจ็กต์นี้ โดยไม่คำนึงถึงคีย์ที่ไม่ใช่ NSString และค่าใดๆ ที่ไม่ใช่ NSString หรือ NSNull

- (NSString *) ได้รับ: (NSString *) paramName

แสดงผลค่าของพารามิเตอร์อินพุต paramName หรือ nil หากไม่มี paramName

- บิลด์ (NSMutableDictionary *)

แสดงผลออบเจ็กต์ NSMutableDictionary ที่มีพารามิเตอร์ทั้งหมดที่ตั้งค่าไว้

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

แยกวิเคราะห์และแปลพารามิเตอร์แคมเปญ UTM เป็นพารามิเตอร์แคมเปญ Analytics และแสดงผลเป็นแผนที่

พารามิเตอร์
paramsURL ที่มีพารามิเตอร์แคมเปญ UTM

พารามิเตอร์แคมเปญที่ถูกต้องคือ

  • 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 ที่มีพารามิเตอร์ที่เฉพาะเจาะจงสําหรับ Hit ของ AppView

โปรดทราบว่าการใช้เมธอดนี้จะไม่ตั้งชื่อหน้าจอสำหรับ Hit ที่ติดตามมา ซึ่งคุณจะต้องเรียก set:kGAIDescription value:<screenName> ในอินสแตนซ์ GAITracker

วิธีการนี้เลิกใช้งานแล้ว ใช้ createScreenView แทน

+ (GAIDictionaryBuilder *) createScreenView

แสดงผลออบเจ็กต์ GAIDictionaryBuilder ที่มีพารามิเตอร์ที่เฉพาะเจาะจงสําหรับ Hit ของการดูหน้าจอ

โปรดทราบว่าการใช้เมธอดนี้จะไม่ตั้งชื่อหน้าจอสำหรับ Hit ที่ติดตามมา ซึ่งคุณจะต้องเรียก set:kGAIDescription value:<screenName> ในอินสแตนซ์ GAITracker

+ (GAIDictionaryBuilder *) createEventWithCategory: (NSString *) category
การดำเนินการ: (NSString *) การดำเนินการ
ป้ายกำกับ: (NSString *) ป้ายกำกับ
value: (NSNumber *) ค่า

แสดงผลออบเจ็กต์ GAIDictionaryBuilder ที่มีพารามิเตอร์ที่เฉพาะเจาะจงสําหรับ Event Hit

+ (GAIDictionaryBuilder *) createExceptionWithDescription: (NSString *) รายละเอียด [description]
withFatal: (NSNumber *) ร้ายแรง

แสดงผลออบเจ็กต์ GAIDictionaryBuilder ที่มีพารามิเตอร์ที่เฉพาะเจาะจงสําหรับ Hit ของข้อยกเว้น

+ (GAIDictionaryBuilder *) createItemWithTransactionId: (NSString *) transactionId
ชื่อ: (NSString *) name
SKU: (NSString *) SKU
หมวดหมู่: (NSString *) category
ราคา: (NSNumber *) price
จำนวน: (NSNumber *) quantity
currencyCode: (NSString *) currencyCode

แสดงผลออบเจ็กต์ GAIDictionaryBuilder ที่มีพารามิเตอร์ที่เฉพาะเจาะจงสําหรับ Hit ของรายการ

+ (GAIDictionaryBuilder *) createSocialWithNetwork: (NSString *) เครือข่าย
การดำเนินการ: (NSString *) การดำเนินการ
เป้าหมาย: (NSString *) เป้าหมาย

แสดงผลออบเจ็กต์ GAIDictionaryBuilder ที่มีพารามิเตอร์ที่เจาะจงสําหรับ Hit ของโซเชียล

+ (GAIDictionaryBuilder *) createTimingWithCategory: (NSString *) category
ช่วงเวลา: (NSNumber *) intervalMillis
ชื่อ: (NSString *) name
ป้ายกำกับ: (NSString *) ป้ายกำกับ [label]

แสดงผลออบเจ็กต์ GAIDictionaryBuilder ที่มีพารามิเตอร์ที่เฉพาะเจาะจงสําหรับ Hit ตามเวลา

+ (GAIDictionaryBuilder *) createTransactionWithId: (NSString *) transactionId
affiliation: (NSString *) affiliation
รายได้: (NSNumber *) revenue
ภาษี: (NSNumber *) tax
การจัดส่ง: (NSNumber *) shipping
currencyCode: (NSString *) currencyCode

แสดงผลออบเจ็กต์ GAIDictionaryBuilder ที่มีพารามิเตอร์ที่เฉพาะเจาะจงสําหรับ Hit ของธุรกรรม

- (GAIDictionaryBuilder *) setProductAction: (GAIEcommerceProductAction *) productAction

กำหนดช่องการดำเนินการเกี่ยวกับผลิตภัณฑ์สำหรับ Hit นี้

- (GAIDictionaryBuilder *) addProduct: (GAIEcommerceProduct *) ผลิตภัณฑ์

เพิ่มผลิตภัณฑ์ไปยัง Hit นี้

- (GAIDictionaryBuilder *) addProductimpression: (GAIEcommerceProduct *) ผลิตภัณฑ์
การแสดงผลรายการ: (NSString *) name
แหล่งที่มาของการแสดงผล: (NSString *) แหล่งที่มา

เพิ่มการแสดงผลผลิตภัณฑ์ลงใน Hit นี้

- (GAIDictionaryBuilder *) addPromotion: (GAIEcommercePromotion *) โปรโมชัน

เพิ่มโปรโมชันให้กับ Hit นี้