總覽

輔助類別，建立命中參數和值的字典。

範例：

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 集] 或 [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 的值；如果沒有 paramName，則傳回 nil。更多...

(NSMutableDictionary *)	- 建構
	傳回 NSMutableDictionary 物件，並將此屬性設定的所有參數。更多...

(GAIDictionaryBuilder *)。	- setCampaignParametersFromUrl：
	剖析並轉譯 utm 廣告活動參數至 Analytics (分析) 廣告活動參數，並將這些參數以地圖形式傳回。更多...

(GAIDictionaryBuilder *)。	- setProductAction:
	設定這筆命中的產品動作欄位。更多...

(GAIDictionaryBuilder *)。	- addProduct:
	將產品加入這筆命中。更多...

(GAIDictionaryBuilder *)。	- addProductImpression:impressionList:impressionSource:
	為這筆命中新增產品曝光。更多...

(GAIDictionaryBuilder *)。	- add 宣傳：
	請為這筆命中新增宣傳素材資源。更多...

類別方法
(「請改用 createScreenView」)。	還有 createAppView
	傳回包含應用程式檢視命中專用參數的 GAIDictionaryBuilder 物件。更多...

(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 的值；如果沒有 paramName，則傳回 nil。

- (NSMutableDictionary *) 版本

傳回 NSMutableDictionary 物件，並將此屬性設定的所有參數。

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

剖析並轉譯 utm 廣告活動參數至 Analytics (分析) 廣告活動參數，並將這些參數以地圖形式傳回。

參數

params 網址包含 Urchin 流量監視器 (UTM) 廣告活動參數。

有效的廣告活動參數包括：

utm_id
utm_campaign
utm_content
utm_medium
utm_source
utm_term
DCLID
Google 點擊 ID
gmob_t
專家
援助

範例：http://my.site.com/index.html?utm_campaign=wow&utm_source=source utm_campaign=wow&utm_source=source。

如要進一步瞭解自動標記和手動標記，請參閱「自動標記的優點」一文。

+ (GAIDictionaryBuilder *) createAppView

傳回包含應用程式檢視命中專用參數的 GAIDictionaryBuilder 物件。

請注意，使用這個方法並不會設定後續命中的畫面名稱。為此，您需要在 GAITracker 執行個體上呼叫 set:kGAIDescription value:<screenName>。

這個方法已淘汰。請改用 createScreenView。

+ (GAIDictionaryBuilder *) createScreenView

傳回包含畫面瀏覽命中專用參數的 GAIDictionaryBuilder 物件。

請注意，使用這個方法並不會設定後續命中的畫面名稱。為此，您需要在 GAITracker 執行個體上呼叫 set:kGAIDescription value:<screenName>。

+ (GAIDictionaryBuilder *) createEventWithCategory：	(NSString *)	category
動作：	(NSString *)	動作
唱片公司：	(NSString *)	標籤
值：	(NSNumber *)	value

傳回包含事件命中專用參數的 GAIDictionaryBuilder 物件。

+ (GAIDictionaryBuilder *) createExceptionWithDescription:	(NSString *)	說明
withFatal：	(NSNumber *)	fatal

傳回包含例外狀況命中專用參數的 GAIDictionaryBuilder 物件。

+ (GAIDictionaryBuilder *) createItemWithTransactionId：	(NSString *)	transactionId
name:	(NSString *)	name
SKU：	(NSString *)	SKU
類別：	(NSString *)	category
價格：	(NSNumber *)	price
數量：	(NSNumber *)	quantity
currencyCode:	(NSString *)	currencyCode

傳回包含項目命中特定參數的 GAIDictionaryBuilder 物件。

+ (GAIDictionaryBuilder *) createSocialWithNetwork：	(NSString *)	網路
動作：	(NSString *)	動作
target:	(NSString *)	target

傳回包含社交命中專用參數的 GAIDictionaryBuilder 物件。

+ (GAIDictionaryBuilder *) createTimingWithCategory：	(NSString *)	category
間隔：	(NSNumber *)	intervalMillis
name:	(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 *) product

將產品加入這筆命中。

- (GAIDictionaryBuilder *) addProductImpression：	(GAIEcommerceProduct *)	product
次曝光：	(NSString *)	name
次曝光：	(NSString *)	資料來源

為這筆命中新增產品曝光。

- (GAIDictionaryBuilder *) add 宣傳： (GAIEcommercePromotion *) 促銷活動

請為這筆命中新增宣傳素材資源。

GAIDictionaryBuilder 類別參考資料

總覽

執行個體方法

類別方法

方法說明文件