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

# Atribución

> Clasifica el tráfico en canales con reglas que tú controlas y reescribe el historial cuando las cambies.

![Sección Filtros con las reglas de atribución ordenadas por prioridad, con sus condiciones, operaciones y etiquetas](https://www.notifuse.com/docs/assets/screenshots/web_analytics/filters.png)

Cada visita llega con señales en bruto: un referente, algunos parámetros UTM y quizá un ID de clic de anuncio. Las reglas de atribución convierten esas señales en un **Canal** y un **Grupo de canales** sobre los que puedes hacer informes.

Tu propio sitio nunca cuenta como una de esas señales. Si el referente está en el mismo host que la página a la que llevó, se descarta y la visita se registra como **directo**. Una sesión termina tras 30 minutos de inactividad, así que un visitante que vuelve a una pestaña, o que hace clic después de una lectura larga, empieza una sesión nueva con una de tus propias páginas como referente.

Otro host sí es una referencia real y se conserva: si `docs.example.com` enlaza a `www.example.com`, aparece en tus informes.

## Reglas predeterminadas

Un espacio de trabajo nuevo empieza con 40 reglas que cubren búsqueda de pago, redes sociales de pago, vídeo de pago, display, búsqueda orgánica, redes sociales orgánicas, correo y tráfico directo. Son reglas normales: puedes editar o eliminar cualquiera.

| Prioridad | Familia                                                                         |
| --------- | ------------------------------------------------------------------------------- |
| 900 a 831 | De pago, identificado por el ID de clic de anuncio                              |
| 830 a 770 | De pago, identificado por un origen UTM conocido junto con un medio UTM de pago |
| 760       | Display de pago, identificado por el referente                                  |
| 750       | Directo, declarado con `utm_source=direct` y `utm_medium=none`                  |
| 745       | Correo                                                                          |
| 740       | Tráfico directo: sin referente _y_ sin parámetros de campaña                    |
| 705 a 650 | Búsqueda orgánica                                                               |
| 600 a 510 | Redes sociales orgánicas                                                        |
| 10        | Regla de reserva (`not-mapped`)                                                 |

> [!NOTE]
>
> La regla de correo está por encima de la de tráfico directo a propósito. Muchos clientes de correo eliminan el referente, así que un clic desde un correo parecería alguien que escribe tu dirección a mano. Por eso tus envíos masivos deben llevar parámetros UTM.

> [!WARNING]
>
> No hay ninguna regla predefinida para el tráfico de **referencia**. Un clic normal en un enlace desde otro sitio no coincide con ninguna regla y acaba en `not-mapped`, y es intencionado: así aparece en la pestaña Filtros, donde puedes clasificar esos referentes una vez, en lugar de quedar archivado sin que lo veas. Añade tu propia regla sobre Referrer Domain cuando quieras un canal de referencia.
>
> Por el mismo motivo, las reglas UTM de pago exigen un origen _conocido_ además de un medio de pago: `utm_medium=cpc` desde una red para la que Notifuse no incluye regla cae en `not-mapped` y no se considera de pago.

## Cómo se aplican las reglas

Las reglas se ejecutan por prioridad, de la más alta a la más baja, y **todas las reglas que coinciden contribuyen**: la evaluación no se detiene en la primera coincidencia.

La precedencia se decide por destino, no por regla:

- Para cada destino, gana la regla de mayor prioridad que lo escribe.
- Una regla de menor prioridad puede escribir un destino que ninguna regla de mayor prioridad haya reclamado. Por eso una regla que solo define `custom_3` se aplica aunque una regla de mayor prioridad ya haya definido el canal.
- Si dos reglas que coinciden tienen la _misma_ prioridad, se ejecutan las dos y la segunda sobrescribe a la primera: en caso de empate gana la última regla, no la primera.
- `set as default` nunca reclama un destino, así que un `set` de menor prioridad sigue sustituyendo un valor predeterminado escrito antes. Así funciona la regla de reserva de prioridad 10.

## Escribir una regla

Una regla es un conjunto de condiciones y los valores que se escriben cuando todas coinciden. Una regla sin condiciones coincide siempre, como la regla predefinida Default Channel, y se puede guardar así.

![Edición de la regla iPhone General: detalles, una condición regex sobre Landing Path junto a una operación que define Product line, el orden de las reglas, las comprobaciones, una prueba rápida que coincide y la tarjeta Cuándo se aplica](https://www.notifuse.com/docs/assets/screenshots/web_analytics/edit_rule.png)

- Las **Condiciones** prueban cualquier señal registrada: el referente, su dominio y su ruta, si la visita es directa, la página de destino, su dominio y su ruta, la ruta actual, cada parámetro UTM y el ID de clic de anuncio, además del dispositivo, el navegador, el tipo de navegador, el sistema operativo, el user agent, el tipo de conexión, el idioma y la zona horaria.
- Los **operadores** son `equals`, `not equals`, `contains`, `not contains`, `is empty`, `is not empty` y `regex`.
- Las **Operaciones** pueden hacer `set` de un valor, hacer `set` solo como valor _predeterminado_ donde nada más haya escrito uno, o hacer `unset`.
- Los **destinos** son Canal, Grupo de canales, cualquiera de los cinco campos UTM, Referrer Domain, Is Direct y de `custom_1` a `custom_10`.

Una regla que escribe una dimensión personalizada clasifica tráfico que no pudiste etiquetar en el origen. Por ejemplo, el referente de un socio puede convertirse en el nombre de ese socio sin pedirle que añada parámetros.

### El editor de reglas

**Añadir**, o el botón de edición de una regla en la pestaña Filtros, abre el editor a todo el ancho. La barra muestra el nombre y la prioridad de la regla, **Cambios sin guardar** en cuanto la editas, y los botones **Descartar** y **Guardar cambios** (**Crear regla** si es nueva).

- **Detalles**: nombre, prioridad de 0 a 1000, si está habilitada y las etiquetas.
- **Condiciones** y **Operaciones** se muestran una al lado de otra en una pantalla ancha.
- **Orden de las reglas** lista las reglas que también escriben las dimensiones que escribe esta regla, en el orden en que se ejecutan (primero la prioridad más alta, y las prioridades iguales en el orden de la lista), con lo que lee y escribe cada una, dos a cada lado de esta regla. **Mostrar todas las reglas** las lista todas.
- **Comprobaciones** se actualiza mientras escribes:
  - si cada condición y cada operación "set" tiene un valor, y **Coincide siempre** para una regla sin condiciones;
  - cada expresión regular: si es válida, si el servidor la rechaza (una aserción lookaround o una referencia inversa), si no es una expresión regular válida y quizá se rechace al guardar, o si usa una sintaxis que solo lee el motor RE2 del servidor, como `\A`, `\z`, `\Q…\E`, `\p{…}`, `[[:alpha:]]` o `(?U)`. El navegador no puede probar este último tipo; el servidor lo comprueba al guardar;
  - las reglas habilitadas que **se ejecutan antes** y pueden impedir que esta regla escriba una dimensión, y las que **se ejecutan después** y pueden sobrescribirla. Si la regla está deshabilitada, la comprobación indica en su lugar que no se ejecuta y no escribe nada.
- **Prueba rápida** solo pide los campos que lee la regla, muestra el resultado de cada condición para esa visita y los valores que escribe la regla cuando coincide. No se guarda ni se envía nada. **Abrir el probador** lleva la visita al [probador de reglas](#test-your-rules).
- **Cuándo se aplica**: a las sesiones nuevas desde el momento en que guardas, a las sesiones pasadas tras un [backfill](#changing-rules-later), y el estado del último backfill.

La tecla Escape no cierra el editor, y si lo cierras con cambios sin guardar te pide confirmación antes de descartarlos. Los miembros sin permiso de escritura en Analíticas web abren las reglas en solo lectura: el formulario está deshabilitado, el botón de guardar explica por qué y la prueba rápida sigue funcionando.

## Probar tus reglas

![Probar todas las reglas, rellenado desde una URL de destino con parámetros UTM y un gclid: los campos UTM y Páginas rellenos, y las reglas que coinciden con los valores que escribe cada una](https://www.notifuse.com/docs/assets/screenshots/web_analytics/rule_tester.png)

El probador pasa una visita que tú describes por las reglas, en tu navegador, y actualiza los resultados mientras escribes. No se guarda ni se envía nada. **Prueba**, en la pestaña Filtros, ejecuta todas las reglas guardadas. **Abrir el probador**, en el editor, ejecuta la regla que estás editando, con los cambios sin guardar, a partir de los valores de la prueba rápida.

Los campos de la visita se agrupan por tipo, con el número de campos que rellenaste en cada grupo. Los campos vacíos cuentan como valores vacíos. **Borrar la visita** los vacía, y al cerrar el probador se olvida la visita.

**Empezar desde un enlace** rellena los campos a partir de una URL de destino: Landing Page, Landing Domain, Landing Path y Current Path, los cinco parámetros UTM, y UTM ID y UTM ID From a partir del primer [ID de clic de anuncio](#ad-click-ids) presente. Los campos de referente y de dispositivo se quedan como los escribiste.

- Un enlace sin esquema se lee como `https://`. Cualquier dirección que no sea http o https se rechaza.
- Solo se reconocen los trece ID de clic predeterminados, así que un enlace con un ID de clic que añadiste con `extraAdClickIds` deja UTM ID vacío aquí. Escríbelo tú.
- Un `%` que no va seguido de dos dígitos hexadecimales en la ruta o el fragmento, como en `/50%off`, hace que el enlace esté mal formado. El servidor no puede leerlo y registra un dominio y una ruta de destino vacíos, así que el probador también los deja vacíos y explica por qué.

Al probar todas las reglas, el probador las reparte en pestañas, de mayor a menor prioridad, cada una con el resultado de cada condición frente a la visita:

| Pestaña                 | Reglas                                                                                                                                                            |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Coinciden**           | Reglas habilitadas cuyas condiciones coinciden todas, con los valores que escribe cada una.                                                                       |
| **No coinciden**        | Reglas habilitadas con una condición que falla.                                                                                                                   |
| **No se pueden probar** | Reglas habilitadas que ninguna condición descarta, pero con una expresión regular que solo lee el servidor. La pestaña solo aparece cuando contiene alguna regla. |
| **Deshabilitado**       | Reglas que nunca se ejecutan, coincidan o no.                                                                                                                     |

> [!NOTE]
>
> El probador muestra lo que escribe cada regla que coincide por separado. No aplica la [precedencia](#how-rules-are-applied) para dar los valores finales del canal o de las dimensiones: si la regla de reserva indica "default to `not-mapped`" junto a una regla que define `google-ads`, la visita termina como `google-ads`.

## ID de clic de anuncio

El tracker reconoce trece ID de clic de anuncio en la URL de destino, en este orden:
`gclid` (Google Ads), `fbclid` (Meta), `msclkid` (Microsoft), `dclid` (Google
Display), `twclid` (X), `ttclid` (TikTok), `li_fat_id` (LinkedIn), `wbraid` y
`gbraid` (Google Ads), `epik` (Pinterest), `ScCid` (Snapchat), `rdt_cid` (Reddit)
y `qclid` (Quora).

El primero presente se guarda en `utm_id`, y el parámetro del que procede en
`utm_id_from`, así que un clic de pago se puede atribuir aunque la campaña haya
olvidado sus UTM. "Primero" se refiere al orden de esa lista, no al de la URL: un
enlace con `gclid` y `fbclid` se atribuye a Google.

La coincidencia no distingue mayúsculas de minúsculas: `?sccid=`, `?ScCid=` y
`?SCCID=` se reconocen igual, y `utm_id_from` siempre guarda la grafía canónica de
arriba, que es la que usan las reglas incluidas.

> [!NOTE]
>
> Para capturar un ID de clic propio **además** de esos trece, define
> `extraAdClickIds: ['myclid']` en `NotifuseAnalyticsConfig`. También existe
> `adClickIds`, pero **sustituye** la lista entera, y `adClickIds: []` no captura
> ninguno: úsalo solo si es lo que quieres. Una regla que compara `utm_id_from`
> solo se activa con un parámetro que el tracker tenga configurado para capturar.

## Cambiar las reglas más adelante

Las reglas se aplican cuando se registra una visita, así que editarlas cambia lo que pasa a partir de ese momento, no lo que ya pasó. Para aplicarlas al tráfico existente, ejecuta un **backfill** desde la pestaña Filtros.

Un backfill reescribe las columnas de atribución de las filas históricas de **sesiones y objetivos**, lo que actualiza los "ingresos por canal" del tráfico pasado. Nunca añade, elimina ni cambia la fecha del tráfico, y no toca en absoluto las filas de vistas de página.

> [!WARNING]
>
> Un backfill **vacía** el canal y el grupo de canales en cualquier fila que sus reglas no escriban.
> Esos dos valores solo existen porque una regla los definió, así que "ninguna regla coincide" significa vacío.
>
> Las dimensiones personalizadas no se tocan, porque tu tracker puede definirlas sin
> intervención de ninguna regla. Una regla que apunta a una de ellas sigue
> reescribiendo las filas con las que coincide, y una regla `unset_value` sigue
> vaciándolas, pero una fila con la que no coincide ninguna regla conserva lo que
> envió tu sitio. Por eso, un valor personalizado escrito por una regla sobrevive
> a la eliminación de esa regla, ya que después nada permite distinguirlo de uno
> enviado por el tracker. Bórralo con una regla `unset_value` temporal.

> [!WARNING]
>
> Solo se ejecuta un backfill a la vez por espacio de trabajo. Al cancelarlo se detiene donde esté; las particiones ya reescritas conservan sus valores nuevos, así que una ejecución cancelada deja tus datos en un estado mixto hasta que la vuelvas a lanzar.

## De dónde viene el tráfico

Los envíos masivos añaden parámetros UTM a sus enlaces (consulta [Campañas de envío masivo → Seguimiento UTM](https://www.notifuse.com/es/docs/features/broadcast-campaigns.md#utm-tracking)). La regla de correo predefinida busca esos parámetros, así que el tráfico de las campañas se clasifica sin trabajo extra.

## Notas

- La atribución se resuelve por sesión, a partir de la página de destino. Un visitante que llega desde un buscador y luego hace clic en uno de tus correos empieza una sesión nueva con su propia atribución una vez terminada la primera.
- Los objetivos parten de la atribución de su sesión y después vuelven a ejecutar las reglas con la ruta de página _propia_ del objetivo. Un objetivo coincide con su sesión salvo que alguna de tus reglas pruebe la ruta actual.
- El conjunto de reglas se versiona con un hash que el servidor recalcula en cada guardado. La consola lo compara con la versión del último backfill completado para avisarte cuando tu historial se atribuyó con otro conjunto de reglas. Un backfill reescribe todas las filas históricas, no solo las desactualizadas.
- [Referencia de la API](https://www.notifuse.com/docs/api-reference.md)
