Monitoraggio e-commerce - SDK Android v2 (legacy)

Questo documento offre una panoramica su come misurare i pagamenti in-app e le entrate utilizzando l'SDK Google Analytics per Android v2.

Panoramica

La misurazione e-commerce ti consente di inviare vendite e acquisti in-app a Google Analytics. I dati di e-commerce in Google Analytics comprendono generalmente transazioni ed articoli, correlati a un ID transazione condiviso. Nell'SDK Google Analytics per Android tale relazione viene stabilita creando un oggetto transazione e aggiungendo elementi.

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

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

Implementazione

Esistono tre passaggi per misurare una transazione con Google Analytics:

  1. Creare un oggetto Transaction.
  2. Creazione di oggetti elemento e aggiunta all'oggetto transazione.
  3. Invia la transazione utilizzando sendTransaction(Transaction transObject) .

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

/**
 * The purchase was processed. We will send the transaction and its associated line items to Google Analytics,
 * but only if the purchase has been confirmed.
 */
public void onPurchaseCompleted() {
  Transaction myTrans = new Transaction.Builder(
      "0_123456",                                           // (String) Transaction Id, should be unique.
      (long) (2.16 * 1000000))                              // (long) Order total (in micros)
      .setAffiliation("In-App Store")                       // (String) Affiliation
      .setTotalTaxInMicros((long) (0.17 * 1000000))         // (long) Total tax (in micros)
      .setShippingCostInMicros(0)                           // (long) Total shipping cost (in micros)
      .build();

  myTrans.addItem(new Item.Builder(
      "L_789",                                              // (String) Product SKU
      "Level Pack: Space",                                  // (String) Product name
      (long) (1.99 * 1000000),                              // (long) Product price (in micros)
      (long) 1)                                             // (long) Product quantity
      .setProductCategory("Game expansions")                // (String) Product category
      .build());

    Tracker myTracker = EasyTracker.getTracker(); // Get reference to tracker.
    myTracker.sendTransaction(myTrans); // Send the transaction.
}

Tipi di valuta

Nell'SDK Google Analytics per Android, i campi delle valute di e-commerce devono essere in micro (milioni di valute).

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

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

I campi delle valute e-commerce supportano anche 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 nella valuta della vista (profilo) in cui vengono registrati.

Per sostituire la valuta locale di una transazione, chiama setCurrencyCode quando crei un Transaction come nel seguente esempio:

/**
 * 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).
 */
public void onPurchaseCompleted() {
  Transaction myTrans = new Transaction.Builder(
      "0_123456",
      (long) (1.59 * 1000000))
      .setAffiliation("In-App Store")
      .setTotalTaxInMicros((long) (0.13 * 1000000))
      .setShippingCostInMicros(0)
      .setCurrencyCode("EUR")                               // (String) Set currency code to Euros.
      .build();

    Tracker myTracker = EasyTracker.getTracker();
    myTracker.sendTransaction(myTrans);
}

Per l'elenco completo delle valute e dei codici valuta supportati, consulta il Riferimento per le valute supportate.