Riferimento alla classe GAIDictionaryBuilder

Panoramica

Classe di supporto per creare un dizionario di parametri e valori degli hit.


Esempi:

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

Verrà inviato un tipo di hit da evento con i parametri specificati e un parametro di dimensione personalizzata.
Se vuoi inviare un parametro con tutti gli hit, impostalo direttamente su 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]];

Puoi ignorare un valore impostato sul tracker aggiungendolo al dizionario.

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

I valori impostati tramite il set [GAIDictionaryBuilder] o [GAIDictionaryBuilder setAll] sostituiranno qualsiasi valore esistente nell'oggetto GAIDictionaryBuilder (ovvero inizializzato da [GAIDictionaryBuilder createXYZ]). ad es.

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

Eredita NSObject.

Metodi di istanza

(GAIDictionaryBuilder *)- setAll:
 Copia tutte le coppie nome-valore dai parametri in questo oggetto, ignorando le chiavi diverse da NSString e i valori che non sono né NSString o NSNull. Altro...
 
(NSString *)- get:
 Restituisce il valore del parametro di input paramName o nil se paramName non è presente. Altro...
 
(NSMutableDictionary *)- creazione
 Restituisci un oggetto NSMutableDictionary con tutti i parametri impostati al suo interno. Altro...
 
(GAIDictionaryBuilder *)- setCampaignParametersFromUrl:
 Analizza e converte i parametri utm della campagna nel parametro della campagna di Analytics e li restituisce come mappa. Altro...
 
(GAIDictionaryBuilder *)- setProductAction:
 Imposta il campo dell'azione del prodotto per questo hit. Altro...
 
(GAIDictionaryBuilder *)- addProduct:
 Aggiunge un prodotto a questo hit. Altro...
 
(GAIDictionaryBuilder *)- addProductImpression:impressionList:impressionSource:
 Aggiungi un'impressione del prodotto a questo hit. Altro...
 
(GAIDictionaryBuilder *)- addpromotion:
 Aggiungi una promozione a questo hit. Altro...
 

Metodi della classe

("Usa invece createScreenView").+ createAppView
 Restituisce un oggetto GAIDictionaryBuilder con parametri specifici di un hit appview. Altro...
 
(GAIDictionaryBuilder *)+ createScreenView
 Restituisce un oggetto GAIDictionaryBuilder con parametri specifici di un hit di visualizzazione di schermata. Altro...
 
(GAIDictionaryBuilder *)+ createEventWithCategory:action:label:value:
 Restituisce un oggetto GAIDictionaryBuilder con parametri specifici di un hit da evento. Altro...
 
(GAIDictionaryBuilder *)+ createExceptionWithDescription:withFatal:
 Restituisce un oggetto GAIDictionaryBuilder con parametri specifici per un hit da eccezione. Altro...
 
(GAIDictionaryBuilder *)+ createItemWithTransactionId:name:sku:category:price:quantity:currencyCode:
 Restituisce un oggetto GAIDictionaryBuilder con parametri specifici per un hit da elemento. Altro...
 
(GAIDictionaryBuilder *)+ createSocialWithNetwork:action:target:
 Restituisce un oggetto GAIDictionaryBuilder con parametri specifici di un hit social. Altro...
 
(GAIDictionaryBuilder *)+ createTimingWithCategory:interval:name:label:
 Restituisce un oggetto GAIDictionaryBuilder con parametri specifici di un hit di tempo. Altro...
 
(GAIDictionaryBuilder *)+ createTransactionWithId:affiliation:revenue:tax:shipping:currencyCode:
 Restituisce un oggetto GAIDictionaryBuilder con parametri specifici di un hit da transazione. Altro...
 

Documentazione del metodo

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

Copia tutte le coppie nome-valore dai parametri in questo oggetto, ignorando le chiavi diverse da NSString e i valori che non sono né NSString o NSNull.

- (NSString *) ottiene: (NSString *) paramName

Restituisce il valore del parametro di input paramName o nil se paramName non è presente.

- Build (NSMutableDictionary *)

Restituisci un oggetto NSMutableDictionary con tutti i parametri impostati al suo interno.

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

Analizza e converte i parametri utm della campagna nel parametro della campagna di Analytics e li restituisce come mappa.

Parametri
paramsURL contenente i parametri della campagna utm.

I parametri della campagna validi sono:

  • utm_id
  • utm_campaign
  • utm_content
  • utm_medium
  • utm_source
  • utm_term
  • dclid
  • gclid
  • gmob_t
  • aclid
  • anid

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

Per saperne di più sul tagging automatico e manuale, consulta l'articolo Vantaggi del tagging automatico.

+ (GAIDictionaryBuilder *) createAppView

Restituisce un oggetto GAIDictionaryBuilder con parametri specifici di un hit appview.

Tieni presente che questo metodo non imposterà il nome schermata per gli hit successivi. A tale scopo, devi chiamare set:kGAIDescription value:<screenName> sull'istanza GAITracker.

Questo metodo è deprecato. Usa invece createScreenView.

+ (GAIDictionaryBuilder *) createScreenView

Restituisce un oggetto GAIDictionaryBuilder con parametri specifici di un hit di visualizzazione di schermata.

Tieni presente che questo metodo non imposterà il nome schermata per gli hit successivi. A tale scopo, devi chiamare set:kGAIDescription value:<screenName> sull'istanza GAITracker.

+ (GAIDictionaryBuilder *) createEventWithCategory: (NSString *) category
azione: (NSString *) azione
casa discografica: (NSString *) etichetta
value: (NSNumber *) valore

Restituisce un oggetto GAIDictionaryBuilder con parametri specifici di un hit da evento.

+ (GAIDictionaryBuilder *) createExceptionWithDescription: (NSString *) description
withFatal: (NSNumber *) non irreversibile

Restituisce un oggetto GAIDictionaryBuilder con parametri specifici per un hit da eccezione.

+ (GAIDictionaryBuilder *) createItemWithTransactionId: (NSString *) transactionId
name: (NSString *) name
SKU: (NSString *) sku
categoria: (NSString *) category
prezzo: (NSNumber *) price
quantità: (NSNumber *) quantity
currencyCode: (NSString *) currencyCode

Restituisce un oggetto GAIDictionaryBuilder con parametri specifici per un hit da elemento.

+ (GAIDictionaryBuilder *) createSocialWithNetwork: (NSString *) network
azione: (NSString *) azione
target: (NSString *) target

Restituisce un oggetto GAIDictionaryBuilder con parametri specifici di un hit social.

+ (GAIDictionaryBuilder *) createTimingWithCategory: (NSString *) category
: (NSNumber *) intervalMillis
name: (NSString *) name
casa discografica: (NSString *) label

Restituisce un oggetto GAIDictionaryBuilder con parametri specifici di un hit di tempo.

+ (GAIDictionaryBuilder *) createTransactionWithId: (NSString *) transactionId
affiliation: (NSString *) affiliation
entrate: (NSNumber *) revenue
tasse: (NSNumber *) tax
spedizione: (NSNumber *) shipping
currencyCode: (NSString *) currencyCode

Restituisce un oggetto GAIDictionaryBuilder con parametri specifici di un hit da transazione.

- (GAIDictionaryBuilder *) setProductAction: (GAIEcommerceProductAction *) productAction

Imposta il campo dell'azione del prodotto per questo hit.

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

Aggiunge un prodotto a questo hit.

- (GAIDictionaryBuilder *) addProductImpression: (GAIEcommerceProduct *) product
elenco impressioni: (NSString *) name
Sorgente impressione: (NSString *) fonte

Aggiungi un'impressione del prodotto a questo hit.

- (GAIDictionaryBuilder *) addPromotion: (GAIEcommercePromotion *) promozione

Aggiungi una promozione a questo hit.