Вы находитесь здесь:
Подключение внешней формы к средству обработки форм
После создания и публикации средства обработки форм настройте внешнюю форму для отправки данных в Salesforce.
Требуемые версии
Просмотр поддерживаемых версий.
| Необходимые полномочия пользователя | |
|---|---|
| Для создания средства обработки форм: | Набор полномочий менеджера Marketing Cloud И Любая роль соавтора рабочего пространства CMS |
| Для публикации средства обработки форм: | Набор полномочий менеджера Marketing Cloud И Роль автора рабочего пространства CMS администратора содержимого или менеджера содержимого |
| Для настройки списка разрешенных CORS: | Модификация всех данных |
Прежде чем выполнить эти действия, создайте и опубликуйте средство обработки форм.
Существует два способа отправки данных из формы в Salesforce. Выберите тип подключения, наиболее соответствующий структуре и возможностям сайта.
| Фрагмент JavaScript (клиентский) | URL-адрес прямого сообщения (серверный) |
|
|---|---|---|
| Как это работает | Сценарий на вашей странице отправляет данные формы в Salesforce, когда посетитель отправляет форму. | Ваша форма публикует данные напрямую в URL-адрес Salesforce без сценария на странице. |
| Добавить на сайт | Тег <script> и атрибуты формы, вставляемые в HTML для страницы. |
URL-адрес, заданный в качестве действия для формы или цели webhook. |
| Наиболее подходит для | Страницы, где вы управляете HTML и можете добавлять сценарии. | Сторонние конструкторы форм, которые не разрешают настраиваемые сценарии, страницы со строгими правилами политики безопасности содержимого (CSP) и формы, публикуемые с сервера. |
| Поддерживает веб-отслеживание | Да | Нет |
| Поддерживает разрешающую способность при опознавании | Да | Нет |
| Требует наличия записи в списке разрешенных CORS | Да | Да |
Оба метода отправляют данные в одно средство обработки форм и запускают один поток. Оба метода также требуют авторизации домена в списке разрешенных CORS.
При любом типе подключения убедитесь, что каждое поле в вашей форме использует атрибут HTML-name, точно соответствующий имени внешнего поля в средстве обработки форм. Если имена не совпадают, средство обработки форм не собирает значение. Например, если вы соотнесли email_address имени внешнего поля с полем Email, атрибут name для соответствующего поля в форме должен также быть email_address.
Вариант 1: Настройка формы для использования клиентского подключения
Используйте этот метод при управлении HTML-файлом страницы и можете добавить к нему сценарий. Поскольку сценарий выполняется в обозревателе посетителя, этот метод поддерживает веб-отслеживание и разрешающую способность при опознавании. В результате, этот метод может связать отправку формы с веб-деятельностью посетителя.
- Опубликуйте средство обработки форм.
-
Во вкладке «Фрагмент кода» в обработчике клиентских форм скопируйте сценарий отслеживания. Сценарий напоминает пример ниже.
<script async src="https://YOUR_DOMAIN/lp/assets/scripts/external-form-handler-host.min.js" onload="SFDCFormHandler.init('https://YOUR_DOMAIN/lp')"></script> -
В HTML-код сайта вставьте сценарий перед закрывающим тегом
</body>. -
Во вкладке «Фрагмент кода» скопируйте атрибуты формы. Атрибуты напоминают пример ниже.
<form id="CONTENT_KEY" data-uma-forms="true"></form> -
В HTML добавьте атрибуты
idиdata-uma-formsк тегу<form>. -
Убедитесь, что атрибут HTML-
nameдля каждого поля формы соответствует соотнесенному имени внешнего поля. - Добавьте домен, размещающий форму, в список разрешенных CORS. Этот шаг разрешает домену отправлять представления в Salesforce.
- Чтобы отслеживать занятость пользователей, включите веб-отслеживание.
Когда посетитель отправляет форму, сценарий отправляет данные в Salesforce, а средство обработки форм обрабатывает отправку и запускает поток. Обработчик форм потом перенаправляет их на настроенный URL-адрес успеха или ошибки.
Вариант 2: Настройка формы для использования серверного подключения
Используйте серверное подключение, если вы не можете добавить код на страницу или выполнить настраиваемые конфигурации кода. С помощью этого метода средство обработки форм предоставляет целевой URL-адрес, и вы настраиваете форму на отправку ее данных на этот URL-адрес. Поскольку сценарий не встроен, этот метод работает с инструментами формы, которые не позволяют настраиваемый JavaScript. Этот метод также используется на страницах со строгими правилами политики безопасности содержимого (CSP) и в формах, отправляемых с сервера.
-
Во вкладке «Фрагмент кода» средства обработки форм в разделе «Серверное средство обработки форм» скопируйте URL-адрес действия формы. URL-адрес напоминает пример ниже.
https://YOUR_DOMAIN/lp/cms/form/submit/v1/CONTENT_KEY -
Настройте форму для отправки данных в Salesforce. Этапы внедрения зависят от способа внедрения формы.
При использовании стороннего конструктора форм или плагина В параметрах стороннего инструмента найдите поле для настройки действия формы, URL-адреса сообщения или цели веб-хука. Введите URL-адрес Salesforce в это поле. Если вы можете изменить HTML, но не можете добавить сценарий Установите атрибут actionтега<form>на URL-адрес Salesforce и задайте атрибутуmethodзначениеPOST.Если форма использует базовый процесс Отправьте запрос POST на URL-адрес Salesforce с данными формы в кодировке application/x-www-form-urlencoded. -
Убедитесь, что имя каждого поля полностью соответствует имени соотнесенного внешнего поля.
Средство обработки форм собирает поля только при их точном совпадении.
- Добавьте домен, размещающий форму, в список разрешенных CORS. Этот шаг разрешает домену отправлять представления в Salesforce.
Настройка списка разрешенных CORS
Оба метода подключения требуют авторизации домена перед принятием отправлений формы Salesforce. Если вы не авторизуете домен, Salesforce блокирует отправку до ее обработки. Чтобы авторизовать домен, добавьте его в список разрешенных CORS.
-
Определите домен, размещающий форму, например,
https://www.example.com. Чтобы авторизовать все субдомены, используйте специальный символ (например,https://*.example.com). - Добавьте домен в список разрешенных CORS.
Тестирование формы
После подключения формы к средству обработки форм протестируйте ее, чтобы убедиться в ее соответствии ожидаемым требованиям.
- В форме отправьте тестовую запись и подтвердите, что вы отправлены на URL-адрес успеха.
-
В Salesforce проверьте создание или обновление записи, соответствующей тестовой записи.
Совет Если запись не создана или не обновлена после отправки тестовой записи, убедитесь, что атрибут имени каждого поля формы соответствует имени внешнего поля. Если средство обработки форм подключено к потоку, убедитесь, что поток завершен без ошибок.
