Segmento

Segment é uma poderosa ferramenta de análise que ajuda as equipes de produto e marketing a entender o comportamento dos usuários. Ele permite que as empresas coletem, transformem, enviem e armazenem seus dados de clientes de primeira mão de forma mais eficaz. O segmento simplifica o gerenciamento de dados e facilita conectar os dados dos clientes com outras ferramentas da sua pilha, então você gasta menos tempo na configuração e mais tempo analisando dados significativos.

Integrar o Segment com o Document360 permite que você envie dados de visitantes do banco de conhecimento para o Segment e os encaminhe para qualquer destino de análise ou marketing na sua pilha.

Antes de começar

• Você precisa de uma conta Segment.
• Você precisa da sua Chave de Gravação de Segmento. No Document360, isso é chamado de ID de Segmento. Veja abaixo como encontrar sua Chave de Escrita de Segmento .

Como encontrar sua Chave de Escrita de Segmento

Para integrar o Segment com o Document360, você precisa criar uma fonte no Segment e copiar sua Chave de Escrita.

1. Faça login na sua conta Segment.
2. Navegue até Conexões > Fontes, depois clique em Adicionar fonte.
3. Escolha Javascript como tipo de fonte. Você pode procurá-lo usando a barra de busca no canto superior direito.
4. Na página de código-fonte em Javascript, clique em Adicionar Fonte.
5. Na página de configuração da fonte , insira um Nome para a sua fonte. Você pode opcionalmente adicionar um Rótulo (como dev ou prod) e uma URL de Site. Esses campos são opcionais e usados apenas para identificação.

6. Após criar a fonte, encontre sua Chave de Escrita em qualquer um destes locais:

   • Aba de visão geral: No bloco de código de integração, procure pela linha analytics.load("YOUR_WRITE_KEY"). O valor dentro das aspas é sua Chave de Escrita.
   
   • Aba de configurações: Em chaves API, copie a Chave de Gravação listada lá.
   

7. Use esta Chave de Escrita no Document360 ao configurar a integração do Segmento (no campo ID do Segmento ).

Como integrar o Segment com o Document360

1. No portal Document360, navegue até Conexões () > Integrações () na barra de navegação da esquerda.

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

3. No painel Adicionar nova integração , escolha um tipo de configuração:

   Configuração básica: use isso para conectar rapidamente o Segment com sua base de conhecimento.

   • Descrição (opcional): adicionar um rótulo para identificar a integração.
   • ID de segmento: cole sua Chave de Gravação de Segmento aqui.

   Configuração personalizada: use isso para adicionar código JavaScript personalizado para rastreamento avançado.

   • Descrição (opcional): adicionar um rótulo para identificar a integração.
   • Código: cole o trecho completo do Segmento com sua Chave de Escrita. Você também pode incluir eventos personalizados usando analytics.track() ou analytics.page().

4. Opcionalmente, expanda as condições de inclusão/exclusão do Código para controlar onde a integração com o Segmento se aplica com base no endereço IP, espaço de trabalho ou idioma.

5. Clique em Adicionar para completar a integração.

Verifique a integração

Depois de concluir a integração, siga estes passos para confirmar que o Segment está recebendo dados da sua base de conhecimento do Document360.

1. Abra seu site de base de conhecimento do Document360 em uma nova aba. Isso desencadeia um page evento que o Segmento deve capturar.
2. Em uma aba separada, vá para o seu espaço de trabalho de Segmentos.
3. Navegue até Conexões > Fontes e selecione a fonte que você criou para o Document360.
4. Vá para a aba Depurador .
5. Você deve ver um page evento aparecer no depurador. Se você configurou eventos personalizados como cliques de botões, realize essas ações agora e verifique se os eventos correspondentes aparecem.

Se nenhum evento aparecer no Depurador, verifique o seguinte:

• Write Key está incorreto: verifique se você colou o valor correto no campo Segment ID.
• Erro de JavaScript na página: abra o console do navegador e verifique se há erros que possam estar bloqueando a execução do script.
• Extensão de navegador bloqueando scripts de rastreamento: tente desativar extensões de privacidade como uBlock Origin ou Ghostery e recarregue a página.
• Condições de inclusão/exclusão de código que impedem a execução do script: revise qualquer endereço IP, espaço de trabalho ou filtros de idioma aplicados nas configurações de integração.

Melhores práticas

• Use a configuração básica para rastreamento padrão de visualização de página. Inserir sua Chave de Escrita na configuração Básica é a maneira mais rápida de começar a enviar dados para o Segment. Use a configuração personalizada apenas quando precisar adicionar rastreamento específico de eventos além das visualizações de página.
• Diga claramente a fonte do seu segmento. Use um nome descritivo como "Document360 Production" para facilitar a identificação no seu espaço de trabalho de Segmento quando múltiplas fontes estão conectadas.
• Use o Depurador de Segmentos para verificar eventos após qualquer alteração. Sempre que você atualizar as configurações de integração ou adicionar novos eventos personalizados, verifique a aba Depurador para confirmar se os eventos estão fluindo corretamente.
• Direcione os dados do segmento para seus destinos de análise e marketing. Assim que o Segment estiver recebendo dados do Document360, conecte-o a ferramentas downstream como Amplitude, Mixpanel ou seu CRM para analisar o desempenho da base de conhecimento junto com outros dados do seu produto.
• 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 as visitas da equipe distorçam seus dados analíticos.

FAQ