Synchroniser les données entre Campaign et le CRM data-synchronization

La synchronisation des données entre Adobe Campaign et la gestion de la relation client (CRM) est réalisée à travers une activité de workflow dédiée : connecteur CRM.

Par exemple, pour importer les données Microsoft Dynamics dans Adobe Campaign, créez un workflow du type suivant :

Ce workflow importe les contacts depuis Microsoft Dynamics, les synchronise avec les données Adobe Campaign existantes, déduplique les contacts et met à jour la base de données Adobe Campaign.

L'activité Connecteur CRM doit être paramétrée pour synchroniser les données.

Avec cette activité, vous pouvez effectuer les actions suivantes :

Sélectionnez le compte externe correspondant au CRM avec lequel vous souhaitez paramétrer une synchronisation puis choisissez l'objet à synchroniser : comptes, opportunités, leads, contacts, etc.

La configuration de cette activité dépend ensuite du traitement à réaliser. Les différents types de paramétrages sont présentés ci-après.

Import depuis le CRM importing-from-the-crm

Pour importer des données depuis le CRM dans Adobe Campaign, vous devez réaliser un workflow du type :

Pour un import, les étapes de paramétrage de l'activité Connecteur CRM sont les suivantes :

  1. Sélectionnez une opération de type Import depuis le CRM.

  2. Accédez à la liste déroulante Objet distant et sélectionnez l’objet concerné par le processus. Cet objet correspond à l'une des tables créées dans Adobe Campaign lors de la configuration du connecteur.

  3. Dans la section Champs distants, indiquez les champs à importer.

    Pour ajouter un champ, cliquez sur le bouton Ajouter de la barre d'outils puis sur l'icône Editer l'expression.

    Si nécessaire, modifiez le format des données dans la liste déroulante des colonnes Conversion. Les types de conversion possibles sont détaillés dans la section Format des données.

    note important
    IMPORTANT
    L'identifiant de l'enregistrement dans le CRM est obligatoire pour relier les objets côté CRM et côté Adobe Campaign. Il est automatiquement ajouté lors de la validation de la boîte.
    La date de la dernière modification côté CRM est également requise pour permettre l'import incrémental des données.
  4. Vous pouvez également filtrer les données à importer selon vos besoins. Pour ce faire, cliquez sur le lien Modifier le filtre….

    Dans l'exemple suivant, Adobe Campaign n'importera que les contact ayant eu une activité après le 1er novembre 2012.

    note important
    IMPORTANT
    Les limitations relatives au mode de filtrage des données sont décrites dans la section Filtrer les données.
  5. L'option Utiliser l'index automatique… permet de gérer automatiquement la synchronisation incrémentale des objets entre le CRM et Adobe Campaign, selon la date de leur dernière modification.

    Voir à ce sujet la section Gestion des variables.

Gérer les variables variable-management

Activez l’option Index automatique pour ne collecter que les objets modifiés depuis la dernière exécution de l’import.

La date de la dernière synchronisation est stockée dans l'option indiquée dans la fenêtre de paramétrage, par défaut : LASTIMPORT_<%=instance.internalName%>_<%=activityName%>.

NOTE
Cette note s'applique uniquement à l'activité Connecteur CRM générique. Pour les autres activités CRM, le processus est automatique.
Cette option doit être créée et renseignée manuellement sous Administration > Plateforme > Options. Il doit s’agir d’une option de texte et sa valeur doit correspondre au format suivant : yyyy/MM/dd hh:mm:ss.
Pour tout autre import, vous devez mettre à jour manuellement cette option.

Vous pouvez indiquer le champ CRM distant à prendre en compte pour identifier les modifications les plus récentes.

Par défaut, les champs suivants sont utilisés (dans l'ordre indiqué) :

  • Pour Microsoft Dynamics : modifiedon,
  • Pour Salesforce.com : LastModifiedDate, SystemModstamp.

L'activation de l'option Index automatique génère trois variables, qui pourront être exploitées dans le workflow de synchronisation, via une activité de type Code JavaScript. Ces variables sont les suivantes :

  • vars.crmOptionName  : représente le nom de l'option contenant la date du dernier import.

  • vars.crmStartImport  : représente la date de début (incluse) de la dernière récupération des données.

  • vars.crmEndDate  : représente la date de fin (exclue) de la dernière récupération des données.

    note note
    NOTE
    Ces dates s’affichent au format suivant : yyyy/MM/dd hh:mm:ss.

Filtrage des données filtering-data

Afin d'assurer un bon fonctionnement avec les différents CRM, les filtres doivent être créés selon les règles suivantes :

  • Chaque niveau de filtrage ne peut utiliser qu'un seul type d'opérateur.
  • L'opérateur AND NOT n'est pas supporté.
  • Les comparaisons ne peuvent porter que sur des valeurs nulles (de type 'est vide'/'n'est pas vide') ou des nombres. Lorsque la colonne Valeur (colonne de droite) est évaluée, le résultat de cette évaluation doit être une valeur numérique.
  • Les données de la colonne Valeur sont évaluées en JavaScript.
  • Les comparaisons de type JOIN ne sont pas supportées.
  • L'expression indiquée dans la colonne de gauche doit nécessairement être un champ. Elle ne peut pas être une combinaison de plusieurs expressions, un nombre, etc.

Par exemple, les critères de filtrage suivants ne seront PAS valides dans le cadre d'un import CRM, car l'opérateur OU est placé au même niveau que les opérateurs ET :

  • l'opérateur OU est placé au même niveau que les opérateurs ET
  • des comparaisons portent sur des chaînes de texte

Ordre de tri order-by

Sous Microsoft Dynamics et Salesforce.com, vous pouvez trier les champs distants à importer, par ordre descendant ou ascendant.

Pour cela, cliquez sur le lien Ordre de tri et ajoutez les colonnes dans la liste.

L'ordre des colonnes dans la liste indique l'ordre de tri :

Identification des enregistrements record-identification

Plutôt que d'importer directement des éléments contenus (et éventuellement filtrés) dans le CRM, vous pouvez utiliser une population calculée en amont dans le workflow.

Pour cela, sélectionnez l'option Utiliser la population calculée en amont et indiquez le champ contenant l'identifiant distant.

Sélectionnez ensuite les champs à importer depuis la population entrante, comme dans l'exemple ci-dessous :

Export vers le CRM exporting-to-the-crm

L'export de données Adobe Campaign dans le CRM permet de copier l'intégralité d'un contenu vers une base CRM.

Pour exporter des données vers le CRM, vous devez réaliser un workflow du type :

Pour un export, les étapes de paramétrage de l'activité Connecteur CRM sont les suivantes :

  1. Sélectionnez une opération de type Exporter vers le CRM.

  2. Accédez à la liste déroulante Objet distant et sélectionnez l’objet concerné par le processus. Cet objet correspond à l'une des tables créées dans Adobe Campaign lors de la configuration du connecteur.

    note important
    IMPORTANT
    La fonction d'export de l'activité Connecteur CRM peut insérer ou mettre à jour des champs côté CRM. Pour activer les mises à jour des champs dans le CRM, vous devez spécifier la clé primaire de la table distante. Si la clé est manquante, les données sont insérées (au lieu d'être mises à jour).
  3. Consultez Exportation par lots si vous avez besoin d’exportations plus rapides.

  4. Dans la section Mapping, cliquez sur Nouveau pour indiquer les champs à exporter et leur mapping dans le CRM.

    Pour ajouter un champ, cliquez sur le bouton Ajouter de la barre d'outils puis sur l'icône Editer l'expression.

    note note
    NOTE
    Pour un champ, si aucune correspondance n'est définie côté CRM, alors les valeurs ne peuvent pas être mises à jour : elle seront directement insérées dans le CRM.

    Si nécessaire, modifiez le format des données dans la liste déroulante des colonnes Conversion . Les types de conversion possibles sont détaillés dans la section Format des données.

    note note
    NOTE
    La liste des enregistrements à exporter et le résultat de l'export sont conservés dans un fichier temporaire qui reste accessible tant que le workflow n'est pas terminé ou redémarré, ce qui permet de reprendre le traitement en cas d'erreur, sans risquer d'exporter plusieurs fois le même enregistrement et sans perte de données.

Paramétrages additionnels additional-configurations

Sur le format des données saisies data-format

Vous pouvez convertir à la volée le format des données lors de leur import depuis le CRM ou lors de leur export vers le CRM.

Pour cela, sélectionnez la conversion à appliquer dans la colonne correspondante.

Le mode par défaut applique une conversion automatique des données, qui correspond dans la plupart des cas, à un copier/coller des données. Toutefois, la gestion des fuseaux horaires est appliquée.

Les autres conversions possibles sont les suivantes :

  • Date seulement  : ce mode supprime les heures des champs de type Date + Heure.
  • Sans décalage  : ce mode annule la gestion des fuseaux horaires appliquée dans le mode par défaut.
  • Copié/collé  : ce mode utilise les données brutes comme des chaînes (pas de conversion).

Traitement des erreurs error-processing

Dans le cadre d'un import ou d'un export de données, vous pouvez appliquer un traitement spécifique aux erreurs et rejets. Pour cela, sélectionnez les options Traiter les rejets et Traiter les erreurs, dans l'onglet Comportement.

Ces options positionnent les transitions sortantes correspondantes.

Positionnez ensuite les activités relatives aux traitements à appliquer.

Pour traiter les erreurs, vous pouvez par exemple positionner une boîte d'attente puis planifier des reprises.

Les rejets sont collectés avec leur code d'erreur et le message correspondant, vous pouvez donc mettre en place un tracking des rejets afin d'optimiser vos processus de synchronisation.

NOTE
Même lorsque l'option Traiter les rejets n'est pas activée, un avertissement est généré pour chaque colonne rejetée, avec le code erreur et le message correspondant.

La transition sortante Rejet permet d'accéder au schéma de sortie qui contient les colonnes spécifiques relatives aux codes et messages d'erreur. Pour Salesforce.com, cette colonne est errorSymbol (symbole de l'erreur, différent du code de l'erreur), errorMessage (description du contexte de l'erreur).

Import d'objets supprimés dans le CRM importing-objects-deleted-in-the-crm

Afin de permettre la mise en place d'un processus exhaustif de synchronisation des données, vous pouvez importer dans Adobe Campaign les objets supprimés côté CRM.

Pour cela, les étapes sont les suivantes :

  1. Sélectionnez une opération de type Import des objets supprimés dans le CRM.

  2. Accédez à la liste déroulante Objet distant et sélectionnez l’objet concerné par le processus. Cet objet correspond à l'une des tables créées dans Adobe Campaign lors de la configuration du connecteur.

  3. Indiquez la période de suppression à prendre en compte dans les champs Date de début et Date de fin. Ces dates seront incluses dans la période.

    note important
    IMPORTANT
    La période de suppression des éléments à récupérer doit correspondre aux limitations propres au CRM. Ainsi, par exemple, pour Salesforce.com, les éléments dont la suppression remonte à plus de 30 jours ne peuvent pas être récupérés.

Suppression d'objets dans le CRM deleting-objects-in-the-crm

Pour supprimer des objets côté CRM, vous devez indiquer la clé primaire des éléments distants à effacer.

L’onglet Comportement vous permet d’activer le traitement des rejets. Cette option génère une seconde transition de sortie pour l’activité Connecteur CRM. Voir à ce sujet la section Traitement des erreurs.

NOTE
Même lorsque l'option Traiter les rejets n'est pas activée, un avertissement est généré pour chaque colonne rejetée.
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1