Mixpanel

Mixpanel é uma ferramenta de análise centrada em eventos que acompanha eventos do usuário em vez de capturar dados automaticamente. Integrar o Mixpanel com sua base de conhecimento do Document360 permite que você analise como os leitores interagem com seu conteúdo, quais artigos geram engajamento, onde eles se deslocam e quão eficaz é seu site no geral.

Antes de começar

• Você precisa de uma conta no Mixpanel.
• Você precisa do seu token Mixpanel Project, disponível no Mixpanel em Configurações > Configurações do Projeto > Token do Projeto.

Opções de configuração

Ao adicionar a integração com o Mixpanel, você pode escolher entre dois tipos de configuração:

• Configuração básica: configuração padrão que rastreia automaticamente as visualizações de página após você inserir seu token do Mixpanel Project. Use isso para uma montagem rápida com esforço mínimo.
• Configuração personalizada: configuração avançada que exige carregar e inicializar manualmente a biblioteca do Mixpanel. Use isso quando quiser acompanhar eventos específicos além das visualizações de página, como cliques de botões ou envio de formulários.

Como configurar o Mixpanel

Configuração básica

1. No portal Document360, navegue até Conexões () > Integrações () na barra de navegação da esquerda.
2. Selecione Mixpanel na lista de integrações e clique em Adicionar. A janela de Adicionar nova integração aparece.
3. Selecione a opção de configuração Básica .
4. Insira uma Descrição para essa integração.
5. Insira seu token do Mixpanel Project no campo ID do Mixpanel . Para detalhes sobre onde encontrar seu token, consulte o guia de instalação do Mixpanel.
6. Opcionalmente, expanda as condições de inclusão/exclusão do código para aplicar o código com base no endereço IP, Workspace ou Linguagem.
7. Clique em Adicionar.

Sua base de conhecimento agora enviará dados de visualização de página para o Mixpanel.

Configuração personalizada

Use a configuração personalizada para configurar uma integração avançada com o Mixpanel. Essa opção permite adicionar código JavaScript diretamente no painel de configuração e personalizar o acompanhamento de eventos conforme suas necessidades.

1. No portal Document360, navegue até Conexões () > Integrações () na barra de navegação esquerda.
2. Selecione Mixpanel na lista de integrações e clique em Adicionar. O painel Adicionar nova integração aparece.
3. Selecione a opção Configuração personalizada .
4. Insira uma Descrição para essa integração.
5. Cole seu trecho de JavaScript no campo de código. Veja os exemplos abaixo.
6. Opcionalmente, expanda as condições de inclusão/exclusão do código para aplicar o código com base no endereço IP, Workspace ou Linguagem.
7. Clique em Adicionar.

Exemplo: Carregar e inicializar o Mixpanel

Substitua YOUR_PROJECT_TOKEN pelo seu token real do Projeto Mixpanel nas configurações do Projeto do Mixpanel.

<script>
(function(f,b){
  if(!b.__SV){
    var e,g,i,h;window.mixpanel=b;b._i=[];
    b.init=function(e,f,c){function g(a,d){var b=d.split(".");
      2==b.length&&(a=a[b[0]],d=b[1]);
      a[d]=function(){a.push([d].concat(Array.prototype.slice.call(arguments,0)))}}
      var a=b;"undefined"!==typeof c?a=b[c]=[]:c="mixpanel";
      a.people=a.people||[];a.toString=function(a){var d="mixpanel";
      "mixpanel"!==c&&(d+="."+c);a||(d+=" (stub)");return d};
      a.people.toString=function(){return a.toString(1)+".people (stub)"};
      i="disable time_event track track_pageview track_links track_forms track_with_groups add_group set_group remove_group register register_once alias unregister identify name_tag set set_once union unset toString reset opt_in_tracking opt_out_tracking has_opted_in_tracking has_opted_out_tracking clear_opt_in_out_tracking get_group".split(" ");
      for(h=0;h<i.length;h++)g(a,i[h]);
      b._i.push([e,f,c])
    };
    b.__SV=1.2;
    e=f.createElement("script");
    e.type="text/javascript";e.async=!0;
    e.src="https://cdn.mxpnl.com/libs/mixpanel-2-latest.min.js";
    g=f.getElementsByTagName("script")[0];
    g.parentNode.insertBefore(e,g)
  }
})(document, window.mixpanel || []);
mixpanel.init("YOUR_PROJECT_TOKEN");
</script>

Exemplo: rastreamento de visualização de página

<script>
mixpanel.track("Page View", {
  "Page URL": window.location.href,
  "Page Title": document.title,
  "Referrer": document.referrer || ""
});
</script>

Exemplo: Rastreamento por clique de botão

Substitua yourButtonId pelo ID real do botão que você quer rastrear e atualize "Your Button Label" com um selo significativo. Por exemplo, se você está acompanhando um botão chamado "Assinar", use "subscribeButton" e "Subscribe".

<script>
document.getElementById("yourButtonId")
  .addEventListener("click", function() {
    mixpanel.track("Button Click", {
      "Button Name": "Your Button Label",
      "Page URL": window.location.href
    });
  });
</script>

Verifique a configuração

Se nenhum dado aparecer no Mixpanel após a configuração, faça as seguintes verificações:

Confirme seu token

Certifique-se de ter inserido o token do Project do Mixpanel e não o ID do Projeto ou o segredo da API.

Verifique a fonte da página

1. Abra seu site de base de conhecimento em um navegador.
2. Clique com o botão direito em qualquer lugar da página e selecione Ver fonte da página (atalho: Ctrl + U no Windows/Linux, ⌘+ Option+ U no Mac).
3. Pressione Ctrl + F / ⌘ + F e procure por mixpanel. Se você não encontrar, o script de integração do Mixpanel não foi injetado.

Verifique a aba Rede

1. Abra seu site de base de conhecimento em um navegador.
2. Pressione F12 (Windows/Linux) ou ⌘ + Option + I (Mac) para abrir as Ferramentas de Desenvolvedor.
3. Vá para a aba Rede .
4. Na caixa do filtro, digite api.mixpanel.com.
5. Recarregue a página ou realize uma ação, como visualizar um artigo. Se você vir solicitações para api.mixpanel.com, eventos estão sendo enviados. Se não aparecerem solicitações, a biblioteca Mixpanel não está carregando ou eventos estão sendo bloqueados.

Descarte bloqueadores

Verifique se há bloqueadores de anúncios, banners de consentimento de cookies ou Políticas de Segurança de Conteúdo (CSP) restritivas. Esses podem impedir que o Mixpanel carregue ou envie dados.

Solução alternativa usando HTML personalizado

Se o script de integração do Mixpanel não carregar corretamente pela integração nativa, você pode adicioná-lo como uma integração HTML personalizada.

1. No portal Document360, navegue até Conexões () > Integrações () na barra de navegação à esquerda.
2. Selecione HTML personalizado na lista de integrações e clique em Adicionar. O painel Adicionar nova integração aparece.
3. Cole o trecho da biblioteca do Mixpanel (veja "Carregar e inicializar o Mixpanel" acima).
4. Adicione seu código personalizado de rastreamento de eventos abaixo do trecho de inicialização.
5. Clique em Adicionar e teste novamente no Mixpanel.

Melhores práticas

• Use a configuração básica, a menos que precise de rastreamento de eventos personalizado. Para a maioria das bases de conhecimento, inserir o token do Projeto na configuração Básica é suficiente para começar a acompanhar as visualizações de página.
• Sempre inicialize a biblioteca do Mixpanel antes de chamar as funções de rastreamento. Na configuração personalizada, cole primeiro o trecho completo de inicialização da biblioteca e depois adicione seu código de rastreamento de eventos abaixo.
• Teste em uma janela incógnita após salvar. O cache do navegador pode fazer scripts obsoletos rodarem, o que faz parecer que as mudanças não tiveram efeito.
• Use condições de inclusão/exclusão de código para excluir o tráfego interno. Adicione o endereço IP do seu escritório como uma exclusão para evitar que visitas de equipe distorçam seus dados de análise.
• Renomeie os eventos para combinar com sua convenção de nomes. Os nomes dos eventos do Mixpanel são sensíveis a maiúsculas minúsculas e aparecem como estão no seu painel. Use nomes consistentes e descritivos como "Article Viewed" em vez de "Page View" para facilitar a leitura dos seus dados.

FAQ