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 por meio do SDK do Google Analytics para iOS 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 e-commerce no Google Analytics são compostos por hits de transação e item relacionados por um ID de transação compartilhado.

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

Nome do campo Campo do rastreador Tipo Obrigatório Descrição
Transaction ID kGAITransactionId NSString Sim Um ID exclusivo que representa a transação. Esse ID não deve colidir com outros IDs de transação.
Affiliation kGAITransactionAffiliation NSString Sim Uma entidade à qual a transação deve ser afiliada (por exemplo, uma loja específica)
Receita kGAITransactionRevenue NSNumber Sim A receita total de uma transação, incluindo impostos e frete.
Tax kGAITransactionTax NSNumber Sim O total de impostos de uma transação.
Shipping kGAITransactionShipping NSNumber Sim O custo total do frete de uma transação.
Currency code kGAICurrencyCode NSString 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 kGAITransactionId NSString Sim O código da transação com o qual o produto deve ser associado.
Nome kGAIItemName NSString Sim O nome do produto.
SKU kGAIItemSku NSString Sim O SKU de um produto.
Category kGAIItemCategory NSString Não Uma categoria à qual produto pertence.
Preço kGAIItemPrice NSNumber Sim O preço de um produto.
Quantity kGAIItemQuantity NSNumber Sim A quantidade de um produto.
Currency code kGAICurrencyCode NSString 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:

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

  // Assumes a tracker has already been initialized with a property ID, otherwise
  // this call returns null.
  id tracker = [[GAI sharedInstance] defaultTracker];



  [tracker send:[[GAIDictionaryBuilder createTransactionWithId:@"0_123456"             // (NSString) Transaction ID
                                                   affiliation:@"In-app Store"         // (NSString) Affiliation
                                                       revenue:@2.16F                  // (NSNumber) Order revenue (including tax and shipping)
                                                           tax:@0.17F                  // (NSNumber) Tax
                                                      shipping:@0                      // (NSNumber) Shipping
                                                  currencyCode:@"USD"] build]];        // (NSString) Currency code


  [tracker send:[[GAIDictionaryBuilder createItemWithTransactionId:@"0_123456"         // (NSString) Transaction ID
                                                              name:@"Space Expansion"  // (NSString) Product Name
                                                               sku:@"L_789"            // (NSString) Product SKU
                                                          category:@"Game expansions"  // (NSString) Product category
                                                             price:@1.9F               // (NSNumber) Product price
                                                          quantity:@1                  // (NSInteger) Product quantity
                                                      currencyCode:@"USD"] build]];    // (NSString) Currency code

}

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.

/*
 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).
 */
- (void)onPurchaseCompleted {

  // Assumes a tracker has already been initialized with a property ID, otherwise
  // this call returns null.
  id tracker = [[GAI sharedInstance] defaultTracker];

  [tracker send:[[GAIDictionaryBuilder createTransactionWithId:@"0_123456",         // (NSString) Transaction ID, should be unique among transactions.
                                                   affiliation:@"In-app Store",     // (NSString) Affiliation
                                                       revenue:(int64_t) 2.16,      // (int64_t) Order revenue (including tax and shipping)
                                                           tax:(int64_t) 0.17,      // (int64_t) Tax
                                                      shipping:(int64_t) 0,         // (int64_t) Shipping
                                                  currencyCode:@"EUR"] build]];     // (NSString) Currency code
}