> For the complete documentation index, see [llms.txt](https://docs.patagon.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.patagon.ai/es/marketing-y-atribucion/capturing-attribution-data.md).

# Cómo capturar datos de atribución

Antes de poder analizar algo, Patagon AI necesita capturar de dónde viene cada conversación de WhatsApp. Hay tres métodos de captura: configura los que apliquen a tu caso. Muchos equipos usan los tres.

El script de rastreo y el enlace de tu agente están en **Agente → Capacidades → Atribución**.

![Agente → Capacidades → Atribución](/files/HTNXFXNMjZt3xrPPus6n)

## Método 1: Botón de WhatsApp en un sitio web o landing page

Usa este método cuando los visitantes llegan a WhatsApp haciendo clic en un botón de tu sitio o landing page. Captura los UTMs, los click IDs (`fbclid`, `gclid`, etc.) y la URL de la página de cada visitante; los datos que Patagon usa luego para enviar conversiones de vuelta a tus plataformas publicitarias.

### Visión general del flujo

El flujo completo tiene tres etapas:

1. El visitante llega a la landing page con parámetros UTM y/o click IDs (`gclid`, `fbclid`) en la URL
2. El script de rastreo de Patagon AI lee esos parámetros y los incorpora al enlace del botón
3. Cuando el visitante abre WhatsApp, Patagon AI usa el código de referencia para asociar esa conversación a la campaña correcta

### Paso 1: Instalar el script de rastreo en la landing page

Ve a **Agente → Capacidades → Atribución**, copia el script de rastreo de una línea y pégalo antes del cierre de la etiqueta `</head>` en todas las páginas que tienen (o tendrán) un botón de WhatsApp vinculado a tu agente Patagon AI. Es el **mismo script para todas las páginas**:

```html
<script src="https://api.patagon.ai/api/v1/tracking.js"></script>
```

El script captura automáticamente todos los datos de campaña presentes en la URL de la página: parámetros UTM (`utm_source`, `utm_medium`, `utm_campaign`, `utm_content`, `utm_term`), el click ID de Google (`gclid`) y el click ID de Meta (`fbclid`).

{% hint style="info" %}
Si usas un constructor de landing pages (Elementor, Webflow, RD Station Landing Pages, Unbounce, etc.), pega el script en la sección de código personalizado del encabezado de la página. Si la plataforma no permite scripts personalizados, publica la landing page en un dominio propio donde tengas control del HTML.
{% endhint %}

### Paso 2: Configurar el botón de WhatsApp con el enlace de rastreo

Después de instalar el script, **reemplaza el enlace de tu botón de WhatsApp** por el enlace de rastreo generado por Patagon AI. Este enlace es único para cada agente y tiene este formato:

```
https://patg.ai/api/v1/r/agt_01HZ0R7NA78WSNXNN9VXYZABCD?text=¡Hola!%20Me%20gustaría%20más%20información.
```

Encuentras tu enlace completo y personalizado en **Agente → Capacidades → Atribución → Usa este enlace de rastreo en tu botón de WhatsApp**.

#### ¿Por qué no usar un enlace wa.me directo?

Un enlace `wa.me` común no tiene rastreo. Cuando el visitante hace clic en él, WhatsApp se abre, la conversación comienza, pero Patagon AI no sabe de dónde provino ese lead. El enlace de rastreo es lo que permite asociar la conversación a la campaña, al anuncio y a la palabra clave correctos.

#### Cómo personalizar el mensaje de apertura

El parámetro `text` define el mensaje que aparece prellenado cuando el visitante abre WhatsApp. Puedes personalizarlo por campaña agregando el parámetro directamente en la URL:

```
https://patg.ai/api/v1/r/agt_01HZ0R7NA78WSNXNN9VXYZABCD?text=Quiero%20saber%20más%20sobre%20el%20plan%20empresarial
```

Usa textos diferentes por campaña para que tu agente identifique el contexto desde el primer mensaje. Recuerda codificar los espacios como `%20` y caracteres especiales según el estándar URL encoding.

### Paso 3: Agregar parámetros UTM al enlace del anuncio

El script solo puede capturar lo que llega en la URL de la landing page. Por eso, tus anuncios necesitan pasar los UTMs correctamente.

Patagon AI organiza la atribución siguiendo esta jerarquía fija:

```
utm_source → utm_medium → utm_campaign → utm_content → utm_term
```

Esta jerarquía determina cómo se agrupan las conversaciones en **Leads → Atribución**, así que mantén la nomenclatura consistente en todo el equipo. Una convención recomendada:

| Parámetro      | Qué identifica                                 | Ejemplo                             |
| -------------- | ---------------------------------------------- | ----------------------------------- |
| `utm_source`   | El canal de origen                             | `meta`, `google`, `instagram`       |
| `utm_medium`   | El tipo de tráfico                             | `cpc`, `email`, `social`, `organic` |
| `utm_campaign` | La campaña específica                          | `lanzamiento-producto-q2`           |
| `utm_content`  | El conjunto de anuncios o variación            | `video-v1`, `headline-b`            |
| `utm_term`     | La palabra clave (Search) o nombre del anuncio | `crm-para-ventas`                   |

{% hint style="warning" %}
Los UTMs distinguen entre mayúsculas y minúsculas. `Facebook` y `facebook` aparecen como dos fuentes diferentes en el informe. Define la convención antes de lanzar y úsala en todo el equipo.
{% endhint %}

### Cómo funciona el rastreo por dentro

Cuando un visitante llega a la landing page con UTMs en la URL, el script de Patagon AI lee todos esos parámetros y los incorpora al shortlink de rastreo. Cuando el visitante hace clic en el botón de WhatsApp, un pequeño código de referencia se incluye en el mensaje que envía. En el momento en que ese mensaje llega a tu agente, Patagon AI usa ese código para atribuir automáticamente esa conversación a la campaña, al conjunto de anuncios y al anuncio correctos, sin ninguna acción adicional de tu parte.

Esto significa que la ventana de captura es el tiempo que el visitante pasa en la landing page. Si llega por la landing page con UTMs, cierra y vuelve después vía enlace directo sin UTMs, la atribución puede no capturarse. Para mitigar esto, mantén la ventana de sesión de la landing page activa mientras el visitante esté en la página.

### Probar el rastreo antes de lanzar la campaña

Probar antes de lanzar es lo que garantiza que no perderás datos de atribución de una campaña completa. Sigue estos pasos:

#### 1. Arma una URL de prueba con UTMs

Abre la URL de tu landing page en el navegador y agrega los parámetros UTM manualmente, simulando cómo llegaría la URL desde un anuncio:

```
https://tulandingpage.com/pagina?utm_source=meta&utm_medium=cpc&utm_campaign=prueba-rastreo&utm_content=video-v1&utm_term=palabra-clave
```

#### 2. Verifica si el script se cargó

Abre las herramientas de desarrollador del navegador (F12 → pestaña Network) y busca una solicitud a `api.patagon.ai/api/v1/tracking.js`. Si aparece con estado 200, el script se cargó correctamente.

#### 3. Haz clic en el botón y abre WhatsApp

Haz clic en el botón de WhatsApp de la landing page. WhatsApp (web o app) debe abrirse con el mensaje prellenado. Observa que el mensaje puede contener un código de referencia invisible al final. Esto es esperado y es lo que Patagon usa para atribución.

#### 4. Envía el mensaje y verifica en Leads → Atribución

Envía el mensaje por WhatsApp y espera unos minutos. En **Leads → Atribución**, la conversación debe aparecer bajo la fuente `meta → cpc → prueba-rastreo`. Si aparece como **no rastreado**, verifica:

* Si el script está en el `<head>` de la página (no solo en el `<body>`)
* Si el enlace del botón es el enlace de rastreo de Patagon, no un `wa.me` directo
* Si los UTMs están en la URL cuando accedes a la página (algunos constructores de landing pages eliminan parámetros por defecto, verifica las configuraciones)

#### 5. Prueba también con el enlace limpio

Accede a la landing page sin ningún UTM y haz clic en el botón. Esta conversación debe aparecer como **no rastreado**. Si aparece con alguna fuente, puede haber UTMs siendo heredados de otra sesión.

### Diferencias entre enlace wa.me y enlace de rastreo de Patagon

|                                        | Enlace directo `wa.me`                  | Enlace de rastreo Patagon                          |
| -------------------------------------- | --------------------------------------- | -------------------------------------------------- |
| **Formato**                            | `https://wa.me/5511999999999?text=Hola` | `https://patg.ai/api/v1/r/ID_DEL_AGENTE?text=Hola` |
| **Destino**                            | Número de WhatsApp fijo                 | El agente Patagon AI vinculado al número           |
| **Captura UTMs**                       | No                                      | Sí                                                 |
| **Captura gclid / fbclid**             | No                                      | Sí                                                 |
| **Captura URL de la página de origen** | No                                      | Sí                                                 |
| **Aparece en Leads → Atribución**      | Como "no rastreado"                     | Con fuente, campaña y anuncio                      |
| **Permite enrutamiento por campaña**   | No                                      | Sí (vía parámetros)                                |
| **Mensaje prellenado**                 | Sí (parámetro `text`)                   | Sí (parámetro `text`, personalizable por campaña)  |
| **Envía conversiones a Meta/Google**   | No                                      | Sí (cuando conversiones offline configuradas)      |

El enlace `wa.me` abre una conversación en WhatsApp, pero Patagon AI no puede rastrear de dónde provino el lead ni enviar conversiones de leads calificados de vuelta a tus plataformas de anuncios. El enlace de rastreo es lo que cierra ese ciclo.

### Ejemplo de configuración completa

A continuación un ejemplo de cómo queda el botón de WhatsApp en una landing page debidamente configurada:

```html
<!DOCTYPE html>
<html>
<head>
  <!-- Script de rastreo Patagon AI: instala UNA VEZ en el encabezado -->
  <script src="https://api.patagon.ai/api/v1/tracking.js"></script>
</head>
<body>

  <!-- Botón de WhatsApp usando el enlace de rastreo de Patagon AI -->
  <a href="https://patg.ai/api/v1/r/TU_ID_DE_AGENTE?text=¡Hola!%20Me%20gustaría%20más%20información.">
    Hablar con especialista en WhatsApp
  </a>

</body>
</html>
```

Cuando un usuario llega a esta página proveniente de un anuncio con UTMs en la URL, el script captura todo automáticamente. El botón no necesita ninguna lógica adicional.

## Método 2: Campañas Click-to-WhatsApp (solo Meta)

Para los anuncios Click-to-WhatsApp (CTWA) no etiquetas nada a mano. Solo **conecta tu cuenta de Meta** en **Leads → Atribución → Configuración → Conectar Plataformas** (mira [Cómo conectar Meta y mapear conversiones](/es/marketing-y-atribucion/meta-ads/meta-conversions-api.md)).

Una vez conectada Meta, cada conversación que provenga de un anuncio CTWA se completa automáticamente:

| Parámetro      | Valor                                   |
| -------------- | --------------------------------------- |
| `utm_source`   | `meta`                                  |
| `utm_medium`   | `cpc`                                   |
| `utm_campaign` | el nombre de la campaña CTWA            |
| `utm_content`  | el nombre del conjunto de anuncios CTWA |
| `utm_term`     | el nombre del anuncio CTWA              |

## Método 3: Enlace de Patagon AI con parámetros UTM

Usa este método donde no hay sitio web ni anuncio CTWA (códigos QR, botones en newsletters, materiales impresos, etc.). Toma el enlace de rastreo de tu agente (**Agente → Capacidades → Atribución**) y agrégale tus propios parámetros UTM:

```
https://patg.ai/api/v1/r/agt_01HZ0R7NA78WSNXNN9VXYZABCD?text=Hola!%20Me%20gustaría%20más%20información&utm_source={{source}}&utm_medium={{medium}}&utm_campaign={{campaign}}&utm_content={{content}}&utm_term={{term}}
```

| Parámetro      | Qué rastrea                   | Ejemplo                     |
| -------------- | ----------------------------- | --------------------------- |
| `utm_source`   | El canal                      | google, facebook, instagram |
| `utm_medium`   | El tipo de tráfico            | cpc, social, email, organic |
| `utm_campaign` | La campaña específica         | lanzamiento-producto-q2     |
| `utm_content`  | La variación creativa         | video-v1, headline-b        |
| `utm_term`     | La palabra clave (Google Ads) | crm para equipos de ventas  |

{% hint style="warning" %}
Los parámetros UTM distinguen entre mayúsculas y minúsculas. `Facebook` y `facebook` aparecen como dos fuentes diferentes. Define una convención de nomenclatura y úsala de forma consistente en todo tu equipo.
{% endhint %}

## Próximos pasos

* Mira tus datos capturados en [Cómo leer tus métricas de atribución](/es/marketing-y-atribucion/attribution-metrics.md).
* Envía conversiones de leads calificados de vuelta a tu plataforma publicitaria en [Cómo conectar Meta y mapear conversiones](/es/marketing-y-atribucion/meta-ads/meta-conversions-api.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.patagon.ai/es/marketing-y-atribucion/capturing-attribution-data.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.