> ## 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 Flutterflow
> Instructions pour ajouter le SDK Flutter OneSignal à votre application Flutterflow pour iOS et Android
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
;
};
Ce guide concerne la configuration d'application mobile Flutterflow. Si vous avez un site Flutterflow, veuillez consulter notre guide de [configuration du SDK Web](./web-sdk-setup).
## Prérequis
* Forfait Flutterflow : Standard ou supérieur
* Application et plateforme OneSignal configurées
**Prérequis 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+
**Prérequis Android**
* Appareil Android 7.0+ ou émulateur 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
### 1. Créer une nouvelle action personnalisée
Dans votre projet Flutterflow, naviguez vers Custom Code, puis cliquez sur le bouton +Add et sélectionnez Action.
Dans les paramètres Action de la barre d'outils de droite, cliquez sur Add Dependency et saisissez la dépendance suivante, puis cliquez sur refresh pour l'ajouter à l'action :
```yaml dependency theme={null}
dependencies:
onesignal_flutter: ^5.1.2
```
Dans le Action Code, sous le code préchargé, ajoutez ce qui suit, puis enregistrez et compilez votre action.
Remplacez `YOUR_APP_ID` par votre ID d'application OneSignal que vous trouverez 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 Flutter theme={null}
import 'package:onesignal_flutter/onesignal_flutter.dart';
Future onesignal() async {
//Remove this method to stop OneSignal Debugging
OneSignal.Debug.setLogLevel(OSLogLevel.verbose);
OneSignal.initialize("YOUR_APP_ID");
// The promptForPushNotificationsWithUserResponse function will show the iOS or Android push notification prompt. We recommend removing the following code and instead using an In-App Message to prompt for notification permission
OneSignal.Notifications.requestPermission(true);
}
```
Ensuite, cliquez sur le fichier main.dart dans la barre d'outils de gauche et cliquez sur l'icône + à côté de Initial Actions dans la barre de droite, puis cliquez sur l'action `onesignal` qui vient d'être créée.
Cela ajoutera l'action à votre application et provoquera l'initialisation du SDK OneSignal lors de l'exécution de l'application :
### 2. Exporter le projet
Ouvrez le menu Développeur et téléchargez l'APK :
Une fois l'APK téléchargé, vous pouvez tester l'application en faisant glisser l'APK dans un émulateur Android pour l'installer. Les capacités push devraient fonctionner immédiatement et vous pouvez envoyer des notifications push à l'appareil dès que vous accordez les autorisations push via l'invite native.
Ouvrez le menu Développeur et téléchargez le code du projet :
### 3. Configuration iOS
Le projet téléchargé ne sera probablement pas prêt à être lancé sur iOS. Avant de configurer les ajouts spécifiques à OneSignal, vous devez vous assurer que le projet est entièrement construit. Pour ce faire :
* Ouvrez une fenêtre Terminal, cd (changez de répertoire) vers le dossier `ios` de votre projet téléchargé.
* Dans Terminal, tapez `flutter build ios` et appuyez sur Entrée. Attendez que la construction se termine, cela peut prendre du temps selon la taille de votre projet.
* Toujours dans Terminal, tapez `pod install` et appuyez sur Entrée. Attendez que l'installation du pod se termine.
Ouvrez le fichier `.xcworkspace` dans Xcode situé dans le dossier ios de votre projet.
Sélectionnez le **projet racine > votre cible d'application principale > Signing & Capabilities**.
Si vous ne voyez pas Push Notifications activé, cliquez sur **+ Capability** et ajoutez **Push Notifications**. Assurez-vous de saisir les détails corrects pour votre équipe et votre Bundle Identifier.
Cliquez à nouveau sur **+ Capability** et ajoutez **Background Modes**. Cochez ensuite **Remote notifications**.
#### Ajouter l'extension de service de notification
La OneSignalNotificationServiceExtension permet à votre application iOS de recevoir des notifications enrichies avec des images, des boutons et des badges. Elle est également requise pour les fonctionnalités d'analyse de livraison confirmée de OneSignal.
Dans Xcode, sélectionnez **File > New > Target...**
Sélectionnez **Notification Service Extension** puis **Next**.
Saisissez le nom du produit comme `OneSignalNotificationServiceExtension` et appuyez sur **Finish**.
N'activez pas le schéma dans la boîte de dialogue qui s'affiche après avoir sélectionné **Finish**.
Appuyez sur **Cancel** dans l'invite "Activate scheme".
Sélectionnez la cible **OneSignalNotificationServiceExtension** et les paramètres **General**.
Définissez **Minimum Deployments** avec la **même valeur que votre cible d'application principale**. Cela devrait être iOS 11 ou supérieur.
#### Ajouter les groupes d'applications
Les groupes d'applications permettent à votre application et à la OneSignalNotificationServiceExtension de communiquer lorsqu'une notification est reçue, même si votre application n'est pas active. Cela est requis pour les badges et les livraisons confirmées.
Sélectionnez votre **cible d'application principale > Signing & Capabilities > + Capability > App Groups**.
Dans **App Groups**, cliquez sur le bouton **+**.
Définissez le conteneur App Groups comme `group.YOUR_BUNDLE_IDENTIFIER.onesignal` où `YOUR_BUNDLE_IDENTIFIER` est identique à votre "Bundle Identifier" de l'application principale.
Appuyez sur **OK** et répétez pour la cible OneSignalNotificationServiceExtension.
Sélectionnez la **cible OneSignalNotificationServiceExtension > Signing & Capabilities > + Capability > App Groups**.
Dans **App Groups**, cliquez sur le bouton **+**.
Définissez le conteneur App Groups comme `group.YOUR_BUNDLE_IDENTIFIER.onesignal` où `YOUR_BUNDLE_IDENTIFIER` est identique à **votre "Bundle Identifier" de l'application principale**.
**N'INCLUEZ PAS** `OneSignalNotificationServiceExtension`.
Cette étape n'est requise que si vous **ne souhaitez pas** utiliser le nom de groupe d'applications par défaut (qui est `group.{your_bundle_id}.onesignal`).
Ouvrez votre fichier `Info.plist` et ajoutez une nouvelle clé `OneSignal_app_groups_key` de type `String`.
Entrez le nom du groupe que vous avez coché à la dernière étape comme valeur.
Assurez-vous de faire de même pour le `Info.plist` sous le dossier `OneSignalNotificationServiceExtension`.
#### Ajouter le SDK OneSignal à la OneSignalNotificationServiceExtension
Mettez à jour votre `ios/Podfile` pour inclure :
```ruby Podfile theme={null}
target 'OneSignalNotificationServiceExtension' do
pod 'OneSignalXCFramework', '>= 5.0.0', '< 6.0'
end
```
```ruby Example theme={null}
target 'MyApp' do
config = use_native_modules!
use_react_native!(
:path => config[:reactNativePath],
# An absolute path to your application root.
:app_path => "#{Pod::Config.instance.installation_root}/.."
)
post_install do |installer|
# https://github.com/facebook/react-native/blob/main/packages/react-native/scripts/react_native_pods.rb#L197-L202
react_native_post_install(
installer,
config[:reactNativePath],
:mac_catalyst_enabled => false,
# :ccache_enabled => true
)
end
end
target 'OneSignalNotificationServiceExtension' do
pod 'OneSignalXCFramework', '>= 5.0.0', '< 6.0'
end
```
En haut de votre `Podfile`, assurez-vous d'avoir `platform :ios, '11.0'`. - Ou une version iOS plus récente si votre application le nécessite.
```Text Podfile theme={null}
# Uncomment this line to define a global platform for your project
platform :ios, '11.0'
```
Ouvrez le terminal, faites un `cd` vers le répertoire `ios` et exécutez `pod install`.
Si vous voyez l'erreur ci-dessous, ajoutez `use_frameworks!` en haut de votre podfile et réessayez.
```
- Runner (true) and OneSignalNotificationServiceExtension (false) do not both set use_frameworks!.
```
#### Code de OneSignalNotificationServiceExtension
Dans le navigateur de projet Xcode, sélectionnez le **dossier OneSignalNotificationServiceExtension** et ouvrez le fichier `NotificationService.m` ou `NotificationService.swift`.
Remplacez tout le contenu du fichier par le code suivant.
```swift Swift theme={null}
import UserNotifications
import OneSignalExtension
class NotificationService: UNNotificationServiceExtension {
var contentHandler: ((UNNotificationContent) -> Void)?
var receivedRequest: UNNotificationRequest!
var bestAttemptContent: UNMutableNotificationContent?
override func didReceive(_ request: UNNotificationRequest, withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) {
self.receivedRequest = request
self.contentHandler = contentHandler
self.bestAttemptContent = (request.content.mutableCopy() as? UNMutableNotificationContent)
if let bestAttemptContent = bestAttemptContent {
/* DEBUGGING: Uncomment the 2 lines below to check this extension is executing
Note, this extension only runs when mutable-content is set
Setting an attachment or action buttons automatically adds this */
// print("Running NotificationServiceExtension")
// bestAttemptContent.body = "[Modified] " + bestAttemptContent.body
OneSignalExtension.didReceiveNotificationExtensionRequest(self.receivedRequest, with: bestAttemptContent, withContentHandler: self.contentHandler)
}
}
override func serviceExtensionTimeWillExpire() {
// Called just before the extension will be terminated by the system.
// Use this as an opportunity to deliver your "best attempt" at modified content, otherwise the original push payload will be used.
if let contentHandler = contentHandler, let bestAttemptContent = bestAttemptContent {
OneSignalExtension.serviceExtensionTimeWillExpireRequest(self.receivedRequest, with: self.bestAttemptContent)
contentHandler(bestAttemptContent)
}
}
}
```
```c objective-c theme={null}
#import
#import "NotificationService.h"
@interface NotificationService ()
@property (nonatomic, strong) void (^contentHandler)(UNNotificationContent *contentToDeliver);
@property (nonatomic, strong) UNNotificationRequest *receivedRequest;
@property (nonatomic, strong) UNMutableNotificationContent *bestAttemptContent;
@end
@implementation NotificationService
- (void)didReceiveNotificationRequest:(UNNotificationRequest *)request withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler {
self.receivedRequest = request;
self.contentHandler = contentHandler;
self.bestAttemptContent = [request.content mutableCopy];
/* DEBUGGING: Uncomment the 2 lines below and comment out the one above to ensure this extension is executing
Note, this extension only runs when mutable-content is set
Setting an attachment or action buttons automatically adds this */
// NSLog(@"Running NotificationServiceExtension");
// self.bestAttemptContent.body = [@"[Modified] " stringByAppendingString:self.bestAttemptContent.body];
[OneSignalExtension didReceiveNotificationExtensionRequest:self.receivedRequest
withMutableNotificationContent:self.bestAttemptContent
withContentHandler:self.contentHandler];
}
- (void)serviceExtensionTimeWillExpire {
// Called just before the extension will be terminated by the system.
// Use this as an opportunity to deliver your "best attempt" at modified content, otherwise the original push payload will be used.
[OneSignalExtension serviceExtensionTimeWillExpireRequest:self.receivedRequest withMutableNotificationContent:self.bestAttemptContent];
self.contentHandler(self.bestAttemptContent);
}
@end
```
***
## 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.
***
***