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