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 v2.

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 generalmente costituiti da transazioni ed articoli correlati da un ID transazione condiviso. Nell'SDK di Google Analytics per iOS, questa relazione viene stabilita creando un oggetto Transaction e aggiungendovi elementi.

I dati di e-commerce sono utilizzati come principali nei seguenti report:

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

Implementazione

Per misurare una transazione con Google Analytics sono previsti tre passaggi:

  1. Creare un oggetto Transaction.
  2. Creare oggetti elemento e aggiungerli all'oggetto Transaction.
  3. Invia la transazione utilizzando sendTransaction:.

Nell'esempio seguente, supponiamo che onPurchaseCompleted venga chiamato dopo che l'utente ha completato un acquisto in-app.

- (void)onPurchaseCompleted {
  GAITransaction *transaction =
      [GAITransaction transactionWithId:@"0_123456"            // (NSString) Transaction ID, should be unique.
                        withAffiliation:@"In-App Store"];      // (NSString) Affiliation
  transaction.taxMicros = (int64_t)(0.17 * 1000000);           // (int64_t) Total tax (in micros)
  transaction.shippingMicros = (int64_t)(0);                   // (int64_t) Total shipping (in micros)
  transaction.revenueMicros = (int64_t)(2.16 * 1000000);       // (int64_t) Total revenue (in micros)

  [transaction addItemWithSKU:@"L_789"                         // (NSString) Product SKU
                         name:@"Level Pack: Space"             // (NSString) Product name
                     category:@"Game expansions"               // (NSString) Product category
                  priceMicros:(int64_t)(1.99 * 1000000)        // (int64_t)  Product price (in micros)
                     quantity:1];                              // (NSInteger)  Product quantity

  [[GAI sharedInstance].defaultTracker sendTransaction:transaction]; // Send the transaction.
}

Tipi di valuta

Nell'SDK Google Analytics per iOS, i campi della valuta per l'e-commerce devono essere in micro (milioni di valuta).

Ad esempio, per inviare un valore di valuta pari a 4.5991, devi convertirlo in micro (ovvero 4599100) quando invii la transazione a Google Analytics, come negli esempi precedenti. Quando l'SDK invia la transazione a Google Analytics, questo valore viene automaticamente convertito in un valore decimale a virgola fissa e inviato come 4.5991.

I simboli di valuta non devono essere inclusi nel codice e-commerce e non devono essere utilizzate le virgole.

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