Manual de Integração da TAG de contabilização

292 views

Published on

Manual de integração da TAG.
Allinmedia - BTG360.
Versão A.1.1

Published in: Technology
  • Be the first to comment

  • Be the first to like this

Manual de Integração da TAG de contabilização

  1. 1. Manual de integração da TAG de TrackPara adicionar o track de navegação no site, coloque a tag JavaScript abaixo em todas aspá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, eo "QTDDIAS" pela quantidade de dias que leva para o carrinho expirar, caso o carrinho nãoexpire basta remover o __bsd["expiraCarrinho"]=QTDDIAS;.Track de NavegaçãoO 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 é acategoria e a Categoria é a subcategoria, a subcategoria sempre deverá estar contida nacategoria.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. 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"});ouvar 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, paraidentificar 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 Carrinhobs.addPreProdutoCarrinho();Utilizado quando a pessoa clica em colocar o produto no carrinho, mas ao invés de ir para apágina do carrinho, vai para uma tela com opções do produto, como por exemplo a página deescolha 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 osprodutos que foram abandonados antes de irem para o carrinho.As opções escolhidas nesta página deverão ser tratadas de duas maneiras, quando foremadicionadas 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. 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 umproduto novo este método deve-ser chamado para adicionar os produtos novos, alteração deproduto 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. 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 exemploa 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 assimcomo 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 decompra 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. 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 decré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. 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 prefirautilizar outra nomenclatura, basta colocar na váriavel global _bsd["utms"] a nomenclatura quedeseja utilizar em formato de objeto javascript com o nome padrão do utm como nome davariá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";

×