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

# Vue d'ensemble du push

> Envoyez et gérez des notifications push mobiles et web avec OneSignal depuis le tableau de bord ou l'API, avec ciblage, personnalisation et planification.

Les notifications push réengagent les utilisateurs avec du contenu opportun et personnalisé sur tous les appareils — même lorsqu'ils n'utilisent pas activement votre application ou site web.

Regardez comment les notifications push génèrent le plus d'engagement, ou passez directement à la mise en route.

<Frame caption="Pourquoi les notifications push génèrent le plus d'engagement">
  <iframe width="560" height="315" src="https://www.youtube.com/embed/atjjj4BQqfc?si=PP-XrMF8ttXkXkuQ" 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>

OneSignal fournit une plateforme complète pour gérer les notifications push sur mobile, web et ordinateur :

* **Envoyer des campagnes et des messages transactionnels** depuis le [Tableau de bord](#send-push-notifications) ou l'[API](/reference/create-message)
* **Automatiser des flux multicanaux** avec [Journeys](./journeys-overview)
* **Cibler les utilisateurs avec précision** en utilisant des [Segments](./segmentation), des filtres ou des données utilisateur
* **[Tests A/B](./ab-testing) et optimisation** des performances des messages
* **Personnaliser le contenu** avec des attributs utilisateur et du [contenu dynamique](./message-personalization)
* **S'intégrer à votre stack** — HubSpot, Mixpanel, Amplitude, Zapier et [plus](./integrations)

***

## Configuration du push

Avant d'envoyer des notifications push, terminez la configuration de la plateforme, configurez les invites de permission et activez les fonctionnalités dont vous avez besoin.

### Guides de configuration de plateforme

<Columns cols={2}>
  <Card title="Configuration du push mobile" icon="mobile" href="./mobile-push-setup">
    Configuration complète pour les notifications push iOS, Android, Huawei et Amazon.
  </Card>

  <Card title="Configuration du push web" icon="globe" href="./web-push-setup">
    Activez le push pour Chrome, Firefox, Safari et Edge.
  </Card>

  <Card title="Configuration du SDK mobile" icon="code" href="./mobile-sdk-setup">
    Intégrez le SDK OneSignal dans votre application mobile.
  </Card>

  <Card title="Configuration du SDK web" icon="browsers" href="./web-sdk-setup">
    Intégrez le SDK OneSignal dans votre site web.
  </Card>

  <Card title="Migration vers OneSignal" icon="arrow-right-arrow-left" href="./migrating-to-onesignal">
    Étapes de migration depuis Firebase, Airship, Braze et d'autres fournisseurs.
  </Card>

  <Card title="Support des applications macOS" icon="desktop" href="./macos-app-setup">
    Configurez OneSignal pour les applications macOS.
  </Card>

  <Card title="Support des applications Windows" icon="desktop" href="./windows-app-setup">
    Configurez OneSignal pour les applications de bureau Windows.
  </Card>

  <Card title="Support watchOS et Wear OS" icon="clock" href="./watchos-and-wear-os-support">
    Ajoutez OneSignal aux appareils Apple Watch et Wear OS.
  </Card>
</Columns>

### Permissions

Une expérience d'opt-in bien conçue maximise votre audience push.

<Columns cols={2}>
  <Card title="Invites de push mobile" icon="bell" href="./prompt-for-push-permissions">
    Créez des invites de pré-autorisation et des bonnes pratiques pour les applications mobiles.
  </Card>

  <Card title="Invites de push web" icon="bell-on" href="./permission-requests">
    Personnalisez le moment et le message de l'invite pour le push web.
  </Card>

  <Card title="Push provisoire iOS" icon="apple" href="./ios-provisional-push-notifications">
    Envoyez des notifications silencieuses au centre de notifications avant de demander l'autorisation complète.
  </Card>

  <Card title="Catégories de notifications Android" icon="android" href="./android-notification-categories">
    Permettez aux utilisateurs Android de personnaliser comment ils reçoivent les notifications de votre application.
  </Card>
</Columns>

### Fonctionnalités et cas d'usage avancés

<Columns cols={2}>
  <Card title="Personnalisation des messages" icon="wand-magic-sparkles" href="./message-personalization">
    Ajoutez du contenu dynamique pour personnaliser les messages pour chaque utilisateur.
  </Card>

  <Card title="Messagerie multilingue" icon="language" href="./multi-language-messaging">
    Envoyez des notifications push dans la langue préférée de chaque utilisateur.
  </Card>

  <Card title="Limitation" icon="gauge-high" href="./throttling">
    Contrôlez la vitesse de livraison des notifications pour les grandes audiences.
  </Card>

  <Card title="Plafonnement de fréquence" icon="hand" href="./frequency-capping">
    Limitez le nombre de notifications push par utilisateur.
  </Card>

  <Card title="Notifications de données et d'arrière-plan" icon="database" href="./data-notifications">
    Envoyez des notifications de données uniquement pour les tâches en arrière-plan.
  </Card>

  <Card title="Notifications VoIP" icon="phone" href="./voip-notifications">
    Envoyez des notifications push spécifiques à VoIP pour les applications d'appel.
  </Card>
</Columns>

***

## Envoyer des notifications push

Vous pouvez envoyer des messages de plusieurs façons. La meilleure option dépend de vos cas d'utilisation.

<Columns cols={2}>
  <Card title="Tableau de bord" icon="window-maximize" href="#send-from-the-dashboard">
    Rédigez un message rapidement depuis le tableau de bord.
  </Card>

  <Card title="Envoyer via l'API" icon="code" href="/reference/create-message">
    Envoyez des messages par programmation via l'API REST.
  </Card>

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

  <Card title="Tests A/B" icon="flask" href="./ab-testing">
    Testez jusqu'à 10 variantes de message pour optimiser les performances.
  </Card>
</Columns>

### Envoyer depuis le tableau de bord

<Steps>
  <Step title="Sélectionner 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éez 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="Tableau de bord OneSignal montrant les options de création de message" width="2128" height="1374" data-path="images/dashboard/create-message.png" />
    </Frame>
  </Step>

  <Step title="Choisir une méthode de composition" icon="pencil">
    * Commencez de zéro ou utilisez le [compositeur de messages IA](./ai-message-composer).
    * Utilisez un [modèle](./templates) pré-construit
  </Step>

  <Step title="Définir 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électionner 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="Champs du tableau de bord pour le nom, l'étiquette et la sélection du segment d'audience" width="1650" height="518" data-path="images/dashboard/message-name-label-audience.png" />
    </Frame>

    | Méthode de ciblage                                        | Tableau de bord | API |
    | --------------------------------------------------------- | :-------------: | :-: |
    | [**Segments**](./segmentation)                            |       Oui       | Oui |
    | **Filtres** ([API uniquement](/reference/create-message)) |       Non       | Oui |
    | **Alias** ([API uniquement](/reference/create-message))   |       Non       | Oui |
  </Step>
</Steps>

### Planification de livraison et optimisation

Observez comment le timing impacte les performances des notifications push.

<Frame caption="Le timing est tout : Comment envoyer des notifications push qui génèrent de l'action">
  <iframe width="560" height="315" src="https://www.youtube.com/embed/pRTbUuvYsWY?si=uqL5wSK_vXH6VwMJ" 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>

Choisissez quand le message doit commencer à être envoyé.

| Option                    | Description                                                  | Champ API    |
| ------------------------- | ------------------------------------------------------------ | ------------ |
| **Envoyer immédiatement** | Livrer à tous les destinataires maintenant.                  | —            |
| **Planifié**              | Envoyer à une heure spécifique, jusqu'à 30 jours à l'avance. | `send_after` |

**Optimisation par utilisateur :**

Définissez quand les utilisateurs doivent recevoir le message.

| Option                                                            | Description                                                                                 | Champ API                                          |
| ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | -------------------------------------------------- |
| **Tout le monde en même temps**                                   | Tous les destinataires reçoivent le message en même temps. Idéal pour les messages urgents. | —                                                  |
| **Livraison intelligente**                                        | Envoie au moment optimal pour chaque utilisateur en fonction de son activité de session.    | `delayed_option: last-active`                      |
| **Heure personnalisée par fuseau horaire**                        | Envoie à une heure locale définie dans le fuseau horaire de chaque utilisateur.             | `delayed_option: timezone`, `delivery_time_of_day` |
| **Remplacer la [Limitation](./throttling)**                       | Modifier le taux de limitation.                                                             | `throttle_rate_per_minute`                         |
| **Remplacer le [Plafonnement de fréquence](./frequency-capping)** | Désactiver le plafonnement de fréquence pour ce message.                                    | `enable_frequency_cap`                             |

### Propriétés de conception

Les messages push peuvent soit afficher du contenu destiné à l'utilisateur, soit effectuer des opérations en arrière-plan.

* **Notifications d'affichage** : Nécessitent un [message](#message) et peuvent inclure un titre, une image, des boutons d'action et d'autres éléments visuels.
* **Notifications d'arrière-plan/de données uniquement** : Omettent le message, incluent [content\_available](./data-notifications) et éventuellement des [données supplémentaires](#additional-data).

<Frame caption="1 : Titre, 2 : Message, 3 : Icône, 4 : Image, 5 : Boutons d'action, 6 : Nom de l'application ou navigateur, 7 : Horodatage reçu">
  <img src="https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/web-and-mobile-push-notifications-anatomy.jpg?fit=max&auto=format&n=l4Z9oMlZl9nJOS_T&q=85&s=abd46b4656559360cc713cfa98f138fe" alt="Diagramme annoté montrant l'anatomie des notifications push web et mobiles" width="1468" height="2302" data-path="images/push/web-and-mobile-push-notifications-anatomy.jpg" />
</Frame>

<Tip>
  Utilisez le [Compositeur de messages IA](./ai-message-composer) pour générer rapidement des titres et du texte de corps de notification. Ajustez le ton et le contenu pour correspondre à votre marque en quelques clics.
</Tip>

#### Titre

Texte personnalisable le plus haut de la notification. L'apparence du texte est contrôlée par le système d'exploitation.

* Requis pour **push web** et **Huawei**
* Par défaut au nom du site sur le web si non défini
* Limite recommandée : 25–50 caractères (mobile), 60–80 (web)
* Prend en charge : [Compositeur de messages IA](./ai-message-composer), emojis, [personnalisation des messages](./message-personalization), [messagerie multilingue](./multi-language-messaging)
* API : `headings`

#### Sous-titre

Texte secondaire pris en charge sur iOS et macOS uniquement (via APNs). Non disponible sur Android ou web.

* Limite recommandée : 25–50 caractères
* Prend en charge : emojis, [personnalisation des messages](./message-personalization), [messagerie multilingue](./multi-language-messaging)
* API : `subtitle`

#### Message

Contenu principal de la notification. Ne prend pas en charge les polices personnalisées ou les styles. Le style est défini par le système d'exploitation.

* Requis sauf si vous envoyez une notification en arrière-plan
* Prend en charge : [Compositeur de messages IA](./ai-message-composer), emojis, [personnalisation des messages](./message-personalization), [messagerie multilingue](./multi-language-messaging)
* Limite recommandée : \~150 caractères
* API : `contents`

#### Icônes

Personnalisez les petites et grandes icônes sur Android et web. iOS utilise toujours l'icône de l'application.

* Voir [Icônes de notification](./notification-icons)

#### Image

Ajoutez une grande image aux notifications sur Android, iOS et Chrome pour Windows/Android.

* Taille recommandée : `1024×512px` (rapport d'aspect 2:1)
* Taille maximale : 1 Mo, largeur maximale : 2000 px
* Non pris en charge sur Safari (macOS/iOS) ou le Centre de notifications macOS
* L'image doit être tapée ou agrandie sur mobile pour être vue
* Formats pris en charge : `PNG`, `JPG`, `GIF` (animé uniquement sur iOS)
* API : `ios_attachments` (iOS), `big_picture` (Android), `chrome_web_image` (Chrome web)
* Voir [Images et médias riches](./rich-media)

#### Nom de l'application

Le nom de l'application affichant la notification.

* **iOS** : Défini dans Xcode sous *Display Name* ; nécessite un redémarrage de l'appareil pour mettre à jour
* **Android/Amazon/Huawei** : Défini dans `AndroidManifest.xml` sous `<application android:label="YOUR APP NAME">`
* **Web** : Affiche le nom du site et/ou le navigateur

### Propriétés de fonctionnalité

#### Boutons d'action

Ajoutez des boutons interactifs à la notification push.

* Pris en charge sur Android 4.1+ et iOS 8.0+
* Voir [Boutons d'action](./action-buttons)

#### URL de lancement

Contrôlez où vont les utilisateurs lorsqu'ils tapent sur la notification.

* API : `url` (URL universelle unique), `app_url` (lien profond, par exemple `votre-app://ecran`), `web_url` (lien web http/https)
* Voir [URLs, liens et liens profonds](./links)

#### Badges

Affichez des points ou des numéros de badge sur les icônes d'application.

* **iOS** : Badge numérique rouge ; peut définir, incrémenter ou effacer. API : `ios_badgeType`, `ios_badgeCount`
* **Android** : Nécessite des [catégories de notification](./android-notification-categories)
* **Huawei** : Badge affiché sous forme de nombre ou de point. API : `huawei_badge_class`, `huawei_badge_set_num`, `huawei_badge_add_num`
* **Web (Chrome/Android)** : Icône affichée dans la barre d'état Android ; doit être un PNG alpha 72×72. API : `chrome_web_badge`
* Voir [Badges](./badges)

#### Son

Jouez un son lorsque le push est livré.

* **iOS** : Défini avec `sound`
* **Android** : Défini via les [catégories de notification](./android-notification-categories)
* **Web** : Non disponible

#### Données supplémentaires

Ajoutez des paires clé-valeur personnalisées à la charge utile pour la gestion du SDK.

* Utilisé par les [extensions de service mobile](./service-extensions) et les écouteurs de clic dans le [SDK mobile](./mobile-sdk-reference) et le [SDK web](./web-sdk-reference)
* Le tableau de bord ne prend en charge que les données clé-valeur simples ; utilisez l'API avec `data` pour envoyer du JSON imbriqué
* Taille totale maximale de la charge utile : \~4 Ko ; champ `data` : jusqu'à 2048 octets
* Voir [Référence de charge utile de notification](./osnotification-payload)

#### ID de repli (push mobile)

Remplacez les notifications antérieures par une plus récente si elles partagent le même `collapse_id`. Longueur maximale : 64 caractères. API : `collapse_id`

Par exemple, une application météo envoie trois alertes. Si l'utilisateur ouvre son appareil après les trois, seul le dernier message s'affiche.

#### Sujet de push web (push web)

Évitez de remplacer les anciennes notifications web en utilisant des valeurs `web_push_topic` uniques. Les notifications avec des sujets différents restent visibles indépendamment. Longueur maximale : 64 caractères. API : `web_push_topic`

#### Priorité

Définissez l'urgence du push, en particulier dans les modes d'économie de batterie.

* **Élevée** (recommandé) : Messages immédiats, basés sur des alertes
* **Normale** : Utilisé pour les notifications d'arrière-plan/de données
* API : `priority`
* Docs de plateforme : [Priorité APNs](https://developer.apple.com/documentation/usernotifications/setting_up_a_remote_notification_server/sending_notification_requests_to_apns), [Priorité FCM](https://firebase.google.com/docs/cloud-messaging/android/message-priority)

#### Durée de vie (TTL)

Combien de temps conserver un message si l'appareil est hors ligne. Par défaut : 3 jours. Plage : 0–2 419 200 secondes (28 jours). API : `ttl`

Si un utilisateur est hors ligne et que le TTL expire, le message est rejeté. Définissez `ttl: 0` pour les messages qui ne doivent jamais être livrés en retard.

<Note>
  **Limitation iOS** : APNs ne stocke que la notification **la plus récente** hors ligne. Les précédentes sont abandonnées. [En savoir plus](https://developer.apple.com/library/archive/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/APNSOverview.html#//apple_ref/doc/uid/TP40008194-CH8-SW5).
</Note>

#### Regroupement de notifications

Android et iOS regrouperont automatiquement les notifications après que l'appareil ait reçu 4 ou plus de votre application.

* **iOS** : Utilisez `thread_id` dans l'API pour regrouper les messages.
* **Android** : Utilisez `android_group` dans l'API, ou définissez la "Clé de groupe" dans le tableau de bord. Pour une personnalisation avancée, voir [Android NotificationExtenderService](./service-extensions#android-notification-extender-service) et le [Guide de groupe de notification Android](https://developer.android.com/training/notify-user/group).

<Frame caption="Notifications regroupées sur Android.">
  <img src="https://mintcdn.com/onesignal/6tscVAtiSqz353kV/images/docs/GnEw4PmmSVWWfgX5Uc3W_stacked_notification.png?fit=max&auto=format&n=6tscVAtiSqz353kV&q=85&s=cee04b5675b291562d92add259bc2224" alt="Appareil Android montrant des notifications push regroupées de la même application" width="900" height="460" data-path="images/docs/GnEw4PmmSVWWfgX5Uc3W_stacked_notification.png" />
</Frame>

***

## Annuler les notifications push

Annulez un message s'il n'a pas encore été **Livré**. OneSignal cesse d'envoyer le message à tous les abonnements pas encore en file d'attente. Cela ne supprime pas le message des appareils qui l'ont déjà reçu.

Dans le [Rapport de message](./push-notification-message-reports), sélectionnez **Actions > Annuler**, ou utilisez l'[API Cancel Message](/reference/cancel-message).

### Supprimer une notification push d'un appareil

Une fois livré, vous ne pouvez remplacer une notification push que si vous définissez un [ID de repli](#collapse-id-mobile-push) ou un [Sujet de push web](#web-push-topic-web-push). Sans l'un de ces éléments, la notification ne peut pas être remplacée ou supprimée.

***

## Analyses

Suivez les performances des messages et l'engagement.

<Columns cols={2}>
  <Card title="Rapports de messages push" icon="chart-line" href="./push-notification-message-reports">
    Rapports de taux de livraison, de taux d'ouverture et de clics au niveau des messages.
  </Card>

  <Card title="Vue d'ensemble 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 outils BI en temps réel.
  </Card>

  <Card title="API View messages" icon="code" href="/reference/view-messages">
    Extrayez les analyses de messages par programmation via l'API REST.
  </Card>
</Columns>

***

## Questions fréquentes

### Quelles plateformes le push OneSignal prend-il en charge ?

OneSignal prend en charge le push sur iOS (APNs), Android (FCM), Huawei (HMS), Amazon (ADM), les navigateurs web (Chrome, Firefox, Safari, Edge), macOS et Windows. Voir les [guides de configuration de plateforme](#platform-setup-guides) ci-dessus.

### Comment tester les notifications push avant de les envoyer aux utilisateurs ?

Configurez des [abonnements de test](./test-users) pour vérifier la livraison, le rendu et les liens profonds sans affecter les vrais utilisateurs. Vous pouvez également envoyer à un segment d'un seul utilisateur pour des tests rapides.

### Pourquoi mes notifications push ne s'affichent-elles pas ?

Les causes courantes incluent des informations d'identification de plateforme manquantes ou expirées, des utilisateurs n'ayant pas accordé l'autorisation, ou des paramètres au niveau de l'appareil comme Ne pas déranger. Voir [Notifications non affichées ou retardées](./notifications-show-successful-but-are-not-being-shown) pour une liste de vérification complète de dépannage.

### Quelle est la taille maximale du payload de notification push ?

La taille totale du payload est d'environ 4 Ko sur toutes les plateformes. Le champ `data` prend en charge jusqu'à 2048 octets. Dépasser ces limites peut entraîner une troncature ou un rejet des notifications.