Amplitude

Integre o OneSignal com Amplitude para habilitar segmentação em tempo real baseada em comportamento em push, no aplicativo, email e SMS. Esta integração no nível do aplicativo suporta três fluxos de dados:

• Eventos de mensagens → Amplitude: Rastreie entrega, cliques, falhas e muito mais para todos os canais.
• Eventos personalizados → OneSignal: Envie eventos do Amplitude para o OneSignal para acionar Jornadas ou Segmentos.
• Coortes → OneSignal: Sincronize coortes do Amplitude baseadas em comportamento como filtros de segmentação no OneSignal.

---

​

Requisitos

• Conta Amplitude
• Plano Pago OneSignal
• Aplicativo OneSignal com Usuários e ID Externo definidos.

---

​

Configuração

​

Adicionar Amplitude ao OneSignal (Saída)

Envia eventos de mensagens do OneSignal para seu projeto Amplitude.

1. No OneSignal, navegue até Dados > Integrações > Catálogo e selecione Amplitude.
2. Clique em Configurações e abra a aba Saída.
3. Insira seu token de API do Amplitude, selecione os eventos de mensagem que deseja enviar e clique em Salvar.

​

No Amplitude

1. Encontre sua chave de API do projeto e copie-cole no OneSignal.
2. Se estiver usando os servidores EU do Amplitude, marque Enviar eventos exclusivamente para o Endpoint de Residência EU do Amplitude. Você pode verificar isso pela sua URL do Amplitude. Se você ver eu.amplitude.com, então está usando os servidores EU do Amplitude.

​

Adicionar OneSignal ao Amplitude (Entrada)

Nos Destinos do Amplitude, procure por OneSignal. O Amplitude fornece dois tipos de destino OneSignal no catálogo:

• Coortes: Sincronizar coortes do Amplitude para o OneSignal.
• Propriedades de Usuário de Eventos: Enviar eventos personalizados do Amplitude para o OneSignal.

​

Mapeamento de User ID

O ID Externo no OneSignal deve corresponder à propriedade de usuário do Amplitude que você selecionar (por exemplo, user_id). Verifique se essa propriedade está preenchida em ambos os sistemas — a sincronização de coortes e o rastreamento de eventos dependem de uma correspondência exata.

​

Propriedades adicionais

Você pode incluir propriedades extras que serão anexadas aos eventos personalizados no OneSignal. Isso é útil para processamento condicional de eventos.

---

​

Testando eventos personalizados

1. No Destino de Eventos Amplitude > OneSignal, clique no botão Testar Conexão.

2. Certifique-se de que o "user_id" no payload está definido como um ID Externo de Usuário existente em seu Aplicativo OneSignal.
3. Clique no botão Enviar Evento de Teste.
4. A caixa de Resposta deve permanecer vazia e você deve ver "OneSignal has successfully received test event."

5. No OneSignal, navegue até Dados > Eventos Personalizados e verifique se o evento de teste aparece na lista.

​

Exportar coortes do Amplitude para o OneSignal

Sincronize coortes do Amplitude para o OneSignal usando o ID Externo correspondente configurado acima. Exportar não cria Usuários — cada Usuário já deve existir no OneSignal.

1. No Amplitude, crie uma coorte. Veja documentação do Amplitude sobre coortes.
2. Clique em Sincronizar e escolha OneSignal como destino.
3. Escolha a frequência de sincronização.

​

Criação de Segmento OneSignal

A coorte sincronizada aparece como um filtro de Segmento do Amplitude. O OneSignal cria automaticamente um Segmento para a coorte se:

• Os Usuários na Coorte do Amplitude também existirem no OneSignal com ID Externo correspondente.
• Você não tiver excedido seu limite de Segmentos no OneSignal.

---

​

Rastrear eventos de mensagens no Amplitude

O OneSignal envia os seguintes eventos de mensagens ao Amplitude em tempo real. Selecione quais eventos enviar em Dados > Integrações > Amplitude > Saída.

​

Propriedades do evento

Cada evento enviado do OneSignal para o Amplitude inclui estas propriedades:

---

​

Perguntas Frequentes

​

Por que as contagens de minha coorte e segmento não correspondem?

1. IDs Externos ausentes ou incompatíveis Apenas usuários com um ID Externo OneSignal e ID de Usuário Amplitude correspondentes são incluídos. Esta integração não cria usuários ou assinaturas.
2. Usuários não inscritos Segmentos OneSignal exibem apenas a contagem de Assinaturas inscritas. Assinaturas não inscritas estão disponíveis para Jornadas ou Mensagens no Aplicativo.

Por exemplo, se uma coorte do Amplitude tem 10 usuários mas o segmento OneSignal mostra 8 Assinaturas, os 2 usuários faltantes podem:

• Não existir no OneSignal ou ter um ID Externo incorreto.
• Ter assinaturas não inscritas.

Para verificar, confira a aba Público > Usuários no OneSignal para ver se os usuários existem e têm assinaturas ativas.

​

Usuários não inscritos sincronizam do Amplitude?

Sim, mas eles são excluídos das contagens de segmento OneSignal no momento. Você ainda pode enviar mensagens para eles via Jornadas ou mensagens no aplicativo se eles tiverem outras Assinaturas ou seu tipo de Assinatura suportar isso.

​

Por que os dados de entrega não correspondem?

Um único usuário pode ter múltiplas Assinaturas (dispositivos push, endereços de email, números de telefone). Cada Assinatura gera seu próprio evento de entrega. Por exemplo:

• 1 usuário = 2 Android + 1 iOS + 2 Web = 5 Assinaturas push
• 1 mensagem push = até 5 eventos enviados/recebidos/clicados

Use o subscription_id nas propriedades do evento para rastrear a fonte exata. Para solucionar eventos ausentes:

• Certifique-se de que OneSignal.login seja chamado sempre que um usuário for identificado para definir o ID Externo.
• Verifique se OneSignal.logout não está removendo o ID Externo.
• Verifique solicitações de API ou uploads CSV que possam alterar o ID Externo.

​

Como podemos enviar eventos de usuário/assinatura?

Eventos de nível de usuário e assinatura (por exemplo, permissão concedida, login/logout do usuário) não são enviados automaticamente. O SDK OneSignal tem ouvintes de eventos que podem ser usados para rastrear esses eventos para você enviar ao Amplitude:

• Observador de Estado do Usuário: SDK Mobile, SDK Web
• Observador de Permissão: SDK Mobile, SDK Web

​

Por que o ID de Assinatura OneSignal é adicionado ao Amplitude como device_id?

O Amplitude espera um device_id para desduplicação. O OneSignal usa subscription_id para isso, que é mapeado automaticamente para device_id. Veja a documentação do Amplitude para mais informações.

---

​

Páginas relacionadas

---