Dokumentacja klas GAIDictionaryBuilder

Przegląd

Klasa pomocnicza do tworzenia słownika parametrów parametrów i wartości.


Przykłady:

id<GAITracker> t = // get a tracker.
[t send:[[[GAIDictionaryBuilder createEventWithCategory:@"EventCategory"
                                                 action:@"EventAction"
                                                  label:nil
                                                  value:nil]
    set:"dimension1" forKey:[GAIFields customDimensionForIndex:1]] build]];

Spowoduje to wysłanie typu działania dotyczącego zdarzenia z określonymi parametrami i parametrem wymiaru niestandardowego.
Jeśli chcesz wysłać parametr ze wszystkimi działaniami, ustaw go bezpośrednio w 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]];

Możesz zastąpić wartość ustawioną w trackerze, dodając ją do słownika.

[t set:kGAIScreenName value:@"Home"];
[t send:...];
[t send[[[GAIDictionaryBuilder createEventWithCategory:@"click"
                                                action:@"popup"
                                                 label:nil
                                                 value:nil]
    set:@"popup title" forKey:kGAIScreenName] build]];

Wartości ustawione przez [GAIDictionaryBuilder set] lub [GAIDictionaryBuilder setAll] zastąpią wszystkie istniejące wartości w obiekcie GAIDictionaryBuilder create (np. zainicjowane przez [GAIDictionaryBuilder createXYZ]). np.

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];

Dziedziczy obiekt NSObject.

Metody instancji

(GAIDictionaryBuilder*)setAll:
 Kopiuje wszystkie pary nazw i wartości z parametrów do tego obiektu, ignorując wszystkie klucze niebędące NSString i wartości, które nie są NSString ani NSNull. Więcej...
 
(NSString *)- get:
 Zwraca wartość parametru wejściowego paramName lub „nil”, jeśli go nie ma. Więcej...
 
(NSMutableDictionary *)- utwórz
 Zwraca obiekt NSMutableDictionary ze wszystkimi parametrami ustawionymi w tej kolumnie. Więcej...
 
(GAIDictionaryBuilder*)setCampaignParametersFromUrl:
 Analizuje i tłumaczy parametry kampanii „utm” na parametry kampanii Analytics oraz zwraca je jako mapę. Więcej...
 
(GAIDictionaryBuilder*)setProductAction:
 Ustaw pole działania produktu dla tego działania. Więcej...
 
(GAIDictionaryBuilder*)addProduct:
 Dodaje produkt do tego działania. Więcej...
 
(GAIDictionaryBuilder*)addProductImpression:impressionList:impressionSource:
 Dodaj wyświetlenie produktu do tego działania. Więcej...
 
(GAIDictionaryBuilder *)addpromo:
 Dodaj promocję do tego działania. Więcej...
 

Metody klasy

("Użyj funkcji createScreenView).")+ createAppView
 Zwraca obiekt GAIDictionaryBuilder z parametrami charakterystycznymi dla działania Appview. Więcej...
 
(GAIDictionaryBuilder*)+ createScreenView
 Zwraca obiekt GAIDictionaryBuilder z parametrami charakterystycznymi dla wyświetlenia ekranu. Więcej...
 
(GAIDictionaryBuilder*)+ createEventWithCategory:action:label:wartość:
 Zwraca obiekt GAIDictionaryBuilder z parametrami specyficznymi dla zdarzenia. Więcej...
 
(GAIDictionaryBuilder *)+ createExceptionWithDescription:withFatal:
 Zwraca obiekt GAIDictionaryBuilder z parametrami charakterystycznymi dla działania wyjątku. Więcej...
 
(GAIDictionaryBuilder *)+ createItemWithTransactionId:name:sku:category:price:quantity:currencyCode:
 Zwraca obiekt GAIDictionaryBuilder z parametrami charakterystycznymi dla działania elementu. Więcej...
 
(GAIDictionaryBuilder*)+ create SocialWithNetwork:action:target:
 Zwraca obiekt GAIDictionaryBuilder z parametrami charakterystycznymi dla działania społecznościowego. Więcej...
 
(GAIDictionaryBuilder *)+ createTimingWithCategory:interval:nazwa:etykieta:
 Zwraca obiekt GAIDictionaryBuilder z parametrami specyficznymi dla działania związanego z czasem. Więcej...
 
(GAIDictionaryBuilder*)+ createTransactionWithId:affiliation:revenue:tax:shipping:currencyCode:
 Zwraca obiekt GAIDictionaryBuilder z parametrami charakterystycznymi dla działania transakcji. Więcej...
 

Przydatna dokumentacja

- (GAIDictionaryBuilder *) setAll: (NSDictionary *) parametry

Kopiuje wszystkie pary nazw i wartości z parametrów do tego obiektu, ignorując wszystkie klucze niebędące NSString i wartości, które nie są NSString ani NSNull.

- (NSString *) uzyska: (NSString *) nazwa parametru

Zwraca wartość parametru wejściowego paramName lub „nil”, jeśli go nie ma.

- (NSMutableDictionary *)

Zwraca obiekt NSMutableDictionary ze wszystkimi parametrami ustawionymi w tej kolumnie.

- (GAIDictionaryBuilder *) setCampaignParametersFromUrl: (NSString *) Adres URL

Analizuje i tłumaczy parametry kampanii „utm” na parametry kampanii Analytics oraz zwraca je jako mapę.

Parametry
parametryURL zawierający parametry kampanii utm.

Prawidłowe parametry kampanii to:

  • utm_id
  • utm_campaign
  • utm_content
  • utm_medium
  • utm_source
  • utm_term
  • DCLID
  • gclid
  • Gmob_t
  • aclid
  • anid

Przykład: http://my.site.com/index.html?utm_campaign=wow&utm_source=source utm_campaign=wow&utm_source=source.

Więcej informacji o automatycznym i ręcznym tagowaniu znajdziesz w artykule Zalety automatycznego tagowania.

+ (GAIDictionaryBuilder*) createAppView

Zwraca obiekt GAIDictionaryBuilder z parametrami charakterystycznymi dla działania Appview.

Pamiętaj, że ta metoda nie ustawia nazwy ekranu dla działań po wyświetleniu. Aby to zrobić, musisz wywołać funkcję set:kGAIDescription value:<screenName> w instancji GAITracker.

Ta metoda została wycofana. Zamiast tego użyj createScreenView.

+ (GAIDictionaryBuilder*) createScreenView

Zwraca obiekt GAIDictionaryBuilder z parametrami charakterystycznymi dla wyświetlenia ekranu.

Pamiętaj, że ta metoda nie ustawia nazwy ekranu dla działań po wyświetleniu. Aby to zrobić, musisz wywołać funkcję set:kGAIDescription value:<screenName> w instancji GAITracker.

+ (GAIDictionaryBuilder *) createEventWithCategory: (NSString *) category
działanie: (NSString *) action
etykieta: (NSString *) label.
value: (NSNumber *) value

Zwraca obiekt GAIDictionaryBuilder z parametrami specyficznymi dla zdarzenia.

+ (GAIDictionaryBuilder *) createExceptionWithDescription: (NSString *) description
withFatal: (NSNumber *) fatal

Zwraca obiekt GAIDictionaryBuilder z parametrami charakterystycznymi dla działania wyjątku.

+ (GAIDictionaryBuilder*) createItemWithTransactionId: (NSString *) transactionId
imię i nazwisko: (NSString *) name
sku: (NSString *) sku
kategoria: (NSString *) category
cena: (NSNumber *) price
quantity: (NSNumber *) quantity
kodWaluta: (NSString *) currencyCode

Zwraca obiekt GAIDictionaryBuilder z parametrami charakterystycznymi dla działania elementu.

+ (GAIDictionaryBuilder*) createSocialWithNetwork: (NSString *) sieć
działanie: (NSString *) action
kieruj reklamy na: (NSString *) target

Zwraca obiekt GAIDictionaryBuilder z parametrami charakterystycznymi dla działania społecznościowego.

+ (GAIDictionaryBuilder *) createTimingWithCategory: (NSString *) category
interwał: (NSNumber *) IntervalMillis
imię i nazwisko: (NSString *) name
etykieta: (NSString *) label

Zwraca obiekt GAIDictionaryBuilder z parametrami specyficznymi dla działania związanego z czasem.

+ (GAIDictionaryBuilder *) createTransactionWithId: (NSString *) transactionId
przynależność: (NSString *) affiliation
przychody: (NSNumber *) revenue
podatek: (NSNumber *) tax
dostawa: (NSNumber *) shipping
kodWaluta: (NSString *) currencyCode

Zwraca obiekt GAIDictionaryBuilder z parametrami charakterystycznymi dla działania transakcji.

- (GAIDictionaryBuilder *) setProductAction: (GAIEcommerceProductAction *) productAction (działanie produktu)

Ustaw pole działania produktu dla tego działania.

- (GAIDictionaryBuilder *) addProduct: (GAIcommerceProduct *) product

Dodaje produkt do tego działania.

- (GAIDictionaryBuilder *) addProductImpression: (GAIcommerceProduct *) product
Listawyświetleń: (NSString *) name
Wyświetlenie źródła: (NSString *) source

Dodaj wyświetlenie produktu do tego działania.

- (GAIDictionaryBuilder *) addpromo: (GAIEcommercePromocje*) promocja

Dodaj promocję do tego działania.