Importer des contacts

Enregistrez des contacts pour l’e-mail, les SMS, WhatsApp et Viber à partir d’un seul fichier CSV. Une seule colonne de numéros de téléphone peut enregistrer un contact à la fois pour les SMS et WhatsApp : vous n’avez donc pas besoin d’un fichier séparé par canal.

Préparez votre fichier CSV

Format du fichier

• La première ligne doit contenir les en-têtes de colonne décrivant les données de chaque colonne.
• Chaque ligne suivante représente un seul contact, avec des valeurs correspondant aux en-têtes.
• Les valeurs doivent être séparées par des virgules.
• Enregistrez le fichier en encodage UTF-8 pour garantir un affichage correct des caractères.
• La taille maximale du fichier est de 100 Mo.

Colonnes de contact

Incluez au moins une des colonnes suivantes, selon les canaux pour lesquels vous souhaitez enregistrer les contacts :

• E-mail : l’adresse e-mail du destinataire.
• Numéro de téléphone (pour SMS, WhatsApp et Viber) : au format international, commençant par + suivi du code du pays, par exemple +120XXXXX234. Saisissez le numéro seul, sans préfixe whatsapp: ou viber:. Pushwoosh ajoute le préfixe lorsque vous mappez la colonne à ce canal.

Si un numéro de téléphone n’est pas dans un format international valide, il est ignoré pour ce canal. Le reste de la ligne est tout de même importé.

Note

Les noms de colonnes dans votre fichier CSV n’ont pas besoin de correspondre à ces étiquettes. Lors de l’importation, vous mappez les noms de vos colonnes existantes à un canal dans l’assistant. Par exemple, une colonne nommée Mobile peut être mappée au canal SMS ou WhatsApp.

Colonnes facultatives

• User ID : un identifiant unique pour l’utilisateur (par exemple, nom ou e-mail). Non requis, mais recommandé pour que les canaux du contact partagent un seul profil utilisateur au lieu de plusieurs.
• Toute autre colonne peut être mappée à un tag système pour la segmentation et la personnalisation, par exemple Emplacement, Date de naissance, Langue ou Type de client.

Exemple de fichier CSV

Email,Mobile,User ID,Name,Location
john.smith@email.com,+120XXXXX234,john.smith@email.com,John Smith,New York
jane.smith@email.com,+131XXXXX890,jane.smith@email.com,Jane Smith,Los Angeles

Téléchargez et mappez le fichier CSV

1. Allez dans Audience → Importer un CSV → Importer des contacts.

   

2. Cliquez sur Télécharger le CSV et sélectionnez votre fichier. Pour le remplacer, cliquez sur Télécharger un autre CSV.

   Attention

   Pushwoosh vérifie l’ensemble du fichier lorsque vous le téléchargez. Une ligne qui ne peut pas être analysée (son nombre de colonnes ne correspond pas à l’en-tête, ou une valeur entre guillemets n’est pas fermée) entraîne immédiatement le rejet du fichier. Une notification toast indique la ligne et la raison, par exemple « Row 42: the number of values does not match the header. » Rien n’est importé dans ce cas. Corrigez cette ligne et téléchargez à nouveau le fichier.

3. Saisissez un Nom de segment pour les contacts importés.

4. Sous Colonne de contact dans le CSV, sélectionnez une colonne et, à côté, choisissez le Canal qu’elle enregistre (E-mail, SMS, WhatsApp ou Viber). Cliquez sur + Ajouter un canal pour mapper une autre colonne, ou pour mapper la même colonne à un canal supplémentaire.

5. Sous Colonne UserId dans le CSV, sélectionnez la colonne avec les identifiants utilisateur uniques, si votre fichier en possède une.

6. Pour inclure des données supplémentaires pour la segmentation, sélectionnez un Nom de colonne de votre CSV et assignez-lui un Tag. Cliquez sur + Ajouter une colonne pour mapper plus d’attributs.

   

7. Cliquez sur Démarrer l’importation.

Après l’importation, les contacts sont disponibles pour les campagnes sur les canaux que vous avez mappés. Ils apparaissent comme un nouveau segment dans la liste des Segments et peuvent également être consultés via l’explorateur d’utilisateurs.

L’écran de fin affiche deux compteurs :

• Créés : les enregistrements de canaux nouveaux pour l’application.
• Mis à jour : les enregistrements de canaux qui existaient déjà, y compris lorsque la même adresse ou le même numéro est réenregistré sous un autre User ID ou sur une autre plateforme d’appareil.

Les deux comptent des enregistrements de canaux, et non des contacts ou des lignes CSV. Un contact mappé à deux canaux, par exemple SMS et WhatsApp, ajoute 2.

Pour un contact mis à jour, seuls les tags mappés à l’étape 6 changent. Leurs valeurs sont écrasées par les valeurs du CSV. Les autres tags déjà définis sur le contact restent inchangés.

Note

Les importations plus anciennes de la liste des importations récentes affichent un seul compteur Importés au lieu de Créés et Mis à jour.

Lignes ignorées lors de l’importation

L’écran de fin regroupe les lignes ignorées par motif :

• L’adresse e-mail n’est pas valide
• Le numéro de téléphone n’est pas valide
• Aucune adresse de contact dans la ligne : chaque colonne mappée était vide

Une ligne peut être partiellement importée et apparaître quand même dans cette répartition. Par exemple, la colonne e-mail réussit, mais la colonne téléphone échoue à la validation.

Cliquez sur Télécharger les lignes ignorées pour obtenir un CSV de ces lignes uniquement. Le fichier ajoute le motif de l’omission comme une colonne supplémentaire afin que vous puissiez corriger les lignes et les télécharger à nouveau.

Note

Téléchargez le fichier avant de quitter l’écran de fin. Si vous ouvrez la même importation plus tard depuis la liste des importations récentes sur le hub d’importation CSV, les décomptes des motifs s’affichent, mais pas le lien de téléchargement.

Lignes que l’importation n’a pas réussi à enregistrer

Certaines lignes semblent correctes dans le fichier mais ne passent toujours pas. Par exemple, une adresse e-mail peut être correctement orthographiée et être tout de même rejetée car elle appartient à un domaine jetable ou qui a généré un rebond. Pushwoosh compte les lignes comme celles-ci comme Échouées, séparément des lignes Créées, Mises à jour ou Ignorées.

Les lignes échouées ne sont pas détaillées par motif et ne sont pas incluses dans le téléchargement des lignes ignorées. Pour les trouver, comparez votre CSV source avec le segment importé. Corrigez les adresses manquantes (par exemple, supprimez un domaine jetable ou qui a généré un rebond), puis téléchargez à nouveau uniquement ces lignes dans une nouvelle importation.