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
-
params URL 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.