> ## Documentation Index
> Fetch the complete documentation index at: https://help.scribe-mail.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Seguimiento de conversiones

> Haz seguimiento de registros, demos y compras en tu web con el SDK de JavaScript de Scribe y atribuye cada conversión a la firma de correo electrónico que la generó.

El seguimiento de conversiones cierra el círculo de tus firmas de correo electrónico. La analítica de firmas ya te muestra las vistas y los clics. Con el SDK de JavaScript de Scribe, también puedes registrar lo que ocurre después en tu propia web —los registros, las demos reservadas y las compras— y vincular cada uno con la firma, el miembro del equipo y el enlace que lo generó. Este es el fondo del embudo: vistas, después clics y después conversiones.

En Scribe, estas conversiones se llaman **eventos**. Los registras con unas pocas líneas de JavaScript, y Scribe los atribuye automáticamente usando el mismo seguimiento de clics que alimenta el resto de tu analítica.

<Note>
  El seguimiento de conversiones está disponible en los planes de pago. Si el plan de tu espacio de trabajo no lo incluye, el fragmento de seguimiento no registra nada.
</Note>

## Cómo funciona

1. Un destinatario hace clic en un enlace de una de tus firmas de correo electrónico.
2. Scribe lo redirige a tu sitio y añade un parámetro `scribe_click_id` a la URL de destino.
3. El SDK de Scribe en tu página de aterrizaje lee ese `scribe_click_id`, lo almacena como cookie propia y lo adjunta a cada evento que registras.
4. Cuando el visitante convierte, llamas a `scribe.track('signup')`. Scribe vincula el evento con el clic de origen.

El resultado: puedes ver qué firmas, qué miembros del equipo y qué elementos clicados generan conversiones e ingresos reales, no solo clics. La atribución funciona a nivel de remitente, firma y elemento, y Scribe asocia una conversión con un clic hasta 30 días después del clic.

Si un evento llega sin un `scribe_click_id` conocido (tráfico directo, un enlace caducado o un parámetro eliminado), se sigue registrando. Simplemente no se atribuye a un clic.

## Antes de empezar

Necesitas tres cosas:

* **Un plan de pago** que incluya el seguimiento de conversiones.
* **Seguimiento activado** para tu espacio de trabajo. Es el mismo ajuste que impulsa la analítica de vistas y clics de firma. Actívalo solo cuando tengas el consentimiento necesario (consulta [Privacidad y consentimiento](#privacy-and-consent)).
* **Tu Event Tracking ID.** Es un identificador público, no secreto, de tu espacio de trabajo. Se puede incrustar sin problema en el HTML de tu sitio web.

<Steps>
  <Step title="Copia tu Event Tracking ID">
    En Scribe, abre **Ajustes**, ve a la pestaña **Espacio de trabajo** y copia el valor de **Event Tracking ID**. Ya que estás ahí, comprueba que **Seguimiento** está activado.
  </Step>

  <Step title="Añade el SDK a tu sitio">
    Usa el fragmento de script para un sitio web estándar, o el paquete npm para una aplicación o una single-page app. Ambos exponen la misma API `scribe.track(...)`.

    **Opción A. Fragmento de script.** Añádelo a cada página que quieras rastrear, justo antes de la etiqueta `</head>` de cierre. El fragmento se autoinicializa desde `data-workspace`, así que no hay que hacer ninguna llamada a `init()`.

    ```html theme={null}
    <!-- Scribe conversion tracking -->
    <script src="https://cdn-1.scribe-mail.com/v1/tracking.js"
            data-workspace="YOUR_EVENT_TRACKING_ID" async></script>
    ```

    **Opción B. npm o yarn.** Instala el paquete y, después, inicialízalo una vez al arrancar la aplicación.

    ```bash theme={null}
    npm install @scribemail/js
    # or: yarn add @scribemail/js
    ```

    ```js theme={null}
    import scribe from '@scribemail/js';

    scribe.init({ id: 'YOUR_EVENT_TRACKING_ID' }); // once, at app startup
    ```

    Importar el módulo no tiene efectos secundarios (es seguro para el renderizado en servidor). No se envía nada hasta que llames a `init()`.
  </Step>

  <Step title="Registra tu primera conversión">
    Llama a `scribe.track` allí donde se produzca una conversión, por ejemplo en el gestor de éxito de registro.

    ```js theme={null}
    scribe.track('signup', { value: 99.0, currency: 'USD', plan: 'pro' });
    ```

    El SDK captura por ti la atribución de clic de Scribe desde la URL de destino, agrupa tus eventos y los envía de forma fiable, incluso cuando el visitante abandona la página.
  </Step>

  <Step title="Comprobar que funciona">
    Activa el evento en tu sitio y abre **Analytics** en Scribe. Tus conversiones aparecen junto a las visualizaciones y los clics, desglosadas por firma, miembro del equipo, campaña y país.
  </Step>
</Steps>

## Referencia del SDK

### `scribe.track(name, metadata)`

Registra un evento. `name` es obligatorio, por ejemplo `signup`, `demo_booked` o `purchase`.

```js theme={null}
scribe.track('purchase', {
  value: 149.0,           // optional, monetary value of the conversion
  currency: 'EUR',        // optional, ISO currency code
  event_id: 'order_8821', // optional, your own id, used for idempotency
  plan: 'team',           // any other key becomes an event "property"
  seats: 5
});
```

* `value`, `currency` e `event_id` son campos de nivel superior reconocidos.
* **Cualquier otra clave** pasa a formar parte del `properties` del evento. Mantén las propiedades como valores escalares planos (cadenas, números, booleanos). No incluyas datos personales, como correos electrónicos o números de teléfono, en las propiedades: Scribe descarta automáticamente las claves que parecen datos personales.
* Proporciona tu propio `event_id` para que un envío pueda reintentarse de forma segura. El mismo `event_id` recibido dos veces en 24 horas se registra una sola vez.

### `scribe.identify(userId, traits)`

Asocia al visitante con uno de tus propios usuarios, para que veas qué firmas captan a qué clientes. Útil para B2B y trabajo por cuentas.

```js theme={null}
scribe.identify('user_42', { email: 'ada@example.com', name: 'Ada', plan: 'pro' });
```

Tras una llamada a `identify`, las llamadas posteriores a `track` quedan vinculadas a ese usuario. Llama a `scribe.reset()` al cerrar sesión para borrar la identidad.

### `scribe.flush()`

Los eventos se agrupan y se envían automáticamente, y siempre al ocultarse la página. Llama a `flush()` solo si necesitas forzar el envío inmediato del lote actual.

### Atributos del snippet

Cuando uses el snippet de script, configúralo con los atributos `data-*`:

| Atributo             | Obligatorio | Descripción                                                                                               |
| -------------------- | ----------- | --------------------------------------------------------------------------------------------------------- |
| `data-workspace`     | Sí          | Tu ID de Event Tracking.                                                                                  |
| `data-consent`       | No          | Ponlo en `"denied"` para desactivar el almacenamiento propio hasta que el visitante dé su consentimiento. |
| `data-cookie-domain` | No          | Define tu dominio raíz para compartir la identidad entre subdominios.                                     |

### Content Security Policy

Si tu sitio define una Content Security Policy, añade los hosts de Scribe a la lista de permitidos:

```
script-src  https://cdn-1.scribe-mail.com;
connect-src https://t.scribe-mail.com;
```

<Tip>
  ¿Necesitas registrar un evento autoritativo desde tu backend, como un pago que ha confirmado tu servidor? Scribe también acepta eventos a través de la API con una clave `events:write`, lo que mantiene los valores de ingresos fiables en lugar de depender del cliente. Consulta la [referencia de la API](/api-reference/introduction) para más detalles.
</Tip>

## Casos de uso: convierte las conversiones en crecimiento

El seguimiento de conversiones convierte tus firmas de correo electrónico en un canal de adquisición medible. Así es como los equipos aprovechan los datos, incluido su envío a campañas de remarketing de pago.

### Lanza campañas de remarketing en Google Ads y Meta Ads

Dispara los píxeles de conversión de tus plataformas publicitarias en el mismo punto en el que llamas a `scribe.track`, de modo que una única conversión llegue a la vez a Scribe, Google Ads y Meta. Scribe te indica que la conversión provino de una firma de correo electrónico; Google y Meta usan la misma señal para las pujas y las audiencias.

```js theme={null}
function onSignupComplete(plan, price) {
  // 1. Attribute the conversion to the email signature that drove it
  scribe.track('signup', { value: price, currency: 'USD', plan });

  // 2. Send the same conversion to your ad platforms for bidding and audiences
  // gtag('event', 'conversion', { send_to: 'AW-XXXXXXXXX/abc', value: price, currency: 'USD' });
  // fbq('track', 'CompleteRegistration', { value: price, currency: 'USD' });
}
```

### Crea audiencias de retargeting de alta intención

Las personas que hicieron clic en tu firma y llegaron a tu sitio, pero no convirtieron, son contactos cálidos. Usa Scribe para confirmar el tráfico procedente de firmas y, después, haz retargeting a esos visitantes con una oferta específica en Google y Meta. Como el tráfico procede de tus propios correos, estas audiencias suelen convertir mejor que la prospección en frío.

### Genera audiencias lookalike y similares a partir de tus convertidores

Tu mejor audiencia semilla son las personas que ya han convertido a través de un canal de confianza. Extrae los visitantes captados por las firmas (filtrando por firma, miembro del equipo o campaña), súbelos como Custom Audience en Meta o como lista de Customer Match en Google Ads y crea audiencias Lookalike o Similares a partir de esa semilla de alta calidad.

### Excluye a los clientes actuales del gasto de adquisición

Deja de pagar por adquirir a personas que ya se han registrado o han comprado. Exporta a tus conversores y añádelos como lista de exclusión o supresión en tus campañas de prospección, para que el presupuesto se destine a prospectos realmente nuevos.

### Optimiza por ingresos, no solo por clics

Envía un `value` y un `currency` reales con cada conversión. Con los ingresos asociados, puedes cambiar Google y Meta a pujas basadas en valor, y en Scribe puedes clasificar firmas, miembros del equipo y campañas por los ingresos que generan, no solo por los clics.

### Demuestra el canal y reasigna el presupuesto

El seguimiento de conversiones te permite comparar los ingresos generados por la firma de correo electrónico con los de tus canales pagados en los mismos términos. Cuando una campaña de firma supera a una campaña pagada, tienes las cifras para reasignar el presupuesto a lo que funciona.

## Pide a un agente de IA que lo configure

No tienes que montar esto a mano. Si usas un asistente de IA para programar (como Claude Code, Cursor o un agente similar en tu editor), pégale un prompt como este, con tu propio Event Tracking ID y las conversiones que te interesan:

```text theme={null}
Install the Scribe conversion tracking SDK on my website.

- If this is an app or single-page app, add the @scribemail/js package and call
  scribe.init({ id: 'YOUR_EVENT_TRACKING_ID' }) once at startup. If it is a plain
  HTML site, add the https://cdn-1.scribe-mail.com/v1/tracking.js script with
  data-workspace="YOUR_EVENT_TRACKING_ID" before </head> instead.
- Call scribe.track('signup', { value, currency }) from my signup success handler
  and scribe.track('purchase', { value, currency }) from my checkout confirmation.
- If I have logged-in users, call scribe.identify(userId, { email, plan }) after login.
- Add https://cdn-1.scribe-mail.com and https://t.scribe-mail.com to my Content
  Security Policy if I have one.
```

Una vez que las conversiones estén llegando, un agente conectado al [servidor MCP de Scribe](/es/ai-agents/connect) puede leer y explicarte los resultados. Pregúntale cosas como «¿qué firmas y miembros del equipo generaron más conversiones e ingresos este mes?» o «lista los visitantes que mis firmas adquirieron esta semana». Consulta [Scribe para agentes de IA](/es/ai-agents) y la [skill de analítica de Scribe](/es/ai-agents/skills) para ver qué puede extraer tu asistente.

## Privacidad y consentimiento

El seguimiento de conversiones está diseñado para respetar a tus visitantes y tus obligaciones:

* **Las direcciones IP se anonimizan.** Scribe aplica un hash a la IP antes de almacenarla. Nunca se conservan las IP en bruto.
* **Sin datos personales en las propiedades.** Las claves que parecen datos personales (correo electrónico, teléfono, contraseña, tokens, números de tarjeta y similares) se eliminan automáticamente de las propiedades de los eventos. Usa `identify` cuando quieras asociar deliberadamente un usuario.
* **Almacenamiento sujeto a consentimiento.** Configura `data-consent="denied"` (snippet) o `consent: false` (npm `init`) para que el SDK no almacene el identificador de clic hasta que el visitante dé su consentimiento.
* **Obtén el consentimiento antes de activar el seguimiento.** El ajuste de seguimiento del espacio de trabajo conlleva la misma responsabilidad que cualquier píxel analítico. Asegúrate de contar con el consentimiento que exige tu región antes de activarlo.

## Artículos relacionados

* [Resumen de analíticas](/es/analytics-overview): vistas, clics, alcance y CTR en tu espacio de trabajo.
* [Panel de analíticas](/es/analytics-dashboard): consulta las conversiones junto a las vistas y los clics en cada pestaña.
* [Analíticas de firma](/es/signature-analytics): rendimiento de una firma concreta.
* [Campañas de marketing](/es/marketing-overview): lanza y mide campañas de banners dentro de las firmas.
* [Scribe para agentes de IA](/es/ai-agents): deja que un asistente configure el seguimiento e informe sobre las conversiones.
