Captura información adicional desde los parámetros de la URL cuando los clientes envían tu formulario.
¿Qué son los metadatos?
Los metadatos son información extra que se captura de los parámetros de consulta de la URL cuando alguien visita y envía tu formulario. Esos datos se almacenan con el envío y son visibles en las vistas de conversación.
Cómo funciona
Añade parámetros de consulta a la URL de tu formulario:
https://supportretriever.com/form/your-form-id?origen=newsletter&campaign=summer2024&userId=12345
Cuando un cliente envía el formulario, esos parámetros se:
- Capturan: Se almacenan con el envío
- Limpian: Se eliminan de la URL (URL más limpia)
- Almacenan: Quedan disponibles en los metadatos de la conversación
Ejemplos de uso
Campañas de marketing
Seguir qué campañas generan envíos:
https://supportretriever.com/form/your-id?utm_origen=facebook&utm_campaign=product_launch&utm_medium=social
Contexto de usuario
Capturar información del usuario:
https://supportretriever.com/form/your-id?userId=12345&plan=premium&page=settings
Seguimiento de referidos
Identificar de dónde vienen los clientes:
https://supportretriever.com/form/your-id?referrer=blog&article=getting-started&origen=internal
Formularioato de la URL
Añade parámetros con el formato estándar de cadena de consulta:
[url-formulario]?key1=valor1&key2=valor2&key3=valor3
Reglas:
- Usa
¶ separar varios parámetros - Los valores se codifican en URL automáticamente
- Los nombres de parámetro se sanean (alfanuméricos, guiones bajos, guiones)
- Los valores están limitados a 500 caracteres
- Los nombres de parámetro a 50 caracteres
Ver los metadatos
Los metadatos aparecen en las vistas de conversación:
- Abre una conversación en tu panel
- Busca el icono de metadatos (llaves:
{}) en la cabecera - Haz clic para ver los metadatos capturados
Integración con estadísticas
Los metadatos también están en tus estadísticas:
- Ve a Estadísticas (
/stats) - Busca la sección Desglose por metadatos
- Consulta conteos por campo y valor de metadatos
Así puedes ver:
- Qué campañas generan más envíos
- De dónde vienen los clientes
- Qué contextos llevan a solicitudes de soporte
Ejemplos de implementación
En campañas de correo
<a href="https://supportretriever.com/form/your-id?origen=email&campaign=newsletter_jan">Contactar soporte</a>
En la navegación del sitio
<a href="https://supportretriever.com/form/your-id?origen=header&page=home">Contactar</a>
En la configuración de la aplicación
const formUrl = `https://supportretriever.com/form/your-id?origen=app&page=settings&userId=${userId}`;
window.location.href = formUrl;
Con parámetros UTM
<a href="https://supportretriever.com/form/your-id?utm_origen=blog&utm_medium=article&utm_campaign=product_guide">Obtener ayuda</a>
Buenas prácticas
- Nombres coherentes: Usa nombres de parámetro consistentes en todo el sitio
- Valores útiles: Usa valores que aporten contexto
- Sin datos sensibles: No incluyas contraseñas ni datos sensibles
- Documentación: Documenta la estructura de parámetros para tu equipo
Seguridad
- Los parámetros se sanean automáticamente
- Solo se permiten caracteres alfanuméricos, guiones bajos y guiones en las claves
- Los valores tienen límite de longitud
- No pases datos sensibles en las URLs
Limpieza de la URL
SupportRetriever elimina los parámetros de la URL tras capturarlos:
- Antes:
https://supportretriever.com/form/your-id?origen=newsletter - Después:
https://supportretriever.com/form/your-id
Así la URL queda limpia para el cliente y los metadatos se conservan.