Searching for

Criação e instalação

A criação e instalação de códigos de rastreamento (trackers) é rápida e prática. Em poucos minutos, você já pode enviar eventos personalizados e eventos de visualização de páginas e identificação para acompanhar o comportamento dos seus visitantes e usuários.

Criar um novo tracker no sistema

Como nosso produto permite a criação e uso de diferentes códigos de rastreamento, você precisa criar e gerar um novo código de implementação dentro do sistema:

  1. Acesse Settings > Apps > Tracker
  2. Clique no Botão de Adicionar Botão de Adicionar
  3. Nomeie seu tracker no campo Tracker name
  4. Clique no botão Create para finalizar a criação

Tracker > New Tracker

Após criar o seu código de rastreamento, você terá acesso a três configurações principais do seu tracker: autenticação, código de implementação e opções gerais. São configurações rápidas para que o código funcione da maneira que a sua empresa precisa.

Autenticação e Chaves API

Na aba Auth, você tem acesso às informações de API Key e API Secret, que são as informações de autenticação para acesso via API. A API Key funciona como o nome de usuário e a API Secret como a senha de acesso, recursos de segurança que evitam que outras pessoas se passem por você para capturar os eventos que são gerados e enviados ao sistema.

Se desejar, você pode clicar no ícone Regenerate API Key Regenerate API Key para gerar uma nova chave de API enquanto mantém a API Secret gerada anteriormente. Porém, ao criar uma nova API Key, você precisa reinstalar o código de rastreamento em seu produto, website ou blog, afinal estes estarão instalados usando uma API Key antiga.

Tracker > Your Tracker > Auth

Na opção IP Ignore List, você tem a opção de adicionar uma lista de IPs cujos eventos serão ignorados pelo código de rastreamento. Saiba mais no artigo Ignorar IPs e reset de eventos.

Código de implementação do tracker

A aba Integration Code exibe o código de implementação do seu tracker. Este é o código responsável por receber eventos e enviá-los ao Pipz, estabelecendo uma conexão entre seu website ou produto e o nosso sistema. Ele já vem com sua API Key embutida, então para copiá-lo rapidamente apenas clique no botão Copy to clipboard.

Tracker > Integration Code

Opções gerais

A aba Options reúne as configurações gerais do código de rastreamento.

  • Set Contact Stage On Creation: defina o estágio atribuído ao contato no momento da identificação;
  • Enable chat: ativar o chat online dentro do seu website ou app;
  • Enable secure connections: ativar conexões seguras entre seu website/app e o sistema;

Instalando o código de rastreamento

Como esse código reúne todas as funções do nosso sistema e possibilita a ativação de diversos recursos da nossa plataforma, é importante que você instale-o em todas as páginas que deseja acompanhar as atividades dos seus leads e clientes, exibir notificações in-app e habilitar as conversas em tempo real via chat.

Depois de copiar o código Javascript na aba Integration Code do tracker que você criou insira-o entre as tag's e do código HTML de todas as páginas onde seus usuários terão suas ações rastreadas.

<script>
!function() {
    var a = window.pipz = window.pipz || [];
    if (!a.initialize)
        if (a.invoked) window.console && console.error && console.error('Snippet included twice.');
        else {
            a.invoked = !0;
            a.methods = 'trackSubmit trackClick trackLink trackForm pageview reset identify group track ready alias page once off on'.split(' ');
            a.factory = function(c) {
                return function() {
                    var b = Array.prototype.slice.call(arguments);
                    b.unshift(c);
                    a.push(b);
                    return a
                }
            };
            for (var c = 0; c < a.methods.length; c++) {
                var d = a.methods[c];
                a[d] = a.factory(d)
            }
            a.load = function(c) {
                var b = document.createElement('script');
                b.type = 'text/javascript';
                b.async = !0;
                var d = document.getElementsByTagName('script')[0];
                d.parentNode.insertBefore(b, d);
                b.onload = function() {
                    a = window.pipz;
                    a.initialize({
                        'eCentrack.io': {
                            apiKey: c
                        }
                    }, {
                        plan: {
                            track: {}
                        }
                    });
                };
                b.src = '//app.pipz.io/v3/js/pipz.min.js'
            };
            a.SNIPPET_VERSION = '3.1.0';
            a.load('SUA_API_KEY')
        }
}();
</script>

O código padrão é este, mas é necessário substituir o texto SUA_API_KEY com a API Key que é gerada no momento da criação do tracker. Se você copiar o código do tracker através da plataforma, o mesmo já vem com a API Key corretamente inserida, e não há a necessidade de adicioná-la manualmente.

Seu tracker também possui uma API Secret, uma chave que permite o envio de dados seguros dos seus contatos, gerando um código hash e prevenindo que alguém envie dados e eventos para o sistema se passando por você. Esta API Secret deve ser mantida segura e não deve ser compartilhada com ninguém.