# Configuración

## Identificación

{% hint style="info" %}
**Todos los eventos de monitoreo están asociados a un `mail_id` único por `recipient (to)`.** 
{% endhint %}

En el caso de que para un elemento `recipient` se incluyan `cc` o `bcc`, todos ellos compartirán el mismo `mail_id` y por ende cualquier acción que realicen (apertura, click, desuscripción, etc.) quedará asociada al mismo `mail_id`. 

Para evitar este comportamiento, se debería indicar cada uno como un `recipient` único.

## Activación

{% hint style="info" %}
**Por el momento** **sólo es posible configurar el monitoreo mediante la API HTTP**. En la API SMTP aún no está soportado.
{% endhint %}

La opciones de monitoreo se especifican dentro de la sección `tracking`. En caso de no especificarlas, se activarán por defecto tanto el monitoreo de aperturas como el de clicks.

```javascript
"tracking": { 
	"open": { 
		"enable": true 
	},
	"click": { 
		"enable": true
	},
	"ganalytics": {
		"utm_source": "Perfit",
		"utm_medium": "email",
		"utm_campaign": "my campaign",
		"utm_content": "",
		"utm_term": ""				
	}
}
```

{% hint style="info" %}
El monitreo de aperturas y clicks están sólo disponibles para el contenido de tipo `html`.
{% endhint %}

## Aperturas

Para el monitoreo de aperturas se incluye un tag `<img>` justo antes de cerrar el body del html, por lo que es necesario que en el cliente de email se visualicen las imágenes, en caso contrario no será contabilizada la apertura.

## Clicks

El monitoreo de los clicks se realiza reemplazando todos los enlaces (sólo los indicados en atributos `href`) por urls propias de Perfit que luego de contabilizar el click hacen un redirect al destino final.

### Intereses

Es posible indicar una serie de intereses asociados a un link. Estos intereses serán indicados junto a los eventos `track.mail.clicked`.&#x20;

La forma de asociar intereses mediante el atributo html `data-interests`. Es posible indicar más de un interés por link, separados por coma:

```markup
<a href="https://www.mydomain.com/prods/123" data-interests="electro,hogar">
    Link
</a>
```

### Desactivar monitoreo por link

Es posible desactivar el monitoreo de un link específico usando el atributo `data-track-disabled`.

```markup
<a href="https://www.mydomain.com/prods/123" data-track-disabled>
    Link no monitoreado
</a>
```

### Links variables

Existen casos en los que los links contienen partes variables, por ejemplo: `https://www.mydomain.com/prods/${product.id}`. El comportamiento por defecto es asociar los eventos de click a la URL original, antes del reemplazo.

Si lo que se desea es medir los clicks sobre cada URL final, es decir luego del reemplazo, es necesario usar el atributo `data-track-final-url`.

```markup
<a href="https://www.mydomain.com/prods/${product.id}" data-track-final-url>
    Link final monitoreado
</a>
```

## Google Analytics

Los parámetros utm indicados en `tracking.ganalytics` se incluirán en todos los links que se encuentren (sólo atributos `href`). Esto se hace independientemente de la activación del monitoreo de clicks.&#x20;

Sólo se incluyen en los links los parámetros utm que tengan un valor definido. En caso de que se encuentren links que ua incluyen alguno de los parámetros indicados, no se pisarán, conservando el valor original.

{% hint style="info" %}
Por el momento sólo es posible especificar los parámetros utm mediante la API HTTP. La API SMTP aún no soporta esta funcionalidad, y se deberán incluir los utm en forma individual en cada link.
{% endhint %}


---

# Agent Instructions: 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:

```
GET https://developers.myperfit.com/monitoreo/monitoreo-y-links-especiales.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.