Visão geral

Este artigo explica como o UserGuiding se integra ao Mixpanel, uma plataforma que ajuda você a analisar dados de usuários em tempo real para identificar tendências e entender o comportamento do usuário.

Ao ativar a integração com o Mixpanel, você pode analisar e direcionar com mais profundidade a experiência de integração do usuário criada com o UserGuiding.

Ao configurar funis de integração, ativação e retenção no Mixpanel, você também pode testar e ajustar seus Guias para essas métricas.

A integração funciona em duas direções. O UserGuiding, como fonte, envia eventos do UserGuiding para o Mixpanel. O UserGuiding, como destino, sincroniza as coortes do Mixpanel com o UserGuiding como segmentos.

UserGuiding como fonte: Envio de eventos do UserGuiding para o Mixpanel

Você pode começar acessando sua conta do Mixpanel e navegando até o projeto no qual deseja que seus eventos do UserGuiding sejam transmitidos.

Em seguida, acesse as 'Configurações do Projeto' através do menu mostrado abaixo.

Na seção 'Chaves de Acesso', você encontrará o seu 'Token do Projeto' e poderá copiá-lo.

Em seguida, faça login na sua conta UserGuiding, acesse a guia Integrações em Configurações e clique em Ativar para Mixpanel.

Na janela pop-up que se abrir, cole a sua 'Chave do Projeto' do Mixpanel que você copiou. Se os dados do seu projeto do Mixpanel estiverem em servidores da UE, você deve selecionar a opção 'Residência de Dados na UE'. Caso contrário, use 'Servidor Padrão' e clique em 'Salvar'.

Está tudo pronto! O UserGuiding começará imediatamente a enviar os dados de engajamento do material de integração para cada usuário à sua conta Mixpanel.

Rastreamento de eventos

Após a ativação, você encontrará os dados do UserGuiding como eventos personalizados no Mixpanel, prontos para serem usados em qualquer gráfico, relatório ou funil do Mixpanel.

Para verificar o desempenho de um determinado usuário com o material de integração do UserGuiding, acesse Usuários > Explorar > Usuário X > e examine os dados do evento no Feed de Atividades.

Formato do evento

 <EVENT_NAME>
 <EVENT_PROPERTIES>

Exemplo de evento

 banner button click (userguiding)
 bannerId: 36
 bannerName: Banner Name
 buttonId: 0910f959-f611-4f42-9337-3964d7f9e005
 ctaText: Explore Now
 userId: USER-ID
 pageUrl: https://panel.userguiding.com/dashboard

Encontre a lista de todos os eventos que o UserGuiding emite para as ferramentas integradas neste artigo .

UserGuiding como destino: Sincronizando grupos do Mixpanel com o UserGuiding

Você também pode enviar grupos do Mixpanel para o UserGuiding. Cada grupo sincronizado se torna um segmento do UserGuiding que você pode usar para criar Guias, Pesquisas, Listas de Verificação e outros materiais. A participação é atualizada automaticamente conforme o grupo muda no Mixpanel.

Antes de começar: Seu plano UserGuiding deve incluir integrações de entrada. A identificação de usuários deve estar habilitada em seu projeto UserGuiding e o distinct_id do Mixpanel de seus usuários deve ter o mesmo valor que o ID do usuário enviado ao UserGuiding. Se o distinct_id de um membro da coorte não corresponder a nenhum usuário existente no UserGuiding, um novo usuário com esse ID será criado no UserGuiding e adicionado ao segmento. A sincronização de coortes via Webhook personalizado é um recurso do Mixpanel disponível nos planos pagos.

Passo 1: Obtenha o URL de destino e as credenciais do UserGuiding.

Acesse Configurações > Integrações > Mixpanel e abra a aba "UserGuiding como Destino". Ative a opção. Você verá uma URL de destino, um nome de usuário para autenticação básica e um segredo para autenticação básica. Mantenha esta aba aberta, pois você colará essas informações no Mixpanel em seguida.

Etapa 2: Crie um destino de webhook personalizado no Mixpanel

No Mixpanel, acesse Dados > Destinos, clique em "Adicionar Destino" e escolha Webhook Personalizado. Dê um nome ao destino (por exemplo, "UserGuiding"), cole a URL do destino do UserGuiding como URL e insira o Nome de Usuário da Autenticação Básica como Nome de Usuário e o Segredo da Autenticação Básica como Senha. Em "Propriedades a Exportar", adicione quaisquer propriedades de perfil do Mixpanel que você queira gravar para seus usuários do UserGuiding como atributos (por exemplo, $email , $name , $city ). Salve o destino. A guia Configuração do destino exibirá esses valores posteriormente, e você poderá alterar as propriedades exportadas lá.

Etapa 3: Adicione sincronizações de coorte ao destino

Abra o destino, acesse a aba "Sincronizações" e clique em "Adicionar Sincronização de Coorte". Selecione a coorte que deseja sincronizar com o UserGuiding e escolha "Recorrente" como frequência para que as alterações de membros sejam atualizadas continuamente. Repita o processo para cada coorte; um único destino pode armazenar até 60 sincronizações de coorte recorrentes. A aba "Sincronizações" lista cada coorte com a data e hora da última exportação, a quantidade de perfis exportados e o status.

O que acontece no UserGuiding?

Um novo segmento com o nome da coorte aparece em Segmentos, tendo o Mixpanel como fonte. Os usuários da coorte que já existem no UserGuiding são adicionados ao segmento. Os usuários que o UserGuiding ainda não viu são criados com o Mixpanel como fonte e adicionados ao segmento, para que sejam impactados assim que aparecerem no seu produto. Perfis anônimos do Mixpanel (aqueles com um ID distinto $device: `) não podem ser associados a um usuário do UserGuiding e são ignorados. O controle deslizante mostra quantos membros da última sincronização não puderam ser associados.

Propriedades exportadas como atributos de usuário

Os campos de email , first_name e last_name do Mixpanel , bem como as propriedades listadas em "Propriedades para Exportar" no destino, são salvos como atributos de usuário do UserGuiding. O cifrão ( $ inicial é removido e os pontos são substituídos por __ (por exemplo, $city torna-se city e plan.tier torna-se plan__tier ). Por padrão, esses atributos são gravados apenas para os usuários criados pela sincronização. Ative a opção "Gravar também essas propriedades em usuários existentes" no controle deslizante se desejar que os valores do Mixpanel sobrescrevam os mesmos atributos em usuários que já existem no UserGuiding.

Regenerando o segredo

Clique em "Regenerar Segredo" (Regenerate Secret) no controle deslizante se o segredo estiver exposto. O segredo anterior para de funcionar imediatamente, portanto, atualize a Senha no destino Webhook Personalizado no Mixpanel com o novo segredo logo em seguida.