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

> Intégrez OneSignal avec Mixpanel pour synchroniser les cohortes comportementales, suivre les événements de message et cibler les Utilisateurs sur les canaux push, email, SMS et in-app.

Intégrez OneSignal avec [Mixpanel](https://mixpanel.com) pour activer le ciblage basé sur le comportement en temps réel sur les canaux push, in-app, email et SMS. Cette intégration au niveau de l'application prend en charge deux flux de données :

* **Événements de message → Mixpanel** : Suivez les livraisons, les clics, les échecs et plus encore pour tous les canaux.
* **Cohortes → OneSignal** : Synchronisez les cohortes Mixpanel basées sur le comportement comme filtres de ciblage dans OneSignal.

<Warning>
  Mixpanel n'envoie actuellement pas d'[Événements personnalisés](./custom-events) à OneSignal. Si vous avez besoin d'acheminer des événements Mixpanel vers OneSignal, utilisez un connecteur tiers comme [Vendo](https://www.vendodata.com/use-cases/integrate-mixpanel-with-onesignal).
</Warning>

***

## Prérequis

* [Compte Mixpanel](https://mixpanel.com/)
* [Plan payant OneSignal](https://onesignal.com/pricing)
* Application OneSignal avec ID externe défini.

<Info>
  Cette intégration ne crée pas d'Utilisateurs. Elle mappe les Utilisateurs dans Mixpanel aux Utilisateurs existants dans OneSignal en faisant correspondre les identifiants.
</Info>

***

## Configuration

### Ajouter Mixpanel à OneSignal (Sortie)

Envoie les événements de message OneSignal dans votre projet Mixpanel.

1. Dans OneSignal, naviguez vers **Données > Intégrations > Mixpanel** et cliquez sur **Activer**.

<Frame caption="Activer l'intégration Mixpanel dans 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>

#### Dans Mixpanel

1. Trouvez votre [Token de projet](https://docs.mixpanel.com/docs/orgs-and-projects/managing-projects#find-your-project-tokens) puis copiez-collez-le dans OneSignal.
2. Vérifiez votre [Résidence des données](https://docs.mixpanel.com/docs/orgs-and-projects/managing-projects#project-details). Si vous utilisez les serveurs EU de Mixpanel, cochez la case **Envoyer les événements exclusivement au serveur de résidence EU de Mixpanel**.

#### Sélectionner les événements de message

Sélectionnez les événements de message OneSignal que vous souhaitez envoyer à Mixpanel. Lorsque vous avez terminé, cliquez sur **Activer**.

<Frame caption="Paramètres Mixpanel dans 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>

### Ajouter OneSignal à Mixpanel (Entrée)

Dans vos **Intégrations** Mixpanel, ajoutez OneSignal.

<Frame caption="Ajouter l'intégration OneSignal dans 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>

Définissez le **Nom du connecteur** comme quelque chose d'identifiable comme `OneSignal - APP_NAME` où `APP_NAME` est le nom de l'application dans OneSignal.

Vous aurez besoin des données suivantes disponibles dans OneSignal **Paramètres > [Clés et IDs](./keys-and-ids)** :

1. ID de l'application
2. Clé API

### Mappage de l'ID utilisateur

<Warning>
  Cette étape est essentielle pour que la synchronisation des cohortes et le suivi des événements fonctionnent correctement.
</Warning>

L'**[ID externe](./users)** dans OneSignal doit correspondre à une Propriété d'ID utilisateur Mixpanel que vous sélectionnez (par exemple, `user_id`). Vérifiez que cette propriété est renseignée dans les deux systèmes — la synchronisation des cohortes et le suivi des événements dépendent d'une correspondance exacte.

<Frame caption="Tableau de bord de Mixpanel pour définir les propriétés 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>

Vérifiez que la **Propriété d'ID utilisateur** que vous avez sélectionnée est disponible dans vos propriétés de profil utilisateur Mixpanel.

<Frame caption="Mixpanel > Utilisateurs > Propriétés du profil utilisateur">
  <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>

La même valeur dans Mixpanel pour la propriété de profil utilisateur doit correspondre à l'ID externe dans OneSignal.

<Frame caption="OneSignal > Audience > Utilisateurs > ID externe">
  <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>
  Si vous faites correspondre les Utilisateurs à OneSignal en fonction du `$distinct_id` Mixpanel, seule la valeur supérieure correspondra.

  Dans l'exemple ci-dessous, seul `890ea9b1-9024-4fb9-a92f-152ba67dd21a` fonctionnera. Il ne peut pas correspondre à `109768518080488203109` ou `$device:1880c06821f1b3-052354675cde95-1d525634-1fa400-1880c06821f1b3`.
</Warning>

<Frame caption="Utilisez la prudence lors de la définition de l'ID distinct s'il est utilisé pour le mappage de la propriété d'ID utilisateur">
  <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>
  Cliquez sur **Continuer** lorsque vous avez terminé. Vous devriez maintenant pouvoir exporter des cohortes de Mixpanel vers OneSignal et collecter des événements de message de OneSignal vers Mixpanel.
</Check>

***

## Exporter les cohortes Mixpanel vers OneSignal

Synchronisez les cohortes Mixpanel vers OneSignal en utilisant l'ID externe correspondant configuré ci-dessus. L'exportation **ne crée pas d'Utilisateurs** — chaque Utilisateur doit déjà exister dans OneSignal.

1. Dans Mixpanel, créez une cohorte.
2. Cliquez sur **Options > Exporter vers... > *Le nom de la connexion OneSignal***.

<Frame caption="Comment exporter une cohorte Mixpanel vers 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. Choisissez la fréquence de synchronisation et appuyez sur **Commencer la synchronisation**.

<Frame caption="Options de fréquence 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>

### Création de segment OneSignal

La cohorte synchronisée apparaît dans OneSignal comme un **filtre de segment Mixpanel**. OneSignal crée automatiquement un Segment pour la cohorte si :

* Les Utilisateurs de la cohorte Mixpanel existent également dans OneSignal avec un ID externe correspondant.
* Vous ne devez pas dépasser votre limite de segments dans OneSignal.

<Note>
  Mixpanel nécessite au moins un Utilisateur correspondant pour créer un Segment dans OneSignal. Une fois le Segment créé, il restera dans OneSignal même si la cohorte n'a plus d'Utilisateurs par la suite. Dans ce cas, le Segment apparaît simplement comme vide jusqu'à ce que des Utilisateurs soient à nouveau ajoutés.
</Note>

<Frame caption="Création d'un segment à partir d'une cohorte 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>

***

## Suivre les événements de message dans Mixpanel

OneSignal envoie les événements de message suivants à Mixpanel en temps réel. Sélectionnez les événements à envoyer dans **Données > Intégrations > Mixpanel**.

Pour tester, envoyez-vous un message depuis OneSignal, puis naviguez vers votre page de profil utilisateur dans Mixpanel. Dans le fil d'activité, vous devriez voir les événements se remplir.

<Frame caption="Fil d'activité Mixpanel avec des événements de message 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>

### Événements de message

| Type d'événement de message (OneSignal) | Nom d'événement de message (Mixpanel) | Description de l'événement                                                                                        |
| --------------------------------------- | ------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| Push Sent                               | Message Sent                          | Notification push envoyée avec succès                                                                             |
| Push Received                           | Message Received                      | Notification push reçue avec succès                                                                               |
| Push Clicked                            | App Opened from Push                  | Notification push touchée sur l'appareil                                                                          |
| Push Failed                             | Push Failed                           | Échec d'envoi du push. Consultez le rapport de messages échoués dans OneSignal                                    |
| Push Unsubscribed                       | Push Unsubscribed                     | L'[abonnement](./subscriptions) s'est désabonné du push                                                           |
|                                         |                                       |                                                                                                                   |
| In-App Impression                       | Message Sent                          | Message in-app affiché avec succès sur l'appareil                                                                 |
| In-App Clicked                          | Message Opened                        | Message in-app cliqué sur l'appareil                                                                              |
| In-App Page Displayed                   | In-App Page Displayed                 | Page du message in-app affichée                                                                                   |
|                                         |                                       |                                                                                                                   |
| Email Sent                              | \$campaign\_delivery                  | Email envoyé avec succès                                                                                          |
| Email Received                          | Message Received                      | Email reçu par le destinataire                                                                                    |
| Email Opened                            | Message Opened                        | Email ouvert par le destinataire                                                                                  |
| Email Link Clicked                      | App Opened from Push                  | Lien de l'email cliqué                                                                                            |
| Email Unsubscribed                      | Email Unsubscribed                    | Email désabonné par le destinataire                                                                               |
| Email Reported As Spam                  | Email Reported As Spam                | Email signalé comme spam par le destinataire                                                                      |
| Email Bounced                           | Email Bounced                         | Email retourné à l'expéditeur en raison d'une erreur permanente                                                   |
| Email Failed                            | Email Failed                          | Impossible de livrer l'email dans la boîte de réception du destinataire                                           |
| Email Suppressed                        | Email Suppressed                      | L'adresse email est sur votre liste de suppression. Soit elle a rebondi, soit elle a marqué vos emails comme spam |
|                                         |                                       |                                                                                                                   |
| SMS Sent                                | App Opened from Push                  | SMS envoyé au destinataire                                                                                        |
| SMS Failed                              | SMS Failed                            | Échec d'envoi du SMS                                                                                              |
| SMS Delivered                           | SMS Received                          | SMS livré avec succès                                                                                             |
| SMS Undelivered                         | SMS Undelivered                       | Le SMS n'a pas pu être envoyé                                                                                     |

### Propriétés d'événement

Voici les propriétés présentes sur tous les événements envoyés de OneSignal vers Mixpanel :

| NOM DE PROPRIÉTÉ     | DESCRIPTION                                                        |
| -------------------- | ------------------------------------------------------------------ |
| **Distinct ID**      | L'external\_id associé au message                                  |
| **Message ID**       | L'identifiant du message discret                                   |
| **Message Name**     | Le nom du message                                                  |
| **Message Title**    | Le titre du message                                                |
| **Message Contents** | Le contenu du message                                              |
| **message\_type**    | Le type de message envoyé, push, in-app, email, SMS                |
| **template\_id**     | Le modèle de message utilisé (Messages API et Journey)             |
| **subscription\_id** | L'identifiant d'appareil/email/SMS défini par OneSignal            |
| **device\_type**     | Le type d'appareil qui a reçu le message                           |
| **language**         | Le code de langue à deux caractères de l'appareil                  |
| **source**           | `onesignal` (est indiqué comme la source pour tous les événements) |

<Warning>
  Les comptes de livraison peuvent différer entre Mixpanel et OneSignal. Consultez [Pourquoi mes données de livraison ne correspondent-elles pas ?](#pourquoi-mes-données-de-livraison-ne-correspondent-elles-pas-) pour plus de détails.
</Warning>

***

## Événements personnalisés (tiers)

L'intégration Mixpanel ne prend pas en charge nativement l'envoi d'événements personnalisés de Mixpanel vers OneSignal. Contrairement à [Amplitude](./amplitude), il n'existe pas de destination d'événements intégrée de Mixpanel vers OneSignal.

Si vous avez besoin d'acheminer des événements comportementaux Mixpanel vers OneSignal en tant qu'[événements personnalisés](./custom-events) pour déclencher des Parcours ou des Segments, vous pouvez utiliser un connecteur tiers comme [Vendo](https://www.vendodata.com/use-cases/integrate-mixpanel-with-onesignal). Vendo transmet les événements Mixpanel sélectionnés vers OneSignal en tant qu'événements personnalisés pour le déclenchement de campagnes.

***

## FAQ

### Pourquoi les comptes de ma cohorte et de mon segment ne correspondent-ils pas ?

1. **IDs externes manquants ou non correspondants**
   Seuls les utilisateurs avec un ID externe OneSignal et un ID utilisateur Mixpanel correspondants sont inclus. Cette intégration ne crée pas d'utilisateurs ni d'abonnements.

2. **Utilisateurs désabonnés**
   Les segments OneSignal n'affichent que le nombre d'[Abonnements](./subscriptions) abonnés. Les abonnements désabonnés sont disponibles pour les parcours ou les messages in-app.

Par exemple, si une cohorte Mixpanel a 10 utilisateurs mais que le segment OneSignal affiche 8 abonnements, les 2 utilisateurs manquants peuvent :

* Ne pas exister dans OneSignal ou avoir un ID externe incorrect.
* Avoir des abonnements désabonnés.

Pour vérifier, consultez l'onglet **Audience > Utilisateurs** dans OneSignal pour voir si les utilisateurs existent et ont des abonnements actifs.

### Les utilisateurs désabonnés se synchronisent-ils depuis Mixpanel ?

Oui, mais ils sont exclus des comptes de segment OneSignal pour le moment. Vous pouvez toujours leur envoyer des messages via des parcours ou des messages in-app s'ils ont d'autres [Abonnements](./subscriptions) ou si leur type d'abonnement le prend en charge.

### Pourquoi mes données de livraison ne correspondent-elles pas ?

Un seul utilisateur peut avoir plusieurs [Abonnements](./subscriptions) (appareils push, adresses email, numéros de téléphone). Chaque abonnement génère son propre événement de livraison. Par exemple :

* 1 utilisateur = 2 Android + 1 iOS + 2 Web = 5 abonnements push
* 1 message push = jusqu'à 5 événements envoyés/reçus/cliqués

Utilisez le `subscription_id` dans les propriétés d'événement pour tracer la source exacte.

Pour résoudre les événements manquants :

* Assurez-vous que `OneSignal.login` est appelé chaque fois qu'un utilisateur est identifié pour définir l'ID externe.
* Vérifiez que `OneSignal.logout` ne supprime pas l'ID externe.
* Vérifiez les requêtes API ou les téléchargements CSV qui peuvent modifier l'ID externe.

### Puis-je envoyer des événements personnalisés de Mixpanel vers OneSignal ?

Pas nativement. L'intégration Mixpanel prend en charge les événements de message (OneSignal → Mixpanel) et la synchronisation des cohortes (Mixpanel → OneSignal), mais n'inclut pas de destination d'événements personnalisés intégrée. Pour acheminer les événements Mixpanel vers OneSignal en tant qu'[événements personnalisés](./custom-events), utilisez un connecteur tiers comme [Vendo](https://www.vendodata.com/use-cases/integrate-mixpanel-with-onesignal).

### Comment puis-je envoyer des événements utilisateur/abonnement ?

Les événements au niveau utilisateur et abonnement (par exemple, autorisation accordée, connexion/déconnexion utilisateur) ne sont pas envoyés automatiquement.

Le SDK OneSignal dispose d'écouteurs d'événements qui peuvent être utilisés pour suivre ces événements afin que vous puissiez les envoyer à Mixpanel :

* Observateur d'état utilisateur : [SDK mobile](./mobile-sdk-reference#addobserver-user-state), [SDK web](./web-sdk-reference#addeventlistener-user-state)
* Observateur d'autorisation : [SDK mobile](./mobile-sdk-reference#addpermissionobserver-push), [SDK web](./web-sdk-reference#permissionchange)

***

## Pages connexes

<Columns cols={2}>
  <Card title="Vue d'ensemble des analyses" icon="chart-line" href="./analytics-overview">
    Vue d'ensemble des analyses OneSignal, métriques de livraison et suivi des événements.
  </Card>

  <Card title="Événements personnalisés" icon="bolt" href="./custom-events">
    Suivez les actions des utilisateurs pour déclencher des Parcours ou alimenter les analyses.
  </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>
