- Eventos de mensagem → Mixpanel: Rastreie entrega, cliques, falhas e muito mais em todos os canais.
- Coortes → OneSignal: Sincronize coortes do Mixpanel baseadas em comportamento como filtros de direcionamento no OneSignal.
Requisitos
- Conta Mixpanel
- Plano Pago OneSignal
- Aplicativo OneSignal com External ID definido.
Esta integração não cria Usuários. Ela mapeia os Usuários no Mixpanel para os Usuários existentes no OneSignal por meio de correspondência de identificadores.
Configuração
Adicionar Mixpanel ao OneSignal (Saída)
Envia eventos de mensagem do OneSignal para o seu projeto Mixpanel.- No OneSignal, navegue até Data > Integrations > Mixpanel e clique em Activate.
No Mixpanel
- Encontre seu Project Token e copie-cole no OneSignal.
- Verifique sua Data Residency. Se estiver usando servidores EU do Mixpanel, marque a caixa Send events exclusively to Mixpanel’s EU Residency Server.
Selecionar eventos de mensagem
Selecione quais eventos de mensagem do OneSignal você deseja enviar para o Mixpanel. Quando terminar, clique em Activate.
Adicionar OneSignal ao Mixpanel (Entrada)
Em suas Integrations do Mixpanel, adicione OneSignal.
OneSignal - APP_NAME onde APP_NAME é o nome do aplicativo no OneSignal.
Você precisará dos seguintes dados disponíveis em OneSignal Settings > Keys & IDs:
- App ID
- API Key
Mapeamento de User ID
O External ID no OneSignal deve corresponder a uma Mixpanel User ID Property selecionada (por exemplo,user_id). Verifique se esta propriedade está preenchida em ambos os sistemas — a sincronização de coortes e o rastreamento de eventos dependem de uma correspondência exata.
Clique em Continue quando terminar. Agora você deve poder exportar coortes do Mixpanel para o OneSignal e coletar eventos de mensagem do OneSignal para o Mixpanel.
Exportar coortes do Mixpanel para OneSignal
Sincronize coortes do Mixpanel com o OneSignal usando o External ID correspondente configurado acima. A exportação não cria Usuários — cada Usuário já deve existir no OneSignal.- No Mixpanel, crie um coorte.
- Clique em Options > Export to… > O nome da Conexão OneSignal.
- Escolha a frequência de sincronização e pressione Begin Sync.
Criação de Segmento OneSignal
O coorte sincronizado aparece no OneSignal como um filtro de Segmento Mixpanel. O OneSignal cria automaticamente um Segmento para o coorte se:- Os Usuários no Coorte do Mixpanel também existem no OneSignal com External ID correspondente.
- Você não excedeu seu limite de Segmento no OneSignal.
O Mixpanel requer pelo menos um Usuário correspondente para criar um Segmento no OneSignal. Uma vez que o Segmento é criado, ele permanecerá no OneSignal mesmo se o coorte posteriormente não tiver Usuários. Nesse caso, o Segmento aparece como vazio até que Usuários sejam adicionados novamente.
Rastrear eventos de mensagem no Mixpanel
O OneSignal envia os seguintes eventos de mensagem para o Mixpanel em tempo real. Selecione quais eventos enviar em Data > Integrations > Mixpanel. Para testar, envie uma mensagem para você mesmo do OneSignal e depois navegue até sua página de perfil de usuário no Mixpanel. Dentro do Activity Feed, você deve ver os eventos aparecerem.
Eventos de mensagem
| Tipo de Evento de Mensagem (OneSignal) | Nome do Evento de Mensagem (Mixpanel) | Descrição do Evento |
|---|---|---|
| Push Sent | Message Sent | Notificação push enviada com sucesso |
| Push Received | Message Received | Notificação push recebida com sucesso |
| Push Clicked | App Opened from Push | Notificação push tocada no dispositivo |
| Push Failed | Push Failed | Falha ao enviar push. Verifique o relatório de mensagem com falha no OneSignal |
| Push Unsubscribed | Push Unsubscribed | A Subscription cancelou a inscrição de push |
| In-App Impression | Message Sent | Mensagem in-app exibida com sucesso no dispositivo |
| In-App Clicked | Message Opened | Mensagem in-app clicada no dispositivo |
| In-App Page Displayed | In-App Page Displayed | Página de mensagem in-app é exibida |
| Email Sent | Message Sent | Email enviado com sucesso |
| Email Received | Message Received | Email recebido pelo destinatário |
| Email Opened | Message Opened | Email aberto pelo destinatário |
| Email Link Clicked | App Opened from Push | Link do email clicado |
| Email Unsubscribed | Email Unsubscribed | Email cancelado pelo destinatário |
| Email Reported As Spam | Email Reported as Spam | Email reportado como spam pelo destinatário |
| Email Bounced | Email Bounced | Email devolvido ao remetente devido a erro permanente |
| Email Failed | Email Failed | Não foi possível entregar o email na caixa de entrada do destinatário |
| Email Suppressed | Email Suppressed | O endereço de email está na sua lista de supressão. Ele retornou ou marcou seus emails como spam |
| SMS Sent | Message Sent | SMS enviado ao destinatário |
| SMS Failed | SMS Failed | Falha ao enviar SMS |
| SMS Delivered | Message Received | SMS entregue com sucesso |
| SMS Undelivered | SMS Undelivered | O SMS não pôde ser enviado |
Propriedades de evento
Todos os eventos enviados do OneSignal para o Mixpanel incluem estas propriedades:| NOME DA PROPRIEDADE | DESCRIÇÃO |
|---|---|
| Distinct ID | O external_id associado à 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, in-app, email, SMS |
| template_id | O template de mensagem usado (Mensagens de API e Journey) |
| subscription_id | O identificador de dispositivo/email/sms definido pelo OneSignal |
| 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) |
Eventos personalizados (terceiros)
A integração do Mixpanel não suporta nativamente o envio de eventos personalizados do Mixpanel para o OneSignal. Ao contrário do Amplitude, não há um destino de eventos integrado do Mixpanel para o OneSignal. Se você precisar rotear eventos comportamentais do Mixpanel para o OneSignal como eventos personalizados para acionar Jornadas ou Segmentos, você pode usar um conector de terceiros como o Vendo. O Vendo transmite eventos selecionados do Mixpanel para o OneSignal como eventos personalizados para acionamento de campanhas.FAQ
Por que minhas contagens de coorte e segmento não correspondem?
- External IDs ausentes ou incompatíveis Apenas usuários com um External ID do OneSignal e User ID do Mixpanel correspondentes são incluídos. Esta integração não cria usuários ou subscriptions.
- Usuários desinscritos Os segmentos do OneSignal exibem apenas a contagem de Subscriptions inscritas. Subscriptions desinscritas estão disponíveis para Journeys ou Mensagens In-App.
- Não existir no OneSignal ou ter um External ID incorreto.
- Ter subscriptions desinscritas.
Usuários desinscritos sincronizam do Mixpanel?
Sim, mas eles são excluídos das contagens de segmento do OneSignal neste momento. Você ainda pode enviar mensagens para eles via Journeys ou mensagens in-app se eles tiverem outras Subscriptions ou se o tipo de Subscription suportar isso.Por que os dados de entrega não correspondem?
Um único usuário pode ter múltiplas Subscriptions (dispositivos push, endereços de email, números de telefone). Cada Subscription gera seu próprio evento de entrega. Por exemplo:- 1 usuário = 2 Android + 1 iOS + 2 Web = 5 Subscriptions 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 External ID. - Verifique se
OneSignal.logoutnão está removendo o External ID. - Verifique solicitações de API ou uploads CSV que possam alterar o External ID.
Posso enviar eventos personalizados do Mixpanel para o OneSignal?
Não nativamente. A integração do Mixpanel suporta eventos de mensagem (OneSignal → Mixpanel) e sincronização de coortes (Mixpanel → OneSignal), mas não inclui um destino de eventos personalizados integrado. Para rotear eventos do Mixpanel para o OneSignal como eventos personalizados, use um conector de terceiros como o Vendo.Como posso enviar eventos de usuário/subscription?
Eventos de nível de usuário e subscription (por exemplo, permissão concedida, login/logout de usuário) não são enviados automaticamente. O SDK do OneSignal possui ouvintes de eventos que podem ser usados para rastrear esses eventos para você enviar ao Mixpanel:- User State Observer: Mobile SDK , Web SDK
- Permission Observer: Mobile SDK , Web SDK
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