Synchronisation des données entre Campaign et votre CRM data-synchronization

La synchronisation des données entre Adobe Campaign et votre CRM est gérée par l’activité de workflow 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 :

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

  2. Dans la liste déroulante Objet distant, sélectionnez l’objet à importer. 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 cette section.

    note caution
    CAUTION
    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 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 2021.

    note caution
    CAUTION
    Les limitations relatives aux modes de filtrage des données sont décrites dans cette section.
  5. Sélectionnez l'option Utiliser l'index automatique… pour gérer automatiquement la synchronisation incrémentale des objets entre le CRM et Adobe Campaign, selon la date de leur dernière modification.

    Pour plus d’informations, consultez cette section.

Gestion des 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  : nom de l'option contenant la date du dernier import.

  • vars.crmStartImport  : date de début (incluse) du dernier import de données.

  • vars.crmEndDate  : date de fin (exclue) du dernier import de 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.

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 votre 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

Exportez les données Adobe Campaign dans votre CRM pour copier l’intégralité de son contenu dans votre base de données CRM.

Pour exporter des données vers votre CRM, créez un workflow du type suivant :

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

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

    note caution
    CAUTION
    La fonction d'export de l'activité Connecteur CRM peut insérer ou mettre à jour des champs sur votre CRM. Pour activer les mises à jour des champs dans le CRM, spécifiez 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. Si vous devez effectuer des exports plus rapides, cochez l’option Exportation par lots.

  4. Dans la section Mapping, cliquez sur Nouveau pour indiquer les champs à exporter et leur mapping dans votre 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
    Si aucune correspondance n’est définie pour un champ, les valeurs ne peuvent pas être mises à jour : elles sont insérées directement dans votre 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 cette section.

    note note
    NOTE
    La liste des enregistrements à exporter et le résultat de l'export sont enregistrés dans un fichier temporaire qui reste accessible jusqu'à ce que le workflow soit terminé ou redémarré. Vous pouvez ainsi démarrer le processus en toute sécurité en cas d’erreur.

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 votre CRM ou lors de leur export vers votre 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  : supprime les heures des champs de type Date + Heure.
  • Sans décalage  : annule la gestion des fuseaux horaires appliquée dans le mode par défaut.
  • Copié/collé  : 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 ce faire, sélectionnez les options Conserver les rejets dans un fichier et Traiter les erreurs dans l’onglet Comportement.

Ces options ajoutent les transitions sortantes associées.

Insérez ensuite les activités correspondantes afin de traiter les données. Par exemple, ajoutez une activité Attente et planifiez des reprises pour les erreurs.

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

Vous pouvez importer des objets supprimés dans votre CRM vers Adobe Campaign.

  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 (dates incluses).

    note caution
    CAUTION
    La période de suppression doit correspondre aux limites spécifiques à votre CRM. Par exemple, pour Salesforce.com, les éléments supprimés il y a 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 dans votre 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.

recommendation-more-help
35662671-8e3d-4f04-a092-029a056c566b