Acompanhamento de comércio eletrônico – SDK para iOS

Este documento contém uma visão geral de como avaliar pagamentos e receita no aplicativo usando o SDK do Google Analytics para iOS 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 iOS, 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:

  1. Crie um objeto de transação.
  2. Criar objetos de item e adicioná-los ao objeto de transação.
  3. Envie a transação usando sendTransaction:.

No exemplo abaixo, presumimos que onPurchaseCompleted é chamado depois que o usuário conclui uma compra no app.

- (void)onPurchaseCompleted {
  GAITransaction *transaction =
      [GAITransaction transactionWithId:@"0_123456"            // (NSString) Transaction ID, should be unique.
                        withAffiliation:@"In-App Store"];      // (NSString) Affiliation
  transaction.taxMicros = (int64_t)(0.17 * 1000000);           // (int64_t) Total tax (in micros)
  transaction.shippingMicros = (int64_t)(0);                   // (int64_t) Total shipping (in micros)
  transaction.revenueMicros = (int64_t)(2.16 * 1000000);       // (int64_t) Total revenue (in micros)

  [transaction addItemWithSKU:@"L_789"                         // (NSString) Product SKU
                         name:@"Level Pack: Space"             // (NSString) Product name
                     category:@"Game expansions"               // (NSString) Product category
                  priceMicros:(int64_t)(1.99 * 1000000)        // (int64_t)  Product price (in micros)
                     quantity:1];                              // (NSInteger)  Product quantity

  [[GAI sharedInstance].defaultTracker sendTransaction:transaction]; // Send the transaction.
}

Tipos de moedas

No SDK do Google Analytics para iOS, os campos de moeda de e-commerce precisam estar em micros (milhões de moeda).

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.