Integração com a Amplitude

É necessária a ajuda de um desenvolvedor

Você precisará da ajuda da sua equipe de desenvolvimento para configurar a integração. Compartilhe este guia com eles.

A Amplitude, uma robusta plataforma de análise de produtos, capacita as empresas a entender o comportamento do usuário em tempo real, rastrear interações no produto e obter insights valiosos sobre o engajamento, retenção e receita do usuário.

A integração da Amplitude com o Pushwoosh permite que você personalize as campanhas do Pushwoosh com dados da Amplitude, acione campanhas automatizadas com base nas ações do usuário, analise o desempenho para melhoria contínua e, por fim, impulsione o engajamento aprimorado, reduza o churn e aumente a receita.

Visão geral da integração

Tipo de integração

Destino: Os dados são enviados da Amplitude para o Pushwoosh.

Pré-requisitos

Para configurar a integração de Streaming de Eventos e Sincronização de Coortes da Amplitude para o Pushwoosh, certifique-se de que os seguintes pré-requisitos sejam atendidos:

• Você precisa de uma conta ativa no Pushwoosh.
• Gere um Token de Acesso à API no Pushwoosh para enviar dados.
• Localize o Código do seu Aplicativo Pushwoosh antes de configurar a integração.
• Esta integração está disponível apenas para clientes da Amplitude com planos pagos.
• Você deve ter um plano pago do Pushwoosh para usar esta integração.

Glossário (mapeamento de nomes de entidades, se forem diferentes)

Cohorts na Amplitude = Segmentos no Pushwoosh

Entidades sincronizadas

• Eventos
• Tags
• Segmentos

Como funciona a integração?

A Integração da Amplitude com o Pushwoosh opera sincronizando dados entre as duas plataformas para aprimorar o engajamento e a segmentação do usuário. Aqui está um detalhamento de como funciona:

Transmissão de dados

• Eventos: A Amplitude envia dados de eventos para o Pushwoosh. Cada evento contém um ID de usuário (external_id), um código de aplicativo (app_id), um timestamp (created_at) e atributos adicionais (attributes).

• Tags: O Pushwoosh recebe tags que são associadas aos perfis dos usuários. Essas tags são enviadas com um ID de usuário (external_id), um código de aplicativo (app_id) e propriedades da tag (properties).

• Segmentos: Os segmentos são importados de forma semelhante a como o Pushwoosh lida com importações de CSV. Os usuários são adicionados ou removidos dos segmentos por meio de requisições.

Fluxo de dados

• Eventos e Tags: Os dados são enviados da Amplitude para o Pushwoosh com base nas interações ou atributos do usuário rastreados na Amplitude. Eventos e tags são criados ou atualizados no Pushwoosh de acordo com a configuração e os mapeamentos definidos na Amplitude.

• Segmentos: Os segmentos são criados no Pushwoosh quando a Amplitude faz uma requisição. O Pushwoosh gera um identificador único para cada segmento, que a Amplitude usa para manipular o segmento adicionando ou removendo usuários.

Requisições

As requisições são enviadas para endpoints específicos no Pushwoosh para lidar com eventos, atributos de usuário e atualizações de segmento. Cada requisição requer autenticação e tem cabeçalhos e formatos de payload específicos.

Casos de uso

Rastreamento de eventos

Rastreie ações e interações do usuário da Amplitude e envie esses eventos para o Pushwoosh para acionar notificações ou atualizações.

Marcação de usuários

Atribua tags aos usuários com base em seu comportamento ou atributos na Amplitude. Essas tags podem ser usadas no Pushwoosh para mensagens direcionadas ou segmentação.

Gerenciamento de segmentos

Crie e gerencie segmentos de usuários no Pushwoosh com base nos dados e segmentos configurados na Amplitude. Isso ajuda a direcionar grupos específicos de usuários com mensagens personalizadas.

Gerenciamento automatizado de usuários

Adicione ou remova usuários de segmentos automaticamente com base em suas ações ou atributos na Amplitude, garantindo uma segmentação atualizada no Pushwoosh.

Configurando a integração

Sincronização de coortes

Configuração no Pushwoosh

1. No Pushwoosh, navegue para Settings > Integrations.

2. Clique em Add Integration, em seguida, encontre e adicione Amplitude.

   

3. Copie a Chave de API e o Código do Aplicativo do Pushwoosh para a sua área de transferência.

Configuração na Amplitude

Para configurar a Amplitude para integração, siga estes passos:

1. Nos seus Dados da Amplitude, vá para o Catálogo e selecione Destinos.
2. Na seção Coorte, localize e clique em Pushwoosh.

3. Clique em Adicionar outro destino.

4. Forneça um nome e cole a chave de API que você copiou do Pushwoosh.

5. Mapeie o campo de ID do Usuário da Amplitude para o campo de ID do Usuário do Pushwoosh.
6. Salve suas configurações quando terminar.

Enviando uma coorte

Para sincronizar sua primeira coorte, complete os seguintes passos:

1. Na Amplitude, abra a coorte que você deseja sincronizar e clique em Sincronizar.

2. Escolha Pushwoosh e selecione a conta com a qual você deseja sincronizar. Em seguida, clique em Próximo.

3. Decida a cadência de sincronização e salve suas configurações.

Streaming de eventos

Configuração no Pushwoosh

1. Obtenha sua Chave de API do Pushwoosh

2. Localize o Código do Aplicativo em sua conta Pushwoosh.

Configuração na Amplitude

1. Na Amplitude, vá para Destinos de Dados e encontre Pushwoosh - Event Stream.

2. Insira um nome para a sincronização e clique em Criar Sincronização.

3. Altere o Status de Desabilitado para Habilitado e cole seu Token de Acesso à API do Pushwoosh e o Código do Aplicativo.

4. No menu suspenso à esquerda, selecione a propriedade de usuário da Amplitude que corresponde ao seu UserID do Pushwoosh.
5. (Opcional) Habilite a opção Criar e Atualizar usuários se desejar enviar usuários e suas propriedades em tempo real sempre que a Amplitude criar ou atualizar uma propriedade de usuário.

6. Habilite Enviar Eventos (“Eventos são enviados para o Pushwoosh”) se desejar transmitir eventos para o Pushwoosh. Isso encaminhará automaticamente os eventos para o Pushwoosh à medida que são ingeridos na Amplitude. Os eventos não são enviados em um cronograma ou sob demanda usando esta integração.

8. Em seguida, escolha quais eventos você deseja enviar na seção Selecionar e Filtrar Eventos. Selecione apenas os eventos que você precisa no Pushwoosh; eventos transformados não são suportados.
9. Quando terminar, habilite o destino e clique em Salvar.

Como saber se a integração está funcionando?

Para verificar se a integração da Amplitude e do Pushwoosh está funcionando corretamente, você pode usar os seguintes métodos:

Monitore o painel do Pushwoosh

• Eventos e Tags: Verifique o painel do Pushwoosh para ver se os eventos e tags enviados da Amplitude aparecem como esperado. Procure por atividades recentes ou atualizações relacionadas aos seus eventos e tags.
• Segmentos: Verifique se os segmentos estão sendo criados, atualizados ou modificados com base nos dados da Amplitude. Certifique-se de que as contagens de usuários e as associações de segmentos reflitam as alterações esperadas.

Verifique as respostas da API

• Respostas bem-sucedidas: Certifique-se de receber respostas 200 OK dos endpoints da API do Pushwoosh. Embora nem sempre haja um corpo de resposta, o status 200 OK indica que a requisição foi recebida com sucesso.
• Respostas de erro: Revise quaisquer respostas de erro ou códigos de status diferentes de 200 OK para obter pistas se algo não estiver funcionando. Erros comuns podem incluir 400 Bad Request, 401 Unauthorized ou 500 Internal Server Error.

Registre requisições e respostas

• Logs de requisições: Mantenha logs das requisições de saída da Amplitude e das respostas de entrada do Pushwoosh. Verifique esses logs para garantir que as requisições estejam formatadas corretamente e que as respostas sejam as esperadas.
• Registro de erros: Implemente o registro de erros para capturar quaisquer problemas durante a transferência de dados ou processos de integração.

Teste com dados de amostra

• Envie Eventos/Tags de teste: Crie e envie eventos e tags de teste da Amplitude para o Pushwoosh. Verifique se essas entradas de teste aparecem corretamente no Pushwoosh e acionam os comportamentos esperados.
• Simule ações do usuário: Realize ações na Amplitude que devem acionar eventos ou atualizações específicas no Pushwoosh. Verifique se essas ações resultam nas alterações esperadas no Pushwoosh.

Use ferramentas de monitoramento

• Monitoramento da integração: Utilize ferramentas ou serviços de monitoramento que possam rastrear a saúde e o desempenho da integração. Essas ferramentas podem alertá-lo sobre problemas ou falhas em tempo real.
• Análise e relatórios: Use os recursos de análise em ambas as plataformas, Amplitude e Pushwoosh, para revisar o fluxo de dados e o desempenho da integração.

Revise a documentação da integração

• Revisão da configuração: Verifique novamente a configuração da integração tanto na Amplitude quanto no Pushwoosh para garantir que todas as configurações e mapeamentos estejam aplicados corretamente.
• Atualizações da documentação: Mantenha-se atualizado com quaisquer alterações ou atualizações na documentação da integração que possam afetar a funcionalidade.

Entre em contato com o suporte

Se você encontrar problemas persistentes ou inconsistências, entre em contato com as equipes de suporte da Amplitude ou do Pushwoosh para obter assistência. Forneça a eles detalhes da configuração da integração e quaisquer logs de erro para uma resolução mais rápida.

Solução de problemas

Problemas de integração

• Evento não aparece no Pushwoosh: Certifique-se de que o evento está mapeado corretamente e verifique se o código do aplicativo Pushwoosh e o token da API estão configurados adequadamente.

• Tags não sincronizando: Confirme que as tags estão formatadas corretamente e que todos os detalhes de autenticação necessários estão incluídos na requisição.

Problemas com segmentos

• Segmento não criado: Verifique se a requisição para criar o segmento está formatada corretamente e se o token da API do Pushwoosh é válido.

• Usuários não adicionados/removidos: Verifique se os IDs dos usuários estão especificados corretamente e se o ID do segmento é válido. Certifique-se de que o payload da requisição esteja formatado adequadamente.

Problemas com respostas

• Sem corpo de resposta: Se você receber uma resposta 200 OK mas nenhum corpo de resposta, verifique se a requisição foi formatada corretamente e se os dados foram enviados corretamente.

FAQ

O que devo fazer se receber um erro 400 Bad Request?

Revise o payload da requisição em busca de erros de formatação ou campos ausentes. Certifique-se de que todos os campos obrigatórios estão incluídos e formatados corretamente.

Como posso verificar se a integração está funcionando?

Verifique o painel do Pushwoosh para eventos, tags e atualizações de segmentos recebidos. Você também pode monitorar logs ou respostas dos endpoints da API para transferências de dados bem-sucedidas.

Posso personalizar os eventos ou tags enviados para o Pushwoosh?

Sim, você pode personalizar eventos e tags na configuração da Amplitude. Certifique-se de que os dados sigam o formato esperado pelo Pushwoosh.

Com que frequência os dados são sincronizados entre a Amplitude e o Pushwoosh?

Os dados são sincronizados em tempo real ou quase em tempo real com base nas requisições feitas pela Amplitude. Certifique-se de que sua configuração suporte a frequência de atualização desejada.

Onde posso encontrar mais informações ou suporte para esta integração?

Consulte a documentação oficial da Amplitude e do Pushwoosh. Para obter mais assistência, entre em contato com as respectivas equipes de suporte.