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 }