Fermer

janvier 31, 2024

Un guide pour créer une action de soumission personnalisée pour une capture transparente des données des formulaires Sitecore dans Pardot / Blogs / Perficient

Un guide pour créer une action de soumission personnalisée pour une capture transparente des données des formulaires Sitecore dans Pardot / Blogs / Perficient


Dans mon récent projet, j’ai rencontré une exigence cruciale : la nécessité de transmettre de manière transparente les soumissions de formulaires Sitecore à Salesforce Pardot. J’ai mis en œuvre avec succès une action de soumission personnalisée dans les formulaires Sitecore pour répondre à cette exigence. Dans cet article de blog, je vais vous guider tout au long du processus étape par étape, détaillant la personnalisation appliquée à Sitecore pour réaliser cette intégration.

Étape 1 : Création d’un gestionnaire de formulaires dans Salesforce Pardot

Cette section explique les gestionnaires de formulaires dans Salesforce Pardot, en soulignant leur objectif et leur importance. Il vous guide tout au long du processus de création d’un nouveau gestionnaire de formulaire adapté aux soumissions de formulaires Sitecore.

Mappage des champs du formulaire : Garantir une intégration réussie implique de mapper les champs du formulaire Sitecore avec leurs homologues correspondants dans Salesforce Pardot. Cette étape est cruciale pour maintenir la cohérence et l’exactitude des données pendant la transmission.

Pour créer un gestionnaire de formulaire dans Salesforce Pardot, accédez à la section Gestionnaires de formulaires sur le tableau de bord et cliquez sur le bouton « Ajouter un gestionnaire de formulaire ».
6 Gestionnaire de formulaire

Remplissez tous les détails requis dans le formulaire.
7 Créer un gestionnaire de formulaire

En faisant défiler vers le bas, vous trouverez la section Champs du formulaire, où le champ e-mail est visible par défaut. Pour ajouter un nouveau champ, cliquez sur le bouton « Ajouter un nouveau champ ».
8 Ajouter un champ de formulaire

En cliquant sur le bouton « Ajouter un nouveau champ », une fenêtre contextuelle apparaîtra dans laquelle vous pourrez saisir le nom du champ, le prospect et le format des données.
9 Ajouter un nouveau champ

Dans cette fenêtre contextuelle, il y a également un onglet Avancé. Cliquez dessus si vous souhaitez définir un message personnalisé en cas d’échec de validation.
10 Validation

Après avoir ajouté tous les champs obligatoires, cliquez sur le bouton « Créer un gestionnaire de formulaire ». Vous verrez alors les détails du gestionnaire de formulaire ainsi que les champs ajoutés.
11 Détails du formulaire

Note: Les champs que vous avez ajoutés doivent correspondre exactement au formulaire Sitecore ; les noms des champs doivent correspondre exactement.

Étape 2 : Implémentation du pipeline de code en C#

Cette section explore les subtilités de l’établissement d’un pipeline de code robuste pour gérer les soumissions de formulaires. Il couvre l’intégration transparente avec les API Sitecore, les transformations de données et les processus de validation essentiels à une mise en œuvre réussie.

Ouvrez le code de votre projet dans Visual Studio et sélectionnez le projet dans lequel vous souhaitez créer le pipeline pour cette action personnalisée. Dans mon cas, j’ai créé un projet de fonctionnalités distinct pour cette implémentation, car je prévois d’intégrer d’autres outils de Pardot.

Dans mon dépôt GitHub, j’ai ajouté trois fichiers :

  • PardotParameters.cs : Ce fichier contient le paramètre EndpointUrl, que nous pouvons définir dans Sitecore. Cette URL est fournie par Pardot sur leur tableau de bord.
  • PardotEndpointViewModel.cs : Dans ce fichier, nous remplaçons la propriété pour obtenir le point de terminaison Pardot de Sitecore.
  • SoumettreToPardot.cs : Ici, vous pouvez trouver la logique par laquelle nous récupérons le point de terminaison Pardot, soumettons les données du formulaire, puis les soumettons à Pardot.

Ces fichiers constituent collectivement la base de la mise en œuvre du pipeline de code, permettant une interaction fluide avec Pardot dans la gestion des soumissions de formulaires.

Étape 3 : Création d’une action de soumission personnalisée dans Sitecore

Pour lancer l’intégration, la première étape consiste à créer une action de soumission personnalisée au sein de la plateforme Sitecore. Cette action constitue un lien essentiel entre les formulaires Sitecore et la transmission ultérieure des données à Salesforce Pardot.

Pour créer une action de soumission personnalisée pour les formulaires Sitecore, procédez comme suit :

  1. Accédez au chemin suivant dans votre arborescence Sitecore :/sitecore/system/Settings/Forms/Submit Actions
  2. Créez un élément à l’aide du modèle situé à l’adresse : /sitecore/templates/System/Forms/Submit Action
    1 Soumettre une action
  3. Ajoutez le nom de l’action de soumission ; par exemple, j’ai utilisé « Enregistrer dans Pardot »
    2 Nom de l'action de soumission
  4. Une fois que vous avez créé l’élément d’action de soumission personnalisé, vous trouverez quatre champs : Type de modèle, Message d’erreur, Éditeur et Activer la soumission du robot.
    1. Dans le champ Type de modèle, ajoutez généralement la référence du projet où vous avez ajouté la méthode de traitement personnalisé à l’étape précédente.
      3 types de modèles
    2. Dans le champ Message d’erreur, vous pouvez ajouter votre message d’erreur personnalisé à afficher en cas de problème lors de la soumission du formulaire.
      4 Message d'erreur
    3. Aucune modification n’est nécessaire dans les autres champs, à savoir l’éditeur et la soumission du robot.
  5. Vous pouvez éventuellement ajouter une icône pour l’action de soumission. Voici l’aspect final de votre arborescence Sitecore avec l’action de soumission personnalisée que vous avez créée.
    5 Appel final

Cette action de soumission personnalisée établit un lien crucial dans l’intégration, facilitant le flux transparent des données des formulaires Sitecore vers Salesforce Pardot.

Étape 4 : Ajout de l’action de soumission personnalisée au formulaire Sitecore

Créez tous les champs obligatoires dans les formulaires Sitecore et ajoutez le bouton Soumettre.
12 Créer un formulaire Sitecore

Il est maintenant temps d’ajouter des actions au bouton Soumettre. Cliquez sur le bouton Soumettre et sélectionnez « Ajouter » dans la liste déroulante Soumettre les actions.
13 Soumettre des actions

J’ai ajouté deux actions : une que j’ai créée avec personnalisation pour Pardot et une autre pour l’action prête à l’emploi dans Sitecore pour stocker les données soumises dans Sitecore.
14 Actions ajoutées

Clause de non-responsabilité: Le seul problème concerne les téléchargements de fichiers, car Pardot ne prend pas en charge les téléchargements de fichiers. Par conséquent, les fichiers téléchargés ne seront pas capturés dans Sitecore.

Dans ce guide complet, nous avons parcouru le processus complexe d’intégration de Salesforce Pardot aux formulaires Sitecore, en mettant l’accent sur la création d’un pipeline de données transparent pour les soumissions de formulaires. En créant un gestionnaire de formulaire personnalisé dans Salesforce Pardot et en implémentant un pipeline de code robuste en C#, nous avons établi une connexion fiable entre Sitecore et Pardot, garantissant la transmission précise des données.

La création d’une action de soumission personnalisée au sein de Sitecore a joué un rôle central en comblant le fossé entre les formulaires Sitecore et Salesforce Pardot. Cette action a constitué un maillon crucial dans l’intégration, permettant un flux de données sans effort et l’exécution d’une logique personnalisée.

Même si nous avons rencontré des défis, tels que la limitation des téléchargements de fichiers dans Pardot, l’intégration globale constitue une base solide pour les organisations cherchant à exploiter les capacités de Sitecore et de Salesforce Pardot de manière unifiée.

En suivant ces étapes, les organisations peuvent améliorer leurs stratégies de marketing et de gestion de la relation client, garantissant ainsi un processus transparent et efficace de capture et de gestion des soumissions de formulaires. À mesure que la technologie évolue, l’intégration décrite dans ce guide permet aux entreprises de mieux réussir à tirer parti de la puissance de Sitecore et de Salesforce Pardot en tandem.

Bon codage !






Source link