Vous êtes ici :
Connexion d'un formulaire externe à un gestionnaire de formulaire
Après avoir créé et publié un gestionnaire de formulaire, configurez votre formulaire externe pour envoyer des données à Salesforce.
Éditions requises
Afficher les éditions prises en charge.
| Autorisations utilisateur requises | |
|---|---|
| Pour créer un gestionnaire de formulaire : | Ensemble d'autorisations Responsable Marketing Cloud ET N'importe quel rôle de contributeur dans un espace de travail CMS |
| Pour publier un gestionnaire de formulaire : | Ensemble d'autorisations Responsable Marketing Cloud ET Un rôle de contributeur administrateur de contenu ou responsable de contenu dans l’espace de travail CMS |
| Pour configurer la liste d'autorisations CORS : | Modifier toutes les données |
Avant de suivre ces étapes, créez et publiez un gestionnaire de formulaire.
Il existe deux méthodes pour envoyer des données depuis votre formulaire vers Salesforce. Sélectionnez le type de connexion le plus adapté à la structure et aux capacités de votre site.
| Extrait de code JavaScript (côté client) | URL POST directe (côté serveur) |
|
|---|---|---|
| Comment ça marche | Un script de votre page envoie les données du formulaire à Salesforce lorsqu'un visiteur soumet le formulaire. | Votre formulaire publie des données directement dans une URL Salesforce, sans script sur la page. |
| Ajouter à votre site | Une balise <script> et des attributs de formulaire que vous collez dans le code HTML de votre page. |
Une URL que vous définissez en tant qu'action pour votre formulaire ou destination webhook. |
| Convient le mieux pour | Pages dans lesquelles vous contrôlez le code HTML et pouvez ajouter des scripts. | Générateurs de formulaire tiers qui n'autorisent pas les scripts personnalisés, les pages avec des règles strictes de Stratégie de sécurité des contenus (CSP) et les formulaires qui publient à partir d'un serveur back-end. |
| Prend en charge le suivi Web | Oui | Non |
| Prend en charge la résolution de l'identité | Oui | Non |
| Nécessite une entrée Liste d'autorisations CORS | Oui | Oui |
Les deux méthodes envoient des données au même gestionnaire de formulaire et déclenchent le même flux. Les deux méthodes nécessitent également d'autoriser votre domaine dans la liste d'autorisations CORS.
Avec l'un ou l'autre type de connexion, assurez-vous que chaque champ de votre formulaire utilise un attribut name HTML qui correspond exactement au nom du champ externe correspondant dans le gestionnaire de formulaire. Si les noms ne correspondent pas, le gestionnaire de formulaire ne capture pas la valeur. Par exemple, si vous avez mappé le email_address de nom de champ externe avec le champ Email, l'attribut name du champ correspondant dans le formulaire doit également être email_address.
Option 1 : Configuration de votre formulaire pour utiliser une connexion côté client
Utilisez cette méthode lorsque vous contrôlez le code HTML de votre page et pouvez lui ajouter un script. Le script est exécuté dans le navigateur du visiteur. Par conséquent, cette méthode prend en charge le suivi Web et la résolution de l'identité. Par conséquent, cette méthode peut connecter une soumission de formulaire à l'activité Web d'un visiteur.
- Publiez le gestionnaire de formulaire.
-
Sous l'onglet Extrait de code, sous Gestionnaire de formulaire côté client, copiez le script de suivi. Le script ressemble à cet exemple.
<script async src="https://YOUR_DOMAIN/lp/assets/scripts/external-form-handler-host.min.js" onload="SFDCFormHandler.init('https://YOUR_DOMAIN/lp')"></script> -
Dans le code HTML du site, collez le script avant la balise
</body>fermante. -
Sous l'onglet Extrait de code, copiez les attributs du formulaire. Les attributs ressemblent à cet exemple.
<form id="CONTENT_KEY" data-uma-forms="true"></form> -
Dans votre code HTML, ajoutez les attributs
idetdata-uma-formsà la balise<form>. -
Vérifiez que l'attribut
nameHTML de chaque champ de formulaire correspond au nom du champ externe mappé. - Ajoutez le domaine qui héberge votre formulaire à la liste d'autorisations CORS. Cette étape autorise votre domaine à envoyer des soumissions à Salesforce.
- Pour surveiller l'engagement des utilisateurs, activez le suivi Web.
Lorsqu'un visiteur soumet le formulaire, le script envoie les données à Salesforce, et le gestionnaire de formulaire traite la soumission et déclenche votre flux. Le gestionnaire de formulaire les redirige ensuite vers l'URL de réussite ou d'erreur que vous avez configurée.
Option 2 : Configuration de votre formulaire pour utiliser une connexion côté serveur
Utilisez une connexion côté serveur lorsque vous ne pouvez pas ajouter un code à votre page ou configurer votre code sur mesure. Avec cette méthode, le gestionnaire de formulaire vous donne une URL de destination et vous configurez le formulaire pour envoyer ses données à cette URL. Comme vous n'incorporez pas de script, cette méthode fonctionne avec des outils de formulaire qui n'autorisent pas JavaScript personnalisé. Cette méthode est également utile avec les pages qui ont des règles strictes de Stratégie de sécurité des contenus (CSP) et avec les formulaires soumis à partir d'un serveur back-end.
-
Sous l'onglet Extrait de code du gestionnaire de formulaire, sous Gestionnaire de formulaire côté serveur, copiez l'URL de l'action de formulaire. L'URL ressemble à cet exemple.
https://YOUR_DOMAIN/lp/cms/form/submit/v1/CONTENT_KEY -
Configurez le formulaire pour envoyer les données à Salesforce. Les étapes de mise en œuvre dépendent de la façon dont vous implémentez votre formulaire.
Si vous utilisez un générateur de formulaire ou un plug-in tiers Dans les paramètres de l'outil tiers, recherchez le champ de configuration de l'action, de l'URL postérieure ou de la destination du webhook du formulaire. Saisissez l'URL Salesforce dans ce champ. Si vous pouvez modifier le code HTML, mais pas ajouter un script Définissez l'attribut actionde votre balise<form>sur l'URL Salesforce, puis définissez l'attributmethodsurPOST.Si votre formulaire utilise un processus back-end Envoyez une requête POST à l'URL Salesforce avec les données du formulaire, avec un codage application/x-www-form-urlencoded. -
Vérifiez que le nom de chaque champ correspond exactement au nom du champ externe mappé.
Le gestionnaire de formulaire capture les champs uniquement lorsqu'ils correspondent exactement.
- Ajoutez le domaine qui héberge votre formulaire à la liste d'autorisations CORS. Cette étape autorise votre domaine à envoyer des soumissions à Salesforce.
Configuration de la liste d'autorisations CORS
Les deux méthodes de connexion nécessitent d'autoriser votre domaine avant que Salesforce accepte les soumissions de formulaire. Si vous n'autorisez pas votre domaine, Salesforce bloque la soumission avant son traitement. Pour autoriser votre domaine, ajoutez-le à la liste d'autorisations CORS.
-
Identifiez le domaine qui héberge le formulaire, par exemple
https://www.example.com. Pour autoriser tous les sous-domaines, utilisez un caractère générique, par exemplehttps://*.example.com. - Ajoutez le domaine à la liste d'autorisations CORS.
Test du formulaire
Après avoir connecté votre formulaire au gestionnaire de formulaire, testez-le pour vérifier son comportement.
- Dans le formulaire, soumettez une entrée test et confirmez que vous êtes envoyé à l'URL de réussite.
-
Dans Salesforce, vérifiez si un enregistrement correspondant à l'entrée test a été créé ou mis à jour.
Conseil Si un enregistrement n'est pas créé ou mis à jour après avoir soumis une entrée test, vérifiez que l'attribut name de chaque champ de formulaire correspond à un nom de champ externe. Si le gestionnaire de formulaire est connecté à un flux, vérifiez que le flux est terminé sans erreur.
