Предзаполните Форму по ссылке и передайте источник кампании

Ссылка может открыть Форму с уже заполненными некоторыми ответами и передать значение, которое человек никогда не видит, например кампанию, с которой он пришёл. Обе возможности появились в v1.12.0. В этом руководстве показано, как настроить каждую из них на Размещённой странице, а затем разобраны ограничения: что ссылка заполнить не может, почему ссылка — небезопасное место для персональных данных и что делать со Встроенной формой, где ссылка не читается вообще.

Что вам понадобится

Форма с опубликованной Размещённой страницей. Переключатель «Опубликовать размещённую страницу» на вкладке «Размещённая страница» заблокирован с подсказкой «Размещённые страницы доступны на платных тарифах.» То же правило строки запроса действует для блока «Форма» на странице Микросайта, описанном в статье о Микросайтах. Ссылка заполняет поле по его имени — строке, под которой поле HTML отправляет данные, а не по метке. Откройте вкладку «Поля» и проверьте имя каждого поля, которое вы собираетесь заполнять.

Предзаполните поле из ссылки

1. На вкладке «Поля» запишите имя поля. В этом примере — поле с именем email.

2. Откройте вкладку «Размещённая страница» и убедитесь, что «Опубликовать размещённую страницу» включено. Рядом с «Опубликовано по адресу» вы увидите адрес страницы. Скопируйте его.

3. Добавьте в конец адреса знак вопроса, имя поля, знак равенства и значение. Больше пар соединяйте амперсандом.

4. Откройте готовую ссылку в приватном окне. Поле должно уже содержать значение.

YOUR_HOSTED_PAGE_ADDRESS?email=ada@example.com&topic=Sales

Здесь YOUR_HOSTED_PAGE_ADDRESS — это адрес после «Опубликовано по адресу», а topic — имя поля «Выпадающий список» с вариантом Sales. Что именно будет заполнено, определяют несколько правил:

• Предзаполнение — это лишь то, с чего начинается элемент управления. Человек может изменить всё, что видит, и ничто не считается ответом, пока он не нажмёт «Отправить». Дальше значение оценивается точно так же, как введённое вручную.

• «Выпадающий список», «Один вариант» или «Несколько вариантов» принимает значение, только если оно — один из собственных вариантов поля. Всё остальное игнорируется.

• «Флажок» принимает 1. «Шкала» или «Оценка» принимает целое число в своём диапазоне.

• Поля «Длительность», «Сетка», «Сетка флажков» и «Файл» не заполняются никогда.

• Ключ, который не является полем Формы, игнорируется.

• Если человек уже отправил ответы и страница вернулась, например после ошибки, его ответы имеют приоритет над ссылкой.

• «Оцениваемая» Форма никогда не предзаполняется, поэтому ссылка не может заранее ответить на работу.

Передайте источник кампании в Скрытом поле

Скрытое поле хранит значение, которое человек никогда не видит и не редактирует. Так источник кампании или идентификатор из вашей CRM попадает вместе с Отправкой, не засоряя страницу.

1. На вкладке «Поля» нажмите «Добавить поле».

2. Укажите в поле «Имя» utm_source. В поле «Тип» выберите «Скрытое». Как только вы выберете «Скрытое», подсказка под «Типом» покажет «Заполняется из ссылки» и вид ссылки, который нужно использовать.

3. Оставьте поле на первом шаге. Скрытое поле должно находиться на первом шаге, где его не может обойти ни одно ветвление, и на этом шаге должен быть и вопрос, который человек видит, а не только Скрытые поля.

4. Сохраните Форму.

5. Добавьте ключ в ссылку: YOUR_HOSTED_PAGE_ADDRESS?utm_source=newsletter. Откройте её, заполните видимые поля и отправьте.

6. Откройте новую Отправку. Значение newsletter находится среди её ответов. В Списке изменений FormFlow сказано, что оно попадает также в экспорт, Google Таблицы и вебхуки.

Скрытое поле никогда не бывает обязательным и не имеет правил для настройки, потому что человек не мог бы ни увидеть, ни исправить отказ. Его имя не может совпадать с именем поля-ловушки (honeypot) Формы. Оно никогда не выводится обратно человеку на экране со списком его ответов.

Строгий режим и Скрытые поля

На вкладке «Безопасность» переключатель «Проверять отправки по списку полей» — это строгий режим. Когда он включён, Отправка должна соответствовать списку полей Формы, так что ключ, который Форма не объявляет, — это проблема. Благодаря объявлению Скрытого поля его ключ проходит, поэтому вы можете отслеживать кампании, не отключая строгий режим.

Во Встроенной форме

Предзаполнение читает ссылку, по которой открыли страницу, отдаваемую FormFlow. Встроенная форма находится на вашей собственной странице, поэтому FormFlow эту ссылку никогда не видит. Сгенерированный компонент включает Скрытое поле — как пустой input без значения. Заполнить его предстоит вашей странице. Минимальный скрипт, написанный вами, а не сгенерированный FormFlow, выглядит так:

<input name="utm_source" type="hidden">

<script>
  var source = new URLSearchParams(location.search).get('utm_source');
  var input = document.querySelector('input[name="utm_source"]');
  if (source && input) { input.value = source; }
</script>

Разместите скрипт после формы. Строка с input — это то, что сгенерированный компонент содержит для Скрытого поля с именем utm_source. Строгому режиму по-прежнему нужно, чтобы Скрытое поле было объявлено в Форме.

Ограничения, о которых стоит знать

• Предпросмотр в панели никогда не принимает предзаполнение. Проверяйте по настоящей ссылке.

• Форма, допускающая только «Список участников», проводит людей через шаг входа, и предзаполнение этот редирект не переживает.

• У «Оцениваемой» Формы не может быть Скрытых полей. Конструктор говорит об этом так: «В форме с ключом ответов не может быть скрытых полей.»

• Каждое значение в ссылке может попасть в вашу аналитику и журналы, независимо от того, скрытое ли это поле.