Tổng quan
Lớp trợ giúp để tạo từ điển về các thông số và giá trị lượt truy cập.
Ví dụ:
id<GAITracker> t = // get a tracker. [t send:[[[GAIDictionaryBuilder createEventWithCategory:@"EventCategory" action:@"EventAction" label:nil value:nil] set:"dimension1" forKey:[GAIFields customDimensionForIndex:1]] build]];
Thao tác này sẽ gửi loại lượt truy cập sự kiện cùng với các thông số được chỉ định và thông số phương diện tùy chỉnh.
Nếu bạn muốn gửi thông số có tất cả các lượt truy cập, hãy trực tiếp đặt thông số đó trên 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]];
Bạn có thể ghi đè một giá trị được đặt trên trình theo dõi bằng cách thêm giá trị đó vào từ điển.
[t set:kGAIScreenName value:@"Home"]; [t send:...]; [t send[[[GAIDictionaryBuilder createEventWithCategory:@"click" action:@"popup" label:nil value:nil] set:@"popup title" forKey:kGAIScreenName] build]];
Các giá trị được đặt qua tập hợp [GAIDictionaryBuilder] hoặc [GAIDictionaryBuilder setAll] sẽ ghi đè mọi giá trị hiện có trong đối tượng GAIDictionaryBuilder (ví dụ: do [GAIDictionaryBuilder createXYZ] khởi tạo, ví dụ:
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];
Kế thừa NSObject.
Phương thức thực thể | |
| (GAIDictionaryBuilder *) | – setAll: |
| Sao chép tất cả cặp tên-giá trị từ các tham số vào đối tượng này, bỏ qua mọi khoá không phải là NSString và mọi giá trị không phải là NSString hoặc NSNull. Thêm... | |
| (NSString *) | – nhận được: |
| Trả về giá trị cho thông số đầu vào paramName hoặc nil nếu không có paramName. Thêm... | |
| (NSMutableMutable *) | - tạo |
| Trả về một đối tượng NSMutableSchema với tất cả các tham số được đặt trong đối tượng này. Thêm... | |
| (GAIDictionaryBuilder *) | – setCampaignParametersFromUrl: |
| Phân tích cú pháp và chuyển đổi các thông số chiến dịch utm sang thông số chiến dịch Analytics và trả về chúng dưới dạng bản đồ. Thêm... | |
| (GAIDictionaryBuilder *) | – setProductAction: |
| Đặt trường hành động cho sản phẩm cho lượt truy cập này. Thêm... | |
| (GAIDictionaryBuilder *) | – addProduct: |
| Thêm một sản phẩm vào lượt truy cập này. Thêm... | |
| (GAIDictionaryBuilder *) | – addProductImpression:impressionList:impressionSource: |
| Thêm lượt hiển thị sản phẩm vào lượt truy cập này. Thêm... | |
| (GAIDictionaryBuilder *) | – addpromotion: |
| Thêm chương trình khuyến mãi vào lượt truy cập này. Thêm... | |
Phương thức lớp | |
| ("Thay vào đó, hãy sử dụng createScreenView.") | + createAppView |
| Trả về đối tượng GAIDictionaryBuilder có các thông số dành riêng cho một lượt truy cập vào appview. Thêm... | |
| (GAIDictionaryBuilder *) | + createScreenView |
| Trả về đối tượng GAIDictionaryBuilder có các thông số dành riêng cho một lượt truy cập vào chế độ xem màn hình. Thêm... | |
| (GAIDictionaryBuilder *) | + createEventWithCategory:action:label:value: |
| Trả về đối tượng GAIDictionaryBuilder có các thông số dành riêng cho một lượt truy cập sự kiện. Thêm... | |
| (GAIDictionaryBuilder *) | + createExceptionWithDescription:withFatal: |
| Trả về một đối tượng GAIDictionaryBuilder có các tham số dành riêng cho một lượt truy cập ngoại lệ. Thêm... | |
| (GAIDictionaryBuilder *) | + createItemWithTransactionId:name:sku:category:price:quantity:currencyCode: |
| Trả về một đối tượng GAIDictionaryBuilder có các thông số dành riêng cho một lượt truy cập mục. Thêm... | |
| (GAIDictionaryBuilder *) | + createSocialWithNetwork:action:target: |
| Trả về đối tượng GAIDictionaryBuilder có các thông số cụ thể cho một lượt truy cập trên mạng xã hội. Thêm... | |
| (GAIDictionaryBuilder *) | + createTimingWithCategory:interval:name:label: |
| Trả về một đối tượng GAIDictionaryBuilder có các tham số dành riêng cho một lượt truy cập thời gian. Thêm... | |
| (GAIDictionaryBuilder *) | + createTransactionWithId:affiliation:revenue:tax:shipping:currencyCode: |
| Trả về đối tượng GAIDictionaryBuilder có các thông số dành riêng cho một lượt truy cập giao dịch. Thêm... | |
Tài liệu về phương pháp
| – (GAIDictionaryBuilder *) setAll: | (NSTừ điển *) | params |
Sao chép tất cả cặp tên-giá trị từ các tham số vào đối tượng này, bỏ qua mọi khoá không phải là NSString và mọi giá trị không phải là NSString hoặc NSNull.
| – (NSString *) nhận: | (NSString *) | paramName |
Trả về giá trị cho thông số đầu vào paramName hoặc nil nếu không có paramName.
| – Bản dựng (NSMutableSchema *) |
Trả về một đối tượng NSMutableSchema với tất cả các tham số được đặt trong đối tượng này.
| – (GAIDictionaryBuilder *) setCampaignParametersFromUrl: | (NSString *) | urlString |
Phân tích cú pháp và chuyển đổi các thông số chiến dịch utm sang thông số chiến dịch Analytics và trả về chúng dưới dạng bản đồ.
- Tham số
-
params url chứa thông số chiến dịch utm.
Các thông số chiến dịch hợp lệ là:
- utm_id
- utm_campaign
- utm_content
- utm_medium
- utm_source
- utm_term
- dclid
- gclid
- gmob_t
- aclid
- anid
Ví dụ: http://my.site.com/index.html?utm_campaign=wow&utm_source=source utm_campaign=wow&utm_source=source.
Để biết thêm thông tin về tính năng tự động gắn thẻ và gắn thẻ thủ công, hãy xem bài viết Lợi ích của tính năng tự động gắn thẻ.
| + (GAIDictionaryBuilder *) createAppView |
Trả về đối tượng GAIDictionaryBuilder có các thông số dành riêng cho một lượt truy cập vào appview.
Lưu ý rằng việc sử dụng phương thức này sẽ không đặt tên màn hình cho lượt truy cập tiếp theo. Để làm việc đó, bạn cần gọi giá trị set:kGAIDescription:<screenName> trên phiên bản GAITracker.
Phương thức này không dùng nữa. Thay vào đó, hãy sử dụng createScreenView.
| + (GAIDictionaryBuilder *) createScreenView |
Trả về đối tượng GAIDictionaryBuilder có các thông số dành riêng cho một lượt truy cập vào chế độ xem màn hình.
Lưu ý rằng việc sử dụng phương thức này sẽ không đặt tên màn hình cho lượt truy cập tiếp theo. Để làm việc đó, bạn cần gọi giá trị set:kGAIDescription:<screenName> trên phiên bản GAITracker.
| + (GAIDictionaryBuilder *) createEventWithCategory: | (NSString *) | category | |
| hành động: | (NSString *) | hành động | |
| nhãn: | (NSString *) | nhãn | |
| value: | (NSNumber *) | giá_trị | |
Trả về đối tượng GAIDictionaryBuilder có các thông số dành riêng cho một lượt truy cập sự kiện.
| + (GAIDictionaryBuilder *) createExceptionWithDescription: | (NSString *) | description [mô_tả] | |
| withFatal: | (NSNumber *) | Nghiêm trọng | |
Trả về một đối tượng GAIDictionaryBuilder có các tham số dành riêng cho một lượt truy cập ngoại lệ.
| + (GAIDictionaryBuilder *) createItemWithTransactionId: | (NSString *) | transactionId | |
| tên: | (NSString *) | name | |
| SKU: | (NSString *) | sku | |
| danh mục: | (NSString *) | category | |
| giá: | (NSNumber *) | price | |
| số lượng: | (NSNumber *) | quantity | |
| currencyCode: | (NSString *) | currencyCode | |
Trả về một đối tượng GAIDictionaryBuilder có các thông số dành riêng cho một lượt truy cập mục.
| + (GAIDictionaryBuilder *) createSocialWithNetwork: | (NSString *) | mạng | |
| hành động: | (NSString *) | hành động | |
| mục tiêu: | (NSString *) | mục tiêu | |
Trả về đối tượng GAIDictionaryBuilder có các thông số cụ thể cho một lượt truy cập trên mạng xã hội.
| + (GAIDictionaryBuilder *) createTimingWithCategory: | (NSString *) | category | |
| khoảng thời gian: | (NSNumber *) | intervalMillis | |
| tên: | (NSString *) | name | |
| nhãn: | (NSString *) | label | |
Trả về một đối tượng GAIDictionaryBuilder có các tham số dành riêng cho một lượt truy cập thời gian.
| + (GAIDictionaryBuilder *) createTransactionWithId: | (NSString *) | transactionId | |
| affiliation: | (NSString *) | affiliation | |
| doanh thu: | (NSNumber *) | revenue | |
| thuế: | (NSNumber *) | tax | |
| giao hàng: | (NSNumber *) | shipping | |
| currencyCode: | (NSString *) | currencyCode | |
Trả về đối tượng GAIDictionaryBuilder có các thông số dành riêng cho một lượt truy cập giao dịch.
| – (GAIDictionaryBuilder *) setProductAction: | (GAIEcommerceProductAction *) | productAction |
Đặt trường hành động cho sản phẩm cho lượt truy cập này.
| – (GAIDictionaryBuilder *) addProduct: | (GAIEcommerceProduct *) | product |
Thêm một sản phẩm vào lượt truy cập này.
| – (GAIDictionaryBuilder *) addProductImpression: | (GAIEcommerceProduct *) | product | |
| danh sách hiển thị: | (NSString *) | name | |
| nguồn hiển thị: | (NSString *) | nguồn | |
Thêm lượt hiển thị sản phẩm vào lượt truy cập này.
| - (GAIDictionaryBuilder *) addKhuyến mãi: | (GAIEcommercePromotion *) | chương trình khuyến mãi |
Thêm chương trình khuyến mãi vào lượt truy cập này.