GAIDictionaryBuilder 클래스 참조

개요

조회 매개변수 및 값의 사전을 빌드하는 도우미 클래스입니다.


예:

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 *)- 빌드
 여기에 설정된 모든 매개변수가 포함된 NSMutableDictionary 객체를 반환합니다. 더보기...
 
(GAIDictionaryBuilder *)- setCampaignParametersFromUrl:
 utm 캠페인 매개변수를 파싱하여 애널리틱스 캠페인 매개변수로 변환하여 지도로 반환합니다. 더보기...
 
(GAIDictionaryBuilder *)- setProductAction:
 이 조회에 대한 제품 액션 필드를 설정합니다. 더보기...
 
(GAIDictionaryBuilder *)- addProduct:
 이 조회에 제품을 추가합니다. 더보기...
 
(GAIDictionaryBuilder *)- addProductImpression:impressionList:impressionSource:
 이 조회에 제품 노출을 추가합니다. 더보기...
 
(GAIDictionaryBuilder *)- add프로모션:
 이 조회에 프로모션을 추가합니다. 더보기...
 

클래스 메서드

('대신 createScreenView를 사용하세요.')+ createAppView
 appview 조회와 관련된 매개변수가 있는 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

params의 모든 이름-값 쌍을 이 객체로 복사합니다. 이때 NSString이 아닌 키와 NSString 또는 NSNull이 아닌 값은 무시합니다.

- (NSString *) get: (NSString *) paramName

입력 매개변수 paramName의 값을 반환하거나 paramName이 없으면 nil을 반환합니다.

- (NSMutableDictionary *) 빌드

여기에 설정된 모든 매개변수가 포함된 NSMutableDictionary 객체를 반환합니다.

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

utm 캠페인 매개변수를 파싱하여 애널리틱스 캠페인 매개변수로 변환하여 지도로 반환합니다.

매개변수
paramsutm 캠페인 매개변수가 포함된 URL입니다.

유효한 캠페인 매개변수는 다음과 같습니다.

  • 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

appview 조회와 관련된 매개변수가 있는 GAIDictionaryBuilder 객체를 반환합니다.

이 메서드를 사용해도 후속 조회의 화면 이름이 설정되지는 않습니다. 이렇게 하려면 GAITracker 인스턴스에서 set:kGAIDescription value:<screenName>을 호출해야 합니다.

이 메서드는 지원 중단되었습니다. 대신 createScreenView를 사용하세요.

+ (GAIDictionaryBuilder *) createScreenView

화면 조회수와 관련된 매개변수가 있는 GAIDictionaryBuilder 객체를 반환합니다.

이 메서드를 사용해도 후속 조회의 화면 이름이 설정되지는 않습니다. 이렇게 하려면 GAITracker 인스턴스에서 set:kGAIDescription value:<screenName>을 호출해야 합니다.

+ (GAIDictionaryBuilder *) createEventWithCategory: (NSString *) category
조치: (NSString *) 작업
라벨: (NSString *) label
value: (NSNumber *) value

이벤트 조회와 관련된 매개변수가 있는 GAIDictionaryBuilder 객체를 반환합니다.

+ (GAIDictionaryBuilder *) createExceptionWithDescription: (NSString *) description
withFatal: (NSNumber *) 심각한

예외 조회와 관련된 매개변수가 있는 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 *) 대상

소셜 조회와 관련된 매개변수가 있는 GAIDictionaryBuilder 객체를 반환합니다.

+ (GAIDictionaryBuilder *) createTimingWithCategory: (NSString *) category
간격: (NSNumber *) intervalMillis
name: (NSString *) name
라벨: (NSString *) 라벨

타이밍 조회와 관련된 매개변수가 있는 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 *) 제품

이 조회에 제품을 추가합니다.

- (GAIDictionaryBuilder *) addProductImpression: (GAIEcommerceProduct *) 제품
노출 목록: (NSString *) name
노출 소스: (NSString *) 출처

이 조회에 제품 노출을 추가합니다.

- (GAIDictionaryBuilder *) addPromo: (GAIEcommercePromotion *) 프로모션

이 조회에 프로모션을 추가합니다.