Seatext library

Cómo se integra SeaText con su sitio web: pasos de implementación, control y verificación

SeaText se integra añadiendo un único script a su sitio, activando luego el agente de Landing Page de Google Ads (u otros agentes) para detectar parámetros de URL de clics en anuncios y reescribir...

Cómo se integra SeaText con su sitio web: pasos de implementación, control y verificación

SeaText se conecta a su sitio web a través de un fragmento de JavaScript ligero que se pega una sola vez, normalmente en el <head> o mediante Google Tag Manager. Una vez cargado el fragmento, usted activa el agente de Landing Page de Google Ads (u otros agentes) desde el panel de control de SeaText. El agente lee el parámetro de palabra clave que Google Ads añade a la URL de su página de destino (por ejemplo, ?keyword=office+space), lo compara con una lista de palabras clave que usted aprueba y reescribe el contenido de la página antes de que el visitante lo vea. Usted mantiene el control total: cada versión reescrita aparece en el panel de control para su revisión, puede editar la salida de la IA manualmente, añadir instrucciones para el modelo o desactivar la optimización para cualquier palabra clave.

Cómo funciona la integración de principio a fin

La integración tiene tres partes móviles: el fragmento, el panel de control y la lógica del agente. El fragmento es una única etiqueta <script> que se carga de forma asíncrona y ocupa menos de 50 KB comprimidos en gzipped. No bloquea el renderizado. Una vez presente, escucha las cargas de página, extrae los parámetros de consulta (términos UTM, gclid, parámetros de palabra clave personalizados) y los envía a la función de borde (edge function) de SeaText. La función de borde busca la palabra clave en su lista aprobada, obtiene la variante pregenerada (o genera una sobre la marcha si es la primera visita para esa palabra clave) y devuelve un parche JSON que el fragmento aplica al DOM, intercambiando titulares, cuerpo del texto, ofertas, bloques de productos y CTA. La página original permanece en su CMS sin cambios; los visitantes ven la versión personalizada solo mientras la sesión coincida con una palabra clave aprobada.

Implementación paso a paso

Looking to implement this for your website?
Más información →
  1. Cree una cuenta de SeaText y abra el panel de control. El panel de control es donde usted gestiona los agentes, las listas de palabras clave y revisa el texto reescrito.
  2. Copie el fragmento de instalación. En el panel de control encontrará una línea única <script src="https://cdn.seatext.com/..." async></script>. Péguela en el <head> global de su sitio o añádala a través de Google Tag Manager / Segment / Tealium como una etiqueta HTML personalizada. El fragmento funciona en cualquier plataforma (WordPress, Webflow, Shopify, HTML estático, React, Next.js, Vue) porque solo lee la URL y muta el DOM renderizado.
  3. Verifique que el fragmento se carga. Abra su sitio con ?seatext_debug=1 añadido a cualquier URL. La consola registrará "SeaText snippet loaded" y mostrará los parámetros detectados. Si utiliza una CSP, añada https://cdn.seatext.com y https://api.seatext.com a script-src y connect-src.
  4. Active el agente de Landing Page de Google Ads. En el panel de control, cambie el agente "Google Ads Landing Page AI" a Activo. Este agente está diseñado específicamente para el tráfico de búsqueda pagada; otros agentes (Traducción, Personalización, Pruebas A/B, etc.) pueden activarse de forma independiente.
  5. Conecte su cuenta de Google Ads (opcional pero recomendado). Vincularla permite a SeaText extraer automáticamente su estructura de campañas/palabras clave y sugerir qué palabras clave personalizar. También puede subir un CSV de palabras clave manualmente.
  6. Cree su lista de palabras clave. Para cada palabra clave que desee personalizar, haga clic en Añadir palabra clave, introduzca el término exacto (por ejemplo, "estancia de corta duración") y apruebe la reescritura generada por la IA. El panel de control muestra una comparación lado a lado: original frente a reescrito. Edite la reescritura si es necesario, añada directrices como "enfatizar el pago flexible" y luego guarde.
  7. Establezca la asignación de tráfico. Por defecto, el 100% del tráfico coincidente ve la reescritura. Puede reducir esto para realizar una prueba en la sombra (por ejemplo, 10%) mientras supervisa los datos de conversión.
  8. Publique. Haga clic en Publicar. El siguiente visitante que haga clic en un anuncio para una palabra clave aprobada verá la página personalizada.

Requisitos previos antes de empezar

  • Acceso de administrador al <head> de su sitio o al gestor de etiquetas. Necesita pegar el fragmento una vez.
  • Campañas de Google Ads que utilicen inserción de palabras clave o parámetros de seguimiento de palabras clave explícitos. SeaText lee la palabra clave de la URL de la página de destino. Si sus anuncios solo utilizan gclid sin un parámetro de palabra clave, active el "Etiquetado automático" en Google Ads y añada {keyword} al sufijo de su URL final (por ejemplo, ?kw={keyword}).
  • Una lista de palabras clave por las que realmente puja. Personalizar para palabras clave por las que no puja desperdicia tiempo de revisión y puede confundir a los visitantes orgánicos.
  • Contenido que pueda ser intercambiado de forma segura. El agente reescribe nodos de texto y valores de atributos (titulares, etiquetas de botones, meta descripciones). No reestructura el HTML, no mueve contenedores ni ejecuta JavaScript personalizado. Si su página depende de un diseño rígido donde los cambios en la longitud del texto rompen el diseño, establezca restricciones de longitud de caracteres en la configuración de la palabra clave.
  • Consentimiento para la personalización bajo su política de privacidad. El fragmento establece una cookie de origen (seatext_session) para mantener la consistencia de la variante durante la sesión. Divulgue esto en su aviso de cookies.

Qué se reescribe (y qué no)

Elemento¿Reescrito?Notas
Titulares (H1–H3)SíObjetivo principal; coincide con la intención de la palabra clave.
Párrafos del cuerpoSíReescritos para reflejar la consulta de búsqueda.
Texto del botón CTASíej., "Reservar un tour" → "Reserve su estancia de corta duración".
Bloques de oferta / tablas de preciosSíTexto dentro de las celdas; estructura sin cambios.
Meta título y descripciónSíActualizados para relevancia SEO en la página de destino pagada.
Navegación, pie de página, marcado de esquemaNoEl cromo global del sitio se conserva.
Imágenes, vídeos, PDFsNoLos activos multimedia no se intercambian.
Componentes renderizados por JavaScript (React, Vue)ParcialFunciona si el componente renderiza nodos de texto después de la hidratación; puede necesitar un atributo data-seatext-ignore en widgets dinámicos.

Control y verificación

Cada palabra clave que usted aprueba obtiene un historial de versiones en el panel de control. Puede:

  • Previsualizar la reescritura en su URL en vivo añadiendo ?seatext_preview=keyword-slug.
  • Editar la salida de la IA directamente en una vista de comparación de texto enriquecido.
  • Añadir instrucciones como "Usar ortografía del Reino Unido" o "Mencionar soporte 24/7" que el modelo seguirá en la siguiente regeneración.
  • Pausar una sola palabra clave sin desactivar el agente.
  • Exportar todas las reescrituras como CSV para revisión de cumplimiento.

Para verificar que la integración funciona en producción, abra una ventana de incógnito, haga clic en uno de sus propios anuncios (o simule con la URL final exacta + parámetro de palabra clave) y confirme que el titular cambia. El panel de "Vista en vivo" del panel de control también muestra sesiones en tiempo real, la palabra clave coincidente y la variante servida.

Escenarios de integración comunes

Escenario A: Página de destino única, más de 50 palabras clave

Usted ejecuta una página de destino genérica para una campaña de Google Ads con 50 palabras clave. Tras instalar el fragmento, activa el agente de Google Ads, importa la lista de palabras clave desde Google Ads y aprueba las reescrituras para las 20 palabras clave principales por volumen. Las 30 palabras clave restantes vuelven a la página original. Resultado: cada palabra clave de alto volumen obtiene un titular y una oferta a medida; las palabras clave de cola larga mantienen la página genérica.

Escenario B: Múltiples páginas de destino, diferentes campañas

Usted tiene páginas separadas para "espacio de oficina", "coworking" y "oficina virtual". Instale el fragmento globalmente. En el panel de control, cree tres grupos de palabras clave asignados a la ruta de URL de cada página. Active el agente. Los visitantes que hacen clic en anuncios de "coworking" aterrizan en la página de coworking y ven reescrituras específicas de coworking; los clics de "espacio de oficina" ven reescrituras de espacio de oficina en la página de espacio de oficina.

Escenario C: Headless / SPA (Next.js, React Router)

Debido a que el fragmento se ejecuta en cada cambio de ruta (escucha popstate y pushState), la personalización funciona en la navegación del lado del cliente. Añada data-seatext-ignore a cualquier componente que gestione su propio texto a través de la API del CMS para evitar la doble reescritura.

Limitaciones y cuándo no aplica este consejo

  • Sin parámetro de palabra clave en la URL. Si sus anuncios solo utilizan gclid y no puede añadir un parámetro de palabra clave, SeaText no puede saber qué palabra clave activó el clic. Solución: active el etiquetado automático de Google Ads y añada {keyword} al sufijo de la URL final.
  • Renderizado pesado del lado del cliente sin texto del lado del servidor. Si toda la página se construye a partir de JSON después de la carga, el fragmento puede reescribir demasiado tarde o perder elementos. Utilice el atributo data-seatext-ignore o renderice el texto crítico en el lado del servidor.
  • CSP estricta sin https://cdn.seatext.com y https://api.seatext.com. El fragmento será bloqueado. Actualice su política.
  • Páginas detrás de inicio de sesión o muro de pago. El agente solo funciona en URLs públicas que Google puede rastrear y a las que los visitantes pueden llegar directamente desde un anuncio.
  • Plataformas de anuncios que no son de Google sin parámetros de palabra clave. El agente de Google Ads espera el formato de parámetro de Google. Para Meta, TikTok o correo electrónico, utilice el agente de Reescrituras de Fuente de Visitante en su lugar (activación por separado).

Datos clave

DatoDetalleFuente
Tiempo de instalaciónMenos de 1 minuto (etiqueta de script única)S2
Tamaño del fragmento< 50 KB gzipped, asíncrono, no bloqueanteS2
Detección de palabras claveAutomática desde parámetros de URL (UTM, gclid, personalizados)S1
Alcance de reescrituraTitulares, cuerpo del texto, ofertas, bloques de productos, CTA, meta etiquetasS2
Funciones de controlAprobar/editar/pausar por palabra clave, URLs de vista previa, historial de versionesS1
Activación del agenteAlternar por agente en el panel de control (Google Ads, Traducción, Pruebas A/B, etc.)S2
Consistencia de sesiónCookie de origen seatext_sessionS1
Modo de depuraciónAñada ?seatext_debug=1 a cualquier URLS1
Modo de vista previaAñada ?seatext_preview=keyword-slugS1
Requisitos de CSPPermitir https://cdn.seatext.com (script-src) y https://api.seatext.com (connect-src)S1

Preguntas frecuentes

¿Necesito ayuda de un desarrollador para instalar el fragmento?

Normalmente no. Cualquier persona con acceso al <head> del sitio o a Google Tag Manager puede pegar la línea. Si utiliza una CSP estricta, un desarrollador debe añadir los dos dominios a la política.

¿El fragmento ralentizará mi página?

El script se carga de forma asíncrona, ocupa menos de 50 KB comprimidos y se ejecuta después de DOMContentLoaded. No bloquea el renderizado ni las Core Web Vitals.

¿Puedo usar SeaText sin Google Ads?

Sí. El agente de Reescrituras de Fuente de Visitante personaliza por referente (Meta, correo electrónico, orgánico, directo) en lugar de por palabra clave. Active ese agente en lugar de (o junto con) el agente de Google Ads.

¿Qué sucede si la IA escribe algo inexacto?

Usted revisa cada reescritura antes de publicarla. Puede editar el texto manualmente, añadir instrucciones de corrección o pausar la palabra clave. Nada se publica sin su aprobación.

¿SeaText cambia el contenido de mi CMS?

No. Las reescrituras ocurren en el navegador mediante la mutación del DOM. Su CMS, base de datos y HTML fuente permanecen exactamente como están.

¿Puedo realizar una prueba A/B de la versión personalizada frente a la original?

Sí. Establezca la asignación de tráfico por debajo del 100% para cualquier palabra clave (por ejemplo, 50%) para realizar una prueba dividida. El panel de control informa de las conversiones por variante.

¿Hay una prueba gratuita?

SeaText ofrece un piloto gratuito de 1 mes para el agente de Landing Page de Google Ads. Actívelo desde el panel de control después de instalar el fragmento.

Lecturas adicionales y fuentes de comparación

Estas fuentes externas proporcionan contexto adicional para evaluar el tema. Su inclusión no constituye un respaldo.

Más información

Visite el sitio web para obtener más información.

Recommended Solution

Ready to Take the Next Step?

See how our verified tools and services help you put this guide into practice.