Seguimiento de referencias para WPForms

¿Cómo habilito el plugin?

Tras adquirir Referral Source Tracking para WPForms, deberás instalar el plugin en tu sitio web de WordPress. A continuación, te explicamos cómo hacerlo.

Paso 1Instalación

Inicia sesión en tu sitio web de WordPress y ve a Plugins > Añadir plugin > Subir plugin > Instala el archivo zip y actívalo.

Paso 2: Registra el plugin

En el menú de navegación de la izquierda, vaya a WPForms > Seguimiento de referencias.

Introduce tu clave de licencia y actívala.

Paso 3: Habilitar la función

Tras activar su licencia, aparecerá una pestaña "General" en la página de configuración de Seguimiento de referencias; haga clic en ella y luego en "Guardar cambios".

¡Eso es todo! Ahora el seguimiento de la fuente de referencia estará activo en todos los formularios existentes o en los nuevos que crees.

Detalles de la característica

Fuentes que detecta

Capturamos la URL de referencia cuando está disponible. y lo almacenamos en la entrada. También aplicamos etiquetas descriptivas para las plataformas más comunes, de modo que la fuente sea fácil de entender de un vistazo.

Aquí está la lista de fuentes que se etiquetan cuando se detectan:

• Google: Google Ads, Google Orgánico, Gemini
• Microsoft/Bing: Anuncios de Microsoft, Bing Orgánico
• Facebook: Anuncios de Facebook, Facebook Orgánico
• LinkedIn: Anuncios de LinkedIn, Publicidad orgánica de LinkedIn
• X (Twitter): X Anuncios, X Orgánico
• Reddit: Anuncios de Reddit, Reddit Orgánico
• TikTok: Anuncios de TikTok, Publicidad orgánica de TikTok
• Pinterest: Anuncios de Pinterest, Pinterest orgánico
• Snapchat: Anuncios de Snapchat, Snapchat Orgánico
• Otros motores de búsqueda: Yahoo, DuckDuckGo, Yandex
• Asistentes de IA (cuando estén disponibles): ChatGPT, Perplejidad, Microsoft Copilot, Claude, Grok, DeepSeek
• Plataformas de correo electrónico (seguimiento de campañas): Mailchimp, Constant Contact, Salesforce Pardot, HubSpot
• Directo y Desconocido se utilizan cuando es apropiado.
• Costumbre ¡También se pueden añadir fuentes!

Parámetros UTM que captura

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

Identificadores de clic capturados

• gclid
• gbraid
• wbraid
• msclkid
• li_fat_id
• rdt_cid
• ttclid
• pin_cid
• snap_cid
• mc_cid
• mc_eid
• dclid

Etiquetas inteligentes

{pb_ref_source} – la etiqueta de la fuente de referencia detectada (por defecto es "Desconocido" cuando la visita no pudo ser clasificada).

{pb_ref_params} – Cadena completa de parámetros de referencia capturados (UTM y otras variables de consulta se mantienen juntas).

{pb_ref_referrer} – Referencia del navegador que trajo al visitante al sitio.

{pb_ref_utm_id} – capturado utm_id.

{pb_ref_utm_source} – capturado utm_source.

{pb_ref_utm_medium} – capturado utm_medium.

{pb_ref_utm_campaign} – capturado utm_campaign.

{pb_ref_utm_term} – capturado utm_term.

{pb_ref_utm_content} – capturado utm_content.

{pb_ref_clid} – el primer ID de clic detectado (gclid, fbclid, msclkid, etc.).

Traducciones

Este plugin está totalmente preparado para la traducción. Puedes traducirlo a cualquier idioma usando el plugin gratuito. Loco Translate plugin o cualquier otra herramienta de traducción de WordPress.

Idioma predeterminado: inglés (en_US)

Preguntas frecuentes

¿Es compatible con WPForms Lite?

Sí. La captura de seguimiento de referencias y el procesamiento de etiquetas inteligentes funcionan con WPForms Lite. Sin embargo, WPForms Lite tiene una interfaz de usuario de gestión de entradas limitada en comparación con la versión Pro: las columnas de la lista de entradas, la barra lateral de seguimiento de referencias de una sola entrada y la integración de exportación CSV requieren WPForms Pro.

¿Puedo exportar los datos?

Sí. Los valores de seguimiento se incluyen en las exportaciones CSV de WPForms. Todos los campos de referencia (origen, referente, UTM, ID de clic, etc.) se añaden automáticamente como columnas de exportación.

¿Qué es exactamente lo que captura el plugin?

Capturamos campos de atribución comunes y los almacenamos junto con cada entrada de WPForms, incluyendo: Parámetros UTM (fuente, medio, campaña, término, contenido), Haga clic en los identificadores (gclid, msclkid, gbraid/wbraid, etc.), el URL de referencia original, y el contexto de la página de destino correspondiente para que pueda ver claramente de dónde proviene cada cliente potencial.

¿Puedo agregar fuentes personalizadas?

¡Sí! Ya sea un sitio de referencia, una asociación de afiliados, etc., puedes agregar fuentes personalizadas con etiquetas claras.

¿Dónde se guardan los datos de referencia?

En tu base de datos de WordPress, en una tabla de plugins específica vinculada a las entradas de WPForms. No enviamos conversiones ni eventos a plataformas publicitarias.

¿Se trata de una atribución de primer contacto o de último contacto?

Este complemento se centra en atribución de primer contacto almacenando el original Parámetros de referencia y de campaña que llevaron al visitante a su sitio (dentro del período de retención).

¿Durante cuánto tiempo recuerda los datos de atribución de un visitante?

La ventana de retención es 7 días. Si un visitante envía un formulario dentro de los 7 días posteriores a su primera visita registrada, se aplicarán los valores de atribución originales a la entrada.

¿Funciona con almacenamiento en caché/CDN?

Por lo general, sí. El seguimiento se ejecuta del lado del cliente, por lo que la mayoría de las configuraciones de caché/CDN funcionan correctamente. Si utiliza una optimización agresiva de scripts (minificación/aplazamiento), excluya los scripts del complemento que se indican a continuación y realice una prueba de envío:

• /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

¿Funciona con WPForms habilitado para AJAX?

Sí. Funciona con formularios AJAX (WPForms por defecto) y envíos estándar.

¿Puedo realizar el seguimiento de más de un formulario?

Sí. Funciona en todos tus formularios de WPForms: cada envío guarda sus propios valores de atribución para esa entrada.

¿Esto reemplaza el seguimiento de conversiones de GA4 / Google Ads?

No. Este plugin no activa píxeles ni envía eventos de conversión a GA4 ni a plataformas publicitarias. Almacena datos de atribución. dentro de la entrada de WPForms, para que tu equipo pueda ver los datos de origen de los clientes potenciales directamente en WordPress y en las exportaciones.

¿Recopila datos personales?

Por defecto, captura datos de atribución (UTM, gclid, URL de referencia). Lo hace no Capturamos información personal identificable adicional de forma predeterminada. Los campos de tu formulario y cualquier parámetro incluido en las URL están controlados por la configuración de tu sitio web y de marketing.

¿Cumple con el RGPD/CCPA?

Puede utilizarse de forma compatible con el RGPD y la CCPA. El plugin almacena los datos de atribución junto con tus entradas y no transmite eventos a las plataformas publicitarias. Eres responsable del consentimiento/interés legítimo y de la divulgación adecuada para tu configuración específica.

¿Es compatible con una red WordPress Multisite?

TL;DR

• Licencia ilimitada: Habilite el modo de red una vez; una sola tecla puede gestionarlo. cada Configuración y soporte del subsitio.
• Activado por la red: Todos los subdominios realizan un seguimiento de las referencias y reciben actualizaciones de inmediato.
• Plan limitado / sin licencia para subdominios: El seguimiento permanece activado, pero la configuración de los subsitios es de solo lectura.
• El soporte se rige por la licencia: Los sitios cubiertos por la clave activa son elegibles.

Sí; el plugin se ejecuta automáticamente en cada subsitio tan pronto como lo actives en la red.—No se requiere configuración manual. Cada subdominio puede usar el seguimiento y recibir actualizaciones incluso sin una licencia local. Para cambiar la configuración de formularios u obtener asistencia directa en un subdominio, aún necesita activar una licencia allí.

Si dispone de una licencia ilimitada, puede habilitar el modo de red desde el sitio principal y distribuir esa clave única a todos los subsitios en un solo lote (con seguimiento en tiempo real). Estos subsitios heredarán automáticamente la configuración y el soporte gestionados por la licencia.

Manos

Comportamiento

pb_wpforms_referral_tracking_loaded

Se activa una vez que el complemento se ha inicializado por completo: todas las clases están cargadas, los ganchos están registrados y la API está lista. Este es el punto de arranque fiable para los complementos o plugins asociados que extienden el seguimiento de la fuente de referencia.

Parámetros:

• $plugin (Complemento) — La instancia del complemento.

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 );
    }
} );

Filtros

pb_wpforms_referral_tracking_enabled

Anula la opción de habilitar o deshabilitar el seguimiento de referencias para un formulario específico. Devuelve verdadero para activar el seguimiento, falso para desactivarlo, independientemente de la configuración predeterminada por formulario o global.

Parámetros:

• $enabled (booleano) — Si el seguimiento está habilitado actualmente.
• $form_id (int) — El ID del formulario actual.
• $form_data (matriz|nulo) — El array de datos del formulario, o null si no está disponible.

Ejemplo de uso:

// 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

Modifique el mapa de etiquetas inteligentes que define qué etiquetas inteligentes están disponibles y a qué claves de seguimiento corresponden. Úselo para agregar etiquetas inteligentes totalmente personalizadas o para renombrar las existentes.

Parámetros:

• $map (formación) — Matriz asociativa de etiqueta => clave de seguimiento (por ejemplo. 'pb_ref_source' => 'source').

Ejemplo de uso:

// 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

Filtra un valor de seguimiento sin procesar antes de usarlo para reemplazar una etiqueta inteligente en una notificación o confirmación. Útil para sanitizar o transformar valores específicos.

Parámetros:

• $value (cadena) — El valor de seguimiento sin procesar.
• $tag (cadena) — La clave de la etiqueta inteligente (por ejemplo,. pb_ref_source).
• $form_data (formación) — El array de datos del formulario.
• $fields (formación) — Los campos de entrada.
• $entry_id (int) — El ID de entrada.

Ejemplo de uso:

// 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

Filtre el valor de la etiqueta inteligente con formato completo después del procesamiento.

Parámetros:

• $formatted (cadena) — La cadena de salida formateada.
• $tag (cadena) — La llave de la etiqueta inteligente.
• $form_data (formación) — El array de datos del formulario.
• $fields (formación) — Los campos de entrada.
• $entry_id (int) — El ID de entrada.

// 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

Anula el valor de reserva que se utiliza cuando un campo de seguimiento está vacío en el momento del envío. El valor predeterminado es "Desconocido".

Parámetros:

• $default (cadena) — El valor predeterminado actual (“Desconocido”).
• $key (cadena) — Clave de contexto: source, referrer, o 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

Sobrescribe todo el objeto de configuración JavaScript del front-end antes de que se pase al script de seguimiento. Esto te da control total sobre la configuración de cookies, los patrones de detección de fuentes, las fuentes conocidas, los medios de pago y mucho más.

Parámetros:

• $config (formación) — El array de configuración JS completo.

// 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

Inyecte mediante programación reglas de origen personalizadas que se ejecutan junto con las reglas configuradas en la interfaz de administración. Las reglas de este filtro se combinan con las reglas guardadas de la interfaz de usuario y se ordenan por prioridad antes de enviarse al front-end.

Parámetros:

• $sources (formación) — Matriz vacía. Devuelve una matriz de matrices de reglas para agregar.

Cada regla debe tener: label, matchField (referrer, utm_source, utm_medium, utm_campaign, utm_term, utm_content), matchType (contains o equals), matchValue, y opcionalmente priority (valor predeterminado 10, los valores más altos se ejecutan primero).

// 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

Controla si los recursos de interfaz del plugin (biblioteca de cookies y script de seguimiento) se ponen en cola. Devuelve falso para deshabilitar por completo la carga en una página o condición.

Parámetros:

• $enqueue (booleano) — Si se deben poner en cola los activos. Predeterminado 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;
} );