Este documento contém uma visão geral de como avaliar os pagamentos no aplicativo e a receita usando o SDK do Google Analytics para Android v2.
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 e-commerce no Google Analytics geralmente são compostos por transações e itens relacionados por um ID de transação compartilhado. No SDK do Google Analytics para Android, essa relação é estabelecida criando um objeto de transação e adicionando itens a ele.
Os dados de e-commerce são usados principalmente nos seguintes relatórios:
- Visão geral do e-commerce
- Desempenho do produto
- Desempenho de vendas
- Transações
- Tempo até a compra
Implementação
Há três etapas para medir uma transação com o Google Analytics:
- Crie um objeto de transação.
- Criar objetos de item e adicioná-los ao objeto de transação.
- Envie a transação usando
sendTransaction(Transaction transObject).
No exemplo abaixo, presumimos que
onPurchaseCompleted()
é chamado depois que o usuário conclui uma compra no 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.
}
Tipos de moedas
No SDK do Google Analytics para Android, os campos de moeda de e-commerce precisam estar em micros (milhões de moedas).
Por exemplo, para enviar um valor de moeda de 4.5991, você precisa converter esse valor em micros (por exemplo, 4599100) ao enviar a transação para o Google Analytics, como nos exemplos acima. Quando o SDK envia essa transação ao Google Analytics, esse valor é automaticamente convertido em um valor decimal de ponto fixo e enviado como 4.5991.
Símbolos de moeda não devem ser incluídos no código de comércio eletrônico e vírgulas.
Os campos de moeda de e-commerce também aceitam 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 de transação estejam na moeda da vista (perfil) em que são informados.
Para substituir a moeda local de uma transação, chame
setCurrencyCode ao criar um
Transaction,
como no exemplo
a seguir:
/**
* 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);
}
Para ver a lista completa de moedas aceitas e códigos, consulte a Referência de moedas aceitas.