Skip to main content

Aperçu

Si vous avez un site web adapté aux mobiles et souhaitez le convertir en une application mobile téléchargeable pour l’Apple App Store ou le Google Play Store, Median.co est une solution puissante. Il offre également une intégration transparente avec OneSignal pour activer les notifications push.

Configuration

1. Créer votre application avec Median.co

  1. Suivez le guide de démarrage de Median.co.
  2. Créez une application sur <https://median.co/app>.

2. Configurer OneSignal

  1. Accédez à onesignal.com et créez un compte.
  2. Configurez votre application et plateforme OneSignal.

Configurer votre application OneSignal et votre plateforme

Configuration requise pour les notifications push Pour commencer à envoyer des notifications push avec OneSignal, vous devez d’abord configurer votre application OneSignal avec toutes 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é avec un rôle administrateur pour configurer l’application. Sinon, inscrivez-vous pour un compte gratuit pour commencer.
Vous pouvez gérer plusieurs plateformes (iOS, Android, Huawei, Amazon, Web) sous une seule application OneSignal.
1

Créer ou sélectionner votre application

  • Pour ajouter des plateformes à une application existante, allez dans Settings > Push & In-App dans le tableau de bord OneSignal.
  • Pour repartir de zéro, cliquez sur New App/Website et suivez les instructions.

L'exemple montre la création d'une nouvelle application.

2

Configurer et activer une plateforme

  • Choisissez un nom clair et reconnaissable pour votre application et votre organisation.
  • Sélectionnez la ou les plateformes que vous souhaitez configurer (iOS, Android, etc.).
  • Cliquez sur Next: Configure Your Platform.

Exemple de configuration de votre première application, organisation et canal OneSignal.

3

Configurer les identifiants de plateforme

Suivez les instructions en fonction de vos plateformes :Cliquez sur Save & Continue après avoir saisi vos identifiants.
4

Choisir le SDK cible

Sélectionnez le SDK qui correspond à votre plateforme de développement (par exemple, iOS, Android, React Native, Unity), puis cliquez sur Save & Continue.

Sélectionnez le SDK que vous utilisez pour accéder à la documentation.

5

Installer le SDK et enregistrer votre App ID

Une fois votre plateforme configurée, votre OneSignal App ID sera affiché. Copiez et enregistrez cet ID—vous en aurez besoin lors de l’installation et de l’initialisation du SDK.Si vous collaborez avec d’autres personnes, utilisez le bouton Invite pour ajouter des développeurs ou des membres de l’équipe, puis cliquez sur Done pour terminer la configuration.

Enregistrez votre App ID et invitez des membres d'équipe supplémentaires.

Une fois terminé, suivez le guide d’installation du SDK pour votre plateforme sélectionnée afin de terminer l’intégration de OneSignal.

3. Lier OneSignal à votre application Median

Collez l’ID d’application OneSignal dans la configuration de votre application Median.co (GoNative).

Test de 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 intégrée.

Vérifier les abonnements mobiles

1

Lancez votre application sur un appareil de test.

La demande d’autorisation push native devrait apparaître automatiquement si vous avez ajouté la méthode requestPermission lors de l’initialisation.

Demandes d'autorisation push iOS et Android

2

Vérifiez votre tableau de bord OneSignal

Avant d’accepter la demande, vérifiez le tableau de bord OneSignal :
  • Accédez à Audience > Subscriptions.
  • Vous devriez voir une nouvelle entrée avec le statut “Never Subscribed”.

Tableau de bord affichant un abonnement avec le statut 'Never Subscribed'

3

Retournez à l'application et appuyez sur Autoriser sur la demande.

4

Actualisez la page des abonnements du tableau de bord OneSignal.

Le statut de l’abonnement devrait maintenant afficher Subscribed.

Tableau de bord affichant un abonnement avec le statut 'Subscribed'

Vous avez créé avec succès un abonnement mobile. 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.
1

Ajouter aux abonnements de test.

Dans le tableau de bord, à côté de l’abonnement, cliquez sur le bouton Options (trois points) et sélectionnez Add to Test Subscriptions.

Ajout d'un appareil aux abonnements de test

2

Nommez votre abonnement.

Nommez l’abonnement pour pouvoir identifier facilement votre appareil plus tard dans l’onglet Test Subscriptions.

Tableau de bord affichant le champ 'Name your subscription'

3

Créez un segment d'utilisateurs de test.

Accédez à Audience > Segments > New Segment.
4

Nommez le segment.

Nommez le segment Test Users (le nom est important car il sera utilisé plus tard).
5

Ajoutez le filtre Test Users et cliquez sur Create Segment.

Création d'un segment 'Test Users' avec le filtre Test Users

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 API

1

Obtenez votre clé API d'application et votre ID d'application.

Dans votre tableau de bord OneSignal, accédez à Settings > Keys & IDs.
2

Mettez à jour le code fourni.

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éé précédemment.
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"
}'
3

Exécutez le code.

Exécutez le code dans votre terminal.
4

Vérifiez les images et la livraison confirmée.

Si toutes les étapes de configuration ont été effectuées avec succès, les abonnements de test devraient recevoir une notification avec une image incluse :

Notification push avec image sur iOS et Android

Les images apparaîtront petites dans la vue de notification réduite. Développez la notification pour voir l’image complète.
5

Vérifiez la livraison confirmée.

Dans votre tableau de bord, accédez à 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 le push.

Statistiques de livraison montrant une livraison confirmée

Si vous avez un plan Professional ou supérieur, faites défiler jusqu’à Audience Activity pour voir la confirmation au niveau de l’abonnement :

Livraison confirmée au niveau de l'appareil dans Audience Activity

Vous avez envoyé avec succès une notification via notre API à un segment.

Envoyer un message intégré

Les messages intégrés vous permettent de communiquer avec les utilisateurs pendant qu’ils utilisent votre application.
1

Fermez ou mettez votre application en arrière-plan sur l'appareil.

C’est parce que les utilisateurs doivent répondre aux critères d’audience intégrés avant qu’une nouvelle session ne commence. Dans OneSignal, une nouvelle session commence lorsque l’utilisateur ouvre votre application après qu’elle a é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 intégrés sont affichés.
2

Créez un message intégré.

  • Dans votre tableau de bord OneSignal, accédez à 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.

Ciblage du segment 'Test Users' avec un message intégré

3

Personnalisez le contenu du message si vous le souhaitez.

Exemple de personnalisation du message de bienvenue intégré

4

Définissez le déclencheur sur 'On app open'.

5

Planifiez la fréquence.

Sous Schedule > How often do you want to show this message? sélectionnez Every time trigger conditions are satisfied.

Options de planification des messages intégrés

6

Rendez le message actif.

Cliquez sur Make Message Live pour qu’il soit disponible pour vos utilisateurs de test chaque fois qu’ils ouvrent l’application.
7

Ouvrez l'application et voyez le message.

Après que le message intégré est actif, ouvrez votre application. Vous devriez le voir s’afficher :

Message de bienvenue intégré affiché sur les appareils

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 en savoir plus, consultez comment les messages intégrés sont affichés.
  • Toujours dans le segment Test Users ?
    • Si vous avez réinstallé ou changé d’appareil, rajoutez l’appareil aux abonnements de test et confirmez qu’il fait partie du segment Test Users.
  • Vous rencontrez des problèmes ?
    • Suivez Obtenir un journal de débogage tout en reproduisant les étapes ci-dessus. Cela générera une journalisation supplémentaire que vous pouvez 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 :

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 intégré pour expliquer la valeur des notifications push avant de demander l’autorisation. Pour connaître les meilleures pratiques et les détails de mise en œuvre, consultez notre guide Demander les autorisations push.

FAQ

Comment puis-je accéder aux données OneSignal côté client ?

Utilisez la méthode Median Native JavaScript Bridge median_onesignal_info pour récupérer l’ID d’abonnement OneSignal (oneSignalUserId) et le statut d’abonnement.
javascript
  var osSubscriptionId = "the OneSignal Subscription ID string";
  var isSubscribedToPushNotifications;

  median.onesignal.onesignalInfo().then(function (oneSignalInfo) {
    console.log(oneSignalInfo);
    osSubscriptionId = oneSignalInfo.oneSignalUserId;
    isSubscribedToPushNotifications = oneSignalInfo.oneSignalSubscribed;
  });
Plus de détails dans Median.co Docs

Comment envoyer des notifications push avec liens profonds vers mon application Median ?

Les applications Median utilisent des liens profonds pour une expérience native au lieu d’ouvrir un navigateur contextuel.

Lors de l’utilisation du tableau de bord OneSignal :

  • N’utilisez pas le champ Launch URL.
  • Utilisez plutôt le champ Additional Data.
    • Ajoutez une clé : targetUrl (U majuscule)
    • Ajoutez une valeur : l’URL que vous souhaitez que les utilisateurs ouvrent.

Utilisation d'Additional Data avec targetUrl

Lors de l’utilisation de l’API REST :

Incluez targetUrl dans l’objet data de votre charge utile push. Exemple :
{
  "app_id": "YOUR-APP-ID",
  "include_player_ids": ["USER-ID"],
  "data": { "targetUrl": "https://example.com/page" },
  "contents": { "en": "Check out this page!" }
}

Envoi vers le web et le mobile ?

Si vous envoyez vers le web et le mobile simultanément : Dans la section Launch URL, sélectionnez “Different URL for web/app”. Laissez le champ APP URL vide pour éviter le remplacement.

Configuration d'URL différentes pour le web et le mobile