Seguimiento de referencias para Gravity Forms

¿Cómo habilito el complemento?

Tras adquirir Referral Source Tracking para Gravity Forms, instálelo en su sitio web de WordPress.

Paso 1: Instalació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: Registrar el complemento

En el menú de navegación de la izquierda, vaya a Formularios → Configuración → Seguimiento de referencias.

Introduce tu clave de licencia y actívala.

Paso 3: Habilitar la función

Después de activar su licencia, aparece una pestaña General. Haga clic en ella y marque la casilla. Habilitar por defecto (“Habilitar el seguimiento de la fuente de referencia en todos los formularios de forma predeterminada”), luego haga clic en Guardar cambios.

Si dejas esa casilla sin marcar, el seguimiento se desviará en todas partes. En su lugar, puedes activarla formulario por formulario en Configuración del formulario → Opciones del formulario.

¡Eso es todo! Con la opción "Habilitar por defecto" activada, el seguimiento de la fuente de referencia estará activo en todos los formularios existentes y en los nuevos que crees.

Detalles de la característica

Fuentes que detecta

Capturamos la URL de referencia cuando está disponible y la almacenamos en la entrada. Para las plataformas más comunes, también añadimos una etiqueta descriptiva para que la fuente sea fácil de leer.

Una fuente se etiqueta como Anuncios solo cuando la visita incluye el ID de clic de anuncio de la plataforma (gclid, msclkid, li_fat_id, ttclid, oppref, etc.). Una plataforma conocida que llega sin este identificador se etiqueta como Orgánica. Facebook e Instagram son la excepción: Meta agrega fbclid a cada clic, por lo que se clasifican como Anuncios cuando fbclid llega con cualquier parámetro UTM.

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

• Google: Google Ads, Google Orgánico. Tráfico etiquetado de Gemini utm_source=gemini Está etiquetado como Google Organic; no hay una etiqueta Gemini separada.
• Microsoft/Bing: Anuncios de Bing, Bing Orgánico
• Facebook: Anuncios de Facebook, Facebook Orgánico
• Instagram: Anuncios de Instagram, Publicidad orgánica de Instagram
• LinkedIn: Anuncios de LinkedIn, Publicidad orgánica de LinkedIn
• X (Twitter): 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
• YouTube: YouTube Orgánico. Un clic en un anuncio de YouTube que lleva gclid se registra como Google Ads a menos que la URL también esté etiquetada utm_source=youtube, que graba anuncios de YouTube.
• Otros motores de búsqueda: Yahoo, DuckDuckGo, Yandex
• Asistentes de IA/LLM: Anuncios de ChatGPT, ChatGPT Orgánico, Perplexity, Copilot, Claude, Grok, DeepSeek
• Plataformas de correo electrónico (seguimiento de campañas): Mailchimp, Constant Contact, Pardot (etiquetados Salesforce), HubSpot
• Directo y Desconocido se utilizan cuando es apropiado.
• Costumbre Las fuentes se pueden definir en Fuentes personalizadas para el tráfico de socios, afiliados y campañas.

Parámetros UTM que captura

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

Identificadores de clics capturados

Capturamos cada ID de clic a continuación en el campo ID de clic, y cada uno atribuye la visita a su plataforma a menos que la fila indique lo contrario.

Fuentes personalizadas

La detección de fuentes integrada ya cubre los principales motores de búsqueda, plataformas sociales, asistentes de IA y herramientas de marketing por correo electrónico. Las fuentes personalizadas le permiten agregar sus propias reglas etiquetadas. Úselas para sitios asociados, referencias de afiliados, campañas con nombre, acortadores de marca, enlaces de empleados y cualquier otra cosa donde la etiqueta predeterminada "Referencia" o una etiqueta sin formato utm_source El valor no es lo suficientemente específico.

Encuéntralos en Formularios → Configuración → Seguimiento de referencias en el Fuentes personalizadas Sección. Cada fila es una regla.

Cómo se evalúa una regla

En cada visita, el plugin comprueba tus fuentes personalizadas. antes detección integrada. La primera regla que coincide gana: el complemento establece la fuente del visitante a la de esa regla. Etiqueta y omite la detección integrada para esa visita. Si no hay coincidencias, la detección integrada se ejecuta como de costumbre (Google, Facebook, Direct, etc.).

Los campos, uno por uno

• Etiqueta – El texto guardado como origen de la visita (por ejemplo. Partner: Acme, Email: Newsletter, Campaign: Spring Sale). Esto es exactamente lo que aparece en la entrada, en el {pb_ref_source} Etiqueta de combinación, en la pestaña Informes y en cualquier asignación de CRM. Elija algo que reconozca en una pantalla de entradas con mucho movimiento.
• Campo de partido – Dónde buscar:
  • Host de referencia – el dominio en el referente del navegador (por ejemplo, coincidencias) acme.com cuando alguien llega de https://www.acme.com/blog/post).
  • Fuente UTM / Medio / Campaña / Término / Contenido – el correspondiente ?utm_*= parámetro en la URL de destino.
• Tipo de coincidencia – Qué buscar:
  • Contiene – el valor del campo incluye su valor de coincidencia en cualquier parte dentro del mismo. No distingue entre mayúsculas y minúsculas. Bueno para detectar variaciones como acme.com, blog.acme.com, partner.acme.com con una regla.
  • Igual – el valor del campo es exactamente su valor de coincidencia (sin distinción de mayúsculas y minúsculas). Más estricto, así que úselo cuando necesite una coincidencia precisa como utm_source exactamente igual newsletter.
• Valor coincidente – El texto que hay que buscar. Sin comillas, sin asteriscos, solo la cadena de texto literal.
• Prioridad – Un número que controla el orden. Primero las carreras más altas, por lo que cuando las reglas se superponen, gana la de mayor prioridad. El valor predeterminado es 10; subir a 20 o 50 Para reglas que deben superar tus valores predeterminados, baja a 5 para comodines.

Ejemplos resueltos

Etiqueta un sitio asociado por su referente.

Cualquier persona que llegue desde cualquier subdominio de acme.com está etiquetado Partner: Acme en lugar del genérico Referral.

Etiquetar una campaña de boletín informativo etiquetada

Utilice esto cuando controle la URL en su extremo (por ejemplo, enlaces dentro de su envío de correo electrónico semanal). ?utm_source=newsletter).

Etiqueta una campaña de pago por su nombre de campaña UTM.

Capturas ?utm_campaign=spring-sale-2026, ?utm_campaign=spring-sale-google-ads, y variantes similares en una misma regla.

Anular la detección integrada de Google para un afiliado específico.

Una alta prioridad garantiza que esta regla prevalezca sobre la incorporada. utm_source=google → Google Ads etiquetar cada vez que llegue la fuente etiquetada.

“Agregar etiquetas orgánicas/de anuncios” con fuentes personalizadas

Las fuentes integradas siempre se muestran como Google Ads, Facebook Organic, etc. El Agregar etiquetas orgánicas/de anuncios (fuentes personalizadas) La casilla de verificación (que también se encuentra en Formularios → Configuración → Seguimiento de referencias) controla si sus etiquetas personalizadas obtienen ese mismo sufijo.

• Comprobado (predeterminado) – una regla personalizada etiquetada Partner: Acme se convierte Partner: Acme Organic sobre el tráfico de referencia y Partner: Acme Ads si la visita tiene un ID de clic pagado como gclid.
• Desenfrenado – Tus etiquetas personalizadas se muestran exactamente como las escribiste, y el complemento no agrega ningún sufijo.

Elige la opción que mejor se adapte a tus informes. La mayoría de los equipos prefieren el sufijo para poder comparar el tráfico de socios pagado y orgánico, pero si utilizas la etiqueta para transmitir la identidad completa, desactívala.

Agregar reglas mediante programación

Si estás creando un complemento o quieres reglas bajo control de versiones, pb_gforms_referral_tracking_custom_sources El filtro acepta la misma estructura que la interfaz de administración y se fusiona con ella. El complemento ordena las reglas de ambos lugares por prioridad antes de que la interfaz de usuario las evalúe.

campos espejo

Nuestros campos de seguimiento se añaden a tu formulario de forma dinámica al renderizarlo. No forman parte de la lista de campos guardados del formulario. Esto mantiene tus formularios limpios, pero algunos complementos de CRM, marketing por correo electrónico y webhooks crean sus menús desplegables de asignación de campos solo a partir de campos guardados, por lo que no pueden "ver" nuestros campos dinámicos.

Los campos espejo solucionan eso. En Formularios → [tu formulario] → Configuración → Opciones del formulario, haz clic Agregar campos espejo El complemento añade un conjunto paralelo de campos ocultos visibles para el editor a tu formulario. Los campos de seguimiento originales siguen siendo la fuente de información principal; el complemento copia sus valores capturados en los campos espejo cuando se crea la entrada, para que tu complemento pueda asignarlos desde su menú desplegable de campos habitual. El bloque de campos espejo solo aparece cuando se activa la opción de seguimiento de referencias de ese formulario.

Si su complemento admite una opción de asignación de "Valor personalizado", no necesita campos espejo en absoluto. Simplemente asigne nuestras etiquetas de combinación directamente (por ejemplo {pb_ref_source}, {pb_ref_utm_source}, {pb_ref_clid}).

Gestión de campos espejo:

• Agregar campos espejo – crea el conjunto visible para el editor.
• Agregar N campos de espejo faltantes Aparece cuando un formulario contiene algunos, pero no todos, los campos espejo actuales, e indica la cantidad. Esto sucede si alguien elimina campos manualmente, y también después de habilitar la atribución de último toque, que agrega un nuevo conjunto de definiciones. El complemento deja intactos los ID de campo restantes, por lo que las asignaciones guardadas siguen funcionando.
• Eliminar 2 campos espejo duplicados – aparece solo cuando existen duplicados e indica la cantidad. Conserva la primera aparición de cada uno.
• Eliminar campos espejo – Elimina el conjunto (con confirmación). Los valores ya guardados en entradas anteriores permanecen en la base de datos, pero los complementos ya no podrán verlos mediante búsquedas por ID de campo.

Cuando la atribución de último contacto está habilitada, los campos espejo también pueden incluir el conjunto de último contacto. Los formularios que ya tenían el conjunto de primer contacto no los tomarán por sí solos: utilice Agregar N campos de espejo faltantes en cada uno para rellenarlo.

Informes

Encontrar informes en Formularios → Configuración → Seguimiento de referencias → Informes. La pestaña muestra cada entrada rastreada que llegó durante el rango de fechas que seleccione, desglosada por origen, dimensión UTM y referente. Las entradas enviadas antes de que el complemento estuviera activo, las entradas en formularios con el seguimiento desactivado y las entradas eliminadas o de spam no se cuentan, por lo que estos totales pueden ser inferiores al recuento de entradas de Gravity Forms. Los rangos cubren días completos y terminan en la última entrada completa. UTC medianoche, por lo que las comparaciones de períodos se mantienen en igualdad de condiciones. Dependiendo de la diferencia horaria entre la zona horaria de tu sitio y la UTC, ese límite puede caer a mitad del día local.

Gráficos de un vistazo

• Desglose de la fuente – Gráfico circular que muestra la proporción de envíos por fuente etiquetada (Google Orgánico, Anuncios de Facebook, Fuentes Personalizadas, Directo, etc.).
• Entradas a lo largo del tiempo – Gráfico lineal del total de entradas por categoría. Al pasar el cursor sobre un punto, la información emergente desglosa ese total por fuente. En ventanas más largas (90 y 365 días), la información se agrupa por mes para que el eje sea legible; en la ventana de 30 días, el gráfico muestra una etiqueta de fecha cada 7ª para evitar la saturación.
• Fuente/Medio/Campaña UTM principal – Gráficos de barras horizontales de los valores con mayor número de entradas en cada dimensión UTM.
• Principales referentes – Gráfico de barras horizontales de los dominios de referencia que generan la mayor cantidad de envíos. El plugin almacena el tráfico directo con el referente. Direct, por lo que aparece aquí como una barra independiente en lugar de un dominio.

Filtros

• Forma – Limite el alcance a un solo formulario, o déjelo en "Todos los formularios" para una vista general del sitio.
• Rango de fechas – Ventanas predefinidas (últimos 7, 30, 90 y 365 días).
• Comparar con el período anterior – Muestra el total del período con su variación porcentual en comparación con el período anterior equivalente (últimos 7 frente a los 7 anteriores, últimos 30 frente a los 30 anteriores, etc.), y superpone dicho período anterior como una línea discontinua en el gráfico de tiempo. Los gráficos de barras UTM y de referencia no se comparan.
• Ocultar sin atribución – oculta las categorías No establecido y Desconocido para que pueda centrarse en las fuentes atribuidas. Directo permanece.

El plugin recuerda las opciones de rango de fechas, período de comparación y ocultar contenido no atribuido que hayas seleccionado para cada usuario, por lo que no tendrás que configurarlas de nuevo en tu próxima visita.

Rendimiento y almacenamiento en caché

El plugin calcula informes a partir de las entradas de Gravity Forms y almacena en caché el resultado, por lo que las cargas repetidas son rápidas. Las nuevas entradas invalidan esa caché automáticamente, con un retardo de 60 segundos de bloqueo para que los formularios de alto volumen no la sobrecarguen. Los desarrolladores pueden ajustar la ventana de retardo (o deshabilitarla por completo) con el pb_gforms_rt_invalidate_debounce Filtro. Ver Ganchos a continuación.

Resumen por correo electrónico

Si prefiere recibir los resúmenes de atribución en lugar de abrir el panel de control, habilite el resumen por correo electrónico en Formularios → Configuración → Seguimiento de referencias → Informes por correo electrónico. El día y la hora que elija se evalúan en la zona horaria de su sitio, pero el período informado en sí se mide en su totalidad. UTC días, que finalizan a la última medianoche UTC completa antes del envío del correo electrónico. En sitios alejados de UTC, el rango cubierto está desfasado con respecto a sus días locales.

Cadencia y sincronización

• Semanalmente – Seleccione el día de la semana (de domingo a sábado) y la hora en que se envía el correo electrónico.
• Mensual – Seleccione el día del mes (con un límite máximo del día 28 para que el correo electrónico siempre llegue, incluso en febrero) y la hora.
• El calendario de envíos sigue su zona horaria del sitio (WordPress → Ajustes → General), y la página de ajustes muestra la actual justo al lado del selector de hora. El período de informes todavía se mide en días UTC.

Destinatarios

Una dirección de correo electrónico por línea. Deje el campo en blanco y el resumen volverá a la Correo electrónico del administrador del sitio al momento del envío. Esto resulta útil si el correo electrónico del administrador cambia posteriormente y se desea que el resumen se actualice automáticamente.

El Envíame un correo electrónico de prueba ahora. El botón entrega el mismo cuerpo digestivo usando su guardado configuración. Dos cosas difieren de un envío programado: el asunto tiene un prefijo [TEST], y lo ignora Omitir resúmenes vacíos, Por lo tanto, una prueba realizada durante un período de inactividad aún llega donde el resumen real habría permanecido en silencio. El botón se desactiva automáticamente mientras haya cambios sin guardar; guarde primero, luego pruebe.

Opciones de contenido

• Omitir resúmenes vacíos – No envíes el correo electrónico si el total del resumen para el período es cero. En un formato escaso, eso te ahorra un resumen vacío en semanas tranquilas. Con Ocultar sin atribución Además, ese total ignora las entradas No establecidas y Desconocidas, por lo que un período que contiene solo entradas sin atribución se cuenta como vacío y se omite.
• Comparar con el período anterior – Mostrar el porcentaje de cambio con respecto al período equivalente anterior en la parte superior del correo electrónico (semana pasada con respecto a la semana anterior, mes pasado con respecto al mes anterior, etc.).
• Ocultar sin atribución – omitir los valores "No establecido" y "Desconocido" de las tablas de correo electrónico para que la atención se centre en las fuentes atribuidas.

Etiquetas de combinación

{pb_ref_source} – valor almacenado en el campo oculto “Origen” (por defecto “Desconocido” cuando no se pudo clasificar la visita).

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

{pb_ref_referrer} – la URL de referencia de la visita. Este es el referente efectivo, no el valor bruto del navegador. Cuando se detecta un ID de clic o un identificador reconocido utm_source identifica la plataforma, el complemento almacena la URL canónica de la plataforma en su lugar. Como resultado, un gclid registros de visitas https://www.google.com/ incluso cuando el clic provino de un correo electrónico. Registro de visitas del mismo dominio y sin referente Direct. Ninguna etiqueta de combinación expone el referente del navegador sin modificar.

{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} – Primer ID de clic detectado para la visita (gclid, fbclid, msclkid y otros ID de clic de la plataforma).

{pb_ref_custom_source} – tu propia etiqueta para la visita, escrita por el pb_gforms_referral_tracking_source_label filtro (ver Hooks). La etiqueta solo existe cuando ese filtro tiene una función de devolución de llamada asociada. El complemento almacena la fuente detectada por separado y nunca la modifica.

Etiquetas de fusión de último toque

Cuando se habilita la atribución de último toque, el complemento agrega un conjunto paralelo:

• {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}

Cada uno reproduce fielmente su equivalente de primer contacto, pero almacena la fuente más reciente antes de su envío. {pb_ref_last_custom_source} también necesita el pb_gforms_referral_tracking_source_label filtro, igual que su contraparte de primer contacto.

Envío de datos a Google Analytics

El seguimiento de la fuente de referencia nunca contacta a Google por su cuenta. Todo lo que captura permanece en tu formulario de Gravity Forms. Si activas la configuración de GA4, tu propia etiqueta de Google enviará el evento.

Desde la versión 1.6.0 puedes optar por un evento de GA4. Activa GA4 / Tag Manager en Formularios → Ajustes → Seguimiento de referencias → General. Al confirmar, el plugin envía un evento personalizado llamado pb_referral_submit (cámbiele el nombre en la misma configuración) con los parámetros de origen, referente, ID de clic y UTM, además de los valores de último contacto cuando este esté activado. Una validación fallida no se envía. Las confirmaciones de redirección y de agradecimiento de la página requieren la versión 1.7.1.

Consulta GA4 Realtime o DebugView para ver el evento. No necesitas un activador de Tag Manager. Tu propia etiqueta de Google se encarga del envío; el plugin nunca se comunica con Google.

Opcional: también puedes pasar etiquetas de combinación en una cadena de consulta de confirmación de redirección (ver más abajo) si ya realizas la conversión desde parámetros de campaña en la URL de agradecimiento. Esto es independiente del evento personalizado.

Lo que conlleva el evento

Las claves de los parámetros coinciden con los nombres de las etiquetas de combinación. Los valores vacíos se omiten por completo de la carga útil, y el evento se activa como máximo una vez por vista de página.

Opcional: pasar valores en la URL de agradecimiento

1. Abra las confirmaciones de su formulario en Formularios → [tu formulario] → Configuración → Confirmaciones, luego edite (o agregue) un Redireccionar confirmación.
2. En el URL de redireccionamiento En este campo, introduzca la URL de su página de agradecimiento seguida de una cadena de consulta creada a partir de las etiquetas de combinación de seguimiento:

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 rellena y codifica en URL cada valor en el momento del envío, de modo que un visitante que llegó desde un clic en Google Ads aterriza en una URL como esta:

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

La configuración de GA4 o Google Tag Manager en la página de agradecimiento lee esos parámetros del mismo modo que gestiona cualquier URL de campaña, activando la conversión o el evento de generación de clientes potenciales con la fuente, la campaña y el ID de clic capturados. Los valores que no se capturaron para una visita determinada aparecen vacíos.

Aquí puede utilizar cualquiera de las etiquetas de combinación de seguimiento. Ver Etiquetas de combinación para ver la lista completa. (Si lo prefiere, el Pasar datos de campo a través de la cadena de consulta La opción en la misma confirmación de redirección acepta estas mismas etiquetas de combinación.

¿Por qué usar etiquetas de combinación en lugar de sus propios campos ocultos?

Si ya estás enviando datos de campaña a tu página de agradecimiento desde tus propios campos ocultos, apunta la cadena de consulta a nuestras etiquetas de combinación. De esta forma, tanto el valor guardado en la entrada como el enviado a GA4 provienen de la misma fuente capturada, por lo que no pueden desincronizarse. La entrada y GA4 siempre muestran la misma campaña. Además, esto significa un conjunto menos de campos que mantener.

Una nota sobre los identificadores de clics

{pb_ref_clid} Contiene el primer ID de clic detectado en la visita, independientemente de la plataforma de origen: gclid para Google, pero también msclkid (Microsoft), fbclid (Meta) y otros. Si lo está asignando específicamente a un gclid= parámetro para Google Ads, una visita que no sea de Google colocaría su ID de clic en ese espacio. Si solo desea que el ID de clic se incluya en las visitas de Google Ads, agregue lógica condicional a la confirmación para que gclid= El parámetro se envía solo cuando el Fuente es Google Ads.

Verificar que funciona

Puedes confirmar toda la cadena en cuatro pasos:

1. Agregue parámetros de prueba a cualquier URL de página de destino (por ejemplo ?gclid=TEST123&utm_source=google&utm_medium=cpc), luego envíe el formulario.
2. En la página de agradecimiento, compruebe la barra de direcciones: sus valores deberían estar presentes en la URL.
3. Abre las herramientas para desarrolladores de tu navegador, ve a la Red pestaña y filtrar por collect. La solicitud a Google debe incluir su gclid y utm valores.
4. Confirme la recepción en GA4 Vista de depuración o Tiempo real informe.

Realice la prueba en una ventana privada o con la sesión cerrada. Mientras esté conectado como administrador, el complemento se ejecuta deliberadamente en modo de solo sesión, escribiendo cookies sin fecha de caducidad, por lo que la ventana de atribución no se puede reproducir desde una sesión de administrador.

Esos cuatro pasos comprueban el método de cadena de consulta opcional. Para el evento personalizado integrado, envíe el formulario y, a continuación, en la página de confirmación o agradecimiento, abra DevTools → Red, filtre por g/collect, y busca en=pb_referral_submit (o el nombre de tu evento). O usa GA4 DebugView. Si el evento aparece en la pestaña Red pero no en GA4, el espacio en blanco corresponde a tu etiqueta de Google. Si no aparece en la pestaña Red, el plugin no se activó.

Enviando el evento a GA4

Desde la versión 1.6.0, puedes enviar el código fuente que ya está en la entrada de Gravity Forms a GA4 como un evento personalizado. Está desactivado por defecto. Tu propia etiqueta de Google se encarga del envío; el plugin nunca contacta directamente con Google. Consulta GA4 Realtime o DebugView para ver el evento. No necesitas un activador de Tag Manager.

Ir a Formularios → Configuración → Seguimiento de referencias → General. Garrapata Enviar los parámetros capturados a GA4 como un evento personalizado al confirmar el formulario.. Deje el nombre del evento como pb_referral_submit A menos que tengas un motivo para cambiarlo, haz clic en Guardar cambios.

Traducciones

Este complemento está listo para la traducción e incluye traducciones integradas para:

1. Árabe (ar)
2. Bengalí (bn_BD)
3. Filipino (fil)
4. Alemán (de_DE)
5. Español (es_ES)
6. Español (es_MX)
7. Francés (fr_FR)
8. Hindi (hi_IN)
9. indonesio (id_ID)
10. Italiano (it_IT)
11. Japonés (ja)
12. Portugués (pt_BR)
13. Ruso (ru_RU)
14. Urdu (ur)
15. Chino simplificado (zh_CN)
16. Tradicional chino (zh_HK)

Idioma predeterminado: inglés (en_US)

Si su idioma no aparece en la lista Traducciones Arriba, aún puedes traducir el plugin tú mismo. Está listo para la traducción. Usa la versión gratuita. Plugin Loco Translate para crear una traducción para el idioma/localización de tu sitio. ¿Eres nuevo en Loco Translate? Aquí tienes un tutorial apto para principiantes.

Preguntas frecuentes

¿Puedo exportar los datos?

Sí. Los valores de seguimiento se guardan en cada entrada de Gravity Forms, por lo que aparecen en las exportaciones de entradas.

¿Qué es exactamente lo que captura el plugin?

Capturamos campos de atribución comunes y los almacenamos en la entrada de Gravity Forms. Eso incluye 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 relacionada, para que pueda ver de dónde proviene cada cliente potencial.

¿Puedo agregar fuentes personalizadas?

Sí. Añadir reglas en Formularios → Configuración → Seguimiento de referencias → Fuentes personalizadas para etiquetar sitios asociados, tráfico de afiliados, campañas de marca y visitas similares por nombre. Cada regla coincide con el host de referencia o un parámetro UTM y aplica una etiqueta que usted elija. Consulte la Fuentes personalizadas Sección para la guía paso a paso y ejemplos resueltos.

Mi complemento de CRM/correo electrónico/webhook no reconoce los campos de seguimiento en su menú desplegable de asignación. ¿Qué debo hacer?

Nuestros campos de seguimiento se agregan a su formulario dinámicamente en el momento de la renderización, no se guardan en la lista de campos del formulario, por lo que los complementos que construyen su menú desplegable solo a partir de campos guardados no pueden verlos. Tiene dos opciones. Si su complemento tiene una asignación de "Valor personalizado", asigne nuestras etiquetas de combinación directamente ({pb_ref_source}, {pb_ref_utm_source}, {pb_ref_clid}, y así sucesivamente). Si solo admite un menú desplegable de campo, abra Configuración del formulario → Opciones del formulario → Campos de espejo y haga clic Agregar campos espejo. Esto añade campos ocultos visibles para el editor, y el plugin los rellena. Consulta la sección Campos espejo para ver la guía completa.

¿Dónde se guardan los datos de referencia?

En tu base de datos de WordPress, dentro de las entradas de Gravity Forms. El plugin nunca envía los datos a ningún sitio por su cuenta. Si quieres que los valores capturados aparezcan en GA4, activa la configuración de GA4. El plugin sigue siendo la fuente de los datos; tu propia etiqueta de Google se encarga de enviarlos.

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

Ambos. Por defecto, utiliza la atribución de primer contacto, almacenando el referente original y los parámetros de la campaña que llevaron al visitante a su sitio por primera vez (dentro del período de atribución). Hay una casilla de verificación para ignorar las visitas de retorno directas, de modo que el último contacto mantenga el anuncio o la referencia anterior. Los ID de clic de las visitas de retorno se almacenan solo en Click ID (último contacto). Esto le brinda un conjunto paralelo de {pb_ref_last_*} Combina etiquetas, columnas de lista de entradas y columnas de exportación CSV. La pestaña Informes incluye un interruptor Primero/Último que permite alternar entre las dos vistas de cada gráfico.

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

El período de atribución predeterminado es de 7 días, y puede modificarlo en Formularios → Configuración → Seguimiento de referencias. Si un visitante envía un formulario dentro de ese período tras su primera visita registrada, dicha entrada conservará los valores de atribución originales del primer contacto.

¿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 bien. Si utiliza una optimización agresiva de scripts (minificación o aplazamiento), marque Proteger los scripts de la optimización En Formularios → Ajustes → Seguimiento de referencias → Avanzado, borra la caché. Esto etiqueta los scripts del plugin para que se omitan y los añade automáticamente a las listas de exclusión de WP Rocket, LiteSpeed Cache, SG Optimizer, Autoptimize y Cloudflare Rocket Loader. Si utilizas Breeze u otro minificador que no esté en esa lista, excluye manualmente los dos archivos que aparecen a continuación y borra la caché de la CDN después de una actualización.

Para cualquier optimizador que no esté cubierto por esa configuración, excluya manualmente estos dos archivos y pruebe un envío:

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

¿Funciona con Gravity Forms habilitado para AJAX?

Sí. Funciona con formularios AJAX y envíos estándar (no AJAX). Las confirmaciones de redireccionamiento y de agradecimiento en Gravity Forms 2.9+ requieren la versión 1.7.1 para el evento GA4.

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

Sí. Funciona en todos tus formularios de Gravity Forms. Cada envío guarda sus propios valores de atribución para esa entrada.

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

No. Es una fuente de datos, no un píxel de conversión, y nunca activa píxeles ni contacta directamente con Google. Si deseas que la atribución se registre en GA4, la configuración de GA4/Tag Manager envía la información como un evento personalizado mediante tu propia etiqueta de Google al confirmar el formulario.

¿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?

Si necesita obtener el consentimiento antes de capturar cualquier dato de atribución, habilite la puerta de consentimiento opcional. Esta puerta guarda los datos de la primera interacción en el navegador hasta que el visitante otorga su consentimiento a través de su banner de cookies (mediante un indicador de ventana, una función de devolución de llamada o un evento), y luego lo aplica.

¿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 está inactivo en ese subdominio. No se capturan campos de seguimiento, etiquetas de combinación ni datos de entrada hasta que se active una clave o el Modo de red envíe una.
• El soporte se aplica según la licencia: Los sitios cubiertos por la clave activa son elegibles.

Sí, una vez que cada subdominio esté licenciado y activado. La activación en red instala el plugin en todas partes y las actualizaciones se gestionan en toda la red, pero un subdominio necesita su propia licencia activada (o una clave ilimitada enviada a través del Modo de red) antes de que el plugin añada campos de seguimiento o capture valores. Después, active la opción «Habilitar por defecto» o habilite el seguimiento por formulario.

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.

Referencia de configuración

Todo lo que está debajo vive bajo Formularios → Configuración → Seguimiento de referencias, en la pestaña nombrada en cada encabezado.

Datos y privacidad

Avanzado

Puerta de consentimiento

No hay casilla de verificación para esto. La puerta de consentimiento es una opción de activación del desarrollador: establecer consentRequired a través del pb_gforms_referral_tracking_js_config filtro. El script de seguimiento contiene datos de primer contacto en sessionStorage hasta que se obtenga el consentimiento, entonces lo promueve al almacenamiento duradero.

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

Indica tu consentimiento a través de tu banner de cookies de cualquiera de estas tres maneras que mejor te convenga:

• Colocar window.PBReferralTrackingConsent = true.
• Despachar el evento: window.dispatchEvent( new Event( 'pb-ref-tracking:consent-granted' ) ).
• Asignar un consentGranted Función de devolución de llamada que devuelve verdadero una vez que se obtiene el consentimiento.

Manos

Comportamiento

pb_gforms_referral_tracking_loaded

Se activa una vez que el plugin se ha inicializado por completo: clases cargadas, ganchos registrados, API lista. Este es el punto de arranque fiable para complementos o plugins asociados que extienden el seguimiento de fuentes de referencia.

Parámetros:

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

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

Filtros

pb_gforms_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 y 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 (matriz|nulo) – El array meta del formulario, o null si no está disponible.

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

Filtra el conjunto de definiciones de campos de seguimiento ocultos antes de que el complemento las inserte en el formulario. Utiliza esta función para agregar, eliminar o modificar cualquier campo de seguimiento individual.

Parámetros:

• $fields (formación) – Matriz de matrices de definición de campos.
• $form (formación) – El formato actual 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

Filtra el array completo del formulario después de que el plugin haya añadido todos sus campos de seguimiento. Puedes modificar el objeto final del formulario antes de que se muestre.

Parámetros:

• $form (formación) – El formulario con los campos de seguimiento ya añadidos.
• $field_definitions (formación) – Las definiciones de campo que se utilizaron.

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

Modifique el mapa de etiquetas de combinación que define qué etiquetas de combinación están disponibles y a qué identificadores de campo corresponden. Úselo para agregar etiquetas de combinación totalmente personalizadas o para renombrar las existentes.

Parámetros:

• $map (formación) – Matriz asociativa de etiqueta => [ 'etiqueta' => cadena, 'field_id' => cadena ].
• $base_id (cadena) – El prefijo del ID del campo base.
• $constants (Constantes) – La instancia de constantes del complemento.

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

Filtra el valor sin procesar de un campo de seguimiento antes de que el complemento lo formatee y lo utilice para reemplazar una etiqueta de combinación en una notificación o confirmación. Aquí es donde puedes sanitizar o transformar un valor específico.

Parámetros:

• $value (cadena) – El valor del campo sin procesar.
• $tag (cadena) – La clave de la etiqueta de combinación (por ejemplo, pb_ref_source).
• $data (formación) – Los metadatos de la etiqueta de combinación (etiqueta, field_id).
• $entry (formación) – La entrada actual.
• $form (formación) – La forma actual.

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

Filtra el valor de la etiqueta de combinación totalmente formateada después de que Gravity Forms haya aplicado su propio proceso de formato (escapado de caracteres, codificación URL, etc.).

Parámetros:

• $formatted (cadena) – La cadena de salida formateada.
• $tag (cadena) – La clave de la etiqueta de fusión.
• $data (formación) – Los metadatos de la etiqueta de fusión.
• $entry (formación) – La entrada actual.
• $form (formación) – La forma actual.
• $url_encode (booleano)
• $esc_html (booleano)
• $nl2br (booleano)
• $format (cadena)

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

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_gforms_referral_tracking_default_value', function( $default, $key ) {
    if ( $key === 'source' ) {
        return 'Direct';
    }
    return $default;
}, 10, 2 );

pb_gforms_referral_tracking_js_config

Sobrescribe todo el objeto de configuración JavaScript del front-end antes de que el complemento lo pase al script de seguimiento. Tu función de devolución de llamada controla la configuración de las cookies, los mapas de origen (utmSourceMap y utmReferrerMap), fuentes conocidas y la paidClickIds Lista que decide qué parámetros de consulta demuestran que se trata de un clic de pago.

Parámetros:

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

Las teclas, con sus valores predeterminados:

sourcePatterns está deliberadamente ausente de esa lista. Sus entradas necesitan JavaScript en vivo. RegExp objetos, y cualquier cosa que devuelva una devolución de llamada de PHP llega como una cadena una vez que la configuración se codifica en JSON, lo que lanza en el momento de la coincidencia. Para extender los patrones de referencia, asigne a window.PBReferralTrackingConfig desde JavaScript antes de que se ejecute el script de seguimiento.

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

Inyecta mediante programación reglas de origen personalizadas que se ejecutan junto con las reglas configuradas en la interfaz de administración. El complemento combina las reglas de este filtro con las reglas guardadas de la interfaz, ordena el conjunto combinado por prioridad y lo envía al front-end.

Parámetros:

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

Cada regla debe tener: etiqueta, matchField (referrer, utm_source, utm_medium, utm_campaign, utm_term, utm_content), matchType (contiene o es igual a), matchValue y, opcionalmente, prioridad (por defecto 10, las más altas se ejecutan primero).

Las reglas añadidas a través de este filtro también pueden utilizarse referrer_url como matchField, que compara con la URL de referencia completa, incluyendo su ruta y consulta, en lugar de solo el host. La interfaz de administración no lo ofrece, por lo que solo está disponible aquí.

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

Escribe tu propia etiqueta en un campo de Fuente personalizada independiente al enviar el formulario. La Fuente detectada nunca se modifica, por lo que la entrada conserva tanto la etiqueta generada por el plugin como la que tú proporcionaste. Resulta útil cuando un CRM necesita una etiqueta simplificada o interna y no quieres perder la fuente original. Desde la versión 1.6.0.

La función se activa al adjuntar una función de devolución de llamada. Sin ninguna función conectada, los campos de origen personalizado y sus etiquetas de combinación no existen. Al añadir una, el plugin comienza a agregar un campo de origen personalizado a tus formularios, además de un campo de origen personalizado (último contacto) cuando la atribución de último contacto está habilitada. Devuelve una cadena vacía para dejar el campo en blanco para una visita determinada; no se utilizará la etiqueta detectada.

Parámetros:

• $label (cadena) – La etiqueta de origen detectada, por ejemplo Google Ads.
• $key (cadena) – ¿Qué tacto se está etiquetando? source o last_source.
• $form (formación) – El objeto del formulario actual.

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

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) – Indica si se deben agregar los activos a la cola. Valor predeterminado: verdadero.

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

Anular el CSS en línea que oculta los campos de seguimiento en el front-end y en la vista previa del editor de bloques. El CSS predeterminado oculta el seguimiento, el rastreador heredado de Google Ads y los contenedores de campos espejo, la segmentación .gform_wrapper .gfield con los prefijos de clase pb-ref-tracking-, pb-gads-tracking- y pb-ref-mirror-.

Parámetros:

• $css (cadena) – La cadena CSS en línea.

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

Ajusta (o desactiva) el intervalo de retardo de invalidación de la caché de informes. Tras la llegada de una nueva entrada, la caché de informes se reconstruye como máximo una vez cada cierto número de segundos para evitar que los formularios de alto volumen la saturen. El valor predeterminado es de 60 segundos; devuelve 0 para invalidarla inmediatamente con cada entrada.

Parámetros:

• $seconds (int) – El intervalo de retardo en segundos. Valor predeterminado: 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

Personalice las definiciones de campos espejo persistentes que se crean cuando se agregan campos espejo a un formulario. label es la parte que puedes cambiar sin problemas.

Dejar cssClass solo. Al enviarlo, el complemento lee la clave de seguimiento canónica, todo lo que sigue pb-ref-mirror-, para encontrar el valor que se debe copiar. Cambie el nombre de la clase y el campo espejo se enviará vacío cada vez.

Parámetros:

• $fields (formación) – Conjunto de conjuntos de definiciones de campos espejo.
• $form (formación) – El formato actual 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

Redirecciona el enlace "Más información en la documentación" que aparece en la pantalla de configuración. Esto resulta útil en instalaciones de marca blanca o de agencias que gestionan su propia documentación.

Parámetros:

• $url (cadena) – La URL de la documentación. Devuelve la tuya para reemplazarla.

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