Passer au contenu principal

​
Aperçu

Ce guide vous accompagne à travers les différentes façons d’importer des données utilisateur dans OneSignal. Que vous migriez depuis une autre plateforme ou que vous ajoutiez de nouveaux abonnés, vous pouvez importer ou mettre à jour des Utilisateurs et leurs Abonnements en utilisant :
  • SDK — recommandé pour ajouter automatiquement de nouveaux utilisateurs et abonnements push.
  • Importateur CSV — idéal pour l’importation et la mise à jour en masse d’utilisateurs.
  • API REST — parfait pour les mises à jour programmées ou automatisées.
  • Saisie manuelle — idéal pour ajouter ou modifier des utilisateurs individuels.

La page dans la section Audience

​
Import CSV

Importez ou mettez à jour les abonnements email et numéro de téléphone ainsi que leurs tags, langue, fuseau horaire, pays, statut d’abonnement (Email/SMS) et statut de suppression (Email uniquement).

Écran d'import CSV

​
Préparer votre CSV

Assurez-vous que votre fichier respecte les normes suivantes :
  • Encodage UTF-8 (sans BOM)
  • Pas de caractères non imprimables
  • En-têtes de colonnes propres et uniques
  • Taille de fichier inférieure à 150 Mo
Ouvrez votre fichier dans un éditeur de texte brut comme VS Code ou Sublime. Réouvrez avec l’encodage UTF-8 et vérifiez l’affichage correct des caractères.
Votre fichier doit inclure au moins un des éléments suivants :
  • external_id — Recommandé. Identifie les Utilisateurs à travers tous les Abonnements.
  • email — Requis pour les abonnements email.
  • phone_number — Requis pour les abonnements SMS.
  • subscription_id — Recommandé uniquement pour l’ajout de l’ID externe à un abonnement existant.
subscription_id peut être utilisé comme identifiant pour les cas hérités, ou lorsque votre backend suit cet ID d’abonnement unique. Non recommandé pour être utilisé comme identifiant pour ajouter ou mettre à jour des propriétés.
Un seul identifiant de chaque type est autorisé par ligne. Pour associer plusieurs emails ou numéros au même utilisateur, utilisez des lignes séparées partageant le même external_id.
  • Inclure external_id aide à dédupliquer les utilisateurs, prend en charge les mises à jour sur tous les canaux et permet les imports futurs.
  • Assurez-vous que l’external_id est unique pour chaque utilisateur et est le même ID défini via la méthode login du SDK. Sinon, il sera réinitialisé lorsque l’utilisateur ouvrira l’application.

​
Colonnes CSV disponibles

​
external_id
Toute valeur alphanumérique unique
Voir ID externe pour plus d’informations.
​
email
Adresses email valides
Crée un abonnement email. Dédupliqué si déjà présent.
​
phone_number
Numéros de téléphone valides
Utilisez le format E.164 comme +15555551234. Crée un abonnement SMS.
​
subscription_id
UUID v4 attribué par OneSignal
Pour usage hérité uniquement. Utilisez lors du suivi des ID d’abonnement OneSignal.
​
subscribed
`yes`, `no`
Définit le statut d’abonnement pour email, phone_number et subscription_id.
​
suppressed
`true`, `false`
false retire l’email des listes de suppression.
​
timezone_id
Fuseaux horaires au format IANA TZ
Voir IANA TZ.
​
country
Codes ISO 3166-2 à 2 caractères
Voir ISO 3166-2.
​
language
Codes ISO 639-1 à 2 caractères
Voir ISO 639-1.
​
data tags
Valeurs alphanumériques
Jusqu’à 1 000 tags. Utilisez les en-têtes de colonne comme clés. Voir Tags.

​
Importer des tags depuis une seule colonne

Au lieu d’utiliser des en-têtes de colonne séparés pour chaque clé de tag, vous pouvez définir un seul en-tête tags, chaque ligne utilisateur contenant une carte JSON de toutes les paires clé-valeur entre guillemets. Ceci est particulièrement utile si vous avez précédemment exporté un CSV avec des tags et souhaitez le réimporter sans reformatage. Exemple d’en-tête : 
external_id,email,tags
Exemples de lignes : Les tags doivent être formatés comme un objet JSON entre guillemets. 
userA,example@email.com,"{""level"":""30"",""Color"":""teal""}"
Lors de l’import, OneSignal convertit automatiquement chaque paire clé-valeur en tags distincts pour l’enregistrement d’abonnement.

​
Accéder à l’importateur CSV

  1. Allez dans Audience > Importer
  2. Cliquez sur Lancer l’importateur CSV
  3. Téléchargez votre CSV (glisser-déposer ou utilisez le sélecteur de fichiers)

​
Mapper les champs

Après le téléchargement :
  • OneSignal mappe automatiquement les en-têtes aux propriétés connues.
  • Vérifiez les mappages avant de confirmer.

Import CSV Map Fields screen

​
Mettre à jour les propriétés

Utilisez external_id, email, phone_number ou subscription_id pour identifier l’utilisateur que vous mettez à jour. Pour ajouter un nouvel email ou numéro de téléphone à un utilisateur existant, vous devez utiliser external_id. N’utilisez pas subscription_id — cela ne liera ni ne fusionnera les abonnements.

​
Gérer les avertissements

Si OneSignal détecte des problèmes de format :
  • Corrigez le CSV et retéléchargez (recommandé)
  • Ou décochez la colonne affectée pour ignorer son importation

Affiche un message d'erreur pour les numéros de téléphone mal formatés

​
Révision

Sur l’écran de révision :
  • Optionnellement, créez un segment pour cet import
  • Optionnellement, supprimez les tags avec des valeurs vides :
external_id,tag1,tag2
2349-wefh-h34a,,"tag 2 value"
Créer un segment permet d’envoyer rapidement et facilement un message à ces utilisateurs immédiatement. Cependant, si votre CSV contient déjà un tag unique, vous n’avez pas besoin de créer un segment ici. Utilisez simplement le tag que vous avez déjà défini pour créer votre segment.

Options pour créer un segment et supprimer les valeurs de tag vides

Après avoir cliqué sur Confirmer et importer, un écran d’état affiche la progression. Vous recevrez un email lorsque l’import sera terminé.
Vous avez terminé le processus d’importation !
  • La durée de votre importation dépend de la taille du fichier.
  • Vérifiez votre email et ajoutez contact@onesignal.com à vos contacts email pour vous assurer de recevoir l’email de confirmation.

​
Confirmation par email et dépannage

Une fois le téléchargement du CSV terminé, vous recevrez un email de confirmation avec les données suivantes :
  • Enregistrement(s) d’abonnement ajouté(s)
    • Le nombre de nouveaux abonnements email et/ou SMS créés via le téléchargement CSV.
    • 0 signifie que la liste ne contenait pas d’identifiants email et/ou phone_number uniques pour créer les abonnements.
  • Enregistrement(s) d’abonnement modifié(s)
    • Le nombre d’Abonnements où certaines données ont changé, comme les tags définis ou d’autres propriétés.
    • Rappelez-vous que les Utilisateurs peuvent avoir plusieurs Abonnements. Par exemple, si vous avez téléchargé une liste de 10 ID externes et que chacun était associé à 20 abonnements, vous verrez 200 enregistrements d’abonnement modifiés.
  • Mises à jour d’abonnement ignorées
    • Le nombre d’Abonnements qui ont été ignorés pour la raison fournie.
    • Si vous avez téléchargé un CSV d’email et/ou de phone_number, ces Abonnements ont probablement été créés.
    • Si la raison est “en raison du dépassement de la limite de tags de votre application”, vous devez supprimer des tags et télécharger à nouveau. Ou mettez à niveau votre forfait.
  • Non importé
    • Le nombre de lignes qui n’ont pas été mises à jour ou importées.
    • Se produit généralement lorsque :
    1. L’external_id que vous avez défini dans le CSV n’existe sur aucun abonnement dans l’application OneSignal
    2. Les abonnements email et/ou phone_number existent déjà dans l’application OneSignal.
  • Nouveau segment créé
    • Le nom du segment que vous avez créé le cas échéant.

Exemple d'email de confirmation.

Dans l’exemple :
  • 100 abonnements ont été créés car les colonnes email et/ou phone_number incluaient des adresses email et/ou numéros de téléphone uniques qui n’existaient pas actuellement dans l’application OneSignal.
  • 37814 abonnements ont été mis à jour. Ce n’est pas le nombre d’Utilisateurs. Rappelez-vous que les utilisateurs peuvent avoir plusieurs Abonnements.
  • 621852 lignes du CSV n’ont pas été importées. Soit parce qu’elles n’avaient pas d’ID externes qui correspondaient aux utilisateurs dans l’application OneSignal, soit les emails et/ou numéros de téléphone existaient déjà sans données uniques à définir.
Actuellement, les Segments ne comptent que le nombre d’Abonnements abonnés. Ils ne comptent pas les abonnements désabonnés, bien que leurs données aient été mises à jour.Si le nombre de votre segment ne correspond pas au CSV, c’est parce que le segment ne compte pas les abonnements désabonnés pour le moment.Cela est actuellement en cours de développement. La nouvelle segmentation améliorée sera disponible fin 2025.
Vous rencontrez toujours des problèmes ?Contactez support@onesignal.com et partagez le fichier CSV que vous avez téléchargé ainsi qu’une capture d’écran de l’email de confirmation. Nous serons ravis d’y jeter un œil !

​
Historique des imports CSV

Vous pouvez voir l’historique des imports dans Audience > Importer > CSV > Voir les imports précédents (veuillez noter que les imports effectués à l’aide de notre précédent processus d’import CSV monocanal ne seront pas inclus dans cette liste).

​
API REST

Pour importer et mettre à jour des utilisateurs et abonnements via notre API REST :

Créer un utilisateur

Recommandé. Peut être utilisé pour créer et/ou mettre à jour des utilisateurs et abonnements.

Créer un abonnement par alias

Utilisez pour ajouter des abonnements aux utilisateurs uniquement.

​
Saisie manuelle

  • Ajouter manuellement des emails
  • Ajouter manuellement des numéros de téléphone
Accédez à Audience > Abonnements > Flèche à côté de Mettre à jour/Importer des utilisateurs > Ajouter manuellement des emails pour ouvrir une nouvelle fenêtre où vous pouvez ajouter l’email d’un utilisateur individuel et tous les tags de données que vous souhaitez associer à cet utilisateur.

Le menu déroulant du bouton montrant l'option Ajouter manuellement des emails en surbrillance