Reconnect ne prend actuellement en charge que l’intégration Firebase pour les notifications push. Des intégrations supplémentaires seront bientôt disponibles.
Intégrez votre compte Firebase avec Reconnect pour déclencher des notifications push à destination des utilisateurs Android et iOS.
Configurez l’intégration
Prérequis : un compte Firebase intégré à votre application.
Pour créer l’intégration dans Reconnect :
- Dans l’onglet Integrations (Intégrations), cliquez sur Create Channel Integration (Créer une intégration de canal) puis sélectionnez Push Notifications (Notifications push).
- Sélectionnez l’option Firebase.
- Transférez votre fichier de clé de compte de service. Apprenez comment récupérer le fichier dans la section suivante.
Notez ce qui suit :- Le fichier est disponible au téléchargement dans votre projet dans Firebase.
- Il doit s’agir d’un fichier JSON.
- Cliquez sur Validate & Save (Valider et Enregistrer). Le contenu du fichier est validé par rapport aux services Firebase. Si la validation échoue, une erreur s’affiche et le fichier est supprimé. Si la validation réussit, l’intégration est enregistrée et est prête à être utilisée.
Récupérez le fichier de clé de compte de service Firebase
Pour récupérer le fichier de clé Firebase, vous devez créer un nouveau compte de service et générer le jeton.
Étape 1 : créez un nouveau compte de service dans Firebase
Dans votre projet dans Firebase, faites ce qui suit :
- Accédez à Project Overview › Project Settings (Aperçu du projet Paramètres du projet).
- Dans l’onglet Cloud Messaging (Messagerie cloud) ou Service accounts (Comptes de service), sélectionnez Manage Service Accounts (Gérer les comptes de service).
Cela vous amène à la console Google Cloud (console.cloud.google.com). - Cliquez sur + Create Service Account (+ Créer un compte de service).
- Saisissez un nom pour le compte de service (par exemple : DY, DYServiceAccount, ou DynamicYield).
- Saisissez l’identifiant de votre compte de service.
- De façon facultative, vous pouvez saisir une description pour plus de clarté. Par exemple : « Pour les notifications push utilisant les services DY. »
- Cliquez sur Create and Continue (Créer et continuer).
Étape 2 : définissez un rôle d’accès et générer le jeton
- Dans la section Grant this service account access to project (accorder à ce compte de service l’accès au projet), cliquez sur Pick a Predefined Role (Choisir un rôle prédéfini), puis sélectionnez l’un des rôles suivants qui disposent de l’autorisation cloudmessaging.messages.create (pour en savoir plus sur les rôles, reportez-vous à Comprendre les rôles dans la documentation Firebase) :
- Firebase Admin (roles/firebase.admin) : accorde des autorisations générales pour tous les services Firebase, y compris Firebase Cloud Messaging. Permet au compte d’envoyer des notifications push, mais est trop permissif en ce qui concerne uniquement les opérations liées au Firebase Cloud Messaging.
- Firebase Grow Admin (roles/firebase.growthAdmin) : octroie des autorisations dans plusieurs services Firebase liés au développement, comme Firebase Cloud Messaging et Firebase Remote Config.
- Firebase Admin SDK Administrator Service Agent (roles/firebase.sdkAdminServiceAgent) : permet aux comptes de service d’agir comme des SDK Firebase Admin. Cela n’est pas spécifiquement déstyiné à FCM, mais peut inclure les autorisations requises.
- Firebase SDK Provisioning Service Agent (roles/firebase.sdkProvisioningServiceAgent) : conçu pour provisionner et gérer les configurations SDK. Ce n’est pas nécessairement directement lié à l’envoi de messages FCM.
- Cliquez sur Continue (Continuer) puis sur Done (Terminé).
- Dans le menu d’actions à côté du compte de service (3 points verticaux), sélectionnez Manage keys (Gérer les clés).
- Cliquez sur + ADD KEY (+ AJOUTER CLÉ) puis sélectionnez JSON.
- Une clé JSON est générée et téléchargée. Fournissez cette clé à Dynamic Yield dans l’intégration comme décrit dans la section sur la configuration de l’intégration.
Documentation Firebase utile
Vous trouverez à la suite des documents importants contenant des informations sur les champs contenus dans les notifications envoyées via le SDK Firebase Admin (color, image, click link, title, body) :