Monitoraggio e-commerce - SDK per iOS

Questo documento fornisce una panoramica su come misurare i pagamenti in-app e le entrate utilizzando l'SDK di Google Analytics per iOS v3.

Panoramica

La misurazione e-commerce ti consente di inviare acquisti e vendite in-app a Google Analytics. I dati di e-commerce in Google Analytics sono costituiti da hit di transazioni e articoli, correlati da un ID transazione condiviso.

Le transazioni includono i seguenti campi:

Nome campo Campo tracker Tipo Obbligatorio Descrizione
ID transazione kGAITransactionId NSString Sì Un ID univoco che rappresenta la transazione. Questo ID non deve entrare in conflitto con altri ID transazione.
Affiliazione kGAITransactionAffiliation NSString Sì Un'entità a cui dovrebbe essere affiliata la transazione (ad es. un determinato negozio)
Entrate kGAITransactionRevenue NSNumber Sì Le entrate totali di una transazione, incluse imposte e spedizione
Tasse kGAITransactionTax NSNumber Sì L'imposta totale per una transazione
Spedizione kGAITransactionShipping NSNumber Sì Il costo totale della spedizione per una transazione
Codice valuta kGAICurrencyCode NSString No La valuta locale di una transazione. Il valore predefinito è la valuta della vista (profilo) in cui vengono visualizzate le transazioni.

Gli elementi hanno i seguenti campi:

Nome campo Campo tracker Tipo Obbligatorio Descrizione
ID transazione kGAITransactionId NSString Sì L'ID transazione a cui deve essere associato l'articolo
Nome kGAIItemName NSString Sì Il nome del prodotto.
SKU kGAIItemSku NSString Sì Lo SKU di un prodotto
Categoria kGAIItemCategory NSString No Una categoria a cui appartiene il prodotto
Prezzo kGAIItemPrice NSNumber Sì Il prezzo di un prodotto
Quantità kGAIItemQuantity NSNumber Sì La quantità di un prodotto
Codice valuta kGAICurrencyCode NSString No La valuta locale di una transazione. Il valore predefinito è la valuta della vista (profilo) in cui sono riportate le transazioni.

I dati di e-commerce vengono utilizzati principalmente nei seguenti report standard:

  • Panoramica e-commerce
  • Rendimento prodotti
  • Rendimento delle vendite
  • Transazioni
  • Tempo all'acquisto

Implementazione

L'invio dei dati sulle transazioni e sugli articoli a Google Analytics richiede l'impostazione dei valori dei campi delle transazioni e degli articoli sul tracker e l'invio di questi valori, uno alla volta. Ad esempio:

/*
 * 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

}

I campi della valuta e-commerce supportano valori di valuta negativi, come potrebbe essere necessario in caso di rimborsi o resi.

Indicazione delle valute

Per impostazione predefinita, si presume che i valori delle transazioni siano espressi nella valuta della vista (profilo) in cui sono riportati.

Per sostituire la valuta locale di una transazione e di eventuali prodotti associati, imposta il campo del codice valuta della transazione e degli hit dell'articolo con il nuovo codice valuta. Per l'elenco completo delle valute e dei codici valuta supportati, consulta la documentazione di riferimento sulle valute supportate.

/*
 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
}