Przegląd
Klasa pomocnicza do tworzenia słownika parametrów działania 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 zdarzenia z określonymi parametrami i parametrem niestandardowego wymiaru.
Jeśli chcesz wysył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]];
Wartość ustawioną w trackerze można zastąpić, 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 za pomocą funkcji [GAIDictionaryBuilder] lub [GAIDictionaryBuilder setAll] zastąpią wszelkie istniejące wartości w obiekcie GAIDictionaryBuilder (czyli 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 NSObject.
Metody instancji | |
| (GAIDictionaryBuilder *) | – setAll: |
| Kopiuje wszystkie pary nazwa-wartość z parametrów do tego obiektu, ignorując klucze, które nie są NSString, oraz wartości, które nie są NSString ani NSNull. Więcej... | |
| (NSString *) | – pobierz: |
| Zwraca wartość parametru wejściowego paramName lub nil, jeśli nie ma parametru paramName. Więcej... | |
| (NSMutableDictionary *) | - kompilacja |
| Zwraca obiekt NSMutableDictionary ze wszystkimi ustawionymi w tym parametrami parametrami. Więcej... | |
| (GAIDictionaryBuilder *) | – setCampaignParametersFromUrl: |
| Analizuje i przekształca parametry kampanii UTM na parametry kampanii analitycznej i zwraca je w postaci mapy. 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 *) | – addPromotion |
| Dodaj promocję do tego działania. Więcej... | |
Dokumentacja metod
| – (GAIDictionaryBuilder *) setAll: | (NSDictionary *) | params |
Kopiuje wszystkie pary nazwa-wartość z parametrów do tego obiektu, ignorując klucze, które nie są NSString, oraz wartości, które nie są NSString ani NSNull.
| - (NSString *) pobierz: | (NSString *) | paramName |
Zwraca wartość parametru wejściowego paramName lub nil, jeśli nie ma parametru paramName.
| – kompilacja (NSMutableDictionary *) |
Zwraca obiekt NSMutableDictionary ze wszystkimi ustawionymi w tym parametrami parametrami.
| – (GAIDictionaryBuilder *) setCampaignParametersFromUrl: | (NSString *) | urlString |
Analizuje i przekształca parametry kampanii UTM na parametry kampanii analitycznej i zwraca je w postaci mapy.
- Parametry
-
params url 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 specyficznymi dla działania appview.
Pamiętaj, że ta metoda nie spowoduje ustawienia nazwy ekranu dla działań następujących po kliknięciu. Aby to zrobić, musisz wywołać set:kGAIDescription value:<screenName> w instancji GAITracker.
Ta metoda została wycofana. Użyj interfejsu createScreenView.
| + (GAIDictionaryBuilder *) createScreenView |
Zwraca obiekt GAIDictionaryBuilder z parametrami specyficznymi dla działania polegającego na wyświetleniu ekranu.
Pamiętaj, że ta metoda nie spowoduje ustawienia nazwy ekranu dla działań następujących po kliknięciu. Aby to zrobić, musisz wywołać set:kGAIDescription value:<screenName> w instancji GAITracker.
| + (GAIDictionaryBuilder *) createEventWithCategory: | (NSString *) | category | |
| działanie: | (NSString *) | działanie | |
| etykieta: | (NSString *) | etykieta | |
| value: | (NSNumber *) | value (wartość) | |
Zwraca obiekt GAIDictionaryBuilder z parametrami specyficznymi dla działania związanego ze zdarzeniem.
| + (GAIDictionaryBuilder *) createExceptionWithDescription: | (NSString *) | description | |
| withFatal: | (NSNumber *) | krytyczny | |
Zwraca obiekt GAIDictionaryBuilder z parametrami specyficznymi dla działania związanego z wyjątkiem.
| + (GAIDictionaryBuilder *) createItemWithTransactionId: | (NSString *) | transactionId | |
| imię i nazwisko: | (NSString *) | name | |
| sku: | (NSString *) | sku | |
| kategoria: | (NSString *) | category | |
| cena: | (NSNumber *) | price | |
| quantity: | (NSNumber *) | quantity | |
| currencyCode: | (NSString *) | currencyCode | |
Zwraca obiekt GAIDictionaryBuilder z parametrami specyficznymi dla działania związanego z produktem.
| + (GAIDictionaryBuilder *) createSocialWithNetwork: | (NSString *) | sieć, | |
| działanie: | (NSString *) | działanie | |
| cel: | (NSString *) | target, | |
Zwraca obiekt GAIDictionaryBuilder z parametrami specyficznymi dla działania społecznościowego.
| + (GAIDictionaryBuilder *) createTimingWithCategory: | (NSString *) | category | |
| interwał: | (NSNumber *) | intervalMillis | |
| imię i nazwisko: | (NSString *) | name | |
| etykieta: | (NSString *) | label (etykieta) | |
Zwraca obiekt GAIDictionaryBuilder z parametrami specyficznymi dla działania w czasie.
| + (GAIDictionaryBuilder *) createTransactionWithId: | (NSString *) | transactionId | |
| affiliation: | (NSString *) | affiliation | |
| przychody: | (NSNumber *) | revenue | |
| podatek: | (NSNumber *) | tax | |
| dostawa: | (NSNumber *) | shipping | |
| currencyCode: | (NSString *) | currencyCode | |
Zwraca obiekt GAIDictionaryBuilder z parametrami specyficznymi dla działania związanego z transakcją.
| – (GAIDictionaryBuilder *) setProductAction: | (GAIEcommerceProductAction *) | productAction |
Ustaw pole działania produktu dla tego działania.
| – (GAIDictionaryBuilder *) addProduct: | (GAIEcommerceProduct *) | product |
Dodaje produkt do tego działania.
| – (GAIDictionaryBuilder *) addProductimpression: | (GAIEcommerceProduct *) | product | |
| Lista wyświetleń: | (NSString *) | name | |
| wyświetlenieSource: | (NSString *) | source | |
Dodaj wyświetlenie produktu do tego działania.
| – (GAIDictionaryBuilder *) addPromotion: | (GAIEcommercePromotion *) | promocja |
Dodaj promocję do tego działania.