Importer des géozones à partir d'un fichier CSV

Lorsque vous avez des centaines d’emplacements, comme chaque magasin d’une chaîne ou chaque point de retrait, les placer sur la carte un par un n’est pas réaliste. Importez-les plutôt à partir d’une feuille de calcul.

Préparer le fichier

Le fichier doit contenir une ligne d’en-tête et une ligne par emplacement, et ne doit pas dépasser 5 Mo. Cela laisse de la place pour des dizaines de milliers d’emplacements, bien au-delà de ce qu’une seule campagne de géozones est censée couvrir. Trois colonnes sont requises.

Dans le fichier, vous pouvez utiliser des en-têtes courts tels que range ou cooldown. Sur l’écran Importer des géozones, le menu déroulant de mappage utilise les étiquettes ci-dessous (par exemple, range → Portée, m).

Colonne dans le fichier	Correspond à	Requis	Remarques
Nom	Nom	Oui	Jusqu’à 64 caractères.
Latitude	Latitude	Oui	Entre -90 et 90.
Longitude	Longitude	Oui	Entre -180 et 180.
Portée	Portée, m	Non	Mètres, entre 50 et 100 000. Se rabat sur Portée par défaut, m.
Cooldown	Cooldown, s	Non	Secondes, entre 60 et 3 596 400 (41 jours). Se rabat sur Cooldown par défaut, s.
Message	Message	Non	Texte du push, jusqu’à 1024 caractères.
Code de cluster	Code de cluster	Non	Un code de cluster existant.
Code de preset	Code de preset	Non	Un code de preset existant.

Chaque géozone a besoin de quelque chose à envoyer, donc chaque ligne doit se retrouver avec soit un message, soit un preset. Cela peut provenir de la propre colonne de la ligne ou de Message pour chaque zone / Preset pour chaque zone sur l’écran d’importation. Un preset l’emporte lorsqu’une ligne a les deux.

Exemple de CSV

Voici un fichier geozones.csv avec deux emplacements. La deuxième ligne laisse range vide, donc la Portée par défaut, m s’applique :

name	latitude	longitude	range	message
Store Downtown	40.7128	-74.0060	200	Welcome to our store!
Pickup Point	51.5074	-0.1278		Your order is ready

Représentation de geozones.csv en format texte brut :

name,latitude,longitude,range,message
Store Downtown,40.7128,-74.0060,200,Welcome to our store!
Pickup Point,51.5074,-0.1278,,Your order is ready

Les exportations depuis Excel fonctionnent telles quelles

Le séparateur est détecté à partir du fichier : virgule, point-virgule ou tabulation. Une virgule est également acceptée comme séparateur décimal dans les coordonnées, donc 55,7558 dans une exportation séparée par des points-virgules est lu correctement. Les champs entre guillemets peuvent contenir le séparateur et des sauts de ligne.

Enregistrez le fichier en UTF-8. Excel propose cela sous le nom de CSV UTF-8 dans la boîte de dialogue Enregistrer sous. Un fichier enregistré dans un encodage régional affiche à la place les noms non latins sous forme de caractères brouillés. Une marque d’ordre des octets (BOM) est acceptable. Elle est supprimée à la lecture.

Comment importer

Suivez ces étapes pour téléverser le fichier et créer les géozones.

1. Sur la page Campagnes géo, cliquez sur Importer un CSV. L’écran Importer des géozones s’ouvre.

2. Sélectionnez votre fichier CSV.

3. Mappez les colonnes et définissez les valeurs par défaut sur l’écran Importer des géozones.

Mappez chaque colonne CSV à un champ de géozone. Sous chaque en-tête de colonne, ouvrez le menu déroulant et choisissez le champ que cette colonne doit remplir :

• Si Pushwoosh a mal fait correspondre l’en-tête, choisissez le bon champ dans le menu déroulant.
• Réglez une colonne sur Ne pas importer pour l’ignorer.
• Mappez au minimum Nom, Latitude et Longitude.
• Mappez Portée, m, Cooldown, s, Message, Code de cluster ou Code de preset lorsque ces colonnes sont dans le fichier.

Note

Pushwoosh fait correspondre automatiquement les orthographes courantes des en-têtes, telles que name, store, title, lat, latitude, lng, lon, longitude, radius, range, cooldown, message, cluster et preset.

Définissez les valeurs par défaut pour les valeurs que le fichier ne fournit pas :

• Portée par défaut, m et Cooldown par défaut, s. Utilisés lorsque le fichier n’a pas de colonne de portée ou de cooldown, ou que la cellule est vide (comme avec “Pickup Point” dans l’exemple).
• Cluster pour chaque zone. Choisissez un cluster, ou laissez Aucun cluster.
• Preset pour chaque zone. Preset de push optionnel pour chaque ligne qui en a besoin.
• Message pour chaque zone. Utilisé lorsque le fichier n’a pas de colonne de message. Les lignes qui ont déjà un message conservent leur propre texte.

4. Vérifiez les compteurs de lignes prêtes et ignorées (par exemple 2 lignes prêtes, 0 ignorées). Corrigez le mappage ou la feuille de calcul si nécessaire, puis cliquez sur Vérifier sans importer. Pushwoosh valide l’ensemble du fichier sans créer de géozones. Les lignes rejetées sont retournées avec le numéro de ligne et la raison, afin que vous puissiez corriger la feuille de calcul et réessayer sans rien laisser à moitié fait.

5. Lorsque la vérification semble correcte, cliquez sur Importer. Les géozones sont créées par lots. L’écran de résultats indique combien ont été créées et quelles lignes ont échoué.

Les géozones importées sont actives

Les géozones importées sont créées actives et commencent à déclencher des notifications push immédiatement. Définissez un calendrier pour chaque géozone après l’importation, ou mettez-les en pause dans la liste des campagnes géo, si elles ne doivent pas encore se déclencher.

L’importation du même fichier deux fois crée une deuxième copie de chaque géozone : les noms ne sont pas uniques. Pour corriger une erreur, supprimez les géozones que vous avez importées et importez le fichier corrigé.

Pourquoi une ligne est-elle ignorée

Pendant la vérification ou l’importation, les lignes qui ne peuvent pas être lues sont listées avec leur numéro de ligne et ignorées. Le reste est tout de même importé. Une ligne est ignorée lorsque :

• le nom est vide
• la latitude ou la longitude n’est pas un nombre, ou se situe en dehors de la plage indiquée dans le tableau ci-dessus
• la portée n’est pas un nombre, ou se situe en dehors de 50 à 100 000 m
• le cooldown n’est pas un nombre, ou se situe en dehors de 60 à 3 596 400 s
• la ligne se retrouve sans message ni preset

Pour créer des géozones à partir de votre propre système plutôt qu’un fichier, utilisez la méthode API addGeoZone.