> ## 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 SDK Expo
> Guide étape par étape pour intégrer le SDK OneSignal React Native et Expo dans vos applications iOS, Android et dérivées comme Amazon en utilisant Expo SDK 53+ et EAS Build.
export const SdkReleasesIframe = ({sdkFilter = undefined, viewMode = undefined, height, ...frameProps}) => {
const baseUrl = 'https://onesignal.github.io/sdk-releases';
const buildUrl = (theme, sdkFilter, viewMode) => {
const url = new URL(baseUrl);
const params = new URLSearchParams();
if (theme) {
params.set('theme', theme);
}
if (sdkFilter) {
params.set('sdk', sdkFilter);
}
if (viewMode) {
params.set('viewMode', viewMode);
}
if (params.toString()) {
url.search = params.toString();
}
return url.toString();
};
const detectTheme = () => {
if (document.documentElement.classList.contains('dark')) {
return 'dark';
}
return 'light';
};
const [theme, setTheme] = useState('light');
const [iframeSrc, setIframeSrc] = useState(() => {
const initialTheme = detectTheme();
return buildUrl(initialTheme, sdkFilter, viewMode);
});
useEffect(() => {
const currentTheme = detectTheme();
setTheme(currentTheme);
setIframeSrc(buildUrl(currentTheme, sdkFilter, viewMode));
const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');
const handleThemeChange = () => {
const newTheme = detectTheme();
setTheme(newTheme);
setIframeSrc(buildUrl(newTheme, sdkFilter, viewMode));
};
if (mediaQuery.addEventListener) {
mediaQuery.addEventListener('change', handleThemeChange);
} else {
mediaQuery.addListener(handleThemeChange);
}
window.addEventListener('storage', handleThemeChange);
const observer = new MutationObserver(handleThemeChange);
observer.observe(document.documentElement, {
attributes: true,
attributeFilter: ['class', 'data-theme']
});
return () => {
if (mediaQuery.removeEventListener) {
mediaQuery.removeEventListener('change', handleThemeChange);
} else {
mediaQuery.removeListener(handleThemeChange);
}
window.removeEventListener('storage', handleThemeChange);
observer.disconnect();
};
}, [sdkFilter, viewMode]);
const getIframeHeight = () => {
if (viewMode === 'table') {
return '450';
}
if (viewMode === 'mini') {
return '170';
}
return '800';
};
const iframeHeight = height || getIframeHeight();
return
;
};
## Vue d'ensemble
Il s'agit d'un guide étape par étape pour intégrer le SDK OneSignal React Native et Expo dans vos applications iOS et Android. À la fin de ce guide, vous pourrez envoyer des notifications push et des messages in-app avec OneSignal.
## Exigences
* Une application Expo gérée. Pour les applications React Native nues, consultez [Configuration du SDK React Native](./react-native-sdk-setup).
* [Build de développement](https://docs.expo.dev/develop/development-builds/introduction/) Expo
* Expo SDK 53+ (React Native 0.79+) avec la [nouvelle architecture](https://reactnative.dev/docs/new-architecture-intro) activée
* EAS CLI ([documentation EAS Build](https://docs.expo.dev/build/introduction/))
* Application et plateforme OneSignal configurées
**Exigences iOS**
* macOS avec Xcode 14+ (les instructions de configuration utilisent Xcode 16.2)
* Appareil avec iOS 12+, iPadOS 12+ ou simulateur Xcode exécutant iOS 16.2+
* CocoaPods 1.16.2+
**Exigences Android**
* Appareil ou émulateur Android 7.0+ avec Google Play Store (Services) installé
### Configurer votre application OneSignal et votre plateforme
Configurez votre application OneSignal avec les plateformes que vous prenez en charge — Apple (APNs), Google (FCM), Huawei (HMS) et/ou Amazon (ADM).
Si votre organisation possède déjà un compte OneSignal, [demandez à être invité](/docs/en/manage-team-members) à l'Organisation. Sinon, [inscrivez-vous pour un compte gratuit](https://onesignal.com) pour commencer.
Créez une nouvelle application en cliquant sur **New App/Website**, ou ajoutez une plateforme à une application existante dans **Settings > Push & In-App**. Sélectionnez la ou les plateformes que vous souhaitez configurer et cliquez sur **Next: Configure Your Platform**.
Entrez les identifiants pour votre plateforme :
* **Android** : [Configurer les identifiants Firebase](/docs/en/android-firebase-credentials)
* **iOS** : [Jeton p8 (Recommandé)](/docs/en/ios-p8-token-based-connection-to-apns) ou [Certificat p12](/docs/en/ios-p12-generate-certificates)
* **Amazon** : [Générer une clé API](/docs/en/generate-an-amazon-api-key)
* **Huawei** : [Autoriser OneSignal](/docs/en/authorize-onesignal-to-send-huawei-push)
Cliquez sur **Save & Continue** après avoir saisi vos identifiants.
Votre **App ID** est affiché sur l'écran final. Copiez et enregistrez-le — vous en avez besoin lors de l'initialisation du SDK. Sélectionnez votre plateforme SDK, puis suivez le guide de configuration.
***
## Configuration du SDK
### 1. Ajouter le SDK
Installez le plugin Expo OneSignal à l'aide de la CLI Expo.
```shell npm theme={null}
npx expo install onesignal-expo-plugin
```
Ajoutez le package `react-native-onesignal` à votre projet.
```shell npm theme={null}
npm install --save react-native-onesignal
```
```shell Yarn theme={null}
yarn add react-native-onesignal
```
### 2. Configurer le plugin
Ouvrez votre `app.json` (ou `app.config.js` / `app.config.ts`). Vous devez inclure les paramètres suivants.
**Paramètres requis**
* `"bundleIdentifier"` : L'identifiant de bundle de votre application qui correspond à l'authentification p8 ou p12 que vous utilisez dans votre application OneSignal.
* `"infoPlist"` : Nécessite que la clé `UIBackgroundModes` soit définie sur `["remote-notification"]`.
* `"entitlements"`
* Nécessite que la clé `aps-environment` soit définie sur `"development"` pour les tests et `"production"` pour les builds TestFlight et App Store.
* Nécessite que la clé `com.apple.security.application-groups` soit définie sur `["group.${ios.bundleIdentifier}.onesignal"]`.
* `"android"` : Nécessite que la clé `package` soit définie sur le nom de package de votre application.
* `"plugins"` : Le tableau `plugins` de votre application. Il est nécessaire d'ajouter le plugin `[onesignal-expo-plugin]` en haut du tableau de plugins. Il nécessite également que la clé `mode` soit définie sur `"development"` pour les tests et `"production"` pour les builds TestFlight et App Store.
Assurez-vous d'ajouter le plugin `[onesignal-expo-plugin]` au début du tableau de plugins. Il doit être le premier plugin du tableau. Cela empêchera l'erreur `OneSignal/OneSignal.h file not found`.
| Prop | Requis | Description |
| :----------------------: | :------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `mode` | ✅ | Configure l'autorisation [environnement APNs](https://developer.apple.com/documentation/bundleresources/entitlements/aps-environment). Utilisez `"development"` ou `"production"` — `"development"` pour les tests et `"production"` pour les builds TestFlight et App Store. |
| `devTeam` | Déprécié | **Déprécié.** Préférez [`ios.appleTeamId`](https://docs.expo.dev/versions/latest/config/app/#appleteamid) dans la configuration Expo. Le plugin utilise `devTeam` en secours si `appleTeamId` n'est pas défini (par ex. `"91SW8A37CR"`). |
| `iPhoneDeploymentTarget` | ❌ | `IPHONEOS_DEPLOYMENT_TARGET` utilisé lors de l'ajout de l'[extension de service de notification iOS](./service-extensions). Doit correspondre à la version iOS minimale dans votre Podfile (par ex. `"15.0"`). |
| `smallIcons` | ❌ | Tableau de chemins locaux vers les [petites icônes de notification](./notification-icons) Android (blanc, transparent, 96×96px). Les images sont automatiquement mises à l'échelle dans les dossiers de ressources appropriés. Exemple : `["./assets/ic_stat_onesignal_default.png"]` |
| `largeIcons` | ❌ | Tableau de chemins locaux vers les [grandes icônes de notification](./notification-icons) Android (blanc, transparent, 256×256px). Exemple : `["./assets/ic_onesignal_large_icon_default.png"]` |
| `smallIconAccentColor` | ❌ | Couleur hexadécimale d'accent de l'icône de notification Android (par ex. `"#FF0000"`). |
| `iosNSEFilePath` | ❌ | Chemin local vers une extension de service de notification personnalisée en Objective-C. Exemple : `"./assets/NotificationService.m"` |
| `appGroupName` | ❌ | Nom personnalisé d'[App Group](./ios-sdk-setup) iOS. Par défaut `"group.{ios.bundleIdentifier}.onesignal"` si omis (par ex. `"group.com.example.myapp.onesignal2"`). |
| `nseBundleIdentifier` | ❌ | Suffixe de l'identifiant de bundle du NSE. L'identifiant complet est `{ios.bundleIdentifier}.{nseBundleIdentifier}`. Par défaut `OneSignalNotificationServiceExtension` si omis. |
| `disableNSE` | ❌ | Si `true`, le NSE iOS n'est pas ajouté. Le NSE est requis pour les badges, la confirmation de livraison, les pièces jointes médias et les boutons d'action — ne le désactivez que si vous n'avez besoin que de push basique. |
| `disableLocation` | ❌ | Si `true`, le module de localisation natif de OneSignal est exclu des builds iOS et Android. Utilisez cette option uniquement si votre application n'appelle pas `OneSignal.Location`. |
| `sounds` | ❌ | Tableau de chemins locaux vers des sons personnalisés (`.wav` uniquement, ≤30 s). Copiés dans le bundle de l'app sur iOS et `res/raw/` sur Android. Exemple : `["./assets/notification_sound.wav"]`. Voir [Sons de notification](./notification-sounds). |
#### Facultatif : désactiver le module de localisation
Si votre application n'utilise pas `OneSignal.Location`, définissez `disableLocation` sur `true` dans les props du plugin Expo OneSignal. Cette option nécessite `react-native-onesignal` 5.5.1 ou une version ultérieure. Le plugin configure la résolution des dépendances natives afin que `react-native-onesignal` exclue le module de localisation. Sur iOS, le plugin écrit le paramètre d'environnement du Podfile utilisé pendant la résolution CocoaPods. Sur Android, le plugin écrit `onesignal.disableLocation=true` dans les propriétés Gradle générées.
```ts app.config.ts theme={null}
plugins: [
withOneSignal({
mode: 'development',
disableLocation: true,
}),
],
```
```json app.json theme={null}
"plugins": [
[
"onesignal-expo-plugin",
{
"mode": "development",
"disableLocation": true
}
]
]
```
À partir de `onesignal-expo-plugin` 2.6.0, vous pouvez importer `withOneSignal` pour bénéficier d'une prise en charge complète de TypeScript et de l'autocomplétion sur les props du plugin.
```ts app.config.ts theme={null}
import { ConfigContext, ExpoConfig } from '@expo/config';
import withOneSignal from 'onesignal-expo-plugin/plugin';
export default ({ config }: ConfigContext): ExpoConfig => ({
...config,
ios: {
bundleIdentifier: 'com.yourcompany.yourapp',
infoPlist: {
UIBackgroundModes: ['remote-notification'],
},
entitlements: {
'aps-environment': 'development',
},
},
android: {
package: 'com.yourcompany.yourapp',
},
plugins: [
withOneSignal({
mode: 'development',
}),
],
});
```
```json app.json theme={null}
{
"expo": {
"ios": {
"bundleIdentifier": "com.yourcompany.yourapp",
"infoPlist": {
"UIBackgroundModes": ["remote-notification"]
},
"entitlements": {
"aps-environment": "development"
}
},
"android": {
"package": "com.yourcompany.yourapp"
},
"plugins": [
[
"onesignal-expo-plugin",
{
"mode": "development"
}
]
]
}
}
```
### 3. Initialiser le SDK
Selon votre structure Expo (entrée d'application traditionnelle ou Expo Router), initialisez OneSignal en suivant ces options.
Dans votre fichier `App.tsx` ou `App.js`, initialisez OneSignal avec les méthodes fournies.
Remplacez `YOUR_APP_ID` par votre ID d'application OneSignal trouvé dans votre tableau de bord OneSignal **Paramètres > [Clés et ID](./keys-and-ids)**.
Si vous n'avez pas accès à l'application OneSignal, demandez à vos [membres d'équipe](./manage-team-members) de vous inviter.
```javascript App.tsx theme={null}
import React, { useEffect } from 'react';
// Inclure le package OneSignal
import { OneSignal, LogLevel } from 'react-native-onesignal';
export default function App() {
useEffect(() => {
// Activer la journalisation détaillée pour le débogage (à supprimer en production)
OneSignal.Debug.setLogLevel(LogLevel.Verbose);
// Remplacez par votre OneSignal App ID depuis Dashboard > Settings > Keys & IDs
OneSignal.initialize('YOUR_APP_ID');
// Demande l'autorisation push au premier lancement.
// En production, préférez un message in-app pour de meilleurs taux d'acceptation.
OneSignal.Notifications.requestPermission(false);
// Définissez les listeners une fois pour réutiliser la même référence à l'ajout et au retrait.
const clickListener = (event) => {
console.log('OneSignal: notification clicked:', event);
};
// En v5, les notifications en premier plan s'affichent automatiquement.
// Appelez event.preventDefault() pour les supprimer, puis
// event.getNotification().display() pour les afficher après un traitement asynchrone.
const foregroundListener = (event) => {
console.log('OneSignal: foreground will display:', event);
};
OneSignal.Notifications.addEventListener('click', clickListener);
OneSignal.Notifications.addEventListener('foregroundWillDisplay', foregroundListener);
// Nettoyez les listeners au démontage du composant pour éviter les fuites de mémoire.
// La même référence passée à addEventListener doit être passée ici.
return () => {
OneSignal.Notifications.removeEventListener('click', clickListener);
OneSignal.Notifications.removeEventListener('foregroundWillDisplay', foregroundListener);
};
}, []);
}
```
Dans votre fichier `app/_layout.tsx` ou `app/_layout.js`, initialisez OneSignal avec les méthodes fournies.
Remplacez `YOUR_APP_ID` par votre ID d'application OneSignal trouvé dans votre tableau de bord OneSignal **Paramètres > [Clés et ID](./keys-and-ids)**.
Si vous n'avez pas accès à l'application OneSignal, demandez à vos [membres d'équipe](./manage-team-members) de vous inviter.
L'exemple ci-dessous utilise `App` comme nom de fonction — Expo Router accepte tout composant exporté par défaut, donc le renommer en `RootLayout` est optionnel mais conventionnel.
```javascript App.tsx theme={null}
import React, { useEffect } from 'react';
// Inclure le package OneSignal
import { OneSignal, LogLevel } from 'react-native-onesignal';
export default function App() {
useEffect(() => {
// Activer la journalisation détaillée pour le débogage (à supprimer en production)
OneSignal.Debug.setLogLevel(LogLevel.Verbose);
// Remplacez par votre OneSignal App ID depuis Dashboard > Settings > Keys & IDs
OneSignal.initialize('YOUR_APP_ID');
// Demande l'autorisation push au premier lancement.
// En production, préférez un message in-app pour de meilleurs taux d'acceptation.
OneSignal.Notifications.requestPermission(false);
// Définissez les listeners une fois pour réutiliser la même référence à l'ajout et au retrait.
const clickListener = (event) => {
console.log('OneSignal: notification clicked:', event);
};
// En v5, les notifications en premier plan s'affichent automatiquement.
// Appelez event.preventDefault() pour les supprimer, puis
// event.getNotification().display() pour les afficher après un traitement asynchrone.
const foregroundListener = (event) => {
console.log('OneSignal: foreground will display:', event);
};
OneSignal.Notifications.addEventListener('click', clickListener);
OneSignal.Notifications.addEventListener('foregroundWillDisplay', foregroundListener);
// Nettoyez les listeners au démontage du composant pour éviter les fuites de mémoire.
// La même référence passée à addEventListener doit être passée ici.
return () => {
OneSignal.Notifications.removeEventListener('click', clickListener);
OneSignal.Notifications.removeEventListener('foregroundWillDisplay', foregroundListener);
};
}, []);
}
```
**Listeners réutilisables avec `useCallback`**
Si votre listener doit accéder à des props ou à l'état, définissez-le en dehors de `useEffect` avec `useCallback` afin que la même référence soit utilisée pour ajouter et retirer le listener. Passer des références de fonction différentes à `addEventListener` et `removeEventListener` n'a aucun effet — le listener n'est pas retiré et peut se déclencher après le démontage du composant.
```javascript theme={null}
import React, { useCallback, useEffect } from 'react';
import { OneSignal } from 'react-native-onesignal';
export default function App() {
const clickListener = useCallback((event) => {
console.log('OneSignal: notification clicked:', event);
// vos dépendances peuvent varier
}, []);
useEffect(() => {
OneSignal.Notifications.addEventListener('click', clickListener);
return () => {
OneSignal.Notifications.removeEventListener('click', clickListener);
};
}, [clickListener]);
}
```
Consultez notre [dépôt GitHub du plugin Expo OneSignal](https://github.com/OneSignal/onesignal-expo-plugin) pour des options de configuration supplémentaires, des instructions de configuration plus complexes ou ouvrez un problème. Nos SDK sont open source et nous accueillons les PR !
***
## Configuration Android
Assurez-vous que votre application OneSignal est configurée pour la plateforme Android en utilisant vos [identifiants Firebase](/docs/en/android-firebase-credentials).
Configurez vos [icônes de notification](/docs/en/notification-icons) pour qu'elles correspondent à l'image de marque de votre application. Si cette étape est ignorée, une icône de cloche par défaut s'affichera pour vos notifications push.
**Compiler pour Android**
À ce stade, vous devriez pouvoir compiler et exécuter votre application sur un appareil Android physique ou un émulateur sans problème.
Après avoir confirmé que votre compilation Android fonctionne :
* Continuez avec la [Configuration iOS](#ios-setup), le cas échéant.
* Ou passez directement à [Tester l'intégration du SDK OneSignal](#testing-the-onesignal-sdk-integration).
***
## Configuration iOS
Assurez-vous que votre application OneSignal est configurée pour la plateforme iOS en utilisant soit le [jeton p8 (Recommandé)](./ios-p8-token-based-connection-to-apns) soit le [certificat p12](./ios-p12-generate-certificates).
Cela doit utiliser les mêmes informations d'identification configurées dans votre configuration EAS.
### Build pour iOS
Vous devriez maintenant pouvoir compiler et exécuter votre application sur un véritable appareil iOS ou un simulateur iOS (16.2+).
#### Erreurs de build iOS courantes
Vous pouvez voir cette erreur lors de la compilation avec Xcode 15+, en raison d'un changement de configuration par défaut affectant les systèmes multiplateformes.
1. Ouvrez votre dossier `.xcworkspace` dans Xcode et naviguez vers **votre cible d'application > Build Phases**.
2. Vous devriez avoir une phase appelée **"Embed Foundation Extensions"** ou **"Embed App Extensions"**.
3. Faites glisser et déplacez cette phase de build *au-dessus de* **"Run Script"**.
4. Compilez et exécutez votre application. L'erreur devrait être résolue.
RuntimeError - `PBXGroup` a tenté d'initialiser un objet avec ISA inconnu `PBXFileSystemSynchronizedRootGroup` à partir des attributs : `{"isa"=>"...", "exceptions"=>["//", "..."], "explicitFileTypes"=>{}, "explicitFolders"=>[], "path"=>"OneSignalNotificationServiceExtension", "sourceTree"=>""}`
Correction :
1. Trouvez le dossier listé sous "path" dans l'erreur
2. Dans la barre latérale du projet Xcode, faites un clic droit sur le dossier
3. Sélectionnez **Convertir en groupe**
Après avoir confirmé que votre build iOS fonctionne, continuez avec [Tester l'intégration du SDK OneSignal](#testing-the-onesignal-sdk-integration).
***
## Tester l'intégration du SDK OneSignal
Ce guide vous aide à vérifier que votre intégration du SDK OneSignal fonctionne correctement en testant les notifications push, l'enregistrement des abonnements et la messagerie in-app.
Si vous testez avec un émulateur Android, il doit démarrer avec un démarrage à froid.
1. Allez dans **Device Manager** dans Android Studio.
2. Sélectionnez votre appareil émulateur et cliquez sur **Edit**.
3. Allez dans **Additional Settings** ou **More**.
4. Définissez l'**option de démarrage** sur **Cold Boot**.
5. Enregistrez les modifications et redémarrez l'émulateur.
### Vérifier les abonnements mobiles
L'invite d'autorisation push native devrait apparaître automatiquement si vous avez ajouté la méthode `requestPermission` lors de l'initialisation.
Avant d'accepter l'invite, vérifiez le tableau de bord OneSignal :
* Allez dans **Audience > Subscriptions**.
* Vous devriez voir une nouvelle entrée avec le statut "Never Subscribed".
Le statut de l'abonnement devrait maintenant afficher **Subscribed**.
Vous avez créé avec succès un [abonnement mobile](/docs/en/subscriptions).
Les abonnements mobiles sont créés lorsque les utilisateurs ouvrent votre application pour la première fois sur un appareil ou s'ils désinstallent et réinstallent votre application sur le même appareil.
### Configurer les abonnements de test
Les abonnements de test sont utiles pour tester une notification push avant d'envoyer un message.
Dans le tableau de bord, à côté de l'abonnement, cliquez sur le bouton **Options (trois points)** et sélectionnez **Add to Test Users**.
Nommez l'abonnement afin de pouvoir identifier facilement votre appareil plus tard dans l'**onglet Test Users**.
Allez dans **Audience > Segments > New Segment**.
Nommez le segment `Test Users` (le nom est important car il sera utilisé plus tard).
Vous avez créé avec succès un segment d'utilisateurs de test.
Nous pouvons maintenant tester l'envoi de messages à cet appareil individuel et à des groupes d'utilisateurs de test.
### Envoyer un push de test via l'API
Dans votre tableau de bord OneSignal, allez dans **Settings > [Keys & IDs](/docs/en/keys-and-ids)**.
Remplacez `YOUR_APP_API_KEY` et `YOUR_APP_ID` dans le code ci-dessous par vos clés réelles. Ce code utilise le segment `Test Users` que nous avons créé plus tôt.
```curl theme={null}
curl -X \
POST --url 'https://api.onesignal.com/notifications' \
--header 'content-type: application/json; charset=utf-8' \
--header 'authorization: Key YOUR_APP_API_KEY' \
--data \
'{
"app_id": "YOUR_APP_ID",
"target_channel": "push",
"name": "Testing basic setup",
"headings": {
"en": "👋"
},
"contents": {
"en": "Hello world!"
},
"included_segments": [
"Test Users"
],
"ios_attachments": {
"onesignal_logo": "https://avatars.githubusercontent.com/u/11823027?s=200&v=4"
},
"big_picture": "https://avatars.githubusercontent.com/u/11823027?s=200&v=4"
}'
```
Exécutez le code dans votre terminal.
Si toutes les étapes de configuration ont été complétées avec succès, les abonnements de test devraient recevoir une notification avec une image incluse :
Les images apparaîtront petites dans la vue de notification réduite. Développez la notification pour voir l'image complète.
Dans votre tableau de bord, allez dans **Delivery > Sent Messages**, puis cliquez sur le message pour afficher les statistiques.
Vous devriez voir la statistique **confirmed**, ce qui signifie que l'appareil a reçu la push.
Vous avez envoyé avec succès une notification via notre API à un segment.
* Aucune image reçue ? Votre [Notification Service Extension](#ios-setup) est peut-être manquant.
* Aucune livraison confirmée ? Consultez le guide de dépannage [ici](/docs/en/confirmed-delivery#troubleshooting-confirmed-delivery).
* Vous rencontrez des problèmes ? Copiez-collez la requête API et un journal du début à la fin du lancement de l'application dans un fichier `.txt`. Ensuite, partagez les deux avec `support@onesignal.com`.
### Envoyer un message in-app
Les [messages in-app](/docs/en/in-app-messages-setup) vous permettent de communiquer avec les utilisateurs pendant qu'ils utilisent votre application.
C'est parce que les utilisateurs doivent répondre aux critères d'audience in-app *avant* qu'une nouvelle session ne commence. Dans OneSignal, 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. Pour plus de détails, consultez notre guide sur [comment les messages in-app sont affichés](/docs/en/in-app-messages-setup#how-are-iams-displayed%3F).
* Dans votre tableau de bord OneSignal, naviguez vers **Messages > In-App > New In-App**.
* Trouvez et sélectionnez le message **Welcome**.
* Définissez votre Audience comme le segment **Test Users** que nous avons utilisé précédemment.
Sous **Schedule > How often do you want to show this message?** sélectionnez **Every time trigger conditions are satisfied**.
Cliquez sur **Make Message Live** pour qu'il soit disponible pour vos utilisateurs de test chaque fois qu'ils ouvrent l'application.
Après que le message in-app soit actif, ouvrez votre application. Vous devriez le voir s'afficher :
Vous ne voyez pas le message ?
* Démarrez une nouvelle session
* Vous devez fermer ou mettre l'application en arrière-plan pendant au moins 30 secondes avant de la rouvrir. Cela garantit qu'une nouvelle session est démarrée.
* Pour plus d'informations, voir [comment les messages in-app sont affichés](/docs/en/in-app-messages-setup#how-are-iams-displayed%3F).
* Toujours dans le segment `Test Users` ?
* Si vous avez réinstallé ou changé d'appareil, réajoutez l'appareil aux [abonnements de test](#set-up-test-subscriptions) et confirmez qu'il fait partie du segment Test Users.
* Vous rencontrez des problèmes ?
* Suivez [Obtenir un journal de débogage](/docs/en/capturing-a-debug-log) tout en reproduisant les étapes ci-dessus. Cela générera des journaux supplémentaires que vous pourrez partager avec `support@onesignal.com` et nous vous aiderons à enquêter sur ce qui se passe.
Vous avez configuré avec succès le SDK OneSignal et appris des concepts importants tels que :
* Collecter des [Abonnements](/docs/en/subscriptions), définir des [abonnements de test](/docs/en/find-set-test-subscriptions) et créer des [Segments](/docs/en/segmentation).
* Envoyer des [Push](/docs/en/push) avec des images et une [Livraison confirmée](/docs/en/confirmed-delivery) en utilisant des Segments et notre API [Create message](/reference/create-message).
* Envoyer des [messages in-app](/docs/en/in-app-messages-setup).
Continuez avec ce guide pour identifier les utilisateurs dans votre application et configurer des fonctionnalités supplémentaires.
***
## Identification des utilisateurs
Précédemment, nous avons démontré comment créer des [Abonnements](/docs/en/subscriptions) mobiles. Nous allons maintenant étendre l'identification des [Utilisateurs](/docs/en/users) sur tous leurs abonnements (y compris push, email et SMS) en utilisant le SDK OneSignal. Nous couvrirons les External IDs, les tags, les abonnements multicanaux, la confidentialité et le suivi des événements pour vous aider à unifier et engager les utilisateurs sur toutes les plateformes.
### Attribuer un External ID
Utilisez un External ID pour identifier les utilisateurs de manière cohérente sur tous les appareils, adresses e-mail et numéros de téléphone en utilisant l'identifiant utilisateur de votre backend. Cela garantit que votre messagerie reste unifiée sur tous les canaux et systèmes tiers (particulièrement important pour les [Intégrations](/docs/en/integrations)).
Définissez l'External ID avec la [méthode `login`](/docs/en/mobile-sdk-reference#login-external-id) de notre SDK chaque fois qu'ils sont identifiés par votre application.
OneSignal génère des ID uniques en lecture seule pour les abonnements (Subscription ID) et les utilisateurs (OneSignal ID).
Lorsque les utilisateurs téléchargent votre application sur différents appareils, s'abonnent à votre site Web et/ou vous fournissent des adresses e-mail et des numéros de téléphone en dehors de votre application, de nouveaux abonnements seront créés.
La définition de l'External ID via notre SDK est fortement recommandée pour identifier les utilisateurs sur tous leurs abonnements, quelle que soit la façon dont ils sont créés.
### Ajouter des tags de données
Les [Tags](/docs/en/add-user-data-tags) sont des paires clé-valeur de données chaîne que vous pouvez utiliser pour stocker les propriétés des utilisateurs (comme `username`, `role` ou les préférences) et les événements (comme `purchase_date`, `game_level` ou les interactions utilisateur). Les tags alimentent la [Personnalisation des messages](/docs/en/message-personalization) et la [Segmentation](/docs/en/segmentation) avancées permettant des cas d'utilisation plus avancés.
Définissez les tags avec les [méthodes `addTag` et `addTags`](/docs/en/mobile-sdk-reference#data-tags) de notre SDK au fur et à mesure que les événements se produisent dans votre application.
Dans cet exemple, l'utilisateur a atteint le niveau 6 identifiable par le tag appelé `current_level` défini sur une valeur de `6`.
Nous pouvons créer un segment d'utilisateurs ayant un niveau entre 5 et 10, et l'utiliser pour envoyer des messages ciblés et personnalisés :
### Ajouter des abonnements email et/ou SMS
Plus tôt, nous avons vu comment notre SDK crée des abonnements mobiles pour envoyer des messages push et in-app. Vous pouvez également atteindre les utilisateurs via les canaux email et SMS en créant les abonnements correspondants.
* Utilisez la [méthode `addEmail`](/docs/en/mobile-sdk-reference#addemail-%2C-removeemail) pour créer des abonnements email.
* Utilisez la [méthode `addSms`](/docs/en/mobile-sdk-reference#addsms-%2C-removesms) pour créer des abonnements SMS.
Si l'adresse e-mail et/ou le numéro de téléphone existent déjà dans l'application OneSignal, le SDK l'ajoutera à l'utilisateur existant, il ne créera pas de doublons.
Vous pouvez afficher les utilisateurs unifiés via **Audience > Users** dans le tableau de bord ou avec l'[API View user](/reference/view-user).
Meilleures pratiques pour la communication multicanale
* Obtenez un consentement explicite avant d'ajouter des abonnements email ou SMS.
* Expliquez les avantages de chaque canal de communication aux utilisateurs.
* Fournissez des préférences de canal afin que les utilisateurs puissent sélectionner les canaux qu'ils préfèrent.
***
### Confidentialité et consentement de l'utilisateur
Pour contrôler quand OneSignal collecte les données utilisateur, utilisez les méthodes de contrôle du consentement du SDK :
* [`setConsentRequired(true)`](/docs/en/mobile-sdk-reference#setconsentrequired) : Empêche la collecte de données jusqu'à ce que le consentement soit donné.
* [`setConsentGiven(true)`](/docs/en/mobile-sdk-reference#setconsentgiven) : Active la collecte de données une fois le consentement accordé.
Consultez nos documents sur la confidentialité et la sécurité pour en savoir plus sur :
* [Données collectées par le SDK](/docs/en/data-collected-by-the-onesignal-sdk)
* [Gestion des données personnelles](/docs/en/handling-personal-data)
***
## Demander les autorisations push
Au lieu d'appeler `requestPermission()` immédiatement à l'ouverture de l'application, adoptez une approche plus stratégique. Utilisez un message in-app pour expliquer la valeur des notifications push avant de demander l'autorisation.
Pour les meilleures pratiques et les détails d'implémentation, consultez notre guide [Demander les autorisations push](/docs/en/prompt-for-push-permissions).
***
## Écouter les événements push, utilisateur et in-app
Utilisez les écouteurs du SDK pour réagir aux actions des utilisateurs et aux changements d'état.
Le SDK fournit plusieurs écouteurs d'événements auxquels vous pouvez vous connecter. Consultez notre [guide de référence du SDK](/docs/en/mobile-sdk-reference) pour plus de détails.
### Événements de notification push
* [`addClickListener()`](/docs/en/mobile-sdk-reference#addclicklistener-push) : Détecter quand une notification est tapée. Utile pour les [Deep Linking](/docs/en/deep-linking).
* [`addForegroundLifecycleListener()`](/docs/en/mobile-sdk-reference#addforegroundlifecyclelistener-push) : Contrôler comment les notifications se comportent au premier plan.
Pour une personnalisation complète, consultez [Mobile Service Extensions](/docs/en/service-extensions).
### Changements d'état de l'utilisateur
* [`addObserver()` pour l'état utilisateur](/docs/en/mobile-sdk-reference#addobserver-user-state) : Détecter quand l'External ID est défini.
* [`addPermissionObserver()`](/docs/en/mobile-sdk-reference#addpermissionobserver-push) : Suivre l'interaction spécifique de l'utilisateur avec l'invite d'autorisation push native.
* [`addObserver()` pour l'abonnement push](/docs/en/mobile-sdk-reference#addobserver-push-subscription-changes) : Suivre quand le statut de l'abonnement push change.
### Événements de message in-app
* [`addClickListener()`](/docs/en/mobile-sdk-reference#addclicklistener-in-app) : Gérer les actions de clic in-app. Idéal pour le deep linking ou le suivi des événements.
* [`addLifecycleListener()`](/docs/en/mobile-sdk-reference#addclicklistener-in-app) : Suivre le cycle de vie complet des messages in-app (affiché, cliqué, rejeté, etc.).
***
## Configuration avancée et capacités
Explorez davantage de capacités pour améliorer votre intégration :
* [🔁 Migrer vers OneSignal depuis un autre service](/docs/en/migrating-to-onesignal)
* [🌍 Suivi de localisation](/docs/en/mobile-sdk-reference#location)
* [🔗 Deep Linking](/docs/en/deep-linking)
* [🔌 Intégrations](/docs/en/integrations)
* [🧩 Extensions de service mobile](/docs/en/service-extensions)
* [🛎️ Boutons d'action](/docs/en/action-buttons)
* [🌐 Messagerie multilingue](/docs/en/multi-language-messaging)
* [🛡️ Vérification d'identité](/docs/en/identity-verification)
* [📊 Résultats personnalisés](/docs/en/custom-outcomes)
* [📲 Live Activities](/docs/en/live-activities)
### Configuration et référence du SDK mobile
Assurez-vous d'avoir activé toutes les fonctionnalités clés en consultant le guide [Configuration push mobile](/docs/en/mobile-push-setup).
Pour tous les détails sur les méthodes disponibles et les options de configuration, visitez la [référence du SDK mobile](/docs/en/mobile-sdk-reference).
Félicitations ! Vous avez terminé avec succès le guide de configuration du SDK mobile.
***
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 !
***