Suivi du commerce électronique – SDK pour iOS

Ce document explique comment mesurer les revenus et les paiements via l'application à l'aide du SDK Google Analytics pour iOS v3.

Présentation

La mesure de l'e-commerce vous permet d'envoyer des achats et des ventes via l'application à Google Analytics. Dans Google Analytics, les données d'e-commerce sont constituées d'appels de transaction et d'articles, associés à un ID de transaction partagé.

Les transactions comportent les champs suivants:

Nom du champ Champ de suivi Type Obligatoire Description
ID de la transaction kGAITransactionId NSString Oui Identifiant unique représentant la transaction. Cet ID ne doit pas entrer en conflit avec d'autres ID de transaction.
Affiliation kGAITransactionAffiliation NSString Oui Entité à laquelle la transaction doit être affiliée (par exemple, un magasin particulier)
Revenus kGAITransactionRevenue NSNumber Oui Revenu total d'une transaction, taxes et frais de livraison inclus
Taxes kGAITransactionTax NSNumber Oui Montant total des taxes pour une transaction
Expédition kGAITransactionShipping NSNumber Oui Frais de port totaux d'une transaction
Code de devise kGAICurrencyCode NSString Non Devise locale d'une transaction. Valeur par défaut dans la devise de la vue (profil) dans laquelle les transactions sont affichées.

Les éléments comportent les champs suivants:

Nom du champ Champ de suivi Type Obligatoire Description
ID de la transaction kGAITransactionId NSString Oui ID de la transaction à laquelle l'article doit être associé
Nom kGAIItemName NSString Oui Nom du produit
SKU kGAIItemSku NSString Oui Le code SKU d'un produit
Catégorie kGAIItemCategory NSString Non Catégorie à laquelle appartient le produit
Prix kGAIItemPrice NSNumber Oui Prix d'un produit
Quantity kGAIItemQuantity NSNumber Oui Quantité d'un produit
Code de devise kGAICurrencyCode NSString Non Devise locale d'une transaction. Valeur par défaut de la devise de la vue (profil) dans laquelle les transactions sont comptabilisées.

Les données d'e-commerce sont principalement utilisées dans les rapports standards suivants:

  • Vue d'ensemble de l'e-commerce
  • Performances des produits
  • Performances des ventes
  • Transactions
  • Délai avant l'achat

Implémentation

Pour envoyer des données sur les transactions et les articles à Google Analytics, vous devez définir les valeurs des champs de la transaction et de l'article sur l'outil de suivi, puis les envoyer une par une. Exemple :

/*
 * Called when a purchase is processed and verified.
 */
- (void)onPurchaseCompleted {

  // Assumes a tracker has already been initialized with a property ID, otherwise
  // this call returns null.
  id tracker = [[GAI sharedInstance] defaultTracker];



  [tracker send:[[GAIDictionaryBuilder createTransactionWithId:@"0_123456"             // (NSString) Transaction ID
                                                   affiliation:@"In-app Store"         // (NSString) Affiliation
                                                       revenue:@2.16F                  // (NSNumber) Order revenue (including tax and shipping)
                                                           tax:@0.17F                  // (NSNumber) Tax
                                                      shipping:@0                      // (NSNumber) Shipping
                                                  currencyCode:@"USD"] build]];        // (NSString) Currency code


  [tracker send:[[GAIDictionaryBuilder createItemWithTransactionId:@"0_123456"         // (NSString) Transaction ID
                                                              name:@"Space Expansion"  // (NSString) Product Name
                                                               sku:@"L_789"            // (NSString) Product SKU
                                                          category:@"Game expansions"  // (NSString) Product category
                                                             price:@1.9F               // (NSNumber) Product price
                                                          quantity:@1                  // (NSInteger) Product quantity
                                                      currencyCode:@"USD"] build]];    // (NSString) Currency code

}

Les champs de devise de l'e-commerce acceptent les valeurs négatives dans la devise, comme cela peut être nécessaire en cas de remboursement ou de retour.

Spécifier les devises

Par défaut, les valeurs de transaction sont supposées être exprimées dans la devise de la vue (profil) dans laquelle elles sont comptabilisées.

Pour remplacer la devise locale d'une transaction et de tout produit associé, définissez le champ "Code de la devise" de l'appel de transaction et d'élément avec le nouveau code de devise. Pour obtenir la liste complète des devises et des codes de devise acceptés, consultez la documentation de référence sur les devises acceptées.

/*
 In this example, the currency of the transaction is set to Euros. The
 currency values will appear in reports using the global currency
 type of the view (profile).
 */
- (void)onPurchaseCompleted {

  // Assumes a tracker has already been initialized with a property ID, otherwise
  // this call returns null.
  id tracker = [[GAI sharedInstance] defaultTracker];

  [tracker send:[[GAIDictionaryBuilder createTransactionWithId:@"0_123456",         // (NSString) Transaction ID, should be unique among transactions.
                                                   affiliation:@"In-app Store",     // (NSString) Affiliation
                                                       revenue:(int64_t) 2.16,      // (int64_t) Order revenue (including tax and shipping)
                                                           tax:(int64_t) 0.17,      // (int64_t) Tax
                                                      shipping:(int64_t) 0,         // (int64_t) Shipping
                                                  currencyCode:@"EUR"] build]];     // (NSString) Currency code
}