Документация
Как включить плагин?
После приобретения плагина Referral Source Tracking for WPForms вам потребуется установить его на свой сайт WordPress. Давайте рассмотрим этот процесс.
Шаг 1: Установка
Войдите на свой сайт WordPress и перейдите в раздел «Плагины» > «Добавить плагин» > «Загрузить плагин» > «Установить ZIP-файл и активировать его».
Шаг 2: Зарегистрируйте плагин
В левой панели навигации перейдите в раздел WPForms > Referral Tracking.
Введите свой лицензионный ключ и активируйте его.
Шаг 3: Включить функцию
После активации лицензии на странице настроек отслеживания реферальных ссылок появится вкладка “Общие”. Щелкните по ней и нажмите “Сохранить изменения”.
Вот и всё! Теперь отслеживание источников переходов будет активировано для всех существующих форм, а также для новых форм, которые вы создадите.
Подробная информация о функциях
Обнаруженные источники
Мы получаем URL-адрес источника перехода, если он доступен. и хранить его на входе. Мы также используем понятные метки для распространенных платформ, чтобы источник был легко понятен с первого взгляда.
Вот список источников, которые помечаются при обнаружении:
- Google: Google Ads, Google Organic, Gemini
- Microsoft/Bing: Реклама Microsoft, органический поиск Bing
- Facebook: Реклама в Facebook, органический трафик в Facebook
- LinkedIn: Реклама в LinkedIn, органический трафик в LinkedIn
- X (Твиттер): X Реклама, X Органический
- Reddit: Реклама на Reddit, органический трафик на Reddit
- ТикТок: Реклама в TikTok, органический трафик в TikTok
- Пинтерест: Реклама в Pinterest, органический трафик в Pinterest
- Snapchat: Реклама в Snapchat, органический трафик в Snapchat
- Другие поисковые системы: Yahoo, DuckDuckGo, Yandex
- Искусственный интеллект-помощники (при наличии): ChatGPT, Perplexity, Microsoft Copilot, Claude, Grok, DeepSeek
- Платформы для рассылки электронных писем (отслеживание кампаний): Mailchimp, Constant Contact, Salesforce Pardot, HubSpot
- Прямой и Неизвестный используются по мере необходимости.
- Обычай Источники тоже можно добавить!
Параметры UTM, которые она собирает
utm_sourceutm_mediumutm_campaignutm_termutm_contentutm_id
Идентификаторы кликов зафиксированы.
gclidgbraidwbraidmsclkidli_fat_idrdt_cidttclidpin_cidsnap_cidmc_cidmc_eiddclid
Умные метки
{pb_ref_source} – метка обнаруженного источника перехода (по умолчанию “Неизвестно”, если визит не удалось классифицировать).
{pb_ref_params} – Полная строка захваченных параметров реферальной ссылки (UTM-коды и другие переменные запроса хранятся вместе).
{pb_ref_referrer} – браузер, с которого посетитель перешел на сайт.
{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 и т. д.).
Переводы
Этот плагин полностью готов к переводу. Вы можете перевести его на любой язык, используя бесплатный плагин. Loco Translate плагин или любой другой инструмент перевода WordPress.
Язык по умолчанию: английский (en_US)
Часто задаваемые вопросы
Работает ли это с WPForms Lite?
Да. Отслеживание реферальных ссылок и обработка смарт-тегов работают с WPForms Lite. Однако, по сравнению с версией Pro, WPForms Lite имеет ограниченный пользовательский интерфейс для управления записями — столбцы списка записей, боковая панель отслеживания рефералов для отдельных записей и интеграция экспорта в CSV-файлы требуют наличия WPForms Pro.
Могу ли я экспортировать данные?
Да. Значения отслеживания включаются в CSV-экспорт WPForms. Все поля, относящиеся к реферальной ссылке (источник, реферер, UTM-метки, идентификатор клика и другие), автоматически добавляются в качестве столбцов для экспорта.
Что именно фиксирует этот плагин?
Мы собираем общие поля атрибуции и храним их вместе с каждой записью WPForms, включая Параметры UTM (источник, средство массовой информации, кампания, термин, содержание), Идентификаторы кликов (gclid, msclkid, gbraid/wbraid и т. д.), исходный URL-адрес источника перехода, а также соответствующий контекст целевой страницы, чтобы вы могли четко видеть, откуда пришел каждый потенциальный клиент.
Могу ли я добавлять собственные источники?
Да! Будь то партнерская программа, партнерство с другими компаниями и т.д., вы можете добавлять собственные источники с четкими метками.
Где сохраняются данные о рефералах?
В вашей базе данных WordPress в специальной таблице плагинов, связанной с записями WPForms. Мы не отправляем данные о конверсиях или событиях на рекламные платформы.
Это атрибуция по первому или последнему касанию?
Этот плагин ориентирован на атрибуция первого касания путем хранения оригинал Параметры источника перехода и кампании, которые привели посетителя на ваш сайт (в течение периода удержания).
Как долго система запоминает данные об источнике посещения?
Срок хранения составляет 7 дней. Если посетитель отправляет форму в течение 7 дней с момента своего первого зарегистрированного посещения, к записи будут применены исходные значения атрибуции.
Работает ли это с кэшированием/CDN?
Обычно да. Отслеживание выполняется на стороне клиента, поэтому большинство настроек кэширования/CDN работают нормально. Если вы используете агрессивную оптимизацию скриптов (минификация/отсрочка), исключите указанные ниже скрипты плагина и протестируйте отправку:
/wp-content/plugins/pb-wpforms-referral-tracking/assets/dist/js.cookie.min.js/wp-content/plugins/pb-wpforms-referral-tracking/assets/js/front-end.js
Работает ли это с WPForms с поддержкой AJAX?
Да. Работает с AJAX-формами (по умолчанию в WPForms) и стандартными формами отправки.
Могу ли я отслеживать более одной формы?
Да. Это работает со всеми вашими формами WPForms — каждая отправленная форма сохраняет свои собственные значения атрибуции для этой записи.
Заменяет ли это отслеживание конверсий GA4 / Google Ads?
Нет. Этот плагин не запускает пиксели и не отправляет события конверсии в GA4 или рекламные платформы. Он хранит данные атрибуции. внутри записи WPForms, Таким образом, ваша команда сможет видеть данные об источниках лидов непосредственно в WordPress и экспортировать их.
Собирает ли она персональные данные?
По умолчанию он собирает данные об атрибуции (UTM, gclid, (URL-адреса источников перехода). Это так. нет По умолчанию осуществляется сбор дополнительных персональных данных. Поля вашей формы и любые параметры, включенные в URL-адреса, контролируются настройками вашего сайта и маркетинговой стратегии.
Соответствует ли оно требованиям GDPR/CCPA?
Его можно использовать в соответствии с требованиями GDPR/CCPA. Плагин хранит данные об атрибуции вместе с вашими записями и не передает события на рекламные платформы. Вы несете ответственность за согласие/законный интерес и надлежащее раскрытие информации в соответствии с вашей конкретной конфигурацией.
Работает ли это с многосайтовой сетью WordPress?
Вкратце:
- Безлимитная лицензия: Включите сетевой режим один раз; управление осуществляется одной кнопкой. каждый Настройки и поддержка дочернего сайта.
- Активировано сетью: На всех дочерних сайтах ведется отслеживание переходов, и обновления поступают незамедлительно.
- Ограниченный тарифный план / без лицензии на подсайт: Отслеживание остается включенным, но настройки подсайта доступны только для чтения.
- Поддержка предоставляется в соответствии с лицензией: К участию допускаются сайты, охваченные активным ключом.
Да; плагин запускается автоматически на каждом подсайте сразу после его сетевой активации.— Ручная настройка не требуется. Каждый подсайт может использовать отслеживание и получать обновления даже без локальной лицензии. Чтобы изменить настройки на уровне формы или получить прямую поддержку на подсайте, вам все равно необходимо активировать там лицензию.
Если у вас лицензия Unlimited, вы можете включить сетевой режим на главном сайте и отправить этот единый ключ на все дочерние сайты одним пакетом (с отображением хода выполнения в реальном времени). Эти дочерние сайты автоматически наследуют настройки, управляемые лицензией, и поддержку.
Крючки
Действия
pb_wpforms_referral_tracking_loaded
Запуск происходит после полной инициализации плагина — загрузки всех классов, регистрации хуков и готовности API. Это надежная точка загрузки для дополнений или сопутствующих плагинов, расширяющих возможности отслеживания источников переходов.
Параметры:
$plugin(Плагин) — Экземпляр плагина.
add_action( 'pb_wpforms_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_wpforms_referral_tracking_enabled
Укажите, включено ли отслеживание переходов для конкретной формы. Верните true, чтобы принудительно включить отслеживание, false, чтобы принудительно отключить его, независимо от переключателя для каждой формы или глобального значения по умолчанию.
Параметры:
$enabled(логическое значение) — Включено ли в данный момент отслеживание.$form_id(инт) — Идентификатор текущей формы.$form_data(массив|null) — Массив данных формы или значение null, если оно недоступно.
Пример использования:
// Disable tracking on a specific form (e.g. an internal staff-only form).
add_filter( 'pb_wpforms_referral_tracking_enabled', function( $enabled, $form_id, $form_data ) {
$excluded_form_ids = [ 12, 27 ];
if ( in_array( $form_id, $excluded_form_ids, true ) ) {
return false;
}
return $enabled;
}, 10, 3 );pb_wpforms_referral_tracking_merge_tag_map
Измените карту смарт-тегов, определяющую, какие смарт-теги доступны и к каким ключам отслеживания они относятся. Используйте это для добавления полностью пользовательских смарт-тегов или переименования существующих.
Параметры:
$map(множество) — Ассоциативный массив тегов => ключ отслеживания (например).'pb_ref_source' => 'source').
Пример использования:
// Add a custom Smart Tag that maps to a custom tracking key.
add_filter( 'pb_wpforms_referral_tracking_merge_tag_map', function( $map ) {
$map['pb_ref_landing_page'] = 'landing_page';
return $map;
} );pb_wpforms_referral_tracking_value
Фильтрация исходного значения отслеживания перед его использованием для замены смарт-тега в уведомлении или подтверждении. Полезно для очистки или преобразования определенных значений.
Параметры:
$value(нить) — Исходное значение отслеживания.$tag(нить) — Ключ Smart Tag (например).pb_ref_source).$form_data(множество) — Массив данных формы.$fields(множество) — Поля ввода.$entry_id(инт) — Идентификатор записи.
Пример использования:
// Truncate long referrer URLs in Smart Tag output.
add_filter( 'pb_wpforms_referral_tracking_value', function( $value, $tag, $form_data, $fields, $entry_id ) {
if ( $tag === 'pb_ref_referrer' && strlen( $value ) > 100 ) {
return substr( $value, 0, 100 ) . '…';
}
return $value;
}, 10, 5 );pb_wpforms_referral_tracking_formatted_value
Отфильтруйте полностью отформатированное значение смарт-тега после обработки.
Параметры:
$formatted(нить) — Отформатированная выходная строка.$tag(нить) — Ключ Smart Tag.$form_data(множество) — Массив данных формы.$fields(множество) — Поля ввода.$entry_id(инт) — Идентификатор записи.
// Wrap the source value in a bold tag in HTML notifications.
add_filter( 'pb_wpforms_referral_tracking_formatted_value', function( $formatted, $tag, $form_data, $fields, $entry_id ) {
if ( $tag === 'pb_ref_source' ) {
return '<strong>' . esc_html( $formatted ) . '</strong>';
}
return $formatted;
}, 10, 5 );pb_wpforms_referral_tracking_default_value
Переопределите резервное значение, используемое, если поле отслеживания пустое во время отправки. Значение по умолчанию — “Неизвестно”.
Параметры:
$default(нить) — Текущее значение по умолчанию (“Неизвестно”).$key(нить) — Условные обозначения контекста:source,referrer, илиfront_end.
// Use "Direct" instead of "Unknown" for the source field fallback.
add_filter( 'pb_wpforms_referral_tracking_default_value', function( $default, $key ) {
if ( $key === 'source' ) {
return 'Direct';
}
return $default;
}, 10, 2 );pb_wpforms_referral_tracking_js_config
Перед передачей объекта конфигурации JavaScript для фронтенда переопределите его полностью. Это даст вам полный контроль над настройками cookie, шаблонами обнаружения источников, известными источниками, платными каналами и многим другим.
Параметры:
$config(множество) — Полный массив конфигурации JavaScript.
// Extend cookie lifetime to 30 days and add a custom paid medium.
add_filter( 'pb_wpforms_referral_tracking_js_config', function( $config ) {
$config['cookieExpiry'] = 30;
// Add "social" as a paid medium indicator.
$config['paidMediums'][] = 'social';
// Add a custom source pattern for an internal platform.
$config['sourcePatterns']['custom_platforms'][] = [
'pattern' => 'myplatform\.com',
'name' => 'My Platform',
];
return $config;
} );pb_wpforms_referral_tracking_custom_sources
Программно внедряйте пользовательские правила источника, которые будут выполняться параллельно с правилами, настроенными в административном интерфейсе. Правила из этого фильтра объединяются с сохраненными правилами интерфейса и сортируются по приоритету перед передачей на фронтенд.
Параметры:
$sources(множество) — Пустой массив. Возвращает массив массивов правил для добавления.
Каждое правило должно содержать: label, matchField (referrer, utm_source, utm_medium, utm_campaign, utm_term, utm_content), matchType (contains или equals), matchValue, и, при необходимости, priority (по умолчанию 10, сначала запускаются более высокие значения).
// Add partner and affiliate sources without touching the admin UI.
add_filter( 'pb_wpforms_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_wpforms_referral_tracking_enqueue_assets
Управляет процессом добавления в очередь ресурсов внешнего интерфейса плагина (библиотеки файлов cookie и скрипта отслеживания). Возвращает false, чтобы полностью отключить загрузку на странице или при выполнении условия.
Параметры:
$enqueue(логическое значение) — Следует ли ставить активы в очередь. По умолчаниюtrue.
// Disable tracking assets on the homepage only.
add_filter( 'pb_wpforms_referral_tracking_enqueue_assets', function( $enqueue ) {
if ( is_front_page() ) {
return false;
}
return $enqueue;
} );