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

# Configuration du push mobile

> Liste de vérification complète pour configurer les notifications push mobiles avec OneSignal sur iOS, Android, Huawei et Amazon.

Les notifications push réengagent les Utilisateurs lorsqu'ils n'utilisent pas activement votre application. Elles peuvent afficher du texte et du contenu riche comme des images, des boutons et des sons.

<Frame caption="Exemples de notifications push sur iOS et Android.">
  <img src="https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/d6ba464616e546aaf62a5bda18adb4422d036815db4b2454e8a8b6a4dcf67706-channel-setup-mobile-push.jpg?fit=max&auto=format&n=Z6xkXGfmy814If53&q=85&s=63d1840679897262b47a004375a1bb33" alt="Exemples de notifications push mobiles iOS et Android affichant du contenu riche" width="1280" height="720" data-path="images/docs/d6ba464616e546aaf62a5bda18adb4422d036815db4b2454e8a8b6a4dcf67706-channel-setup-mobile-push.jpg" />
</Frame>

Pour que le push fonctionne sur mobile :

* Les Utilisateurs doivent avoir votre application mobile installée
* Vous devez configurer les bonnes informations d'identification de plateforme (FCM pour Android, APNs pour iOS, HMS pour Huawei, ADM pour Amazon)
* Les Utilisateurs doivent accorder l'autorisation de recevoir des notifications

Ce guide parcourt chaque étape, de la configuration du SDK à l'envoi de messages push personnalisés.

***

## Configuration du SDK et migration

Intégrez le SDK OneSignal dans votre application pour enregistrer les appareils et activer la messagerie push. Si vous migrez depuis un autre fournisseur, OneSignal prend en charge la migration depuis Firebase, Airship, Braze et d'autres.

<Columns cols={2}>
  <Card title="Configuration du SDK mobile" icon="mobile" href="./mobile-sdk-setup">
    Intégrez le SDK OneSignal dans votre application pour enregistrer les appareils et activer la messagerie push.
  </Card>

  <Card title="Migration depuis un autre fournisseur" icon="arrow-right-arrow-left" href="./migrating-to-onesignal">
    Migrez depuis Firebase, Airship, Braze ou d'autres fournisseurs de push.
  </Card>
</Columns>

***

## Invites de permission push

Les plateformes mobiles exigent que les Utilisateurs s'inscrivent avant de pouvoir recevoir des notifications push. Les [Directives d'interface humaine](https://developer.apple.com/design/human-interface-guidelines/ios/system-capabilities/notifications) d'Apple recommandent de décrire les types d'informations que vous souhaitez envoyer et de donner aux Utilisateurs un moyen clair de s'inscrire ou de se désinscrire.

Vous pouvez créer une invite de pré-autorisation en utilisant les messages in-app de OneSignal pour expliquer la valeur avant de déclencher l'invite système.

<Frame caption="Invite push de pré-autorisation personnalisée créée avec des messages in-app.">
  <img src="https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/mobile-push-setup-ask-users-for-permission-to-send-push.jpg?fit=max&auto=format&n=l4Z9oMlZl9nJOS_T&q=85&s=aa31e67179d80c4b99c2d86102091d60" alt="Message in-app OneSignal utilisé comme invite de pré-autorisation pour les notifications push" width="2136" height="1338" data-path="images/push/mobile-push-setup-ask-users-for-permission-to-send-push.jpg" />
</Frame>

<Columns cols={2}>
  <Card title="Demander les autorisations push" icon="bell" href="./prompt-for-push-permissions">
    Créez une invite de pré-autorisation personnalisée en utilisant les messages in-app.
  </Card>

  <Card title="Référence du SDK mobile" icon="code" href="./mobile-sdk-reference">
    Déclenchez par programmation les demandes d'autorisation dans le SDK.
  </Card>

  <Card title="Push provisoire iOS" icon="apple" href="./ios-provisional-push-notifications">
    Affichez des notifications silencieuses dans le centre de notifications avant de demander.
  </Card>
</Columns>

***

## Utilisateurs et Abonnements

Une fois le SDK actif, OneSignal crée automatiquement des enregistrements d'Utilisateur et d'Abonnement lorsque les personnes ouvrent votre application.

Les Abonnements mobiles sont créés lorsque les Utilisateurs :

* Ouvrent l'application pour la première fois sur un appareil
* Désinstallent et réinstallent l'application, puis ouvrent à nouveau l'application

Chaque appareil crée un Abonnement séparé. Les Abonnements restent anonymes jusqu'à ce que vous leur attribuiez un [External ID](./users#external-id) via `OneSignal.login`.

<Frame caption="Tableau de bord OneSignal : Audience > Utilisateurs">
  <img src="https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/dashboard/users-page.png?fit=max&auto=format&n=ciRrThfP6xMpI7GY&q=85&s=8992ef97cf3c9f336078f9dbf8a6374e" alt="Page Utilisateurs du tableau de bord OneSignal affichant une liste d'Utilisateurs avec les détails d'Abonnement" width="2316" height="858" data-path="images/dashboard/users-page.png" />
</Frame>

<Columns cols={2}>
  <Card title="Utilisateurs" icon="users" href="./users">
    Gérez les Utilisateurs, attribuez des External IDs et comprenez les Utilisateurs anonymes vs. identifiés.
  </Card>

  <Card title="Abonnements" icon="address-book" href="./subscriptions">
    Comment les Abonnements sont créés et gérés sur les appareils et les canaux.
  </Card>

  <Card title="Segments" icon="chart-pie" href="./segmentation">
    Regroupez les Utilisateurs en segments dynamiques pour la messagerie ciblée.
  </Card>
</Columns>

***

## Concevoir des notifications push

Créer des notifications push efficaces implique plus qu'écrire du texte. Regardez comment tirer le meilleur parti de chaque notification push, puis explorez les éléments de conception ci-dessous.

<Frame caption="Comment tirer le meilleur parti de chaque notification push">
  <iframe width="560" height="315" src="https://www.youtube.com/embed/mlXEsZA2qlM?si=tIstWJYNFOzrtMR5" 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>

<Frame caption="Anatomie d'une notification push mobile sur iOS et Android.">
  <img src="https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/ios-and-android-mobile-push-expanded.jpg?fit=max&auto=format&n=l4Z9oMlZl9nJOS_T&q=85&s=5f0a3048b1b945ce1c960807992e4c74" alt="Diagramme annoté montrant l'anatomie des notifications push iOS et Android" width="1467" height="726" data-path="images/push/ios-and-android-mobile-push-expanded.jpg" />
</Frame>

1. [Titre](./push#title) : Titre accrocheur (recommandé : moins de 50 caractères)
2. [Message](./push#message) : Contenu principal de la notification (recommandé : moins de 120 caractères)
3. [Icônes](./notification-icons) : Icône de votre marque ou image spécifique à la notification
4. [Grande image](./push#image) : Contenu visuel accrocheur
5. [Boutons d'action](./action-buttons) : Boutons d'appel à l'action
6. Horodatage de réception du push
7. [Nom de l'application](./push#app-name) : Le nom de votre application

<Columns cols={2}>
  <Card title="Vue d'ensemble du push" icon="bell" href="./push">
    Vue d'ensemble complète de la création, des options et du comportement de livraison des notifications push.
  </Card>

  <Card title="Modèles" icon="clone" href="./templates">
    Gagnez du temps avec des modèles réutilisables pour une messagerie cohérente.
  </Card>
</Columns>

### Personnalisation et localisation

Regardez comment transformer des notifications push génériques en messages performants, puis explorez les options de personnalisation ci-dessous.

<Frame caption="Comment transformer des notifications push génériques en messages performants">
  <iframe width="560" height="315" src="https://www.youtube.com/embed/Rf6N_rezxuk?si=8t2pd1bxKeN5ofq-" 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="Personnalisation des messages" icon="wand-magic-sparkles" href="./message-personalization">
    Insérez des variables dynamiques comme le nom ou les préférences pour adapter les messages.
  </Card>

  <Card title="Messagerie multilingue" icon="language" href="./multi-language-messaging">
    Livrez automatiquement les messages dans la langue préférée de chaque Utilisateur.
  </Card>
</Columns>

***

## Configurer le comportement push

Contrôlez le comportement de vos notifications après la livraison, y compris le timing, les paramètres d'affichage et les interactions des Utilisateurs.

### Paramètres de livraison, d'affichage et de rejet

<Columns cols={2}>
  <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">
    Définissez des limites pour éviter d'envoyer trop de notifications au même Utilisateur.
  </Card>

  <Card title="Durée de vie (TTL)" icon="clock" href="./push#time-to-live-ttl">
    Définissez combien de temps les services push conservent les messages lorsque l'appareil est hors ligne.
  </Card>

  <Card title="Collapse ID" icon="layer-group" href="./push#collapse-id-mobile-push">
    Remplacez les messages précédents par de nouveaux pour réduire l'encombrement des notifications.
  </Card>

  <Card title="Catégories de notification Android" icon="android" href="./android-notification-categories">
    Contrôlez le niveau d'importance (bannière, silencieux) et d'autres aspects d'affichage.
  </Card>

  <Card title="Modes focus et niveaux d'interruption iOS" icon="apple" href="./ios-focus-modes-and-interruption-levels">
    Contrôlez le niveau de priorité (passif, sensible au temps) pour iOS.
  </Card>

  <Card title="Sons de notification" icon="volume-high" href="./notification-sounds">
    Configurez l'audio de notification pour chaque plateforme.
  </Card>

  <Card title="Badges" icon="circle-1" href="./badges">
    Gérez le comportement du compteur de badge de l'icône d'application sur iOS.
  </Card>
</Columns>

### Notifications de données et d'arrière-plan

Incluez des données personnalisées dans les charges utiles push que votre application peut traiter sans afficher de notification visible.

<Columns cols={2}>
  <Card title="Notifications de données et d'arrière-plan" icon="database" href="./data-notifications">
    Envoyez des charges utiles personnalisées sans notification visuelle.
  </Card>

  <Card title="Données supplémentaires" icon="brackets-curly" href="./push#additional-data">
    Attachez des données clé-valeur aux charges utiles push pour la gestion in-app.
  </Card>
</Columns>

### Comportement de clic et liens profonds

Contrôlez ce qui se passe lorsqu'un Utilisateur appuie sur une notification.

<Columns cols={2}>
  <Card title="URLs, liens et liens profonds" icon="link" href="./links">
    Dirigez les Utilisateurs vers du contenu ou des pages pertinentes en utilisant des liens profonds et des URLs de suivi.
  </Card>

  <Card title="Liens profonds" icon="arrow-up-right-from-square" href="./deep-linking">
    Détails d'implémentation des liens profonds spécifiques à chaque plateforme.
  </Card>

  <Card title="Boutons d'action" icon="hand-pointer" href="./action-buttons">
    Permettez aux Utilisateurs de prendre des actions immédiates depuis votre notification.
  </Card>

  <Card title="Observateurs d'événements de notification" icon="code" href="./mobile-sdk-reference#push-notification-events">
    Écoutez les événements de clic et déclenchez un comportement in-app avec du code personnalisé.
  </Card>
</Columns>

***

## Analytique et dépannage

Mesurez les performances des notifications et résolvez les problèmes de livraison courants.

<Columns cols={2}>
  <Card title="Rapports de messages push" icon="chart-line" href="./push-notification-message-reports">
    Consultez les métriques de livraison, de taux d'ouverture et de clics pour chaque message.
  </Card>

  <Card title="Vue d'ensemble de l'analytique" icon="chart-bar" href="./analytics-overview">
    Explorez les métriques d'engagement et de comportement des Utilisateurs sur tous les canaux.
  </Card>

  <Card title="Notifications non affichées ou retardées" icon="circle-exclamation" href="./notifications-show-successful-but-are-not-being-shown">
    Liste de vérification de dépannage si les messages n'apparaissent pas sur les appareils.
  </Card>

  <Card title="Images de notification non affichées" icon="image" href="./notification-images-not-showing">
    Corrigez les problèmes de rendu d'image sur toutes les plateformes.
  </Card>

  <Card title="Notifications en double" icon="copy" href="./duplicated-notifications">
    Dépannez pourquoi des notifications en double sont affichées.
  </Card>
</Columns>

***

## Prochaines étapes

<Columns cols={2}>
  <Card title="Tests A/B" icon="flask" href="./ab-testing">
    Optimisez les messages avec des expériences pour trouver ce qui stimule l'engagement.
  </Card>

  <Card title="Parcours" icon="route" href="./journeys-overview">
    Créez des flux de messagerie automatisés en plusieurs étapes déclenchés par le comportement des Utilisateurs.
  </Card>

  <Card title="Balises" icon="tags" href="./add-user-data-tags">
    Ajoutez des données au niveau Utilisateur pour la personnalisation et le ciblage.
  </Card>

  <Card title="Messages in-app" icon="window-maximize" href="./in-app-messages-setup">
    Atteignez les Utilisateurs avec des messages riches et interactifs dans votre application.
  </Card>
</Columns>

***

## Questions fréquentes

### Les Utilisateurs doivent-ils s'inscrire pour recevoir des notifications push ?

Oui. iOS et Android exigent que les Utilisateurs accordent l'autorisation avant de pouvoir recevoir des notifications push. Sur iOS, vous devez afficher l'invite système. Sur Android 13+, l'autorisation `POST_NOTIFICATIONS` est requise. Utilisez une [invite de pré-autorisation](./prompt-for-push-permissions) pour expliquer la valeur avant de déclencher la boîte de dialogue système.

### Que sont FCM, APNs, HMS et ADM ?

Ce sont des services de livraison push spécifiques à chaque plateforme. **FCM** (Firebase Cloud Messaging) livre sur Android et web. **APNs** (Apple Push Notification service) livre sur iOS et macOS. **HMS** (Huawei Mobile Services) livre sur les appareils Huawei. **ADM** (Amazon Device Messaging) livre sur les appareils Amazon Fire. Vous configurez les informations d'identification pour chacun dans le tableau de bord OneSignal lors de la [configuration du SDK](./mobile-sdk-setup).

### 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 ou les Modes focus. Consultez [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.

### Puis-je envoyer des notifications push sans notification visible ?

Oui. Utilisez les [notifications de données et d'arrière-plan](./data-notifications) pour envoyer des charges utiles personnalisées que votre application traite silencieusement. Elles sont utiles pour déclencher des synchronisations en arrière-plan, mettre à jour des données locales ou rafraîchir du contenu sans interrompre l'Utilisateur.
