Referencia de la clase GAIDictionaryBuilder

Descripción general

Clase auxiliar para crear un diccionario de parámetros y valores de hits.


Ejemplos:

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

Esta acción enviará un tipo de hit de evento con los parámetros especificados y un parámetro de dimensión personalizada.
Si deseas enviar un parámetro con todos los hits, configúralo directamente en 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]];

Puedes anular un valor establecido en el dispositivo de seguimiento agregándolo al diccionario.

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

Los valores establecidos con [GAIDictionaryBuilder set] o [GAIDictionaryBuilder setAll] anularán cualquier valor existente en el objeto GAIDictionaryBuilder (es decir, inicializado por [GAIDictionaryBuilder createXYZ]). Por ejemplo,

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

Hereda NSObject.

Métodos de instancias

(GAIDictionaryBuilder *).- setAll:
 Copia todos los pares nombre-valor de los parámetros en este objeto e ignora las claves que no son NSString ni los valores que no son NSString ni NSNull. Más...
 
(NSString *)- get:
 Muestra el valor del parámetro de entrada paramName, o nil si paramName no está presente. Más...
 
(NSMutableDictionary *)- compilación
 Muestra un objeto NSMutableDictionary con todos los parámetros configurados aquí. Más...
 
(GAIDictionaryBuilder *).- setCampaignParametersFromUrl:
 Analiza y traduce los parámetros de la campaña del UTM al parámetro de la campaña de Analytics y los muestra como un mapa. Más...
 
(GAIDictionaryBuilder *).- setProductAction:
 Establece el campo de acción del producto para este hit. Más...
 
(GAIDictionaryBuilder *).- addProduct:
 Agrega un producto a este hit. Más...
 
(GAIDictionaryBuilder *).- addProductImpression:impressionList:impressionSource:
 Agrega una impresión del producto a este hit. Más...
 
(GAIDictionaryBuilder *).- addPromoción:
 Agrega una promoción a este hit. Más...
 

Métodos de clase

("En su lugar, usa createScreenView").+ createAppView
 Muestra un objeto GAIDictionaryBuilder con parámetros específicos de un hit de vista de aplicación. Más...
 
(GAIDictionaryBuilder *).+ createScreenView
 Muestra un objeto GAIDictionaryBuilder con parámetros específicos de un hit de vista de pantalla. Más...
 
(GAIDictionaryBuilder *).+ createEventWithCategory:action:label:value:
 Muestra un objeto GAIDictionaryBuilder con parámetros específicos de una visita al evento. Más...
 
(GAIDictionaryBuilder *).+ createExceptionWithDescription:withFatal:
 Muestra un objeto GAIDictionaryBuilder con parámetros específicos de una coincidencia de excepción. Más...
 
(GAIDictionaryBuilder *).+ createItemWithTransactionId:name:sku:category:price:quantity:currencyCode:
 Muestra un objeto GAIDictionaryBuilder con parámetros específicos de una visita a un elemento. Más...
 
(GAIDictionaryBuilder *).+ createSocialWithNetwork:action:target:
 Muestra un objeto GAIDictionaryBuilder con parámetros específicos de un hit de red social. Más...
 
(GAIDictionaryBuilder *).+ createTimingWithCategory:interval:name:label:
 Muestra un objeto GAIDictionaryBuilder con parámetros específicos de una coincidencia de sincronización. Más...
 
(GAIDictionaryBuilder *).+ createTransactionWithId:affiliation:revenue:tax:shipping:currencyCode:
 Muestra un objeto GAIDictionaryBuilder con parámetros específicos de un hit de transacción. Más...
 

Documentación de métodos

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

Copia todos los pares nombre-valor de los parámetros en este objeto e ignora las claves que no son NSString ni los valores que no son NSString ni NSNull.

- (NSString *) obtiene: (NSString *) paramName

Muestra el valor del parámetro de entrada paramName, o nil si paramName no está presente.

- (NSMutableDictionary *) compilación

Muestra un objeto NSMutableDictionary con todos los parámetros configurados aquí.

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

Analiza y traduce los parámetros de la campaña del UTM al parámetro de la campaña de Analytics y los muestra como un mapa.

Parámetros
paramsURL que contiene los parámetros de la campaña del UTM.

Los parámetros de campaña válidos son los siguientes:

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

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

Para obtener más información sobre el etiquetado automático y el etiquetado manual, consulta Beneficios del etiquetado automático.

+ (GAIDictionaryBuilder *) createAppView

Muestra un objeto GAIDictionaryBuilder con parámetros específicos de un hit de vista de aplicación.

Ten en cuenta que, si usas este método, no se establecerá el nombre de pantalla de los hits de seguimiento. Para hacerlo, debes llamar a set:kGAIDescription value:<screenName> en la instancia GAITracker.

Este método está obsoleto. En su lugar, usa createScreenView.

+ (GAIDictionaryBuilder *) createScreenView

Muestra un objeto GAIDictionaryBuilder con parámetros específicos de un hit de vista de pantalla.

Ten en cuenta que, si usas este método, no se establecerá el nombre de pantalla de los hits de seguimiento. Para hacerlo, debes llamar a set:kGAIDescription value:<screenName> en la instancia GAITracker.

+ (GAIDictionaryBuilder *) createEventWithCategory: (NSString *) category
acción: (NSString *) acción
label: (NSString *) label
value: (NSNumber *) value

Muestra un objeto GAIDictionaryBuilder con parámetros específicos de una visita al evento.

+ (GAIDictionaryBuilder *) createExceptionWithDescription: (NSString *) de H1
withFatal: (NSNumber *) fatal

Muestra un objeto GAIDictionaryBuilder con parámetros específicos de una coincidencia de excepción.

+ (GAIDictionaryBuilder *) createItemWithTransactionId: (NSString *) transactionId
name: (NSString *) name
SKU: (NSString *) sku
categoría: (NSString *) category
Precio: (NSNumber *) price
cantidad: (NSNumber *) quantity
currencyCode: (NSString *) currencyCode

Muestra un objeto GAIDictionaryBuilder con parámetros específicos de una visita a un elemento.

+ (GAIDictionaryBuilder *) createSocialWithNetwork: (NSString *) network
acción: (NSString *) acción
objetivo: (NSString *) objetivo

Muestra un objeto GAIDictionaryBuilder con parámetros específicos de un hit de red social.

+ (GAIDictionaryBuilder *) createTimingWithCategory: (NSString *) category
interval: (NSNumber *) intervalMillis
name: (NSString *) name
label: (NSString *) etiqueta

Muestra un objeto GAIDictionaryBuilder con parámetros específicos de una coincidencia de sincronización.

+ (GAIDictionaryBuilder *) createTransactionWithId: (NSString *) transactionId
affiliation: (NSString *) affiliation
de ingresos: (NSNumber *) revenue
impuestos: (NSNumber *) tax
envío: (NSNumber *) shipping
currencyCode: (NSString *) currencyCode

Muestra un objeto GAIDictionaryBuilder con parámetros específicos de un hit de transacción.

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

Establece el campo de acción del producto para este hit.

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

Agrega un producto a este hit.

- (GAIDictionaryBuilder *) addProductImpression: (GAIEcommerceProduct *) product
printList: (NSString *) name
printSource: (NSString *) fuente

Agrega una impresión del producto a este hit.

- (GAIDictionaryBuilder *) addPromotion: (GAIEcommercePromotion *) promoción

Agrega una promoción a este hit.