Acompanhamento de comércio eletrônico

Este documento fornece uma visão geral de como avaliar os pagamentos no aplicativo e a receita usando o SDK v4 do Google Analytics para Android.

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 do comércio eletrônico no Google Analytics são compostos por hits de transações e itens com um ID de transação em comum.

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

Nome do campo Tipo Obrigatório Descrição
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 String Sim Uma entidade à qual a transação deve ser afiliada (por exemplo, uma loja específica)
Revenue Double Sim A receita total de uma transação, incluindo impostos e frete.
Imposto Double Yes The total tax for a transaction
Frete Double Sim O custo total do frete de uma transação.
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 Tipo Obrigatório Descrição
Transaction ID String Sim O código da transação com o qual o produto deve ser associado.
Name String Sim O nome do produto.
SKU String Sim O SKU de um produto.
Category String Não Uma categoria à qual produto pertence.
Price Double Sim O preço de um produto.
Quantity Long Sim A quantidade de um produto.
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 são informadas.

Os dados do comércio eletrônico são usados principalmente nestes 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

O TransactionBuilder e o ItemBuilder são usados para enviar dados de transações e itens ao Google Analytics. Cada campo de comércio eletrônico é definido por meio de métodos auxiliares. Por exemplo:

// Build the transaction.
sendDataToTwoTrackers(new HitBuilders.TransactionBuilder()
    .setTransactionId(getOrderId())
    .setAffiliation(getStoreName())
    .setRevenue(getTotalOrder())
    .setTax(getTotalTax())
    .setShipping(getShippingCost())
    .setCurrencyCode("USD")
    .build());

// Build an item.
sendDataToTwoTrackers(new HitBuilders.ItemBuilder()
    .setTransactionId(getOrderId())
    .setName(getItemName(1))
    .setSku(getItemSku(1))
    .setCategory(getItemCategory(1))
    .setPrice(getItemPrice(getView(), 1))
    .setQuantity(getItemQuantity(getView(), 1))
    .setCurrencyCode("USD")
    .build());

// Sends the ecommerce data.
private void sendDataToTwoTrackers(Map<String, String> params) {
  AnalyticsSampleApp app = ((AnalyticsSampleApp) getActivity().getApplication());
  Tracker appTracker = app.getTracker(TrackerName.APP_TRACKER);
  Tracker ecommerceTracker = app.getTracker(TrackerName.ECOMMERCE_TRACKER);
  appTracker.send(params);
  ecommerceTracker.send(params);
}

Consulte Configuração avançada para detalhes sobre o método getTracker.

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 seus respectivos códigos, consulte a Referência de moedas aceitas.