Observação: esta referência descreve os métodos usados para o comércio eletrônico na geração de relatórios do Google Analytics. Para mais informações sobre como configurar o acompanhamento de comércio eletrônico, consulte Acompanhamento de comércio eletrônico.
Métodos de comércio eletrônico do GATC
_addItem(transactionId, sku, name, category, price, quantity)
_addTrans(transactionId, affiliation, total, tax, shipping, city, state, country)
_trackTrans()
Detalhes dos métodos
_addItem()
- Calcule as quantidades com seu próprio software.
- Na mesma sessão, os itens duplicados adicionados (pela SKU) não afetarão o cálculo da quantidade.
- Na mesma sessão, se dois itens com a mesma SKU forem adicionados, as informações do primeiro item serão substituídas pelas informações do segundo.
- Verifique se cada item em seu inventário possui uma única SKU.
- Se seu inventário tiver itens diferentes com a mesma SKU e um visitante comprar os dois, você só receberá dados do item adicionado mais recentemente.
- Verifique se um objeto de transação principal está configurado para os itens adicionados.
- Se não houver um objeto de transação pai para um item adicionado, o item será anexado a um objeto de transação empty.
- Se um item for adicionado sem um objeto de transação principal, seus relatórios vão mostrar produtos por SKU que não estejam associados a nenhuma transação.
- Sempre forneça um valor para o parâmetro
name
.- Embora o parâmetro
name
não seja obrigatório, os itens adicionados a uma transação sem um parâmetroname
não aparecem no detalhamento do produto de uma transação. Você ainda verá a receita total da transação, mas não será possível saber a quantidade de receita que um determinado item contribuiu para o total da transação.
- Embora o parâmetro
_addItem(transactionId, sku, name, category, price, quantity)
Use esse método para acompanhar itens comprados pelos visitantes do seu site de e-commerce. Este método acompanha itens individuais por suas SKU. Isso significa que o parâmetro sku
é obrigatório.
Em seguida, esse método associa o item ao objeto de transação pai
usando o argumento transactionId
.
A correspondência dos argumentos para esse método é feita pela posição. Portanto, forneça todos os parâmetros, mesmo que alguns deles tenham um valor vazio.
Esse método não executa outros cálculos, como de quantidade. Portanto, lembre-se das seguintes práticas recomendadas:
_gaq.push(['_addItem', '1234', // transaction ID - necessary to associate item with transaction 'DD44', // SKU/code - required 'T-Shirt', // product name - necessary to associate revenue with product 'Olive Medium', // category or variation '11.99', // unit price - required '1' // quantity - required ]);
parâmetros
String transactionId
Opcional ID do pedido da transação a ser associada ao item.
String sku
Obrigatório. Código SKU do item.
String name
Obrigatório. Nome do produto. Obrigatório para ver os dados no relatório detalhado do produto.
String category
Opcional. Categoria do produto.
String price
Obrigatório. Preço
do produto.
String quantity
Obrigatório. Quantidade
comprada.
_addTrans()
_addTrans(transactionId, affiliation, total, tax, shipping, city, state,
country)
-
Cria um objeto de transação com os valores fornecidos. Assim como no
_addItem()
, esse método lida somente com o acompanhamento de transações e não oferece outras funcionalidades de e-commerce. Portanto, se a transação for uma cópia de
uma transação existente para essa sessão, os valores antigos da transação serão
substituídos pelos novos valores da transação. Os argumentos desse método são correspondidos pela posição. Portanto, forneça todos os parâmetros, mesmo que alguns deles tenham um valor vazio.
_gaq.push(['_addTrans', '1234', // transaction ID - required 'Womens Apparel', // affiliation or store name '28.28', // total - required; Shown as "Revenue" in the // Transactions report. Does not include Tax and Shipping. '1.29', // tax '15.00', // shipping 'San Jose', // city 'California', // state or province 'USA' // country ]);
parâmetros
String transactionId
Obrigatório.
Número exclusivo interno do ID da transação para essa transação.
String affiliation
Opcional. Afiliação do parceiro ou da loja (indefinido, caso esteja ausente).
String total
Obrigatório.
O valor total em dólares da transação. Não inclui tributos e frete
e só deve ser considerado o "total geral" se você incluir explicitamente
frete e tributos.
String tax
Opcional. É o valor do tributo
da transação.
String shipping
Opcional. O frete para a transação.
String city
Opcional. Cidade que deve ser associada à transação.
String state
Opcional. Estado a ser associado à transação.
String country
Opcional. País a ser associado à transação.
retorna
_gat.GA_EComm_.Transactions_
O objeto de transação
que foi criado ou modificado.
_trackTrans()
_trackTrans()
-
Envia os dados da transação e do item para o servidor do Google Analytics.
Esse método precisa ser chamado após
_trackPageview()
e usado com os métodos _addItem()
e addTrans()
.
Ele precisa ser chamado depois que os elementos da transação e os itens tiverem sido configurados.
_gaq.push(['_setAccount', 'UA-XXXXX-X']); _gaq.push(['_trackPageview']); _gaq.push(['_addTrans', '1234', // transaction ID - required 'Womens Apparel', // affiliation or store name '28.28', // total - required '1.29', // tax '15.00', // shipping 'San Jose', // city 'California', // state or province 'USA' // country ]); _gaq.push(['_addItem', '1234', // transaction ID - necessary to associate item with transaction 'DD44', // SKU/code - required 'T-Shirt', // product name 'Olive Medium', // category or variation '11.99', // unit price - required '1' // quantity - required ]); _gaq.push(['_trackTrans']);