O documento fornece instruções sobre como implementar uma tag de rastreamento no site para rastrear métricas como navegação, carrinho de compras e conversões. Instruções incluem como adicionar a tag JavaScript, personalizar páginas e variáveis, rastrear eventos de carrinho como adição e remoção de itens, e finalizar compras.
1. Manual de integração da TAG de Track
Para adicionar o track de navegação no site, coloque a tag JavaScript abaixo em todas as
páginas do site:
<script src="http://i.btg360.com.br/bs.js" type="text/javascript"></script>
<script type="text/javascript">
__bsd["id"]="IDDOSITE";
__bsd["expiraCarrinho"]=QTDDIAS;
</script>
Antes de colocá-la é necessário trocar os valores "IDDOSITE" pelo ID fornecido, e
o "QTDDIAS" pela quantidade de dias que leva para o carrinho expirar, caso o carrinho não
expire basta remover o __bsd["expiraCarrinho"]=QTDDIAS;.
Track de Navegação
O track padrão da navegação será realizado apenas por ter adicionado a tag acima na página,
contudo é possível personalizar ou adicionar informações, as quais serão associadas a página,
utilizando os métodos a seguir:
bs.setaPagina();
Parâmetros:
1. pg_nome, string, um apelido para a página, se não for fornecido será utilizado a url da
página;
2. pg_categoria, string, a categoria da página, se não for informado a página não será
associada a uma categoria;
3. pg_categoria_sub, string, a subcategoria, a qual faz parte da categoria informada;
Alguns e-commerces utilizam Departamento e Categoria, neste caso o Departamento é a
categoria e a Categoria é a subcategoria, a subcategoria sempre deverá estar contida na
categoria.
Exemplo:
bs.setaPagina("Buneco Hulk","brinquedos","bonecos");
bs.setaVarsCustomizadas();
Além dos valores trackeados por padrão, assim como os UTMs de origem no site, também é
disponibilizado 10 variáveis para serem utilizadas como identificador da página acessada.
2. Parâmetros:
● vars, object, Objeto Javascript com as variáveis var11 à var20.
Exemplos:
bs.setaVarsCustomizadas({"var11":"2 portas","var12":"branca"});
bs.setaVarsCustomizadas({"var11":"A","var12":"B","var13":"C","var14":"D","var15":"E","var16":"F","var17":"G","var18":"H","var19":"I",
"var20":"J"});
ou
var varsCustomizadas = new Object();
varsCustomizadas["var11"] = "2 portas";
varsCustomizadas["var12"] = "branca";
bs.setaVarsCustomizadas(varsCustomizadas);
bs.setaCliente();
Informa o id do usuáiro e o e-mail, o qual será atrelado ao cookie de UUID do usuário, para
identificar os dados do usuário ao acesso realizado.
Parâmetros:
1. cl_id, string, O id do usuário;
2. cl_email, string, O e-mail do usuário;
Exemplo:
bs.setaCliente("1","teste@teste.com.br");
Track do Carrinho
bs.addPreProdutoCarrinho();
Utilizado quando a pessoa clica em colocar o produto no carrinho, mas ao invés de ir para a
página do carrinho, vai para uma tela com opções do produto, como por exemplo a página de
escolha de garantia extendida, ou de alguma outra opção particular ao produto.
Os produtos colocados por esse método não irão para o carrinho, apenas será identificado os
produtos que foram abandonados antes de irem para o carrinho.
As opções escolhidas nesta página deverão ser tratadas de duas maneiras, quando forem
adicionadas no carrinho:
● Acessório ou serviço agregado, quando o produto puder ser comprado com ela ou sem
ela, deve-se adicionar o produto ao carrinho e a opção selecionada como um outro
produto.
3. ● Característica do produto, quando as opções forem entre uma ou outra, sem que seja
possível não escolher uma delas, deverá fazer parte do nome do produto.
Parâmetros:
1. idProduto, string, o id do produto;
2. nomeProduto, string, o nome do produto;
3. valorUnitario, number, o valor unitário do produto;
4. desconto, number, o valor de desconto dado ao produto;
5. quantidade, number, a quantidade do produto;
6. categoria, string, a categoria do produto;
7. subCategoria, string, a subCategoria do produto;
8. var21, string, valor customizado;
9. var22, string, valor customizado;
10. var23, string, valor customizado;
11. var24, string, valor customizado;
12. var25, string, valor customizado;
Exemplo:
bs.addPreProduto(12,"Produto A",234.30, 10, 2, "Categoria A", "SubCategoria AS", AS-12", "PB-M", "LL", "NATAL", "RTFM");
bs.addProdutoCarrinho();
Adiciona produtos ao carrinho, quando a pessoa entrar no carrinho tendo adicionado um
produto novo este método deve-ser chamado para adicionar os produtos novos, alteração de
produto ou exclusão do carrinho.
● Adicionar e alterar, chamar o método passando os valores como parâmetros
● Excluir, chamar o método também passando os parâmetros mas com o parâmetro
quantidade igual a 0.
Parâmetros:
1. idProduto, string, o id do produto;
2. nomeProduto, string, o nome do produto;
3. valorUnitario, number, o valor unitário do produto;
4. desconto, number, o valor de desconto dado ao produto;
5. quantidade, number, a quantidade do produto;
6. categoria, string, a categoria do produto;
7. subCategoria, string, a subcategoria do produto;
8. var21, string, valor customizado;
4. 9. var22, string, valor customizado;
10. var23, string, valor customizado;
11. var24, string, valor customizado;
12. var25, string, valor customizado;
Exemplos:
bs.addProduto(12,"Produto A",234.30, 10, 2, "Categoria A", "SubCategoria AS", AS-12", "PB-M", "LL", "NATAL", "RTFM");
bs.addProduto(2323,"Produto B",22, 0, 1, "Categoria B", "SubCategoria BAS", "BAS2", "SS", "", "PAIS", "RTFM");
bs.setEtapaCarrinho();
Quando a pessoa entrar no carrinho ou nas etapas do processo de compra, como por exemplo
a tela de login, ou a tela de cadastro de endereço de entrega.
O track do carrinho será realizado ainda que este método não seja utilizado, contudo a assim
como o método setaPágina ele possibilita a customização das informações coletadas.
Parâmetros:
1. nmEtapa, string, o nome da etapa em que o carrinho se encontra;
2. var21, string, valor customizado;
3. var22, string, valor customizado;
4. var23, string, valor customizado;
5. var24, string, valor customizado;
6. var25. string, valor customizado;
Exemplos:
bs.setEtapaCarrinho("endereco","","","","",""RTMF"");
bs.finalizaCompra();
Termina o processo de compra do carrinho, deve ser colocado na última página do processo de
compra do carrinho.
Parâmetros:
1. ValorTotal, number, o valor total da compra;
2. Frete, number, o valor do frete;
3. dtPrevistaEntrega, number, quantidade de dias previsto para a entrega;
4. metodoDePagamento, string, o método de pagamento, cartão, boleto;
5. banco1, string, banco utilizado para pagar a compra;
5. 6. banco2, string, um segundo banco para pagamento da compra, como por exemplo se
a pessoa utilizou dois cartões para efetuar a compra, caso tenha utilizado apenas um
deixar o segundo em branco;
7. codCompra, string, O código da compra;
8. var21, string, valor customizado;
9. var22, string, valor customizado;
10. var23, string, valor customizado;
11. var24, string, valor customizado;
12. var25, string, valor customizado;
Exemplos:
bs.finalizaCompra(102,23,4,"cartão de
crédito","visa","mastercard","4",234234234,"","","","","RTMF");
bs.finalizaCompra(102,23,4,"cartão de crédito","visa","","4",234234234,"","","","","RTMF");
bs.addProdutoComprado();
Após finalizar a compra, os produtos comprados deverão ser informados com este método,
para que estes sejam vinculádos ao código da compra.
Parâmetros:
1. codCompra, string, o código da compra;
2. idProduto, string, o id do produto;
3. nomeProduto, string, o nome do produto;
4. valorUnitario, number, o valor unitário do produto;
5. desconto, number, o valor de desconto dado ao produto;
6. quantidade, number, a quantidade do produto;
7. categoria, string, a categoria do produto;
8. subCategoria, string, a subcategoria do produto;
9. var21, string, valor customizado;
10. var22, string, valor customizado;
11. var23, string, valor customizado;
12. var24, string, valor customizado;
13. var25, string, valor customizado;
Exemplos:
bs.addProduto(12,"Produto A",234.30, 10, 2, "Categoria A", "SubCategoria AS", AS-12", "PB-M", "LL", "NATAL", "RTFM");
UTMs
6. Os UTMs de origem utilizados pela tag são:
● utm_source, string, fonte da visita;
● utm_medium, string, metodo utilizado na entrega da campanha;
● utm_term, string, palavra chave paga;
● utm_content, string, nome para distinção de links que apontão para a mesma url;
● utm_campaign, nome da campanha;
● utm_uid, string, o ID do usuário;
● utm_var1, string, variável customizada;
● utm_var2, string, variável customizada;
● utm_var3, string, variável customizada;
● utm_var4, string, variável customizada;
● utm_var5, string, variável customizada;
● utm_var6, string, variável customizada;
● utm_var7, string, variável customizada;
● utm_var8, string, variável customizada;
● utm_var9, string, variável customizada;
● utm_var10, string, variável customizada;
Estes UTMs serão associados a todas as páginas visitadas pelo usuário, contudo caso prefira
utilizar outra nomenclatura, basta colocar na váriavel global _bsd["utms"] a nomenclatura que
deseja utilizar em formato de objeto javascript com o nome padrão do utm como nome da
variável e o nome que deseja utilizar como o valor.
Exemplo:
__bsd['utms'] = { "utm_source" : "fonteDeTrafego" };
ou
__bsd['utms'] = new Object();
__bsd['utms']["utm_source"] = "fonteDeTrafego";