Référence de la classe GAIDictionaryBuilder

Présentation

Classe d'assistance permettant de créer un dictionnaire de valeurs et de paramètres d'appel.


Exemples:

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

Un type d'appel avec événement sera alors envoyé avec les paramètres spécifiés et un paramètre de dimension personnalisée.
Si vous souhaitez envoyer un paramètre avec tous les appels, définissez-le directement sur 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]];

Vous pouvez remplacer une valeur définie sur l'outil de suivi en l'ajoutant au dictionnaire.

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

Les valeurs définies via [GAIDictionaryBuilder set] ou [GAIDictionaryBuilder setAll] remplacent les valeurs existantes dans l'objet GAIDictionaryBuilder (initialisé par [GAIDictionaryBuilder createXYZ], par exemple).

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

Hérite du NSObject.

Méthodes des instances

(GAIDictionaryBuilder *)- setAll:
 Copie toutes les paires nom/valeur des paramètres dans cet objet, en ignorant les clés qui ne sont pas des chaînes NSString et les valeurs qui ne sont ni NSString ni NSNull. Plus...
 
(NSString *)- get:
 Renvoie la valeur du paramètre d'entrée paramName ou nil si paramName n'est pas présent. Plus...
 
(NSMutableDictionary *)- créer
 Renvoie un objet NSMutableDictionary avec tous les paramètres définis. Plus...
 
(GAIDictionaryBuilder *)- setCampaignParametersFromUrl:
 Analyse et traduit les paramètres de campagne UTM en paramètres de campagne Analytics, puis les renvoie sous forme de carte. Plus...
 
(GAIDictionaryBuilder *)- setProductAction :
 Définissez le champ d'action du produit pour cet appel. Plus...
 
(GAIDictionaryBuilder *)- addProduct: :
 Ajoute un produit à cet appel. Plus...
 
(GAIDictionaryBuilder *)- addProductImpression:impressionList:impressionSource:
 Ajoutez une impression de produit à cet appel. Plus...
 
(GAIDictionaryBuilder *)- addPromotion :
 Ajoutez une promotion à cet appel. Plus...
 

Méthodes de classe

("Utilisez createScreenView à la place.")+ createAppView
 Renvoie un objet GAIDictionaryBuilder avec des paramètres spécifiques à un appel de vue d'application. Plus...
 
(GAIDictionaryBuilder *)+ createScreenView
 Renvoie un objet GAIDictionaryBuilder avec des paramètres spécifiques à un appel de visionnage d'écran. Plus...
 
(GAIDictionaryBuilder *)+ createEventWithCategory:action:label:value:
 Renvoie un objet GAIDictionaryBuilder avec des paramètres spécifiques à un appel avec événement. Plus...
 
(GAIDictionaryBuilder *)+ createExceptionWithDescription:withFatal:
 Renvoie un objet GAIDictionaryBuilder avec des paramètres spécifiques à un appel d'exception. Plus...
 
(GAIDictionaryBuilder *)+ createItemWithTransactionId:name:sku:category:price:quantity:currencyCode:
 Renvoie un objet GAIDictionaryBuilder avec des paramètres spécifiques à un appel d'élément. Plus...
 
(GAIDictionaryBuilder *)+ createSocialWithNetwork:action:target:
 Renvoie un objet GAIDictionaryBuilder avec des paramètres spécifiques à un hit de réseau social. Plus...
 
(GAIDictionaryBuilder *)+ createTimingWithCategory:interval:name:label:
 Renvoie un objet GAIDictionaryBuilder avec des paramètres spécifiques à un hit de temps d'appel. Plus...
 
(GAIDictionaryBuilder *)+ createTransactionWithId:affiliation:revenue:tax:shipping:currencyCode:
 Renvoie un objet GAIDictionaryBuilder avec des paramètres spécifiques à un appel de transaction. Plus...
 

Documentation sur les méthodes

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

Copie toutes les paires nom/valeur des paramètres dans cet objet, en ignorant les clés qui ne sont pas des chaînes NSString et les valeurs qui ne sont ni NSString ni NSNull.

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

Renvoie la valeur du paramètre d'entrée paramName ou nil si paramName n'est pas présent.

- Version (NSMutableDictionary *)

Renvoie un objet NSMutableDictionary avec tous les paramètres définis.

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

Analyse et traduit les paramètres de campagne UTM en paramètres de campagne Analytics, puis les renvoie sous forme de carte.

Paramètres
paramsURL contenant les paramètres de campagne UTM.

Les paramètres de campagne valides sont les suivants:

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

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

Pour en savoir plus sur le taggage automatique et le taggage manuel, consultez l'article Avantages du taggage automatique.

+ (GAIDictionaryBuilder *) createAppView

Renvoie un objet GAIDictionaryBuilder avec des paramètres spécifiques à un appel de vue d'application.

Notez que cette méthode ne permet pas de définir le nom de l'écran pour les appels suivants. Pour ce faire, vous devez appeler set:kGAIDescription value:<screenName> sur l'instance GAITracker.

Cette méthode est obsolète. Utilisez createScreenView à la place.

+ (GAIDictionaryBuilder *) createScreenView

Renvoie un objet GAIDictionaryBuilder avec des paramètres spécifiques à un appel de visionnage d'écran.

Notez que cette méthode ne permet pas de définir le nom de l'écran pour les appels suivants. Pour ce faire, vous devez appeler set:kGAIDescription value:<screenName> sur l'instance GAITracker.

+ (GAIDictionaryBuilder *) createEventWithCategory: (NSString *) category
action: (NSString *) action
maison de disques : (NSString *) label
value: (NSNumber *) valeur

Renvoie un objet GAIDictionaryBuilder avec des paramètres spécifiques à un appel avec événement.

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

Renvoie un objet GAIDictionaryBuilder avec des paramètres spécifiques à un appel d'exception.

+ (GAIDictionaryBuilder *) createItemWithTransactionId: (NSString *) transactionId
name: (NSString *) name
SKU: (NSString *) SKU
catégorie: (NSString *) category
Prix: (NSNumber *) price
quantité: (NSNumber *) quantity
currencyCode: (NSString *) currencyCode

Renvoie un objet GAIDictionaryBuilder avec des paramètres spécifiques à un appel d'élément.

+ (GAIDictionaryBuilder *) createSocialWithNetwork: (NSString *) réseau
action: (NSString *) action
cible: (NSString *) target

Renvoie un objet GAIDictionaryBuilder avec des paramètres spécifiques à un hit de réseau social.

+ (GAIDictionaryBuilder *) createTimingWithCategory: (NSString *) category
interval: (NSNumber *) intervalMillis
name: (NSString *) name
maison de disques : (NSString *) libellé

Renvoie un objet GAIDictionaryBuilder avec des paramètres spécifiques à un hit de temps d'appel.

+ (GAIDictionaryBuilder *) createTransactionWithId: (NSString *) transactionId
affiliation: (NSString *) affiliation
revenus: (NSNumber *) revenue
taxes: (NSNumber *) tax
livraison: (NSNumber *) shipping
currencyCode: (NSString *) currencyCode

Renvoie un objet GAIDictionaryBuilder avec des paramètres spécifiques à un appel de transaction.

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

Définissez le champ d'action du produit pour cet appel.

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

Ajoute un produit à cet appel.

- (GAIDictionaryBuilder *) addProductImpression: (GAIEcommerceProduct *) product
impressionList: (NSString *) name
source d'impression: (NSString *) Source

Ajoutez une impression de produit à cet appel.

- (GAIDictionaryBuilder *) addPromotion: (GAIEcommercePromotion *) promotion [promotion]

Ajoutez une promotion à cet appel.