Отслеживание реферальных ссылок для Gravity Forms

Как включить плагин?

После приобретения инструмента отслеживания источников переходов для Gravity Forms установите его на свой сайт WordPress.

Шаг 1: Установка

Войдите на свой сайт WordPress и перейдите в раздел «Плагины» → «Добавить плагин» → «Загрузить плагин» → Установите zip-файл и активируйте его.

Шаг 2: Зарегистрируйте плагин

В левой панели навигации перейдите в раздел Формы → Настройки → Отслеживание реферальных ссылок.

Введите свой лицензионный ключ и активируйте его.

Шаг 3: Включить функцию

После активации лицензии появится вкладка «Общие». Щелкните по ней и поставьте галочку. Включено по умолчанию (“Включить отслеживание источников переходов во всех формах по умолчанию”), затем нажмите Сохранить изменения.

Если этот флажок не установлен, отслеживание будет отключено везде. Вместо этого вы можете включить его для каждой формы отдельно в разделе «Настройки формы» → «Параметры формы».

Вот и всё! При включенной опции «Включить по умолчанию» отслеживание источников переходов будет активно для всех существующих форм и для всех новых, которые вы создадите.

Подробная информация о функциях

Обнаруженные источники

Если URL-адрес источника перехода доступен, мы его получаем и сохраняем в записи. Для распространенных платформ мы также добавляем удобную метку, чтобы источник был легко читаемым.

Источник помечается как «Реклама» только в том случае, если при посещении используется собственный идентификатор клика по рекламе платформы (gclid, msclkid, li_fat_id, ttclid, oppref и т. д.). Известная платформа, на которую осуществляется переход без такого идентификатора, помечается как «Органический». Исключением являются Facebook и Instagram: Meta добавляет fbclid к каждому клику, поэтому они помечаются как «Реклама», если fbclid присутствует с любым UTM-параметром.

Вот список источников, которые помечаются при обнаружении:

• Google: Google Ads, органический трафик Google. Трафик Gemini с тегами. utm_source=gemini Отмечено как органический результат поиска Google; отдельной метки Gemini нет.
• Microsoft/Bing: Реклама Bing, органический контент Bing
• Facebook: Реклама в Facebook, органический трафик в Facebook
• Инстаграм: Реклама в Instagram, органический трафик в Instagram
• LinkedIn: Реклама в LinkedIn, органический трафик в LinkedIn
• X (Твиттер): X Органический
• Reddit: Реклама на Reddit, органический трафик на Reddit
• ТикТок: Реклама в TikTok, органический трафик в TikTok
• Пинтерест: Реклама в Pinterest, органический трафик в Pinterest
• Snapchat: Реклама в Snapchat, органический трафик в Snapchat
• YouTube: Органический трафик на YouTube. Клик на рекламу на YouTube, который приносит gclid Записывается как реклама Google, если URL-адрес также не помечен тегом. utm_source=youtube, которая записывает рекламу на YouTube.
• Другие поисковые системы: Yahoo, DuckDuckGo, Yandex
• Искусственный интеллект/магистратура: ChatGPT Ads, ChatGPT Organic, Perplexity, Copilot, Claude, Grok, DeepSeek
• Платформы для рассылки электронных писем (отслеживание кампаний): Mailchimp, Constant Contact, Pardot (с метками) Salesforce), HubSpot
• Прямой и Неизвестный используются по мере необходимости.
• Обычай Источники трафика можно определить в разделе «Пользовательские источники» для партнерского, аффилиатного и рекламного трафика.

Параметры UTM, которые он фиксирует

• utm_source
• utm_medium
• utm_campaign
• utm_term
• utm_content
• utm_id

Идентификаторы кликов зафиксированы.

Мы записываем каждый идентификатор клика (Click ID) в поле Click ID, и каждый из них связывает посещение со своей платформой, если в строке не указано иное.

Пользовательские источники

Встроенная функция определения источников уже охватывает основные поисковые системы, социальные сети, ИИ-помощников и инструменты email-маркетинга. Пользовательские источники позволяют добавлять собственные правила с метками. Используйте их для партнерских сайтов, партнерских реферальных ссылок, именованных кампаний, брендированных сокращателей ссылок, ссылок сотрудников и всего остального, где используется стандартная метка “Реферальная ссылка” или необработанный текст. utm_source Значение недостаточно конкретное.

Найдите их в Формы → Настройки → Отслеживание реферальных ссылок в Пользовательские источники Раздел. Каждая строка — это одно правило.

Как оценивается правило

При каждом посещении плагин проверяет ваши пользовательские источники. до Встроенная функция обнаружения. Побеждает первое соответствующее правило: плагин устанавливает источник трафика посетителя в соответствии с этим правилом. Этикетка и пропускает встроенную проверку для этого посещения. Если ничего не совпадает, встроенная проверка выполняется как обычно (Google, Facebook, Direct и т. д.).

Поля, одно за другим

• Этикетка – Текст, сохраненный в качестве источника посещения (например). Partner: Acme, Email: Newsletter, Campaign: Spring SaleИменно это и отображается в записи, в {pb_ref_source} Используйте тег слияния на вкладке «Отчеты» и в любом сопоставлении CRM. Выберите что-нибудь знакомое на экране ввода данных, где много информации.
• Поле матча – Где искать:
  • Хост-реферер – домен в реферере браузера (например, matches) acme.com когда кто-то прибывает из https://www.acme.com/blog/post).
  • UTM Источник / Носитель / Кампания / Термин / Контент – соответствующий ?utm_*= параметр в целевом URL.
• Тип совпадения – На что обратить внимание:
  • Содержит – значение поля включает ваше значение совпадения (Match Value) в любом месте внутри него. Регистр нечувствителен. Хорошо подходит для обнаружения вариантов, таких как: acme.com, blog.acme.com, partner.acme.com с одним правилом.
  • Равен – значение поля точно соответствует вашему значению совпадения (регистронезависимо от регистра). Более строгий подход, поэтому используйте его, когда вам нужно точное совпадение, например: utm_source точно равно newsletter.
• Соответствие – Искомый текст. Без кавычек, без звездочек, просто текст целиком.
• Приоритет – Порядок, контролирующий число. Более высокие показатели сначала, Таким образом, в случаях, когда правила пересекаются, побеждает правило с более высоким приоритетом. По умолчанию используется... 10; поднять на 20 или 50 Для правил, которые должны превосходить ваши значения по умолчанию, перейдите к следующему уровню. 5 для решения самых разных задач.

Примеры решения задач

Пометить партнерский сайт по источнику перехода

Любой, кто заходит с любого поддомена acme.com обозначен Partner: Acme вместо общего Referral.

Обозначьте рекламную кампанию в рассылке с тегами.

Используйте это, когда вы контролируете URL-адреса на своей стороне (например, ссылки внутри вашей еженедельной рассылки). ?utm_source=newsletter).

Обозначьте платную рекламную кампанию её UTM-именем.

Уловы ?utm_campaign=spring-sale-2026, ?utm_campaign=spring-sale-google-ads, и аналогичные варианты в одном правиле.

Отключить встроенную функцию определения партнера Google для конкретного партнера.

Высокий приоритет гарантирует, что это правило превзойдёт встроенное. utm_source=google → Google Ads Пометка поступает всякий раз, когда появляется помеченный источник.

“Добавить метки органического/рекламного контента” с указанием пользовательских источников.

Встроенные источники всегда отображаются как Google Ads, Facebook Organic, и т. д. Добавить метки органического трафика/рекламы (пользовательские источники) Флажок (также находится в разделе Формы → Настройки → Отслеживание рефералов) определяет, будут ли ваши пользовательские метки получать тот же суффикс.

• Проверено (по умолчанию) – пользовательское правило с меткой Partner: Acme становится Partner: Acme Organic по реферальному трафику и Partner: Acme Ads если посещение связано с платным идентификатором клика, например, gclid.
• Неконтролируемый – Ваши пользовательские метки отображаются точно так, как вы их ввели, и плагин не добавляет никаких суффиксов.

Выберите тот вариант, который лучше подходит для вашей отчетности. Большинству команд нужен суффикс, чтобы сравнивать платный и органический партнерский трафик, но если вы используете саму метку для полного представления данных, отключите его.

Добавление правил программным способом

Если вы разрабатываете дополнение или хотите, чтобы правила находились под контролем версий, то... pb_gforms_referral_tracking_custom_sources Фильтр принимает ту же форму, что и административный интерфейс, и объединяет с ним данные. Плагин сортирует правила из обоих источников вместе по приоритету, прежде чем фронтенд их оценит.

Зеркальные поля

Наши поля отслеживания добавляются в вашу форму динамически во время рендеринга. Они не входят в список сохраненных полей формы. Это обеспечивает чистоту ваших форм, но некоторые CRM-системы, приложения для email-маркетинга и веб-хуки создают выпадающие списки сопоставления полей только на основе сохраненных полей, поэтому они не могут “видеть” наши динамические поля.

Зеркальное отображение полей решает эту проблему. В разделе «Формы» → [ваша форма] → «Настройки» → «Параметры формы» нажмите Добавить зеркальные поля Плагин добавляет в вашу форму параллельный набор скрытых полей, видимых редактору. Исходные поля отслеживания остаются источником достоверной информации; плагин копирует их полученные значения в зеркальные поля при создании записи, чтобы ваше дополнение могло сопоставить их со своим обычным выпадающим списком полей. Блок зеркальных полей появляется только после того, как будет включен переключатель отслеживания реферальных ссылок для этой формы.

Если ваше дополнение поддерживает опцию сопоставления “Пользовательское значение”, вам вообще не нужны зеркальные поля. Просто сопоставьте наши теги слияния напрямую (например) {pb_ref_source}, {pb_ref_utm_source}, {pb_ref_clid}).

Управление зеркальными полями:

• Добавить зеркальные поля – создает набор элементов, видимых редактору.
• Добавить N отсутствующих зеркальных полей – появляется всякий раз, когда форма содержит некоторые, но не все текущие зеркальные поля, и указывает количество. Это происходит, если кто-то удаляет поля вручную, а также после включения атрибуции последнего касания, которая добавляет новый набор определений. Плагин оставляет идентификаторы оставшихся полей нетронутыми, поэтому сохраненные сопоставления продолжают работать.
• Удалить 2 дублирующихся зеркальных поля – отображается только при наличии дубликатов и указывает количество. Сохраняет первое вхождение каждого элемента.
• Удалить зеркальные поля – удаляет набор (с подтверждением). Значения, уже сохраненные в предыдущих записях, остаются в базе данных, но дополнения больше не смогут видеть их при поиске по идентификатору поля.

При включении атрибуции последнего касания зеркальные поля также могут включать набор данных о последнем касании. Формы, которые уже имели набор данных о первом касании, не будут автоматически его учитывать: используйте Добавить N отсутствующих зеркальных полей на каждый, чтобы пополнить запасы.

Отчеты

Отчеты можно найти в разделе Формы → Настройки → Отслеживание рефералов → Отчеты. На вкладке отображаются все отслеживаемые записи, поступившие в выбранном вами диапазоне дат, с разбивкой по источнику, UTM-меткам и рефереру. Записи, отправленные до активации плагина, записи в формах с отключенным отслеживанием, а также удаленные или спам-записи не учитываются, поэтому эти итоговые значения могут быть ниже общего количества записей в Gravity Forms. Диапазоны охватывают целые дни и заканчиваются на последней завершенной записи. универсальное глобальное время Полночь, поэтому сравнение периодов остается одинаковым. В зависимости от того, насколько далеко часовой пояс вашего сайта находится от UTC, эта граница может приходиться на середину вашего местного дня.

Краткий обзор диаграмм

• Анализ источников – Круговая диаграмма, показывающая долю заявок по каждому указанному источнику (органический трафик Google, реклама в Facebook, ваши пользовательские источники, прямые переходы и т. д.).
• Записи с течением времени – Линейный график общего количества записей по группам. При наведении курсора на точку всплывающая подсказка отображает это общее количество по источнику. Более длинные временные интервалы (90 и 365 дней) позволяют разделить данные по месяцам, чтобы ось оставалась читаемой; в 30-дневном интервале график отображает каждую седьмую метку даты, чтобы избежать перегрузки.
• Ведущий UTM-источник / Среда распространения / Кампания – Горизонтальные столбчатые диаграммы значений с наибольшим количеством записей в каждом измерении UTM.
• Лучшие рефереры – Горизонтальная гистограмма, показывающая домены-источники трафика, обеспечивающие наибольшее количество отправок. Плагин сохраняет данные о прямом трафике с указанием реферера. Direct, Поэтому здесь он представлен как отдельный бар, а не как домен.

Фильтры

• Форма – Ограничьте область видимости одной формой или оставьте значение “Все формы” для просмотра всей системы.
• Диапазон дат – Предустановленные временные интервалы (последние 7, 30, 90 и 365 дней).
• По сравнению с предыдущим периодом – отображает общую сумму за период с указанием процентного изменения по сравнению с аналогичным предыдущим периодом (последние 7 против предыдущих 7, последние 30 против предыдущих 30 и т. д.) и накладывает этот предыдущий период пунктирной линией на временной график. UTM-диаграммы и диаграммы ссылок не сравниваются.
• Скрыть неуказанный источник – скрывает категории «Не задано» и «Неизвестно», чтобы вы могли сосредоточиться на источниках с указанием авторства. Прямые источники остаются.

Плагин запоминает выбранные вами диапазоны дат, периоды сравнения и параметры скрытия неатрибутированных данных для каждого пользователя, поэтому вам не придется устанавливать их заново при следующем посещении.

Производительность и кэширование

Плагин вычисляет отчеты на основе ваших записей Gravity Forms и кэширует результат, поэтому повторные загрузки происходят быстро. Новые записи автоматически аннулируют этот кэш, блокировка на 60 секунд предотвращает его перегрузку при большом объеме форм. Разработчики могут настроить окно задержки (или полностью отключить его) с помощью соответствующего параметра. pb_gforms_rt_invalidate_debounce фильтр. См. раздел «Крючки» ниже.

Сводка новостей по электронной почте

Если вы предпочитаете получать сводку по атрибуции, а не открывать панель управления, включите рассылку по электронной почте в соответствующем разделе. Формы → Настройки → Отслеживание рефералов → Отчеты по электронной почте. Выбранные вами день и час рассчитываются в соответствии с часовым поясом вашего сайта, но сам период измеряется в полном объеме. универсальное глобальное время дни, заканчивающиеся в последнюю полную полночь UTC перед отправкой электронного письма. На сайтах, удаленных от UTC, охватываемый диапазон смещен относительно вашего местного времени.

Темп и ритм

• Еженедельно – выберите день недели (с воскресенья по субботу) и время отправки электронного письма.
• Ежемесячно – выберите день месяца (с ограничением в 28-е число, чтобы письмо всегда приходило, даже в феврале) и час.
• График отправки соответствует вашему часовой пояс сайта (WordPress → Настройки → Общие), и на странице настроек текущая версия отображается рядом с селектором часов. Сам период формирования отчетов по-прежнему измеряется в днях UTC.

Получатели

Один адрес электронной почты на строку. Оставьте поле пустым, и дайджест будет использовать следующий адрес. электронная почта администратора сайта при отправке. Это полезно, если адрес электронной почты администратора может измениться позже, и вы хотите, чтобы дайджест автоматически следовал этому изменению.

Он Отправьте мне тестовое письмо прямо сейчас. Кнопка отображает то же самое тело дайджеста, используя ваш сохранено Настройки. Два момента отличаются от запланированной отправки: тема письма имеет префикс. [TEST], и оно игнорирует Пропустить пустые дайджесты, Таким образом, тест, проведенный в спокойный период, все равно поступит, тогда как настоящий дайджест останется без изменений. Кнопка автоматически отключается, если есть несохраненные изменения; сначала сохраните, а затем протестируйте.

Параметры содержимого

• Пропустить пустые дайджесты – Не отправляйте электронное письмо вообще, если итоговая сумма дайджеста за период равна нулю. В случае с минимальным количеством писем это позволит избежать пустого дайджеста в спокойные недели. Скрыть неуказанный источник Кроме того, эта сумма игнорирует записи типа «Не задано» и «Неизвестно», поэтому период, содержащий только записи без указания авторства, считается пустым и пропускается.
• По сравнению с предыдущим периодом – В верхней части письма отображайте процентное изменение по сравнению с аналогичным периодом прошлого года (прошлая неделя против позапрошлой, прошлый месяц против позапрошлого и т. д.).
• Скрыть неуказанный источник – Исключить значения «Не задано» и «Неизвестно» из таблиц адресов электронной почты, чтобы основное внимание оставалось на источниках с указанием авторства.

Объединить теги

{pb_ref_source} – значение, хранящееся в скрытом поле “Источник” (по умолчанию — “Неизвестно”, если посещение не удалось классифицировать).

{pb_ref_params} – полная строка захваченных параметров реферальной ссылки (UTM и другие переменные запроса, которые мы храним вместе).

{pb_ref_referrer} – URL-адрес, с которого был осуществлен переход. Это фактический реферер, а не исходное значение из браузера. Когда происходит клик по ID или распознанному URL-адресу utm_source Плагин определяет платформу, но вместо этого сохраняет канонический URL-адрес платформы. В результате... gclid записи о посещениях https://www.google.com/ даже если клик произошел из электронного письма. Запись посещений с того же домена и без источника перехода. Direct. Отсутствие тега слияния позволяет получить доступ к неизмененному рефереру браузера.

{pb_ref_utm_id} – utm_id.

{pb_ref_utm_source} – utm_source.

{pb_ref_utm_medium} – utm_medium.

{pb_ref_utm_campaign} – utm_campaign.

{pb_ref_utm_term} – utm_term.

{pb_ref_utm_content} – utm_content.

{pb_ref_clid} – первый обнаруженный идентификатор клика для посещения (gclid, fbclid, msclkid и другие идентификаторы кликов платформы).

{pb_ref_custom_source} – ваша собственная этикетка для посещения, написанная сотрудником pb_gforms_referral_tracking_source_label фильтр (см. Хуки). Тег существует только тогда, когда к этому фильтру прикреплена функция обратного вызова. Плагин сохраняет обнаруженный Источник отдельно и никогда его не изменяет.

Теги слияния последнего касания

При включении атрибуции по последнему касанию плагин добавляет параллельный набор:

• {pb_ref_last_source}
• {pb_ref_last_referrer}
• {pb_ref_last_params}
• {pb_ref_last_clid}
• {pb_ref_last_utm_source}
• {pb_ref_last_utm_medium}
• {pb_ref_last_utm_campaign}
• {pb_ref_last_utm_term}
• {pb_ref_last_utm_content}
• {pb_ref_last_utm_id}
• {pb_ref_last_custom_source}

Каждый из них повторяет свой первоначальный аналог, но сохраняет самый последний источник перед отправкой. {pb_ref_last_custom_source} также нуждается в pb_gforms_referral_tracking_source_label фильтр, аналогичный фильтру первого касания.

Отправка данных в Google Analytics

Функция отслеживания источников переходов никогда не связывается с Google самостоятельно. Все полученные данные остаются в вашей записи Gravity Forms. Если вы включите эту настройку в GA4, событие будет отправляться вашим собственным тегом Google.

Начиная с версии 1.6.0, вы можете подписаться на событие GA4. Включите GA4 / Tag Manager в разделе Формы → Настройки → Отслеживание рефералов → Общие. После подтверждения плагин отправляет пользовательское событие с именем pb_referral_submit (переименуйте его в тех же настройках) с указанием источника, реферера, идентификатора клика и UTM-параметров, а также значений последнего касания, если функция последнего касания включена. Неудачная проверка не отправляет данные. Для подтверждения перенаправления и страницы благодарности требуется версия 1.7.1.

Проверьте GA4 Realtime или DebugView на наличие события. Вам не нужен триггер Tag Manager. Отправку осуществляет ваш собственный тег Google; плагин никогда не связывается с Google.

Дополнительно: вы также можете передавать теги слияния в строке запроса подтверждения перенаправления (ниже), если вы уже конвертируете данные из параметров кампании в URL-адресе благодарственного письма. Это отдельный параметр от пользовательского события.

Что включает в себя это мероприятие

Ключи параметров соответствуют именам тегов слияния. Пустые значения полностью исключаются из полезной нагрузки, и событие срабатывает не более одного раза за просмотр страницы.

Необязательно: передайте значения в URL-адресе благодарственного письма.

1. Откройте подтверждения вашей формы в разделе Формы → [ваша форма] → Настройки → Подтверждения, затем отредактируйте (или добавьте) Перенаправление подтверждение.
2. В URL перенаправления В это поле введите URL-адрес вашей страницы благодарности, а затем строку запроса, сформированную на основе тегов слияния отслеживания:

https://yoursite.com/thank-you/?gclid={pb_ref_clid}&utm_source={pb_ref_utm_source}&utm_medium={pb_ref_utm_medium}&utm_campaign={pb_ref_utm_campaign}&utm_term={pb_ref_utm_term}&utm_content={pb_ref_utm_content}

Gravity Forms заполняет и кодирует каждое значение в URL-адресе во время отправки формы, поэтому посетитель, перешедший по ссылке из Google Ads, попадает на URL-адрес, например:

https://yoursite.com/thank-you/?gclid=EAIaIQ...&utm_source=google&utm_medium=cpc&utm_campaign=spring-sale

Настройка Google Analytics (GA4) или Google Tag Manager на странице благодарности считывает эти параметры так же, как и любой URL-адрес кампании, запуская событие конверсии или лида с указанием источника, кампании и идентификатора клика. Значения, которые не были зафиксированы для данного посещения, отображаются пустыми.

Здесь можно использовать любые теги слияния для отслеживания. См. Объединить теги Полный список можно посмотреть здесь. (Если хотите, вот Передача данных поля через строку запроса. (В этом же подтверждении перенаправления принимаются те же самые теги слияния.)

Почему следует использовать теги слияния вместо собственных скрытых полей?

Если вы уже передаете данные кампании на страницу благодарности из собственных скрытых полей, укажите в строке запроса наши теги слияния. В этом случае и значение, сохраненное в записи, и значение, отправляемое в GA4, будут поступать из одного и того же источника, поэтому они не будут расходиться. Запись и GA4 всегда будут отображать одну и ту же кампанию. Это также означает, что вам не нужно будет поддерживать один набор полей.

Примечание об идентификаторах кликов

{pb_ref_clid} содержит идентификатор первого клика, обнаруженного во время посещения, независимо от платформы, с которой он был совершен: gclid для Google, но также и msclkid (Microsoft), fbclid (Мета) и другие. Если вы сопоставляете это конкретно с gclid= Для параметра Google Ads идентификатор клика при посещении сайта, не связанного с Google, будет отображаться в этом поле. Если вы хотите, чтобы идентификатор клика отображался только при посещении сайтов Google Ads, добавьте условную логику в подтверждение, чтобы... gclid= Параметр отправляется только тогда, когда Источник является Google Реклама.

Проверка работоспособности.

Подтвердить всю цепочку можно в четыре этапа:

1. Добавьте тестовые параметры к любому URL целевой страницы (например) ?gclid=TEST123&utm_source=google&utm_medium=cpcЗатем отправьте форму.
2. На странице благодарности проверьте адресную строку: ваши значения должны присутствовать в URL-адресе.
3. Откройте инструменты разработчика вашего браузера, перейдите в раздел Сеть вкладка и фильтр для collect. Запрос в Google должен включать ваш gclid и utm ценности.
4. Подтвердите получение в GA4. DebugView или В реальном времени отчет.

Протестируйте в приватном режиме или в режиме без авторизации. Когда вы авторизованы как администратор, плагин намеренно работает в режиме только сессии, записывая файлы cookie без срока действия, поэтому окно с информацией об авторизации невозможно воспроизвести из административной сессии.

Эти четыре шага проверяют необязательный метод строки запроса. Для встроенного пользовательского события отправьте форму, затем на странице подтверждения или благодарности откройте DevTools → Сеть и отфильтруйте по следующим параметрам: g/collect, и ищите en=pb_referral_submit (или название вашего события). Или используйте GA4 DebugView. Если событие находится на вкладке «Сеть», но не отображается в GA4, то причина в вашем теге Google. Если события нет на вкладке «Сеть», значит, плагин не сработал.

Отправка мероприятия в GA4

Начиная с версии 1.6.0, вы можете отправлять данные из источника, уже размещенного в записи Gravity Forms, в GA4 в качестве пользовательского события. По умолчанию эта функция отключена. Отправку данных осуществляет ваш собственный тег Google — плагин никогда не связывается с Google напрямую. Проверьте GA4 Realtime или DebugView для получения информации о событии. Вам не нужен триггер Tag Manager.

Перейти к Формы → Настройки → Отслеживание реферальных ссылок → Общие. Галочка Отправляйте полученные параметры в GA4 в качестве пользовательского события при подтверждении формы.. Оставьте название мероприятия как pb_referral_submit Если у вас нет веских причин для внесения изменений, нажмите «Сохранить изменения».

Переводы

Этот плагин готов к переводу и включает в себя встроенные переводы для:

1. Арабский (ar)
2. Бенгальский (bn_BD)
3. филиппинский (fil)
4. Немецкий (de_DE)
5. Испанский (es_ES)
6. Испанский (es_MX)
7. Французский (fr_FR)
8. Хинди (hi_IN)
9. индонезийский (id_ID)
10. Итальянский (it_IT)
11. японский (ja)
12. Португальский (pt_BR)
13. Русский (ru_RU)
14. Урду (ur)
15. Упрощенный китайский (zh_CN)
16. Китайский традиционный (zh_HK)

Язык по умолчанию: английский (en_US)

Если вашего языка нет в списке. Переводы Выше вы можете перевести плагин самостоятельно. Он готов к переводу. Воспользуйтесь бесплатной версией. Плагин Loco Translate Чтобы создать перевод для языка/локали вашего сайта. Впервые используете Loco Translate? Вот инструкция. Урок для начинающих.

Часто задаваемые вопросы

Могу ли я экспортировать данные?

Да. Значения отслеживания сохраняются для каждой записи в Gravity Forms, поэтому они отображаются при экспорте записей.

Что именно фиксирует этот плагин?

Мы собираем общие поля атрибутов и сохраняем их в записи Gravity Forms. Это включает в себя: Параметры UTM (источник, средство массовой информации, кампания, термин, содержание), Идентификаторы кликов (gclid, msclkid, gbraid/wbraid и т. д.), исходный URL-адрес источника перехода, а также соответствующий контекст целевой страницы, чтобы вы могли видеть, откуда пришел каждый потенциальный клиент.

Могу ли я добавлять собственные источники?

Да. Добавьте правила в раздел Формы → Настройки → Отслеживание рефералов → Пользовательские источники Для маркировки партнерских сайтов, партнерского трафика, брендированных кампаний и аналогичных посещений по имени. Каждое правило сопоставляется с хостом-источником или параметром UTM и применяет выбранную вами метку. См. Пользовательские источники Раздел с пошаговым руководством и примерами решения задач.

Мое дополнение для CRM/почты/вебхуков не видит поля отслеживания в выпадающем списке сопоставления. Что мне делать?

Наши поля отслеживания добавляются в вашу форму динамически во время рендеринга, а не сохраняются в списке полей формы, поэтому дополнения, которые формируют свой выпадающий список только из сохраненных полей, не могут их увидеть. У вас есть два варианта. Если ваше дополнение имеет сопоставление “Пользовательское значение”, сопоставьте наши теги слияния напрямую ({pb_ref_source}, {pb_ref_utm_source}, {pb_ref_clid}, и так далее). Если поддерживается только выпадающий список, откройте «Настройки формы» → «Параметры формы» → «Зеркальное отображение полей» и нажмите Добавить зеркальные поля. Это добавляет видимые редактору скрытые поля, и плагин заполняет их. Полное пошаговое руководство см. в разделе «Зеркальные поля».

Где сохраняются данные о рефералах?

В вашей базе данных WordPress, внутри записей Gravity Forms. Плагин сам по себе никуда эти данные не отправляет. Если вы хотите, чтобы полученные значения отображались в GA4, включите соответствующую настройку GA4. Плагин остается источником данных; отправку данных осуществляет ваш собственный тег Google.

Это атрибуция по первому или последнему касанию?

И то, и другое. По умолчанию используется атрибуция по первому касанию, сохраняющая исходный реферер и параметры кампании, которые впервые привели посетителя на ваш сайт (в пределах окна атрибуции). Есть флажок для игнорирования прямых повторных посещений, поэтому атрибуция по последнему касанию сохраняет предыдущую рекламу или реферал. Идентификаторы кликов по повторным посещениям хранятся только в идентификаторе клика (последнее касание). Это дает вам параллельный набор {pb_ref_last_*} Теги слияния, столбцы списка записей и столбцы для экспорта в CSV. Вкладка «Отчеты» содержит переключатель «Имя/Фамилия», который позволяет переключать все диаграммы между двумя режимами просмотра.

Как долго система запоминает данные об источнике посещения?

По умолчанию период атрибуции составляет 7 дней, и вы можете изменить его в разделе «Формы» → «Настройки» → «Отслеживание рефералов». Если посетитель отправляет форму в течение этого периода своего первого отслеживаемого посещения, эта запись будет содержать исходные значения атрибуции первого касания.

Работает ли это с кэшированием/CDN?

Обычно да. Отслеживание выполняется на стороне клиента, поэтому большинство настроек кэширования/CDN работают нормально. Если вы используете агрессивную оптимизацию скриптов (минификация или отложенная отладка), поставьте галочку. Защитите скрипты от оптимизации В разделе «Формы» → «Настройки» → «Отслеживание рефералов» → «Дополнительно» очистите кеш. Это пометит скрипты плагина, чтобы они пропускались, и автоматически добавит их в списки исключений WP Rocket, LiteSpeed Cache, SG Optimizer, Autoptimize и Cloudflare Rocket Loader. Если вы используете Breeze или другой минификатор, не входящий в этот список, исключите два файла, указанные ниже, вручную и очистите кеш CDN для них после обновления.

Для любого оптимизатора, который не охватывает эта настройка, исключите эти два файла вручную и протестируйте отправку:

• /wp-content/plugins/pb-gforms-referral-tracking/assets/js/front-end.js
• /wp-content/plugins/pb-gforms-referral-tracking/assets/dist/js.cookie.min.js

Работает ли это с формами Gravity Forms, поддерживающими AJAX?

Да. Работает с AJAX-формами и стандартными (не AJAX) формами отправки. Для перенаправления и подтверждения благодарности на страницах Gravity Forms 2.9+ требуется версия 1.7.1 для события GA4.

Могу ли я отслеживать более одной формы?

Да. Это работает во всех ваших формах Gravity Forms. Каждая отправленная форма сохраняет свои собственные значения атрибутов для этой записи.

Заменяет ли это отслеживание конверсий GA4 / Google Ads?

Нет. Это источник данных, а не пиксель конверсии, и он никогда не запускает пиксели и не связывается с самим Google. Если вы хотите получать атрибуцию внутри GA4, настройка GA4 / Tag Manager, позволяющая включить эту функцию, отправляет её как пользовательское событие через ваш собственный тег Google при подтверждении формы.

Собирает ли она персональные данные?

По умолчанию он собирает данные об атрибуции (UTM, gclid, (URL-адреса источников перехода). Это так. нет По умолчанию осуществляется сбор дополнительных персональных данных. Поля вашей формы и любые параметры, включенные в URL-адреса, контролируются настройками вашего сайта и маркетинговой стратегии.

Соответствует ли оно требованиям GDPR/CCPA?

Если для сбора каких-либо данных об авторстве требуется согласие, включите дополнительный механизм согласия. Он хранит данные о первом взаимодействии в браузере до тех пор, пока посетитель не даст согласие через ваш баннер с уведомлением о файлах cookie (с помощью флага окна, обратного вызова или события), после чего применяет его.

Работает ли это с многосайтовой сетью WordPress?

Вкратце:

• Безлимитная лицензия: Включите сетевой режим один раз; управление осуществляется одной кнопкой. каждый Настройки и поддержка дочернего сайта.
• Активировано сетью: На всех дочерних сайтах ведется отслеживание переходов, и обновления поступают незамедлительно.
• Ограниченный тарифный план / без лицензии на подсайт: Отслеживание на этом подсайте неактивно. Никакие поля отслеживания, теги слияния или данные записей не будут фиксироваться до тех пор, пока там не будет активирован ключ или сетевой режим не отправит его.
• Поддержка предоставляется в соответствии с лицензией: К участию допускаются сайты, охваченные активным ключом.

Да, после того, как каждый подсайт будет лицензирован и активирован. Активация по сети устанавливает плагин повсюду, и обновления обрабатываются в масштабах всей сети, но для каждого подсайта требуется собственная активированная лицензия (или ключ Unlimited, переданный ему через сетевой режим), прежде чем плагин добавит какие-либо поля отслеживания или начнет собирать какие-либо значения. После этого включите параметр «Включить по умолчанию» или включите отслеживание для каждой формы отдельно.

Если у вас лицензия Unlimited, вы можете включить сетевой режим на главном сайте и отправить этот единый ключ на все дочерние сайты одним пакетом (с отображением хода выполнения в реальном времени). Эти дочерние сайты автоматически наследуют настройки, управляемые лицензией, и поддержку.

Справочник настроек

Всё, что находится ниже, живёт под землей. Формы → Настройки → Отслеживание реферальных ссылок, на вкладке, указанной в каждом заголовке.

Данные и конфиденциальность

Передовой

Вход для согласия

Для этого нет флажка. Механизм согласия — это опция, которую могут включить разработчики: установить. consentRequired через pb_gforms_referral_tracking_js_config фильтр. Скрипт отслеживания хранит данные о первом касании в sessionStorage до получения согласия, затем переводит данные на долговременное хранение.

add_filter( 'pb_gforms_referral_tracking_js_config', function( $config ) {
    $config['consentRequired'] = true;
    return $config;
} );

Подтвердите согласие на использование файлов cookie с помощью любого из трех способов, которые вам подходят:

• Набор window.PBReferralTrackingConsent = true.
• Отправьте информацию о мероприятии: window.dispatchEvent( new Event( 'pb-ref-tracking:consent-granted' ) ).
• Назначить consentGranted Функция обратного вызова, возвращающая значение true после подтверждения согласия.

Крючки

Действия

pb_gforms_referral_tracking_loaded

Запуск происходит после полной инициализации плагина: загружаются классы, регистрируются хуки, API готов. Это надежная точка загрузки для дополнений или сопутствующих плагинов, расширяющих возможности отслеживания источников переходов.

Параметры:

• $plugin (Плагин) – Экземпляр плагина.

add_action( 'pb_gforms_referral_tracking_loaded', function( $plugin ) {
    // Safe to interact with the plugin's classes and filters here.
    // Example: register your own add-on after the plugin is ready.
    if ( class_exists( 'MyReferralAddon' ) ) {
        new MyReferralAddon( $plugin );
    }
} );

Фильтры

pb_gforms_referral_tracking_enabled

Укажите, включено ли отслеживание переходов для конкретной формы. Верните true, чтобы принудительно включить отслеживание, false, чтобы принудительно отключить его, независимо от переключателя для каждой формы или глобального значения по умолчанию.

Параметры:

• $enabled (логическое значение) – Включено ли в данный момент отслеживание.
• $form_id (инт) – Идентификатор текущей формы.
• $form (массив|null) – Массив метаданных формы или null, если он недоступен.

// Disable tracking on a specific form (e.g. an internal staff-only form).
add_filter( 'pb_gforms_referral_tracking_enabled', function( $enabled, $form_id, $form ) {
    $excluded_form_ids = [ 12, 27 ];
    if ( in_array( $form_id, $excluded_form_ids, true ) ) {
        return false;
    }
    return $enabled;
}, 10, 3 );

pb_gforms_referral_tracking_field_definitions

Фильтрация массива скрытых определений полей отслеживания перед тем, как плагин внедрит их в форму. Используйте это для добавления, удаления или изменения любого отдельного поля отслеживания.

Параметры:

• $fields (множество) – Массив массивов определений полей.
• $form (множество) – Текущая форма meta.

// Remove the Referral Parameters field from all forms.
add_filter( 'pb_gforms_referral_tracking_field_definitions', function( $fields, $form ) {
    return array_filter( $fields, function( $field ) {
        return ! isset( $field['cssClass'] ) || $field['cssClass'] !== 'pb-ref-tracking-ref-params';
    } );
}, 10, 2 );

pb_gforms_referral_tracking_form

Отфильтруйте весь массив формы после того, как плагин добавит все свои поля отслеживания. Конечный объект формы вы можете изменить по своему усмотрению перед его отображением.

Параметры:

• $form (множество) – Массив форм с уже добавленными полями отслеживания.
• $field_definitions (множество) – Использованные определения полей.

// Log which forms have tracking fields injected (useful for debugging).
add_filter( 'pb_gforms_referral_tracking_form', function( $form, $field_definitions ) {
    error_log( 'Referral tracking fields added to form ID: ' . $form['id'] );
    return $form;
}, 10, 2 );

pb_gforms_referral_tracking_merge_tag_map

Измените карту тегов слияния, которая определяет, какие теги слияния доступны и к каким идентификаторам полей они относятся. Используйте это для добавления полностью пользовательских тегов слияния или переименования существующих.

Параметры:

• $map (множество) – Ассоциативный массив тегов => [ 'label' => string, 'field_id' => string ].
• $base_id (нить) – Префикс базового идентификатора поля.
• $constants (Константы) – Экземпляр констант плагина.

// Rename the "Source" merge tag label as it appears in the GF dropdown.
add_filter( 'pb_gforms_referral_tracking_merge_tag_map', function( $map, $base_id, $constants ) {
    if ( isset( $map['pb_ref_source'] ) ) {
        $map['pb_ref_source']['label'] = 'Traffic Source';
    }
    return $map;
}, 10, 3 );

pb_gforms_referral_tracking_value

Фильтрация исходного значения поля отслеживания перед тем, как плагин отформатирует его и использует для замены тега слияния в уведомлении или подтверждении. Здесь можно очистить или преобразовать определенное значение.

Параметры:

• $value (нить) – Исходное значение поля.
• $tag (нить) – Ключ тега слияния (например, pb_ref_source).
• $data (множество) – Метаданные тега слияния (метка, идентификатор поля).
• $entry (множество) – Текущая запись.
• $form (множество) – Текущая форма.

// Truncate long referrer URLs in merge tag output.
add_filter( 'pb_gforms_referral_tracking_value', function( $value, $tag, $data, $entry, $form ) {
    if ( $tag === 'pb_ref_referrer' && strlen( $value ) > 100 ) {
        return substr( $value, 0, 100 ) . '…';
    }
    return $value;
}, 10, 5 );

pb_gforms_referral_tracking_formatted_value

Отфильтруйте полностью отформатированное значение тега слияния после того, как Gravity Forms применит к нему собственный конвейер форматирования (экранирование, кодирование URL и т. д.).

Параметры:

• $formatted (нить) – Отформатированная строка вывода.
• $tag (нить) – Ключ тега слияния.
• $data (множество) – Метаданные тега слияния.
• $entry (множество) – Текущая запись.
• $form (множество) – Текущая форма.
• $url_encode (логическое значение)
• $esc_html (логическое значение)
• $nl2br (логическое значение)
• $format (нить)

// Wrap the source value in a bold tag in HTML-format notifications.
add_filter( 'pb_gforms_referral_tracking_formatted_value', function( $formatted, $tag, $data, $entry, $form, $url_encode, $esc_html, $nl2br, $format ) {
    if ( $tag === 'pb_ref_source' && $format === 'html' && ! $url_encode ) {
        return '<strong>' . $formatted . '</strong>';
    }
    return $formatted;
}, 10, 9 );

pb_gforms_referral_tracking_default_value

Переопределите резервное значение, используемое, если поле отслеживания пустое во время отправки. Значение по умолчанию — “Неизвестно”.

Параметры:

• $default (нить) – Текущее значение по умолчанию (“Неизвестно”).
• $key (нить) – Ключ контекста: source, referrer или front_end.

// Use "Direct" instead of "Unknown" for the source field fallback.
add_filter( 'pb_gforms_referral_tracking_default_value', function( $default, $key ) {
    if ( $key === 'source' ) {
        return 'Direct';
    }
    return $default;
}, 10, 2 );

pb_gforms_referral_tracking_js_config

Переопределите весь объект конфигурации JavaScript на стороне клиента до того, как плагин передаст его скрипту отслеживания. Ваш коллбэк управляет настройками cookie, а исходные карты (utmSourceMap и utmReferrerMap), известные источники и paidClickIds Список, определяющий, какие параметры запроса подтверждают платный клик.

Параметры:

• $config (множество) – Полный массив конфигурации JavaScript.

Клавиши с их значениями по умолчанию:

sourcePatterns Намеренно отсутствует в этом списке. Для работы с его записями требуется активный JavaScript. RegExp Объекты, и все, что возвращает PHP-коллбэк, поступает в виде строки после кодирования конфигурации в формате JSON, что вызывает исключение во время сопоставления. Чтобы расширить шаблоны рефереров, присвойте значение. window.PBReferralTrackingConfig из JavaScript перед запуском скрипта отслеживания.

// Extend cookie lifetime to 30 days and add a custom paid medium.
add_filter( 'pb_gforms_referral_tracking_js_config', function( $config ) {
    // Extend the first-touch attribution window to 30 days.
    $config['cookieExpiry'] = 30;

    // Turn on the cookieless localStorage fallback for visitors who block cookies.
    $config['fallbackStorage'] = 'local';

    return $config;
} );

pb_gforms_referral_tracking_custom_sources

Плагин программно внедряет пользовательские правила обработки данных, которые выполняются параллельно с правилами, настроенными в административном интерфейсе. Плагин объединяет правила из этого фильтра с сохраненными правилами пользовательского интерфейса, сортирует объединенный набор по приоритету и передает его на фронтенд.

Параметры:

• $sources (множество) – Пустой массив. Возвращает массив массивов правил для добавления.

Каждое правило должно содержать: метку, поле соответствия (referrer, utm_source, utm_medium, utm_campaign, utm_term, utm_content), тип соответствия (contains или equals), значение соответствия и, при необходимости, приоритет (по умолчанию 10, более высокие значения выполняются первыми).

Правила, добавленные с помощью этого фильтра, также могут использовать referrer_url В качестве параметра matchField используется сопоставление с полным URL-адресом источника перехода, включая его путь и запрос, а не только с хостом. В административном интерфейсе эта функция отсутствует, поэтому она доступна только здесь.

// Add partner and affiliate sources without touching the admin UI.
add_filter( 'pb_gforms_referral_tracking_custom_sources', function( $sources ) {
    $sources[] = [
        'label'      => 'Partner: Acme Corp',
        'matchField' => 'referrer',
        'matchType'  => 'contains',
        'matchValue' => 'acme.com',
        'priority'   => 20,
    ];
    $sources[] = [
        'label'      => 'Campaign: Spring Sale',
        'matchField' => 'utm_campaign',
        'matchType'  => 'contains',
        'matchValue' => 'spring-sale',
        'priority'   => 10,
    ];
    return $sources;
} );

pb_gforms_referral_tracking_source_label

При отправке запроса введите собственную метку в отдельное поле «Пользовательский источник». Обнаруженный источник никогда не изменяется, поэтому в записи сохраняются как данные, вычисленные плагином, так и ваши собственные. Это полезно, когда CRM-системе требуется упрощенная или внутренняя метка, и вы не хотите потерять реальный источник. Начиная с версии 1.6.0.

Функция активируется при подключении функции обратного вызова. Без подключения поля «Пользовательский источник» и их теги слияния отсутствуют. Добавьте такую функцию, и плагин начнет добавлять поле «Пользовательский источник» в ваши формы, а также поле «Пользовательский источник (Последнее касание)», если включена атрибуция по последнему касанию. Возвращается пустая строка, чтобы оставить поле пустым для данного посещения; функция не будет использовать обнаруженную метку.

Параметры:

• $label (нить) – Например, обнаруженная метка источника. Google Ads.
• $key (нить) – Какое именно касание помечено: source или last_source.
• $form (множество) – Текущий объект формы.

// Roll the detected source up into a few buckets for the CRM.
add_filter( 'pb_gforms_referral_tracking_source_label', function( $label, $key, $form ) {
    if ( 0 === strpos( $label, 'Google' ) || 0 === strpos( $label, 'Bing' ) ) {
        return 'Search';
    }
    if ( 0 === strpos( $label, 'Facebook' ) || 0 === strpos( $label, 'Instagram' ) ) {
        return 'Social';
    }

    // Anything else: leave the Custom Source field empty.
    return '';
}, 10, 3 );

pb_gforms_referral_tracking_enqueue_assets

Управляет процессом добавления в очередь ресурсов внешнего интерфейса плагина (библиотеки файлов cookie и скрипта отслеживания). Возвращает false, чтобы полностью отключить загрузку на странице или при выполнении условия.

Параметры:

• $enqueue (логическое значение) – Следует ли добавлять активы в очередь. По умолчанию — true.

// Disable tracking assets on the homepage only.
add_filter( 'pb_gforms_referral_tracking_enqueue_assets', function( $enqueue ) {
    if ( is_front_page() ) {
        return false;
    }
    return $enqueue;
} );

pb_gforms_referral_tracking_inline_css

Переопределите встроенный CSS-код, скрывающий поля отслеживания на внешнем интерфейсе и в предварительном просмотре блочного редактора. CSS-код по умолчанию скрывает поля отслеживания, устаревший трекер Google Ads и зеркальные обертки полей, ориентированные на .gform_wrapper .gfield с префиксами классов pb-ref-tracking-, pb-gads-tracking- и pb-ref-mirror-.

Параметры:

• $css (нить) – Встроенная строка CSS.

// Replace the default hide rule with a more specific selector.
add_filter( 'pb_gforms_referral_tracking_inline_css', function( $css ) {
    return '.my-theme .gform_wrapper .gfield[class*="pb-ref-tracking-"] { display: none !important; }';
} );

pb_gforms_rt_invalidate_debounce

Отрегулируйте (или отключите) окно задержки аннулирования кэша отчетов. После поступления новой записи кэш отчетов перестраивается не чаще одного раза в указанное количество секунд, чтобы формы с большим объемом данных не перегружали его. Значение по умолчанию — 60 секунд; верните 0, чтобы аннулировать кэш немедленно для каждой записи.

Параметры:

• $seconds (инт) – Окно задержки в секундах. По умолчанию 60.

// Rebuild Reports data immediately on every new entry (no debounce).
add_filter( 'pb_gforms_rt_invalidate_debounce', function( $seconds ) {
    return 0;
} );

pb_gforms_referral_tracking_mirror_field_definitions

Настройте постоянные определения зеркальных полей, создаваемые при добавлении зеркальных полей в форму. label Это та часть, которую можно безопасно заменить.

Оставлять cssClass в одиночку. При отправке плагин считывает из неё канонический ключ отслеживания, всё, что идёт после него. pb-ref-mirror-, Чтобы найти значение для копирования, переименуйте класс, и поле зеркального отображения будет каждый раз отправляться пустым.

Параметры:

• $fields (множество) – Массив массивов определений зеркальных полей.
• $form (множество) – Текущая форма meta.

// Prefix every mirror field label so they're easy to spot in the editor.
add_filter( 'pb_gforms_referral_tracking_mirror_field_definitions', function( $fields, $form ) {
    foreach ( $fields as &$field ) {
        $field['label'] = 'Tracking: ' . $field['label'];
    }
    return $fields;
}, 10, 2 );

pb_gforms_referral_tracking_docs_url

Измените адрес ссылки “Подробнее в документации”, отображаемой на экране настроек. Это полезно для установок под собственным брендом или в агентствах, которые используют собственную документацию.

Параметры:

• $url (нить) – URL-адрес документации. Верните свой собственный, чтобы заменить его.

// Point the settings-screen docs link at our own handbook.
add_filter( 'pb_gforms_referral_tracking_docs_url', function( $url ) {
    return 'https://example.com/handbook/referral-tracking/';
} );