> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mixpanel

> Integre o OneSignal com o Mixpanel para sincronizar coortes comportamentais, rastrear eventos de mensagem e direcionar Usuários nos canais push, email, SMS e in-app.

Integre o OneSignal com o [Mixpanel](https://mixpanel.com) para habilitar o direcionamento em tempo real baseado em comportamento em push, in-app, email e SMS. Esta integração em nível de aplicativo suporta dois fluxos de dados:

* **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.

<Warning>
  O Mixpanel atualmente não envia [Eventos Personalizados](./custom-events) para o OneSignal. Se você precisar rotear eventos do Mixpanel para o OneSignal, use um conector de terceiros como o [Vendo](https://www.vendodata.com/use-cases/integrate-mixpanel-with-onesignal).
</Warning>

***

## Requisitos

* [Conta Mixpanel](https://mixpanel.com/)
* [Plano Pago OneSignal](https://onesignal.com/pricing)
* Aplicativo OneSignal com External ID definido.

<Info>
  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.
</Info>

***

## Configuração

### Adicionar Mixpanel ao OneSignal (Saída)

Envia eventos de mensagem do OneSignal para o seu projeto Mixpanel.

1. No OneSignal, navegue até **Data > Integrations > Mixpanel** e clique em **Activate**.

<Frame caption="Habilitar integração Mixpanel no OneSignal">
  <img src="https://mintcdn.com/onesignal/Xl2NHJvxakrK4JbL/images/docs/f5dfbab5a6c41ae816e34401b7fa5a8624e15d43f90ad723c4c7b2166dbd66de-Screenshot_2025-03-18_at_8.15.13_AM.png?fit=max&auto=format&n=Xl2NHJvxakrK4JbL&q=85&s=4c5a9ba2e4e2a2c8b2e2b2b2376253f1" alt="OneSignal Integrations page with Mixpanel selected" width="1150" height="458" data-path="images/docs/f5dfbab5a6c41ae816e34401b7fa5a8624e15d43f90ad723c4c7b2166dbd66de-Screenshot_2025-03-18_at_8.15.13_AM.png" />
</Frame>

#### No Mixpanel

1. Encontre seu [Project Token](https://docs.mixpanel.com/docs/orgs-and-projects/managing-projects#find-your-project-tokens) e copie-cole no OneSignal.
2. Verifique sua [Data Residency](https://docs.mixpanel.com/docs/orgs-and-projects/managing-projects#project-details). 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**.

<Frame caption="Configurações do Mixpanel no OneSignal">
  <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/bc980ae-Screenshot_2024-06-04_at_10.18.59_AM.png?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=b98514269a60a2144c1dc0334969e7d3" alt="OneSignal Mixpanel integration settings showing event selection" width="2216" height="1412" data-path="images/docs/bc980ae-Screenshot_2024-06-04_at_10.18.59_AM.png" />
</Frame>

### Adicionar OneSignal ao Mixpanel (Entrada)

Em suas **Integrations** do Mixpanel, adicione OneSignal.

<Frame caption="Adicionar Integração OneSignal no Mixpanel">
  <img src="https://mintcdn.com/onesignal/KSCNwSpBCNSQ8xdF/images/docs/mixpanel-integration.png?fit=max&auto=format&n=KSCNwSpBCNSQ8xdF&q=85&s=b4e6bc1f405b2087b455b2942ce5aecd" alt="Mixpanel integrations catalog with OneSignal selected" width="2986" height="1300" data-path="images/docs/mixpanel-integration.png" />
</Frame>

Defina o **Connector Name** como algo identificável como `OneSignal - APP_NAME` onde `APP_NAME` é o nome do aplicativo no OneSignal.

Você precisará dos seguintes dados disponíveis em OneSignal **Settings > [Keys & IDs](./keys-and-ids)**:

1. App ID
2. API Key

### Mapeamento de User ID

<Warning>
  Este passo é essencial para que a sincronização de coortes e rastreamento de eventos funcionem corretamente.
</Warning>

O **[External ID](./users)** 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.

<Frame caption="Painel do Mixpanel para definir as propriedades do OneSignal">
  <img src="https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/b5e818708efcc73ea8eb0cccb6542c205069b395978b8fa796af28d816b33356-Screenshot_2025-03-18_at_11.22.54_AM.png?fit=max&auto=format&n=56ctKxZSV4m5VEkn&q=85&s=c161191d039f187a20df7201d9ca71db" alt="Mixpanel OneSignal connector settings showing User ID property selection" width="864" height="900" data-path="images/docs/b5e818708efcc73ea8eb0cccb6542c205069b395978b8fa796af28d816b33356-Screenshot_2025-03-18_at_11.22.54_AM.png" />
</Frame>

Verifique se a **User ID Property** que você selecionou está disponível nas propriedades de perfil de usuário do Mixpanel.

<Frame caption="Mixpanel > Users > User Profile Properties">
  <img src="https://mintcdn.com/onesignal/YOTSrtBSoqdrJ37A/images/docs/4416681-small-Screenshot_2023-05-15_at_9.54.14_AM.png?fit=max&auto=format&n=YOTSrtBSoqdrJ37A&q=85&s=e89ad019a61077ae376fc92e1a1eb87a" alt="Mixpanel user profile properties list" width="521" height="1024" data-path="images/docs/4416681-small-Screenshot_2023-05-15_at_9.54.14_AM.png" />
</Frame>

O mesmo valor no Mixpanel para a propriedade de perfil de usuário deve corresponder ao External ID no OneSignal.

<Frame caption="OneSignal > Audience > Users > External ID">
  <img src="https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/e6853b59781b29ccbd264f97925830986605ec5514d02b5435c27ec896804a89-Screenshot_2025-03-18_at_10.22.25_AM.png?fit=max&auto=format&n=Z6xkXGfmy814If53&q=85&s=9a0b4237233c0492901853d72a6b1b63" alt="OneSignal user profile showing External ID" width="2764" height="686" data-path="images/docs/e6853b59781b29ccbd264f97925830986605ec5514d02b5435c27ec896804a89-Screenshot_2025-03-18_at_10.22.25_AM.png" />
</Frame>

<Warning>
  Se você corresponder Usuários ao OneSignal com base no `$distinct_id` do Mixpanel, apenas o valor superior será correspondido.

  No exemplo abaixo, apenas `890ea9b1-9024-4fb9-a92f-152ba67dd21a` funcionará. Não é possível corresponder a `109768518080488203109` ou `$device:1880c06821f1b3-052354675cde95-1d525634-1fa400-1880c06821f1b3`.
</Warning>

<Frame caption="Use cautela ao definir Distinct ID se usado para mapeamento de User ID Property">
  <img src="https://mintcdn.com/onesignal/Xl2NHJvxakrK4JbL/images/docs/e7b80eb-small-Screenshot_2023-05-15_at_10.07.10_AM.png?fit=max&auto=format&n=Xl2NHJvxakrK4JbL&q=85&s=ef1999c6f01a48063d98e7e2ea330052" alt="Mixpanel Distinct ID example showing multiple values" width="464" height="314" data-path="images/docs/e7b80eb-small-Screenshot_2023-05-15_at_10.07.10_AM.png" />
</Frame>

<Check>
  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.
</Check>

***

## 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.

1. No Mixpanel, crie um coorte.
2. Clique em **Options > Export to... > *O nome da Conexão OneSignal***.

<Frame caption="Como exportar um coorte do Mixpanel para o OneSignal">
  <img src="https://mintcdn.com/onesignal/tNi1OgLc_p9hiq7_/images/docs/187698db55979af5f5c94d672ada1e0c8d7329d600a650e3115b77077ef99237-Screenshot_2025-03-18_at_12.04.16_PM.png?fit=max&auto=format&n=tNi1OgLc_p9hiq7_&q=85&s=fce16e4cde30d69f3b24a947cf71c937" alt="Mixpanel cohort export menu with OneSignal destination" width="2432" height="1008" data-path="images/docs/187698db55979af5f5c94d672ada1e0c8d7329d600a650e3115b77077ef99237-Screenshot_2025-03-18_at_12.04.16_PM.png" />
</Frame>

3. Escolha a frequência de sincronização e pressione **Begin Sync**.

<Frame caption="Opções de frequência do Mixpanel">
  <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/c6b36cedac01d722acaa4240225ea6d10519458682f4c2844d681b8ee34b236e-Screenshot_2025-03-18_at_12.12.06_PM.png?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=5bb3a035bfb3bea7d78553e86ccb943b" alt="Mixpanel cohort sync frequency selection dialog" width="860" height="896" data-path="images/docs/c6b36cedac01d722acaa4240225ea6d10519458682f4c2844d681b8ee34b236e-Screenshot_2025-03-18_at_12.12.06_PM.png" />
</Frame>

### 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.

<Note>
  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.
</Note>

<Frame caption="Criando um Segmento a partir de um Coorte do Mixpanel">
  <img src="https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7b01785ad5a5f85377bdb20e664e5d5c38280cff56373d70726621569668907d-Screenshot_2025-03-18_at_12.38.47_PM.png?fit=max&auto=format&n=jBdBk5XvQR5eKOks&q=85&s=3ba94cf6588a4158a86e77c4a23c3e34" alt="OneSignal Segment builder using Mixpanel Cohort filter" width="1444" height="818" data-path="images/docs/7b01785ad5a5f85377bdb20e664e5d5c38280cff56373d70726621569668907d-Screenshot_2025-03-18_at_12.38.47_PM.png" />
</Frame>

***

## 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.

<Frame caption="Feed de atividade do Mixpanel com eventos de mensagem do OneSignal">
  <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/c344970fd85bda82f9b6bedf1700a9cbb91afd63afc9fe1e866c42e1b380770e-Screenshot_2025-03-18_at_1.59.23_PM.png?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=9ca542f553f6c08a15ca99d52d68be2b" alt="Mixpanel user activity feed showing OneSignal message events" width="2420" height="1654" data-path="images/docs/c344970fd85bda82f9b6bedf1700a9cbb91afd63afc9fe1e866c42e1b380770e-Screenshot_2025-03-18_at_1.59.23_PM.png" />
</Frame>

### 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](./subscriptions) 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)      |

<Warning>
  As contagens de entrega podem diferir entre o Mixpanel e o OneSignal. Consulte [Por que os dados de entrega não correspondem?](#por-que-os-dados-de-entrega-não-correspondem) para mais detalhes.
</Warning>

***

## 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](./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](./custom-events) para acionar Jornadas ou Segmentos, você pode usar um conector de terceiros como o [Vendo](https://www.vendodata.com/use-cases/integrate-mixpanel-with-onesignal). 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?

1. **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.

2. **Usuários desinscritos**
   Os segmentos do OneSignal exibem apenas a contagem de [Subscriptions](./subscriptions) inscritas. Subscriptions desinscritas estão disponíveis para Journeys ou Mensagens In-App.

Por exemplo, se um coorte do Mixpanel tem 10 usuários mas o segmento do OneSignal mostra 8 Subscriptions, os 2 usuários ausentes podem:

* Não existir no OneSignal ou ter um External ID incorreto.
* Ter subscriptions desinscritas.

Para verificar, verifique a aba **Audience > Users** no OneSignal para ver se os usuários existem e têm subscriptions ativas.

### 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](./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](./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

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 External ID.
* Verifique se `OneSignal.logout` nã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](./custom-events), use um conector de terceiros como o [Vendo](https://www.vendodata.com/use-cases/integrate-mixpanel-with-onesignal).

### 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](./mobile-sdk-reference#addobserver-user-state) , [Web SDK](./web-sdk-reference#addeventlistener-user-state)
* Permission Observer: [Mobile SDK](./mobile-sdk-reference#addpermissionobserver-push) , [Web SDK](./web-sdk-reference#permissionchange)

***

## Páginas relacionadas

<Columns cols={2}>
  <Card title="Visão geral de análises" icon="chart-line" href="./analytics-overview">
    Visão geral das análises do OneSignal, métricas de entrega e rastreamento de eventos.
  </Card>

  <Card title="Eventos personalizados" icon="bolt" href="./custom-events">
    Rastreie ações do usuário para acionar Jornadas ou potencializar análises.
  </Card>
</Columns>

<Info>
  Need help?

  Chat with our Support team or email `support@onesignal.com`

  Please 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](/docs/en/capturing-a-debug-log)

  We're happy to help!
</Info>