Mixpanel

Mixpanel é uma ferramenta de análise centrada em eventos que acompanha eventos do usuário em vez de capturar dados automaticamente. Integrar Mixpanel com sua base de conhecimento permite analisar como os leitores interagem com seu conteúdo, quais artigos geram engajamento, onde eles caem e medir a eficácia do seu site.

Document360 suporta Mixpanel como uma de suas muitas integrações de terceiros.

Pré-requisitos antes de integrar Mixpanel com Document360

• Uma conta Mixpanel

• Seu token Mixpanel Project (disponível no Mixpanel em Configurações > Configurações do Projeto > Token do Projeto).

Opções de configuração

Ao integrar Mixpanel com Document360, você pode escolher entre duas opções de configuração:

• Configuração básica: Configuração padrão que monitora automaticamente as visualizações de página após você inserir seu token Mixpanel Project.

• Configuração personalizada: Configuração avançada que requer carregar e inicializar manualmente a biblioteca Mixpanel . Você pode então adicionar um código de rastreamento personalizado para eventos específicos.

Configuração básica

Use a configuração Básica se quiser uma configuração rápida que rastreie automaticamente as visualizações de página com esforço mínimo.

1. Navegue para  Conexões () > Integrações na barra de navegação esquerda do portal da base de conhecimento.

2. Selecione Mixpanel na lista de integrações e clique em Adicionar.

   A janela de Adicionar nova integração vai aparecer.

3. Selecione a opção de configuração Básica .

4. Insira a descrição.

5. Insira seu token Mixpanel Project no campo Mixpanel. Para detalhes sobre onde encontrar seu token do Mixpanel Project, consulte o guia de instalação Mixpanel.

6. Opcionalmente, use o recurso de inclusão/exclusão de código para aplicar o código com base no endereço IP, Workspace ou Language.

7. Clique em Adicionar para salvar sua integração.

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

NOTA

Se quiser acompanhar eventos adicionais (como cliques de botões ou envio de formulários), pode usar a opção Configuração Personalizada.

Configuração personalizada

Use a configuração personalizada para configurar a integração Mixpanel . Essa opção permite adicionar código JavaScript diretamente no painel de configuração e personalizar ainda mais a integração conforme suas necessidades.

1. Navegar até  Conexões () > Integrações na barra de navegação esquerda do portal da Base de Conhecimento.

2. Selecione Mixpanel na lista de integrações e clique em Adicionar. O painel Adicionar nova integração vai aparecer.

3. Selecione a opção Configuração personalizada .

4. Insira a descrição no painel Adicionar nova integração .

5. Cole seu trecho de JavaScript (veja exemplos abaixo).

6. Opcionalmente, use o recurso de inclusão/exclusão de código para aplicar o código com base no endereço IP, Workspace ou Language.

7. Clique em Adicionar para salvar sua integração.

ATENÇÃO

A configuração Customizada não carrega Mixpanel automaticamente. Você deve primeiro incluir a biblioteca Mixpanel e inicializá-la com seu token de projeto Mixpanel.

Exemplo: Carregar e inicializar Mixpanel

Substitua YOUR_PROJECT_TOKEN pelo seu token Mixpanel nas configurações 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>

NOTA

Você pode renomear "Page View" para outro nome de evento, como "Article Viewed" ou "Category Opened", dependendo do que deseja acompanhar.

Exemplo: Rastreamento por clique de botão

Substitua yourButtonId pelo ID real do botão que você quer rastrear e atualize "Button Name" com um selo significativo.

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

NOTA

Por exemplo, se você estiver acompanhando um botão chamado "Assinar", substitua yourButtonId por "subscribeButton" e "Your Button Label" por "Subscribe".

DICA PROFISSIONAL

Os exemplos de código acima mostram apenas os casos de uso mais comuns (visualizações de página e cliques de botões). Se quiser acompanhar outros tipos de eventos personalizados, como envios de formulários, reproduções de vídeo ou profundidade de rolagem, consulte a documentação do SDK JavaScript Mixpanel. Inclui uma lista completa de métodos, propriedades e padrões avançados de acompanhamento de eventos.

Verifique a configuração

Se nenhum dado aparecer no Mixpanel:

• Confirme seu token
  Certifique-se de ter inserido o token Project do Mixpanel (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 (Windows/Linux) ou ⌘+Opção+U (Mac).

  3. Pressione Ctrl+F / ⌘+F e procure por mixpanel.

     • Se você não encontrar, o script de integração 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 ⌘+Opção+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 os eventos são 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 Mixpanel carregue ou envie dados.

DICA PROFISSIONAL

Sempre teste em uma janela incógnita/privada. Isso garante que você esteja carregando os scripts publicados mais recentes e evita problemas causados pelo cache do navegador.

Solução alternativa usando HTML personalizado

Se o script de integração não carregar corretamente, você pode adicionar uma integração personalizada em HTML como solução alternativa.

1. Navegar até  Conexões () > Integrações na barra de navegação à esquerda do portal da Base de Conhecimento.

2. Selecione HTML personalizado na lista de integrações e clique em Adicionar. O painel Adicionar nova integração vai aparecer.

3. Cole o trecho da biblioteca Mixpanel (veja "Carregar e inicializar Mixpanel" acima).

4. Adicione seu código personalizado de rastreamento de eventos.

5. Salve sua integração e teste novamente no Mixpanel.