概要
ヒットのパラメータと値のマップを構築するヘルパークラス。
例:
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 *) | プロモーション |
このヒットにプロモーションを追加します。