Acompanhamento de comércio eletrônico: SDK para Android

Este documento apresenta uma visão geral de como medir pagamentos e receita no aplicativo usando o SDK do Google Analytics para Android v3.

Visão geral

Com a avaliação do comércio eletrônico, é possível enviar compras e vendas no aplicativo ao Google Analytics. Os dados de comércio eletrônico no Google Analytics são compostos por hits de transações e itens, relacionados por um ID compartilhado da transação.

As transações têm os seguintes campos:

Nome do campo Campo do rastreador Tipo Obrigatório Descrição
Transaction ID Fields.TRANSACTION_ID String Sim Um ID exclusivo que representa a transação. Esse ID não deve colidir com outros IDs de transação.
Affiliation Fields.TRANSACTION_AFFILIATION String Sim Uma entidade à qual a transação deve ser afiliada (por exemplo, uma loja específica)
Receita Fields.TRANSACTION_REVENUE Double Sim A receita total de uma transação, incluindo impostos e frete.
Tax Fields.TRANSACTION_TAX Double Sim O total de impostos de uma transação.
Shipping Fields.TRANSACTION_SHIPPING Double Sim O custo total do frete de uma transação.
Currency code Fields.CURRENCY_CODE String Não A moeda local de uma transação. O padrão é a moeda da vista da propriedade (perfil) em que as transações estão sendo visualizadas.

Os itens têm os seguintes campos:

Nome do campo Campo do rastreador Tipo Obrigatório Descrição
Transaction ID Fields.TRANSACTION_ID String Sim O código da transação com o qual o produto deve ser associado.
Nome Fields.ITEM_NAME String Sim O nome do produto.
SKU Fields.ITEM_SKU String Sim O SKU de um produto.
Category Fields.ITEM_CATEGORY String Não Uma categoria à qual produto pertence.
Preço Fields.ITEM_PRICE Double Sim O preço de um produto.
Quantity Fields.ITEM_QUANTITY Long Sim A quantidade de um produto.
Currency code Fields.CURRENCY_CODE String Não A moeda local de uma transação. O padrão é a moeda da vista (perfil) em que as transações são informadas.

Os dados de e-commerce são usados principalmente nos seguintes relatórios padrão:

  • Visão geral do comércio eletrônico
  • Desempenho do produto
  • Desempenho de vendas
  • Transações
  • Tempo até a compra

Implementação

Para enviar dados de transações e itens ao Google Analytics, é necessário configurar os valores dos campos de transação e item no rastreador e enviá-los um de cada vez. Exemplo:

import android.app.Activity;

import com.google.analytics.tracking.android.EasyTracker;
import com.google.analytics.tracking.android.MapBuilder;

public class CheckoutActivity extends Activity {

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

    // May return null if EasyTracker has not yet been initialized with a
    // property ID.
    EasyTracker easyTracker = EasyTracker.getInstance(this);

    easyTracker.send(MapBuilder
        .createTransaction("0_123456",       // (String) Transaction ID
                           "In-app Store",   // (String) Affiliation
                           2.16d,            // (Double) Order revenue
                           0.17d,            // (Double) Tax
                           0.0d,             // (Double) Shipping
                           "USD")            // (String) Currency code
        .build()
    );

    easyTracker.send(MapBuilder
        .createItem("0_123456",               // (String) Transaction ID
                    "Level Pack: Space",      // (String) Product name
                    "L_789",                  // (String) Product SKU
                    "Game expansions",        // (String) Product category
                    1.99d,                    // (Double) Product price
                    1L,                       // (Long) Product quantity
                    "USD")                    // (String) Currency code
        .build()
    );
  }

  // ... Rest of the Activity definition
}

Os campos de moeda de comércio eletrônico suportam valores de moeda negativos, como pode ser necessário no caso de reembolsos ou devoluções.

Especificação de moedas

Por padrão, presume-se que os valores das transações estejam na mesma moeda da vista da propriedade (perfil) em que são informados.

Para substituir a moeda local de uma transação e todos os produtos associados, defina o campo do código de moeda dos hits de transações e itens com o novo código de moeda. Para ver a lista completa das moedas aceitas e os códigos correspondentes, consulte a referência de moedas aceitas.

import android.app.Activity;

import com.google.analytics.tracking.android.EasyTracker;
import com.google.analytics.tracking.android.MapBuilder;

public class CheckoutActivity extends Activity {
  /**
   * 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() {

    // Assumes a tracker has already been initialized with a property ID, otherwise
    // this call returns null.
    EasyTracker easyTracker = EasyTracker.getInstance(this);

    easyTracker.send(MapBuilder
        .createTransaction("0_123456",       // (String) Transaction ID, should be unique among transactions.
                           "In-app Store",   // (String) Affiliation
                           (long) 2.16,      // (long) Order revenue (includes tax and shipping)
                           (long) 0.17,      // (long) Tax
                           0.0,              // (long) Shipping cost
                           "EUR")            // (String) Currency code
        .build();

  }
  // ... Rest of the Activity definition.
}