Nexus Marketing
Nexus Marketing lleva a Nexus los datos de marketing de tu web. Con un solo componente trabajas con tres cosas: los recursos de contenido (artículos del blog, noticias, casos de éxito, guías y landing pages) con sus métricas diarias, la analítica diaria de tu web y las auditorías SEO y GEO.
Es útil para conectar con Nexus tu gestor de contenidos o tu herramienta de analítica: cada vez que publicas un artículo, o cada noche con los datos del día anterior.
Cuándo usarlo
- Cada vez que publicas un artículo en tu blog, quieres darlo de alta en Nexus como recurso.
- Cada noche quieres enviar a Nexus las visitas de la web del día anterior, en total o por canal y campaña.
- Quieres enviar las visitas, el tiempo de lectura y las conversiones de cada artículo.
- Una herramienta audita el SEO de tu web y quieres guardar en Nexus su puntuación.
Configuración
Necesitas una credencial Nexus con la dirección de tu Nexus (por ejemplo https://nexus.tu-empresa.com) y una clave de aplicación que empieza por nxa_live_. Consulta Credenciales.
La clave la crea un administrador de Nexus en Administración › Integraciones › Claves de API, con Nueva clave de API. Elige Web en NappAI CMS en Para qué es: incluye los permisos de Contenidos, Visitas y SEO/GEO que necesita este componente. Al crearla, Nexus muestra la Clave de API y la Dirección de Nexus: son los dos datos de la credencial.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial Nexus. Rellena por ti Nexus address y Nexus API key. |
| Resource | Con qué trabajas: Resources (recursos de contenido), Web (analítica web) o SEO (auditorías). Por defecto, Resources. |
| Operation | Lo que haces. La lista cambia según el Resource elegido. Ver Recursos y operaciones. |
| Idempotency key (avanzado) | Opcional. Si repites la misma clave en menos de 24 horas, Nexus no vuelve a hacer el envío. Sirve para que un reintento no repita lo mismo. |
Recursos y operaciones
Resources (recursos de contenido)
| Operación | Qué hace | Campos |
|---|---|---|
Upsert Resource | Crea un recurso o, si ya existe con ese External ID, lo actualiza. | External ID, Type, Title, URL. Opcionales: Summary, Thumbnail URL, Language, Published at, Category y Tags. |
Archive Resource | Archiva un recurso. | External ID |
Resource Metrics | Envía las métricas diarias de un recurso. | External ID, Date, y Views, Visitors, Average time (s) y Conversions; o varios días en Several days (JSON). |
- External ID es tu identificador del contenido, por ejemplo el slug del artículo. No puede repetirse con la misma clave.
- Type puede ser
BLOG_POST(artículo),NEWS(noticia),CASE_STUDY(caso de éxito),GUIDE(guía) oLANDING_PAGE. - Summary admite hasta 4.000 caracteres. Language es un código como
esoen-US. Published at es una fecha y hora, por ejemplo2026-11-09T09:00:00Z. - Category se crea en Nexus si no existe. Tags son etiquetas separadas por comas, hasta 20.
Upsert Resourcetambién reactiva un recurso archivado. Solo la creación lanza el eventoresource.created.- Date es el día de las métricas, como
2026-11-08, otodaypara hoy. Visitors y Conversions no pueden ser más que Views. Si envías otra vez el mismo día, sustituye al anterior. - Several days (JSON) sustituye al día suelto: una lista como
[{"date": "2026-10-12", "views": 340, "visitors": 280}], de hasta 100 días.
Web (analítica web)
| Operación | Qué hace | Campos |
|---|---|---|
Web Metrics | Envía la analítica de un día de tu web, en total o por canal y campaña. | Site, Date, Visitors, Page views. Opcionales: Entries, Bounces, Conversions, Source, Medium y Campaign; o varias filas en Several rows (JSON). |
- Site es el dominio de la web, por ejemplo
nappai.es. Si escribes una dirección completa, solo se envía el dominio. - Page views no puede ser menos que Visitors, y Entries (sesiones iniciadas) y Bounces (rebotes) no pueden ser más que Visitors. Conversions no puede ser más que Page views.
- Source (por ejemplo
google), Medium (cpc,organic…) y Campaign reparten los datos por canal. Si los dejas los tres vacíos, la fila es el total del día. - Several rows (JSON) sustituye a la fila suelta: una lista como
[{"site": "nappai.es", "date": "2026-10-12", "visitors": 950, "pageviews": 2400}], de hasta 100 filas.
SEO (auditorías SEO y GEO)
| Operación | Qué hace | Campos |
|---|---|---|
SEO Audit | Guarda una auditoría de tu web con sus puntuaciones, sus páginas y sus incidencias. | Site, Score. Opcionales: Audited at, SEO score, GEO score, Tool, Pages (JSON) y Findings (JSON). |
- Score, SEO score y GEO score van de 0 a 100. GEO score mide la visibilidad en los buscadores con IA.
- Audited at es la fecha y hora de la auditoría. Si lo dejas vacío, se usa el momento actual.
- Tool es el nombre de la herramienta que ha auditado, hasta 80 caracteres. Si lo dejas vacío, se envía
nappai. - Pages (JSON) es la puntuación de cada página, por ejemplo
[{"url": "/precios", "score": 74, "geo_score": 60}], hasta 500 páginas. - Findings (JSON) es el número de incidencias por gravedad, por ejemplo
{"critical": 1, "warning": 6, "info": 12}. - Dos auditorías del mismo sitio en el mismo momento se combinan en una.
Las cantidades se envían como números enteros, redondeadas: 12,7 se envía como 13. Se entiende el separador de miles en los dos formatos (1.500 y 1,500 son 1500).
Resultado
La salida Data devuelve la respuesta de Nexus: el recurso creado o actualizado, o la confirmación de las métricas y la auditoría recibidas.
El componente admite Batch Mode y se puede conectar a un Agente como herramienta. Ver Herramientas.
Ejemplo
Una agencia quiere que cada artículo nuevo de su blog aparezca en Nexus.
- El gestor de contenidos avisa al flujo por un Webhook Input cada vez que publica un artículo, con su slug, su título, su dirección y su resumen.
- Añade Nexus Marketing con el recurso
Resourcesy la operaciónUpsert Resource. - En External ID pon el slug, en Type
BLOG_POST, y en Title, URL y Summary los datos del artículo. - Si el artículo se edita, el mismo flujo lo actualiza en Nexus, porque el External ID es el mismo.
Para la analítica, crea otro flujo en el Programador que cada noche lea las visitas del día anterior y las envíe con Web Metrics.
Buenas prácticas
- Usa siempre el mismo External ID para el mismo contenido: así se actualiza en lugar de duplicarse.
- Si envías las métricas de un día que todavía no ha terminado, vuelve a enviarlas al día siguiente: el último envío de cada día sustituye al anterior.
Seguridad y limitaciones
- Nexus rechaza las métricas con una fecha futura.
- En Site solo se guarda el dominio: la ruta y el
https://se quitan. - La clave de Nexus solo sirve para enviar datos: no puede leer el CRM.
- Si Nexus rechaza la clave, puede estar revocada, pausada o sin el permiso necesario. Un administrador puede revisarla en Administración › Integraciones.
- Nexus limita el número de envíos por minuto. Si lo superas, el componente te dice cuántos segundos esperar.
Componentes relacionados
- Nexus Intake: enviar leads y su actividad.
- Nexus Webhook: pone en marcha el flujo con lo que pasa en Nexus, también cuando se crea un recurso.