- 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.- No OneSignal, navegue até Dados > Integrações > Catálogo e selecione Amplitude.
- Clique em Configurações e abra a aba Saída.
- Insira seu token de API do Amplitude, selecione os eventos de mensagem que deseja enviar e clique em Salvar.
No Amplitude
- Encontre sua chave de API do projeto e copie-cole no OneSignal.
- 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.
- Coortes: Sincronizar coortes do Amplitude para o OneSignal.
- Propriedades de Usuário de Eventos: Enviar eventos personalizados do Amplitude para o OneSignal.
Se você planeja usar tanto sincronização de coortes quanto eventos personalizados, adicione ambos os destinos OneSignal. Cada destino é configurado separadamente no Amplitude, então você inserirá suas credenciais OneSignal para cada um.
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.Clique em Salvar quando terminar. Agora você deve conseguir exportar coortes e eventos personalizados do Amplitude para o OneSignal e coletar eventos de mensagens do OneSignal para o Amplitude.
Testando eventos personalizados
- No Destino de Eventos Amplitude > OneSignal, clique no botão Testar Conexão.
- Certifique-se de que o
"user_id"no payload está definido como um ID Externo de Usuário existente em seu Aplicativo OneSignal. - Clique no botão Enviar Evento de Teste.
- A caixa de Resposta deve permanecer vazia e você deve ver
"OneSignal has successfully received test event."
- 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.- No Amplitude, crie uma coorte. Veja documentação do Amplitude sobre coortes.
- Clique em Sincronizar e escolha OneSignal como destino.
- 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.| Tipo de Evento de Mensagem (OneSignal) | Nome do Evento de Mensagem (Amplitude) | Descrição do Evento |
|---|---|---|
| Push Sent | [OneSignal] Push Sent | Notificação push enviada com sucesso. |
| Push Received | [OneSignal] Push Confirmed delivery | Notificação push recebida com sucesso |
| Push Clicked | [OneSignal] Push Clicked | Notificação push tocada no dispositivo |
| Push Failed | [OneSignal] Push Failed | Falha ao enviar push. Verifique o relatório de mensagens com falha no OneSignal. |
| Push Unsubscribed | [OneSignal] Push Unsubscribed | A Assinatura cancelou a inscrição de push. |
| In-App Impression | [OneSignal] IAM Displayed | Mensagem no aplicativo exibida com sucesso no dispositivo |
| In-App Clicked | [OneSignal] IAM Clicked | Mensagem no aplicativo clicada no dispositivo |
| In-App Page Displayed | [OneSignal] IAM Page Displayed | Página da mensagem no aplicativo é exibida |
| Email Sent | [Onesignal] Email Delivered | Email enviado com sucesso |
| Email Received | [OneSignal] Email Confirmed delivery | Email recebido pelo destinatário |
| Email Opened | [OneSignal] Email Opened | Email aberto pelo destinatário |
| Email Link Clicked | [OneSignal] Email Clicked | Link do email clicado |
| Email Unsubscribed | [OneSignal] Email Unsubscribed | Email com cancelamento de inscrição pelo destinatário |
| Email Reported As Spam | [OneSignal] Email Reported As SPAM | Email reportado como spam pelo destinatário |
| Email Bounced | [OneSignal] Email Hard Bounced | Email retornado ao remetente devido a erro permanente |
| Email Failed | [OneSignal] Email Failed delivery | Não foi possível entregar o email na caixa de entrada do destinatário |
| Email Suppressed | [OneSignal] Email Not delivering to suppressed email address | Email não entregue pois o destinatário suprimiu o endereço de email para o qual foi enviado |
| SMS Sent | [OneSignal] SMS Sent | SMS enviado ao destinatário |
| SMS Failed | [OneSignal] SMS Failed delivery | Falha ao enviar SMS |
| SMS Delivered | [OneSignal] SMS Confirmed deliveery | SMS entregue com sucesso |
| SMS Undelivered | [OneSignal] SMS Undelivered | O SMS não pôde ser enviado. |
Propriedades do evento
Cada evento enviado do OneSignal para o Amplitude inclui estas propriedades:| NOME DA PROPRIEDADE | DESCRIÇÃO |
|---|---|
| Distinct ID | O external_id associado com a mensagem |
| Message ID | O identificador da mensagem discreta |
| Message Name | O nome da mensagem |
| Message Title | O título da mensagem |
| Message Contents | O conteúdo da mensagem |
| message_type | O tipo de mensagem enviada: push, no aplicativo, email, SMS |
| template_id | O template de mensagem usado (Mensagens de API e Jornada) |
| subscription_id | O identificador OneSignal de dispositivo/email/sms |
| device_type | O tipo de dispositivo que recebeu a mensagem |
| language | O código de idioma de dois caracteres do dispositivo |
| source | onesignal (é indicado como a fonte para todos os eventos) |
Perguntas Frequentes
Por que as contagens de minha coorte e segmento não correspondem?
- 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.
- 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.
- Não existir no OneSignal ou ter um ID Externo incorreto.
- Ter assinaturas não inscritas.
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
subscription_id nas propriedades do evento para rastrear a fonte exata.
Para solucionar eventos ausentes:
- Certifique-se de que
OneSignal.loginseja chamado sempre que um usuário for identificado para definir o ID Externo. - Verifique se
OneSignal.logoutnã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 umdevice_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
Visão geral de análises
Visão geral das análises do OneSignal, métricas de entrega e rastreamento de eventos.
Eventos personalizados
Rastreie ações do usuário para acionar Jornadas ou potencializar análises.
Need help?Chat with our Support team or email
support@onesignal.comPlease include:- Details of the issue you’re experiencing and steps to reproduce if available
- Your OneSignal App ID
- The External ID or Subscription ID if applicable
- The URL to the message you tested in the OneSignal Dashboard if applicable
- Any relevant logs or error messages