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

# Aperçu des messages intégrés

> Commencez avec les messages intégrés OneSignal : comment configurer, concevoir, déclencher et tester des campagnes intégrées pour engager efficacement vos utilisateurs mobiles.

<Frame caption="Exemples de messages intégrés">
  <img src="https://mintcdn.com/onesignal/yt4lRKoquAlWvRvF/images/iam/iam_marketing.jpg?fit=max&auto=format&n=yt4lRKoquAlWvRvF&q=85&s=4e09e43dc57956f4c33ad761f403aea5" width="1280" height="720" data-path="images/iam/iam_marketing.jpg" />
</Frame>

Les messages intégrés (IAM) sont des messages ciblés et personnalisables qui s'affichent dans votre application mobile. Ils vous permettent de :

* Inciter l'utilisateur à agir, comme s'abonner aux notifications push ou mettre à jour sa localisation.
* Promouvoir de nouvelles fonctionnalités ou des fonctionnalités sous-utilisées auprès d'utilisateurs ciblés.
* Afficher des annonces et des nouvelles en temps réel sans publier de mise à jour d'application.
* Créer des sondages et des carrousels.
* Aider avec l'intégration et le contenu éducatif.

***

## Configuration in-app

Vous devez avoir le SDK OneSignal installé dans votre application pour utiliser les messages intégrés. Une fois terminé, vous pouvez créer et envoyer des messages intégrés depuis le tableau de bord OneSignal sans écrire de code. Notre SDK dispose également de méthodes pour des cas d'utilisation avancés tels que :

* Déclencher le message à des moments spécifiques
* Gestion des clics et liens profonds
* Mettre le message en pause
* Gestion du cycle de vie et plus encore !

<Columns cols={2}>
  <Card title="Configuration du SDK mobile" href="./mobile-sdk-setup" arrow={true}>
    Ajoutez OneSignal à la base de code de votre application mobile.
  </Card>

  <Card title="Méthodes SDK de messages intégrés" href="./mobile-sdk-reference#in-app-messages" arrow={true}>
    Développeurs : accédez aux API de déclenchement, de gestionnaire de clic et de cycle de vie.
  </Card>

  <Card title="Déclencheurs de messages intégrés" href="./iam-triggers" arrow={true}>
    Contrôlez quand les messages apparaissent en fonction du comportement de l'utilisateur ou de l'activité de l'application.
  </Card>

  <Card title="Actions de clic sur les messages intégrés" href="./iam-click-actions" arrow={true}>
    Définissez ce qui se passe lorsque les utilisateurs interagissent avec votre message.
  </Card>
</Columns>

***

## Envoyer des messages intégrés

Vous pouvez envoyer des messages intégrés depuis le tableau de bord OneSignal et dans les Journeys.

<Frame>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/TSkqp4e-ya0?si=vbNStROmopkSWxWd" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
</Frame>

<Columns cols={2}>
  <Card title="Tableau de bord" icon="window-maximize" href="#send-from-the-dashboard">
    Composez et envoyez des messages in-app depuis le tableau de bord OneSignal.
  </Card>

  <Card title="Journeys" icon="route" href="./journeys-overview">
    Créez des flux automatisés, multi-étapes et multicanaux.
  </Card>
</Columns>

### Envoyer depuis le tableau de bord

<Steps>
  <Step title="Sélectionnez le canal de message" icon="window-maximize">
    Sélectionnez **Créer...** puis choisissez votre canal de message. Vous pouvez également naviguer vers **Messages** ou **Modèles** pour voir les messages précédents.

    <Frame caption="Créer un nouveau message dans le tableau de bord OneSignal.">
      <img src="https://mintcdn.com/onesignal/UDk6E5NjA3sdGdRN/images/dashboard/create-message.png?fit=max&auto=format&n=UDk6E5NjA3sdGdRN&q=85&s=97504cf71555ac4aeb263a36ad2d28b3" alt="OneSignal dashboard showing create message options" width="2128" height="1374" data-path="images/dashboard/create-message.png" />
    </Frame>
  </Step>

  <Step title="Choisissez une méthode de composition" icon="pencil">
    * Commencez de zéro avec l'[Éditeur de blocs](./design-your-in-app-message) ou l'[Éditeur HTML](./design-your-in-app-message-with-html)
    * Utilisez un [modèle](./templates) prédéfini
  </Step>

  <Step title="Définissez un nom et une étiquette" icon="tag">
    Ajoutez des métadonnées internes pour le suivi et les rapports. Équivalent API : `name`
  </Step>

  <Step title="Sélectionnez votre audience" icon="users">
    Choisissez quels utilisateurs reçoivent le message. Vous pouvez inclure et exclure des [segments](./segmentation) pour cibler des groupes spécifiques. Par défaut, tous les « Utilisateurs abonnés » si aucun segment n'est défini.

    <Frame caption="Sélection du nom, de l'étiquette et du segment d'audience dans le tableau de bord.">
      <img src="https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/dashboard/message-name-label-audience.png?fit=max&auto=format&n=ciRrThfP6xMpI7GY&q=85&s=1f41b0e42d31211b1c1badf87ba84056" alt="Dashboard fields for message name, label, and audience segment selection" width="1650" height="518" data-path="images/dashboard/message-name-label-audience.png" />
    </Frame>

    <Note>
      Les messages in-app sont envoyés à tous les [abonnements mobiles](./subscriptions) dans le segment, quel que soit le statut d'opt-in aux notifications push. Cependant, si votre message contient une [action de clic](#click-actions) d'invite push, il ne s'affichera pas aux abonnements mobiles déjà abonnés (opt-in).
    </Note>
  </Step>
</Steps>

### Conception du message

Utilisez notre éditeur visuel par glisser-déposer ou notre éditeur HTML pour plus de contrôle.

<Frame caption="Écran d'édition">
  <img src="https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/b7df349-Screenshot_2022-12-10_at_12.52.59_PM.png?fit=max&auto=format&n=56ctKxZSV4m5VEkn&q=85&s=4930228c3107db798dadc1bf69b4b0d6" width="2134" height="1736" data-path="images/docs/b7df349-Screenshot_2022-12-10_at_12.52.59_PM.png" />
</Frame>

<Columns cols={2}>
  <Card title="Concevoir par glisser-déposer" href="./design-your-in-app-message" arrow={true}>
    Utilisez notre éditeur visuel pour créer rapidement des messages.
  </Card>

  <Card title="Concevoir avec HTML" href="./design-your-in-app-message-with-html" arrow={true}>
    Contrôle total pour les développeurs pour personnaliser les messages.
  </Card>

  <Card title="Modèles HTML préconstruits" href="./in-app-html-templates" arrow={true}>
    Commencez à partir de mises en page et de campagnes testées.
  </Card>

  <Card title="APIs JavaScript intégrées pour HTML" href="./in-app-message-api" arrow={true}>
    Ajoutez les actions de clic de OneSignal à vos messages HTML.
  </Card>

  <Card title="Personnalisation des messages" href="./message-personalization" arrow={true}>
    Ajoutez du contenu dynamique pour personnaliser les messages pour chaque utilisateur.
  </Card>

  <Card title="Messagerie multilingue" href="./multi-language-messaging" arrow={true}>
    Localisez votre contenu pour les audiences mondiales.
  </Card>
</Columns>

### Actions de clic

Personnalisez ce qui se passe lorsque les utilisateurs cliquent sur des éléments de votre message.

<Frame caption="Options d'action de clic">
  <img src="https://mintcdn.com/onesignal/yt4lRKoquAlWvRvF/images/iam/click_action_dropdown.png?fit=max&auto=format&n=yt4lRKoquAlWvRvF&q=85&s=4edea63fce3704ec2c343eacfc77f248" width="518" height="525" data-path="images/iam/click_action_dropdown.png" />
</Frame>

<Columns cols={2}>
  <Card title="Actions de clic" href="./iam-click-actions" arrow={true}>
    Personnalisez ce qui se passe lorsque les utilisateurs cliquent sur des éléments de votre message.
  </Card>

  <Card title="Flux d'événements" href="./event-streams" arrow={true}>
    Suivez les interactions avec le message.
  </Card>

  <Card title="Gestionnaire de clic SDK" href="./mobile-sdk-reference#addclicklistener-in-app" arrow={true}>
    Réagissez aux événements de clic avec notre SDK mobile.
  </Card>

  <Card title="Liens profonds" href="./deep-linking" arrow={true}>
    Naviguez les utilisateurs au clic.
  </Card>
</Columns>

### Déclencheurs

Définissez quand les messages doivent apparaître pendant les sessions d'application.

<Frame caption="Configuration du déclencheur">
  <img src="https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/5578ae6-image.png?fit=max&auto=format&n=jFWn5xzleD8du3j6&q=85&s=d70aa26e6fa87244d4fa8f4527d9b449" width="1766" height="884" data-path="images/docs/5578ae6-image.png" />
</Frame>

Quatre types de déclencheurs :

<Columns col={2}>
  <Card title="À l'ouverture de l'application">
    Déclencher lorsque l'utilisateur lance l'application.
  </Card>

  <Card title="Durée de la session">
    Délai de X secondes après l'ouverture de l'application.
  </Card>

  <Card title="Depuis le dernier message">
    Délai de X temps après le dernier message intégré.
  </Card>

  <Card title="Déclencheurs personnalisés" href="./iam-triggers" arrow={true}>
    Contrôlé via le SDK `addTrigger(s)`.
  </Card>
</Columns>

#### Quand ce message devrait-il être rejeté ?

Les messages peuvent être rejetés :

* Lors d'une interaction utilisateur (clic, balayage)
* Après un temps défini (rejet automatique)

<Frame caption="Rejet automatique après 90 secondes">
  <img src="https://mintcdn.com/onesignal/tc0EvmtSSX56SX0c/images/docs/8dcc001876557819348b804906ed63aee17d83bce300e63e91cc11c54eface2f-Screenshot_2025-04-08_at_2.00.07_PM.png?fit=max&auto=format&n=tc0EvmtSSX56SX0c&q=85&s=59d61042bc7d3e1855e4c90f9a83e562" width="1342" height="530" data-path="images/docs/8dcc001876557819348b804906ed63aee17d83bce300e63e91cc11c54eface2f-Screenshot_2025-04-08_at_2.00.07_PM.png" />
</Frame>

### Planification et fréquence

* **Commencer à afficher** : Quand le message devient éligible
* **Arrêter d'afficher** : Définir une date/heure de fin ou "Afficher pour toujours"

#### À quelle fréquence voulez-vous afficher ce message ?

* **Une seule fois** (par défaut)
* **À chaque fois** que les déclencheurs sont satisfaits
* **Plusieurs fois** avec une logique de répétition personnalisée :

Exemples :

* Afficher **2 fois** avec un intervalle de **1 heure**
* Afficher **12 fois** avec un intervalle de **30 jours**

<Frame caption="L'exemple affichera le message un total de 12 fois tous les 30 jours.">
  <img src="https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/e66d013-Screenshot_2022-12-10_at_1.27.10_PM.png?fit=max&auto=format&n=Z6xkXGfmy814If53&q=85&s=0cfe8f5e92ea5d02aa5ae3c659b5538c" width="2100" height="756" data-path="images/docs/e66d013-Screenshot_2022-12-10_at_1.27.10_PM.png" />
</Frame>

***

## Comment les messages intégrés sont affichés

Les messages intégrés ne sont pas activement poussés. Au lieu de cela, ils sont récupérés au démarrage de l'application en fonction de l'audience. Puis affichés en fonction de la logique de déclenchement.

<Frame caption="Flux de logique d'affichage des messages intégrés">
  <img src="https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/e1ce302cd1350e6c9e5616937a8068329fe61619884cd62889cd1772fd29999d-1c688b0-lifecycle-of-an-in-app.png?fit=max&auto=format&n=Z6xkXGfmy814If53&q=85&s=7a7552973b2746cd2ffa36137e743675" width="2036" height="815" data-path="images/docs/e1ce302cd1350e6c9e5616937a8068329fe61619884cd62889cd1772fd29999d-1c688b0-lifecycle-of-an-in-app.png" />
</Frame>

Le message s'affichera si :

1. L'utilisateur répond aux critères d'audience *avant* le début d'une **nouvelle session**.

* Une **nouvelle session** commence lorsque l'utilisateur ouvre votre application après qu'elle ait été en arrière-plan ou fermée pendant au moins 30 secondes.
* Si les utilisateurs ont l'application ouverte lorsque le message est mis en ligne ou entre dans le(s) segment(s) pendant la même session, ils devront mettre l'application hors focus (fermer ou mettre en arrière-plan) pendant au moins 30 secondes pour être éligibles à voir le message.

2. Les conditions de déclenchement sont remplies.
3. L'heure et la fréquence planifiées sont valides.

Si les critères de segment changent en cours de session, les utilisateurs doivent rouvrir l'application pour voir le message.

### Test

Lors des tests, il est recommandé de faire ce qui suit :

<Steps>
  <Step title="Ajouter la journalisation détaillée à votre application">
    Ajoutez notre [méthode `setLogLevel` à `Verbose`](./mobile-sdk-reference#setloglevel) dans votre application pour obtenir des journaux plus détaillés.
  </Step>

  <Step title="Assurez-vous que votre abonnement est dans le segment">
    Comme expliqué ci-dessus dans [Comment les messages intégrés sont affichés](#comment-les-messages-intégrés-sont-affichés), l'utilisateur doit correspondre aux critères d'audience **avant le début d'une nouvelle session**.

    * Consultez [Trouver des appareils et définir des utilisateurs de test](./test-users) si vous ne connaissez pas l'ID d'abonnement de votre appareil.
    * Assurez-vous que l'abonnement de votre appareil est dans le(s) segment(s) inclus et non dans le(s) segment(s) exclu(s) si utilisé.
    * **Conseil** : Vous pouvez ajouter votre appareil en tant qu'abonnement de test et créer ou mettre à jour le segment pour inclure le filtre **Utilisateurs de test**.
  </Step>

  <Step title="Assurez-vous que l'application est fermée ou hors focus pendant au moins 30 secondes">
    Cela garantira que vous ouvrez l'application pour créer une nouvelle session et être éligible au message.
  </Step>

  <Step title="Vérifier les conditions de déclenchement">
    Assurez-vous de satisfaire les [déclencheurs](#déclencheurs) pour que le message soit affiché.
  </Step>

  <Step title="Vérifier la planification et la fréquence">
    * Assurez-vous que les dates "Commencer à afficher" et "Arrêter d'afficher" sont définies correctement.
    * Définissez ["À quelle fréquence voulez-vous afficher ce message ?"](#planification-et-fréquence) sur "À chaque fois que les conditions de déclenchement sont satisfaites" pendant les tests.
  </Step>

  <Step title="Mettre à jour le message et s'assurer qu'il est actif">
    * Une fois le message actif, vous pouvez ouvrir l'application sur votre appareil.
    * Vous devriez voir le message s'afficher en fonction de vos conditions de déclenchement.
  </Step>
</Steps>

#### Bouton Test & Aperçu

L'utilisation du bouton **Test & Aperçu** enverra une notification push à votre appareil de test sélectionné. Lorsque vous cliquez sur la notification push pour ouvrir l'application, le message intégré s'affichera. Pour utiliser cette fonctionnalité, vous devez :

* Assurez-vous que votre appareil est un [Utilisateur de test](./test-users).
* Les notifications push sont **uniquement envoyées à des fins de test**. Les notifications push ne seront pas envoyées lorsque le message sera en ligne.
* Vous pouvez ouvrir l'application et envoyer le "message de test". Le message intégré s'affichera.
* La substitution de balises ne fonctionne pas pour les messages intégrés de test.
* Si vous ne voyez pas le message, assurez-vous d'avoir suivi les [étapes de test](#test).
* Pour recevoir un message intégré de test, votre appareil doit être abonné aux notifications push. Les IAM de test sont déclenchés par une notification push, donc si votre abonnement a un jeton APNs invalide ou si vous n'êtes pas abonné aux notifications push, le test ne fonctionnera pas.

<Info>
  Besoin d'aide ?

  Discutez avec notre équipe d'assistance ou envoyez un e-mail à `support@onesignal.com`

  Veuillez inclure :

  * Les détails du problème que vous rencontrez et les étapes de reproduction si disponibles
  * Votre OneSignal App ID
  * L'External ID ou le Subscription ID le cas échéant
  * L'URL du message que vous avez testé dans le OneSignal Dashboard le cas échéant
  * Tous les [journaux ou messages d'erreur](/docs/en/capturing-a-debug-log) pertinents

  Nous serons ravis de vous aider !
</Info>

***

## Tutoriels et cas d'utilisation

<Columns cols={2}>
  <Card title="Personnaliser le message intégré" href="./personalization-properties-and-tags" arrow={true}>
    Guide étape par étape pour personnaliser votre message intégré avec des balises.
  </Card>

  <Card title="Cibler les versions d'application obsolètes" href="./app-version-update" arrow={true}>
    Invitez les utilisateurs à mettre à jour leur application.
  </Card>

  <Card title="Invitations à évaluer sur l'App Store" href="./example-app-store-review" arrow={true}>
    Augmentez vos notes avec des demandes d'évaluation opportunes.
  </Card>

  <Card title="Créer des sondages utilisateur" href="./example-create-a-survey" arrow={true}>
    Collectez des commentaires dans votre application.
  </Card>

  <Card title="Invitations de permission push" href="./prompt-for-push-permissions" arrow={true}>
    Améliorez les taux d'acceptation des notifications push.
  </Card>

  <Card title="Invitations de permission de localisation" href="./location-opt-in-prompt" arrow={true}>
    Demandez aux utilisateurs d'activer le suivi de localisation.
  </Card>

  <Card title="Créer un tutoriel" href="./example-create-a-tutorial" arrow={true}>
    Configurez un tutoriel pour aider les utilisateurs à comprendre les nouvelles fonctionnalités de votre application !
  </Card>
</Columns>

***

## Analyses

Suivez les performances et l'engagement des messages.

<Columns cols={2}>
  <Card title="Rapports sur les messages in-app" icon="chart-line" href="./in-app-message-reports">
    Impressions, clics, fermetures et métriques de conversion pour les messages in-app.
  </Card>

  <Card title="Aperçu des analyses" icon="chart-bar" href="./analytics-overview">
    Toutes les options d'analyse disponibles dans OneSignal.
  </Card>

  <Card title="Event Streams" icon="signal-stream" href="./event-streams">
    Diffusez les événements push vers votre entrepôt de données ou vos outils BI en temps réel.
  </Card>
</Columns>

***

## FAQ

### Les messages in-app nécessitent-ils une autorisation de notification push ?

Non. Les messages in-app sont envoyés à tous les Abonnements mobiles du Segment cible, quel que soit le statut d'acceptation des notifications push. Ils s'affichent dans l'application lors d'une session active.

### Pourquoi mon message in-app ne s'affiche-t-il pas ?

La cause la plus fréquente est que la session de l'utilisateur ne s'est pas actualisée. L'utilisateur doit fermer l'application ou la mettre en arrière-plan pendant au moins 30 secondes, puis la rouvrir pour démarrer une nouvelle session. Vérifiez également que l'utilisateur fait partie du Segment cible et que les conditions de déclenchement sont remplies. Consultez [Tests](#testing) pour une liste de vérification complète.

### Puis-je envoyer des messages in-app via l'API ?

Vous devez créer les messages in-app dans le tableau de bord OneSignal.

Vous pouvez inclure le message in-app dans [Journeys](./journeys-overview) et ajouter l'utilisateur au Journey via des [Événements personnalisés](./custom-events) déclenchés depuis l'API.

### En quoi les messages in-app diffèrent-ils des notifications push ?

Les messages in-app s'affichent dans votre application lorsque l'utilisateur l'utilise activement. Les notifications push apparaissent dans la barre de notifications de l'appareil et peuvent atteindre les utilisateurs même lorsque l'application est fermée. Les messages in-app ne nécessitent pas d'autorisation push et sont récupérés au démarrage de la session plutôt qu'envoyés par le serveur.

### Puis-je utiliser des messages in-app sur le web ?

Non. Les messages in-app sont uniquement disponibles pour les applications mobiles avec le SDK mobile OneSignal installé. Pour le web, envisagez d'utiliser les [notifications push web](./web-push-setup) à la place.