Envoyer campagne (scheduled job)

L'option Envoyer Campagne de Symplify permet aux organisations d'envoyer automatiquement un déploiement spécifique en fonction des destinataires transférés dans un fichier vers Symplify FTP ou sFTP.

Un utilisateur Symplify crée un brouillon de campagne dans Symplify. Une sélection est effectuée dans votre système CRM sur les destinataires devant recevoir la campagne spécifique de Symplify. Le fichier contenant les destinataires est ensuite transféré du système CRM vers Symplify. Basé sur le nom de fichier, Symplify enverra la campagne aux destinataires du fichier. Le nom de fichier doit contenir trois paramètres (deliveryID; ListID; Sendtime) pour que Symplify puisse comprendre quoi faire avec le fichier.

Vue d'ensemble de la configuration

La configuration d’une campagne d’envoi se compose de quatre parties.

Symplify fournit ce document et les informations de connexion FTP ou sFTP.
Envoyer Campagne de Symplify est configuré sur le compte pour surveiller les fichiers FTP ou sFTP pour Envoyer Campagne.
Un brouillon de campagne est créé dans Symplify.
Vous créez un fichier conformément aux spécifications de format de fichier décrites dans ce document et suivez également le modèle de nom de fichier spécifique.

* Symplify prend également en charge la copie sécurisée sur SSH. Cette méthode de transfert de fichier offre une plus grande sécurité.

NOTEZ S'IL VOUS PLAÎT! Nous vous recommandons d'utiliser l'API REST de Symplify pour obtenir le nom correcte de la livraison et l'identifiant de liste dans le nom du fichier.

Choix des champs à inclure dans le fichier

Les données à inclure dans le fichier dépendent des données à présenter lors de l'envoi ou des données à utiliser pour segmenter le contenu de l'envoi. Sélectionnez uniquement les données pertinentes pour le contenu de votre courriel et les besoins de segmentation afin de minimiser le temps d'exportation et d'importation.

Dans certains cas, il suffit d’importer des adresses courriel ou des numéros de téléphone. Une des conditions est que les destinataires de votre fichier d'importation soient identifiés par un identifiant unique. Il peut s'agir d'une clé primaire provenant d'une base de données ou de tout autre élément identifiant de manière unique chaque destinataire. Il en résulte que le fichier d'importation le plus simple doit contenir au moins deux colonnes (identifiant unique et adresse courriel / numéro de téléphone).

Si aucun identifiant approprié pour les destinataires ne peut être trouvé, vous pouvez choisir d’identifier les destinataires par leur adresse courriel ou leur numéro de téléphone. Il s’agit d’une méthode inférieure et, de ce fait, les destinataires qui modifient leur adresse électronique ou leur numéro de téléphone seront traités comme de nouveaux destinataires dans le système.

Pour associer l'en-tête de colonne correcte du fichier à une propriété dans Symplify, vérifiez que les informations correctes sont entrées dans le mappage archivé dans Symplify: Paramètres du compte > Attributs de profil (sous l'image). Si un nouvel en-tête de colonne est envoyé à Symplify et n’a pas été ajouté auparavant, Symplify créera automatiquement la nouvelle propriété.

Format de fichier

Les données téléchargées sur Symplify pour importation doivent être conformes aux spécifications suivantes :

Les données doivent être envoyées sous forme de fichier texte brut non formaté.
Vous ne devez pas entourer les champs de données de guillemets ou de guillemets doubles.
La première ligne du fichier servira de matrice de mappage pour insérer les données du fichier dans la propriété correcte * dans Symplify.
Newline doit être représenté par des caractères compatibles ASCII (c'est-à-dire LF, CR ou CR + LF).
Les seuls caractères de contrôle ASCII autorisés sont les suivants : onglet horizontal, espace, retour chariot et saut de ligne.
Les noms d’en-tête de colonne ne peuvent contenir que des caractères alphanumériques ASCII (A-Z a-z 0-9), par exemple. Pas d'espaces, accents ou soulignements.
Les numéros mobiles doivent commencer par 00 [code pays] ou + [code pays], par ex. 0046 ou +46 (où 46 est le code de pays pour la Suède).
Les extensions de fichier autorisées sont .txt et .csv (+ .zip si compressé).
L'encodage du fichier doit être UTF-8.
Le fichier doit être structuré dans un format de tableau afin que chaque ligne représente une ligne de tableau avec des champs séparés par un séparateur de tabulation.
Le fichier ne doit pas inclure de marque d'ordre d'octet (BOM).

* Pour mapper l'en-tête de colonne correct du fichier sur une propriété dans Symplify, vérifiez que les informations correctes sont entrées dans le mappage archivé dans Symplify. Vous pouvez obtenir une vue d'ensemble de la propriété et de l'en-tête du fichier pour vos propriétés existantes dans Symplify dans les paramètres du compte> Attributs de profil.

NOTEZ S'IL VOUS PLAÎT! Ne commencez pas le téléchargement d’un nouveau fichier tant que le fichier précédent n’a pas été renommé, vous risqueriez d’écraser un fichier qui n’a pas encore été traité par les importations planifiées.

Champs de collection

Pour réduire le nombre de champs, il est parfois pratique de fusionner une collection de propriétés dans un seul champ. Cela peut réduire considérablement le temps passé à créer des filtres et à gérer les propriétés dans Symplify.

Pour créer un champ Collection, vous devez sélectionner un nouvel ensemble de délimiteurs différent de votre séparateur de champ normal. Les données sont écrites dans le champ Collection délimité par ce nouveau séparateur selon les spécifications suivantes:

Chaque valeur du champ Collection doit commencer par le délimiteur de début du champ Collection.
Chaque valeur du champ Collection doit se terminer par le délimiteur du champ de fin de la collection.

Nous vous recommandons d'utiliser des accolades, des parenthèses ou des équerres angulaires comme délimiteurs. Voir la section «Exemples de mise en page» pour plus d'informations.

Veuillez noter que les données d'un champ de collecte peuvent être très utiles pour la segmentation, mais ne conviennent pas pour être présentées avec des espaces réservés dans un courriel, car vous avez plusieurs valeurs.

Champs de dates et d'heures

Les valeurs de date et d'heure sont organisées du plus important au moins significatif : année, mois, jour, heure, minute, seconde et fraction de seconde.

Chaque valeur de date et heure a un nombre fixe de chiffres qui doivent être complétés par des zéros non significatifs.

Les représentations peuvent être effectuées dans l'un des deux formats suivants : un format de base avec un nombre minimal de séparateurs ou un format étendu avec des séparateurs ajoutés pour améliorer la lisibilité. Le séparateur utilisé entre les valeurs de date (année, mois et jour) est le trait d'union, tandis que les deux points servent de séparateur entre les valeurs d'heure (heures, minutes et secondes).

Le fuseau horaire utilisé dans Symplify est l'heure d'Europe centrale (CET).

Dates du calendrier

Symplify utilise une notation de données toute numérique [aaaa] - [MM] - [jj]. Une année à quatre chiffres [aaaa] est utilisée pour éviter le problème de l'an 2000. [MM] indique un mois de l'année à deux chiffres, allant de 01 à 12.

Par exemple, «le 5 avril 2014» est représenté par «2014-04-05».

Heure

Symplify utilise le système d'horloge 24 heures. Le format accepté est [hh]: [mm]: [ss].

Il est acceptable d'omettre les éléments de temps d'ordre inférieur pour une précision réduite.

Exemples de date et heure

2013-04-05 13:37

2014-12-11 20:00:00

Exemple de mise en page

Voici un exemple de disposition de fichier simple avec trois colonnes (id, nom et adresse électronique). La première ligne est une ligne d'en-tête et indique comment le fichier est organisé. Le délimiteur choisi pour cette mise en page est la tabulation.

OriginalID<tab>firstname<tab>emailaddress
001<tab>paul<tab>paul.simon@example.com
002<tab>aretha<tab>a.franklin@example.com
003<tab>bruce<tab>the_boss@example.com
004<tab>madonna<tab>queen@example.com

Détails du serveur

Vous pouvez utiliser les protocoles sFTP et FTP sur leurs ports standard avec les références obtenues auprès du support Symplify. Le nom d'hôte Internet de notre serveur de fichiers est storage.carmamail.com

Si vous avez des questions concernant les différentes méthodes de transfert de fichiers, veuillez contacter le support Symplify.

Nous recommandons à nos clients d'utiliser sFTP car cela permet de crypter les données lors de leur transfert vers Symplify.

Téléchargement de fichiers

Utilisez les informations de connexion fournies pour vous connecter au serveur et téléchargez le fichier dans le sous-dossier approprié de votre dossier personnel. S'il existe un risque qu'un fichier soit chargé en même temps que l'exécution de la campagne d'envoi / Batchtrigger, nous vous recommandons d'utiliser un nom de fichier temporaire ou un dossier de téléchargement séparé pour éviter que le travail ne démarre avant que le fichier ne soit complètement téléchargé. Dès que le fichier est complètement téléchargé sur le FTP, vous devez modifier le nom ou le dossier pour vous assurer que le travail lira le fichier.

Caractères autorisés pour les noms de fichier: "A–Z 0–9 – _"

Convention d'appellation

Pour fonctionner, votre fichier téléchargé doit toujours respecter la convention d'appellation :

senddelivery_<deliveryid>_<ListID>_<Sendtime>.txt

DeliveryID = L'ID qui identifie comme le courrier spécifique qui sera envoyé.

ListID = L'ID qui identifie la liste des destinataires à importer

Sendtime = l'heure programmée planifiera l'envoi (yyyyMMddhhmmss).

Exemple : senddelivery_12345_2345_20130601143000.txt

(Delivery ID 12345 sera envoyé le 2013-06-01 14:30.00 et les destinataires du fichier seront importés dans la liste 2345.)

NOTEZ S'IL VOUS PLAÎT! Vous ne pouvez pas télécharger un fichier dont la date / heure est passée, la campagne ne sera pas envoyée.

Dès qu'une tâche programmée est démarrée, elle renommera le fichier enfilename.archive.timestamp (timestamp est le moment où l'import a débuté), exemple senddelivery_12345_2345_20130601143000.txt.archive.[timestamp].

Envoyer la configuration du travail de campagne dans Symplify

Pour que la tâche s'exécute, vous devez, dans Symplify, entrer des informations sur la tâche, le moment auquel l'importation doit être exécutée et l'emplacement où Symplify trouvera le fichier. Ce paramètre s'appelle Tâche programmée et se trouve dans Symplify : Paramètres du compte > Tâche programmée (> Créer une nouvelle tâche d'envoi).

Dans la mesure où une tâche de campagne n'est pas connectée à un fichier spécifique, mais envoie une campagne en fonction des informations contenues dans le nom du fichier, vous pouvez gérer toutes vos campagnes d'envoi dans la même tâche.

Création de tâches programmées

Les tâches d'envoi de campagne se trouvent dans Symplify : Paramètres du compte > Tâches planifiées (> Créer une nouvelle tâche d'envoi).

Vous obtiendrez alors un aperçu de toutes vos tâches programmées actuelles. Pour créer une nouvelle tâche, cliquez sur le bouton “Créer une nouvelle tâche” dans le coin supérieur droit.

Entrez le nom que vous souhaitez donner à la tâche.

Programmation

Dans la liste déroulante, vous pouvez choisir l'heure à laquelle vous souhaitez exécuter la tâche ou si vous souhaitez que la tâche s'exécute dans un intervalle spécifique :

Vous pouvez définir une heure spécifique (par exemple, 03h30 toutes les nuits) ou un intervalle (par exemple, toutes les 15 minutes) :

Par exemple, vous pouvez choisir que votre tâche programmée s'exécute tous les jours à 14h05.

Si vous souhaitez que Symplify recherche un fichier certains jours, sélectionnez le nombre de jours d'exécution souhaité du travail de planification *. En cliquant sur la flèche adjacente à "prochaine exécution", vous verrez les cinq prochains événements.

* Si aucun jour n'est sélectionné, le tâche programmée sera exécutée tous les jours.

Paramètres de fichier

Le dernier paramètre que vous devez entrer est l'emplacement où la tâche programmée trouvera le fichier : informations de chemin d'accès, nom d'utilisateur et mot de passe sur FTP.

Symplify se connectera au FTP et recherchera durant chaque programmation un fichier commençant par senddelivery (nom de fichier complet: senddelivery_<deliveryid>_<ListID>_<Sendtime>.txt comme mentionné dans le téléchargement de fichier).

Pour accélérer le processus d'importation, il est possible de compresser les fichiers d'importation avec ZIP.

Aperçu de la configuration pour le transfert de fichiers API

Ceci est un complément au document de l'API Symplify Rest qui décrit plus en détail la ressource Jobs. Les lecteurs sont supposés avoir une certaine familiarité avec l'interface graphique de Symplify et une certaine expérience de l'API REST. Si ce n'est pas le cas, veuillez lire cet article pour un aperçu de l'API.

Flux de travail

Pour commencer une job, vous devrez préparer quelques éléments dans Symplify :

Une campagne doit être créée. Il est recommandé d'envoyer cette livraison à une liste de test manuellement pour vérifier la possibilité de livraison avant le lancement de toute jobs.
Une liste de type Normal doit être créée.

Vous devez également préparer les données de vos destinataires. Veuillez lire la section Liste des importations dans la documentation principale de l'API REST et vous familiariser avec la manière dont les importations sont traitées par Symplify.

Pour commencer une nouvelle job, une demande POST avec des détails précisant la livraison et la liste des jobs est envoyée.

POST <server>/rest/<customerId>/jobs/generation/fixed
{
"type": "CAMPAIGN",
"id": 336858,
"listId": 22265
}

Les valeurs de type valides sont :

CAMPAIGN

L'objet Id the JSON sera interprété comme l'un des types de livraison ci-dessus.

Symplify traitera votre demande et vous répondra en vous confirmant qu'une nouvelle Job a été créée. La réponse ressemblera à ceci.

{
"id":7202,
"campaignId":336858,
"listId":22265,
"contentUploaded”:false,
"feedback2:[
{
"feedback":"WAITING_FOR_CONTENT",
"severity":"SEVERITY_INFO",
"timestamp":1441374310577
}]
}

Il est maintenant temps de télécharger les données de vos destinataires. Pour construire l'URL de cette requête, vous aurez besoin de la valeur Id de la réponse précédente.

POST <server>/rest/<customerId>/jobs/generation/fixed/<id>/recipients/automapping

La demande doit être envoyée avec le destinataire spécifié comme text/csv, tabulation séparée avec la première ligne contenant les en-têtes de colonne. Il est fortement recommandé, avant d'envoyer des données à Symplify, de préparer et d'examiner les mappages dans la partie "Attributs du destinataire" de l'interface web de Symplify.

OriginalID<tab>firstname<tab>emailaddress
001<tab>paul<tab>paul.simon@example.com
002<tab>aretha<tab>a.franklin@example.com
003<tab>bruce<tab>the_boss@example.com
004<tab>madonna<tab>queen@example.com

Une fois cette demande terminée, la génération des messages est automatiquement lancée. La progression de la job est indiquée dans la partie "feedback" de la réponse. Pour vous aider à suivre l'avancement d'une job, vous pouvez faire une demande en utilisant le recours suivant Il répondra par un ensemble d'entrées de feedback de la même manière que les demandes précédentes.

GET <server>/rest/<customerId>/jobs/generation/fixed/<id>

Exemples de HTTP bruts

Requête 1

POST http://test.carmamail.com/rest/487/jobs/generation/fixed HTTP/1.1
Host: test.carmamail.com
Authorization: Basic XXXX
Accept: application/json
{
"type": "CAMPAIGN",
"id": 336858,
"listId": 22265
}

Réponse 1

HTTP/1.1 200 OK
Content-Type: application/json
Server: Microsoft-IIS/7.5
X-Powered-By: ARR/2.5
X-Powered-By: ASP.NET
Date: Fri, 04 Sep 2015 13:45:10 GMT
Content-Length: 171
{"id":7202,"campaignId":336858,"listId":22265,"contentUploaded":false,"feedback":[{"feedback":"WAITING_FOR_CONTENT","severity":"SEVERITY_INFO","timestamp":1441374310577}]}

Requête 2

POST http://test.carmamail.com/rest/487/jobs/generation/fixed/7202/recipients HTTP/1.1
Host: test.carmamail.com
Authorization: Basic XXX
Content-Type: text/csv;charset=UTF-8
Content-Length: 103
email originalid firstname
paul@example.com 1 paul
a.franklin@example.com 2 aretha
theboss@example.com 3 bruce

Réponse 2

HTTP/1.1 200 OK
Content-Type: application/json
Server: Microsoft-IIS/7.5
X-Powered-By: ARR/2.5
X-Powered-By: ASP.NET
Date: Fri, 04 Sep 2015 13:57:47 GMT
Content-Length: 1124
 {"id":7202,"campaignId":336858,"listId":22265,"contentUploaded":false,"feedback":[{"feedback":"WAITING_FOR_CONTENT","severity":"SEVERITY_INFO","timestamp":1441374310577},{"feedback":"UPLOADING_CONTENT","severity":"SEVERITY_INFO","timestamp":1441375034573},{"feedback":"UPLOADED_CONTENT","severity":"SEVERITY_INFO","timestamp":1441375034620},{"feedback":"STARTED_IMPORT","severity":"SEVERITY_INFO","timestamp":1441375067147}]}

Statut des destinataires

Les destinataires du fichier seront définis comme actifs dans la liste en cours à la fin du travail.

Les destinataires non abonnés resteront désabonnés et ne recevront donc aucun courriel.

Vérification des données

Une fois la configuration terminée, vous devez vérifier que vos données sont correctement représentées dans Symplify. Cela peut être facilement réalisé en exportant toutes les valeurs de propriété de la liste dans Symplify et en l’analysant.