概要
ヒットのパラメータと値のマップを構築するヘルパークラス。
例:
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: |
params に含まれるすべての名前と値のペアをこのオブジェクトにコピーします。その際、NSString でないすべてのキーと、NSString と NSNull のいずれでもないすべての値は無視されます。その他... | |
(NSString *) | - get: |
入力された paramName パラメータの値を返します。paramName が存在しない場合は、nil を返します。その他... | |
(NSMutableDictionary *) | - build |
このメソッドに設定されたすべてのパラメータで NSMutableDictionary オブジェクトを返します。その他... | |
(GAIDictionaryBuilder *) | - setCampaignParametersFromUrl: |
UTM キャンペーン パラメータを解析して、アナリティクス キャンペーン パラメータに変換し、マップとして返します。その他... | |
(GAIDictionaryBuilder *) | - setProductAction: |
このヒットの商品アクション フィールドを設定します。その他... | |
(GAIDictionaryBuilder *) | - addProduct: |
このヒットに商品を追加します。その他... | |
(GAIDictionaryBuilder *) | - addProductImpression:impressionList:impressionSource: |
このヒットに商品インプレッションを追加します。その他... | |
(GAIDictionaryBuilder *) | - addPromotion: |
このヒットにプロモーションを追加します。その他... | |
メソッドのドキュメント
- (GAIDictionaryBuilder *) setAll: | (NSDictionary *) | params |
params に含まれるすべての名前と値のペアをこのオブジェクトにコピーします。その際、NSString でないすべてのキーと、NSString と NSNull のいずれでもないすべての値は無視されます。
- (NSString *) get: | (NSString *) | paramName |
入力された paramName パラメータの値を返します。paramName が存在しない場合は、nil を返します。
- (NSMutableDictionary *) build |
このメソッドに設定されたすべてのパラメータで NSMutableDictionary オブジェクトを返します。
- (GAIDictionaryBuilder *) setCampaignParametersFromUrl: | (NSString *) | urlString |
UTM キャンペーン パラメータを解析して、アナリティクス キャンペーン パラメータに変換し、マップとして返します。
- パラメータ
-
params UTM キャンペーン パラメータを含む URL
有効なキャンペーン パラメータは次のとおりです。
- utm_id
- utm_campaign
- utm_content
- utm_medium
- utm_source
- utm_term
- DCLID
- GCLID
- gmob_t
- 北アフリカ
- AIID
例: http://my.site.com/index.html?utm_campaign=wow&utm_source=source utm_campaign=wow&utm_source=source
自動タグ設定と手動タグ設定の詳細については、自動タグ設定のメリットをご覧ください。
+ (GAIDictionaryBuilder *) createAppView |
appview ヒット固有のパラメータで GAIDictionaryBuilder オブジェクトを返します。
このメソッドを使用しても、後続のヒットにスクリーン名は設定されません。後続のヒットにスクリーン名を設定するには、GAITracker インスタンスで set:kGAIDescription value:<screenName> を呼び出してください。
このメソッドのサポートは終了しているため、代わりに createScreenView を使用してください。
+ (GAIDictionaryBuilder *) createScreenView |
screenview ヒット固有のパラメータで GAIDictionaryBuilder オブジェクトを返します。
このメソッドを使用しても、後続のヒットにスクリーン名は設定されません。後続のヒットにスクリーン名を設定するには、GAITracker インスタンスで set:kGAIDescription value:<screenName> を呼び出してください。
+ (GAIDictionaryBuilder *) createEventWithCategory: | (NSString *) | category | |
action: | (NSString *) | 操作 | |
label: | (NSString *) | label | |
value: | (NSNumber *) | value | |
event ヒット固有のパラメータで GAIDictionaryBuilder オブジェクトを返します。
+ (GAIDictionaryBuilder *) createExceptionWithDescription: | (NSString *) | 説明文 | |
withFatal: | (NSNumber *) | 致命的 | |
exception ヒット固有のパラメータで GAIDictionaryBuilder オブジェクトを返します。
+ (GAIDictionaryBuilder *) createItemWithTransactionId: | (NSString *) | transactionId | |
name: | (NSString *) | name | |
sku: | (NSString *) | SKU | |
category: | (NSString *) | category | |
price: | (NSNumber *) | price | |
quantity: | (NSNumber *) | quantity | |
currencyCode: | (NSString *) | currencyCode | |
item ヒット固有のパラメータで GAIDictionaryBuilder オブジェクトを返します。
+ (GAIDictionaryBuilder *) createSocialWithNetwork: | (NSString *) | network | |
action: | (NSString *) | 操作 | |
target: | (NSString *) | target | |
social ヒット固有のパラメータで GAIDictionaryBuilder オブジェクトを返します。
+ (GAIDictionaryBuilder *) createTimingWithCategory: | (NSString *) | category | |
interval: | (NSNumber *) | intervalMillis | |
name: | (NSString *) | name | |
label: | (NSString *) | label | |
timing ヒット固有のパラメータで GAIDictionaryBuilder オブジェクトを返します。
+ (GAIDictionaryBuilder *) createTransactionWithId: | (NSString *) | transactionId | |
affiliation: | (NSString *) | affiliation | |
revenue: | (NSNumber *) | revenue | |
tax: | (NSNumber *) | tax | |
shipping: | (NSNumber *) | shipping | |
currencyCode: | (NSString *) | currencyCode | |
transaction ヒット固有のパラメータで GAIDictionaryBuilder オブジェクトを返します。
- (GAIDictionaryBuilder *) setProductAction: | (GAIEcommerceProductAction *) | productAction |
このヒットの商品アクション フィールドを設定します。
- (GAIDictionaryBuilder *) addProduct: | (GAIEcommerceProduct *) | product |
このヒットに商品を追加します。
- (GAIDictionaryBuilder *) addProductImpression: | (GAIEcommerceProduct *) | product | |
impressionList: | (NSString *) | name | |
impressionSource: | (NSString *) | 出典 | |
このヒットに商品インプレッションを追加します。
- (GAIDictionaryBuilder *) addPromotion: | (GAIEcommercePromotion *) | プロモーション |
このヒットにプロモーションを追加します。