> ## 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.

# Attribuzione

> Classifica il traffico in canali con regole che controlli tu, e riscrivi lo storico quando le modifichi.

![Sezione Filtri con le regole di attribuzione in ordine di priorità, con condizioni, operazioni e tag](https://www.notifuse.com/docs/assets/screenshots/web_analytics/filters.png)

Ogni visita arriva con dei segnali grezzi: un referrer, alcuni parametri UTM, a volte un ID di clic pubblicitario. Le regole di attribuzione li trasformano in un **Canale** e in un **Gruppo di canali** su cui puoi fare report.

Il tuo sito non è mai uno di questi segnali: un referrer sullo stesso host della pagina a cui ha portato viene scartato e la visita viene registrata come **diretto**. Una sessione termina dopo 30 minuti di inattività, quindi un visitatore che torna su una scheda, o che clicca dopo una lunga lettura, avvia una nuova sessione con una delle tue pagine come referrer. Un altro host è invece un vero referral e viene mantenuto: `docs.example.com` che rimanda a `www.example.com` compare nei tuoi report.

## Regole predefinite

Un nuovo workspace parte con 40 regole che coprono ricerca a pagamento, social a pagamento, video a pagamento, display, ricerca organica, social organico, email e traffico diretto. Sono regole come le altre: puoi modificarle o eliminarle tutte.

| Priorità     | Famiglia                                                                              |
| ------------ | ------------------------------------------------------------------------------------- |
| Da 900 a 831 | A pagamento, riconosciuto dall'ID di clic pubblicitario                               |
| Da 830 a 770 | A pagamento, riconosciuto da una UTM source nota insieme a una UTM medium a pagamento |
| 760          | Display a pagamento, riconosciuto dal referrer                                        |
| 750          | Diretto, dichiarato da `utm_source=direct` e `utm_medium=none`                        |
| 745          | Email                                                                                 |
| 740          | Traffico diretto: nessun referrer _e_ nessun parametro di campagna                    |
| Da 705 a 650 | Ricerca organica                                                                      |
| Da 600 a 510 | Social organico                                                                       |
| 10           | Ripiego (`not-mapped`)                                                                |

> [!NOTE]
>
> La regola Email sta sopra quella del traffico diretto di proposito. Molti client di posta eliminano il referrer, quindi un clic da un'email sembrerebbe altrimenti qualcuno che digita il tuo indirizzo. Per questo i tuoi broadcast dovrebbero avere parametri UTM.

> [!WARNING]
>
> Non esiste una regola predefinita per il traffico **referral**. Un semplice clic su un link da un altro sito non corrisponde a nessuna regola e finisce in `not-mapped`, ed è voluto: compare nella scheda Filtri, dove puoi classificare quei referrer una volta per tutte, invece di essere archiviato senza che tu lo veda. Aggiungi una tua regola su Referrer Domain quando vuoi un canale referral.
>
> Per lo stesso motivo, le regole UTM a pagamento richiedono una sorgente _nota_ oltre a un medium a pagamento: `utm_medium=cpc` da una rete per cui Notifuse non fornisce regole finisce in `not-mapped` invece di essere considerato a pagamento.

## Come vengono applicate le regole

Le regole vengono eseguite in ordine di priorità, dalla più alta, e **ogni regola che corrisponde contribuisce**: la valutazione non si ferma alla prima corrispondenza.

La precedenza vale per destinazione, non per regola:

- Per ogni destinazione vince la regola con la priorità più alta che la scrive.
- Una regola con priorità più bassa può comunque scrivere una destinazione che nessuna regola più prioritaria ha già preso. Una regola che imposta solo `custom_3` si applica quindi anche quando una regola più prioritaria ha già impostato il canale.
- Due regole che corrispondono con la _stessa_ priorità vengono eseguite entrambe, e l'ultima sovrascrive: a parità di priorità vince l'ultima regola, non la prima.
- `set as default` non prende mai una destinazione, quindi un `set` con priorità più bassa sovrascrive comunque un valore predefinito scritto prima. È così che funziona la regola di ripiego con priorità 10.

## Scrivere una regola

Una regola è un insieme di condizioni e i valori da scrivere quando tutte corrispondono. Una regola senza condizioni corrisponde sempre, come la regola predefinita Default Channel, e si può salvare così.

![Modifica della regola iPhone General: dettagli, una condizione regex su Landing Path accanto a un'operazione che imposta Product line, l'ordine delle regole, i controlli, un test rapido che corrisponde e la scheda Quando si applica](https://www.notifuse.com/docs/assets/screenshots/web_analytics/edit_rule.png)

- Le **Condizioni** verificano qualsiasi segnale tracciato: il referrer, il dominio e il percorso del referrer, is-direct, la pagina, il dominio e il percorso di atterraggio, il percorso corrente, ogni parametro UTM e l'ID di clic pubblicitario, oltre a dispositivo, browser, tipo di browser, sistema operativo, user agent, tipo di connessione, lingua e fuso orario.
- Gli **operatori** sono `equals`, `not equals`, `contains`, `not contains`, `is empty`, `is not empty` e `regex`.
- Le **Operazioni** poi impostano un valore con `set`, lo impostano con `set` solo come _predefinito_ dove nessun'altra regola ne ha scritto uno, oppure lo rimuovono con `unset`.
- Le **destinazioni** sono Channel, Channel Group, uno qualsiasi dei cinque campi UTM, Referrer Domain, Is Direct e da `custom_1` a `custom_10`.

Una regola che scrive una dimensione personalizzata classifica traffico che non hai potuto etichettare alla fonte: il referrer di un partner può diventare il nome del partner, senza chiedere al partner di aggiungere parametri.

### L'editor delle regole

**Aggiungi**, o il pulsante di modifica di una regola nella scheda Filtri, apre l'editor a tutta larghezza. La barra mostra il nome e la priorità della regola, **Modifiche non salvate** quando la modifichi, e i pulsanti **Scarta** e **Salva modifiche** (**Crea regola** per una regola nuova).

- **Dettagli**: nome, priorità da 0 a 1000, abilitazione e tag.
- **Condizioni** e **Operazioni** stanno affiancate su uno schermo largo.
- **Ordine delle regole** elenca le regole che scrivono anche le dimensioni scritte da questa regola, nell'ordine in cui vengono eseguite (prima la priorità più alta, a parità di priorità nell'ordine della lista), con ciò che ognuna legge e scrive, due prima e due dopo questa regola. **Mostra tutte le regole** le elenca tutte.
- I **Controlli** si aggiornano mentre scrivi:
  - se ogni condizione e ogni operazione "set" ha un valore, e **Corrisponde sempre** per una regola senza condizioni;
  - ogni espressione regolare: valida, rifiutata dal server (un lookaround o un backreference), non valida e forse rifiutata al salvataggio, oppure scritta in una sintassi che legge solo il motore RE2 del server, come `\A`, `\z`, `\Q…\E`, `\p{…}`, `[[:alpha:]]` o `(?U)`. Il browser non può testare quest'ultimo tipo, che il server controlla al salvataggio;
  - le regole abilitate che **vengono eseguite prima** e possono impedire a questa regola di scrivere una dimensione, e quelle che **vengono eseguite dopo** e possono sovrascriverla. Per una regola disabilitata, il controllo dice invece che non viene eseguita e non scrive nulla.
- **Test rapido** chiede solo i campi che la regola legge, mostra il risultato di ogni condizione per quella visita e i valori che la regola scrive quando corrisponde. Nulla viene salvato o inviato. **Apri il tester** porta la visita nel [tester delle regole](#test-your-rules).
- **Quando si applica**: le nuove sessioni dal momento in cui salvi, le sessioni passate dopo un [backfill](#changing-rules-later), e lo stato dell'ultimo backfill.

Il tasto Esc non chiude l'editor, e se lo chiudi con modifiche non salvate ti chiede conferma prima di scartarle. I membri senza permesso di scrittura su Web Analytics aprono le regole in sola lettura: il modulo è disabilitato, il pulsante di salvataggio spiega perché, e il test rapido funziona comunque.

## Testare le regole

![Testa tutte le regole, compilato da un URL di atterraggio con parametri UTM e un gclid: i campi UTM e Pagine compilati, e le regole corrispondenti con i valori che ognuna scrive](https://www.notifuse.com/docs/assets/screenshots/web_analytics/rule_tester.png)

Il tester fa passare una visita che descrivi tu attraverso le regole, nel tuo browser, e aggiorna i risultati mentre scrivi. Nulla viene salvato o inviato. **Test** nella scheda Filtri esegue tutte le regole salvate. **Apri il tester** nell'editor esegue la regola che stai modificando, comprese le modifiche non salvate, partendo dai valori del test rapido.

I campi della visita sono raggruppati per tipo, con il numero di campi compilati in ogni gruppo. I campi vuoti contano come valori vuoti. **Cancella visita** li svuota, e chiudendo il tester la visita viene dimenticata.

**Parti da un link** compila i campi da un URL di atterraggio: Landing Page, Landing Domain, Landing Path e Current Path, i cinque parametri UTM, e UTM ID e UTM ID From dal primo [ID di clic pubblicitario](#ad-click-ids) presente. I campi del referrer e del dispositivo restano come li hai scritti.

- Un link senza schema viene letto come `https://`. Qualsiasi indirizzo diverso da http o https viene rifiutato.
- Vengono riconosciuti solo i tredici ID di clic predefiniti, quindi un link con un ID di clic aggiunto con `extraAdClickIds` lascia vuoto UTM ID. Inseriscilo tu.
- Un `%` non seguito da due cifre esadecimali nel percorso o nel frammento, come in `/50%off`, rende il link malformato: il server non riesce a leggerlo e registra dominio e percorso di atterraggio vuoti, quindi anche il tester li lascia vuoti e spiega perché.

Testando tutte le regole, il tester le divide in schede, dalla priorità più alta, ognuna con il risultato di ogni condizione rispetto alla visita:

| Scheda                 | Regole                                                                                                                                                            |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Corrispondenti**     | Regole abilitate le cui condizioni corrispondono tutte, con i valori che ognuna scrive.                                                                           |
| **Non corrispondenti** | Regole abilitate con almeno una condizione che non corrisponde.                                                                                                   |
| **Non testabili**      | Regole abilitate che nessuna condizione esclude, ma con un'espressione regolare che solo il server sa leggere. La scheda compare solo quando contiene una regola. |
| **Disabilitato**       | Regole che non vengono mai eseguite, qualunque cosa corrisponderebbero.                                                                                           |

> [!NOTE]
>
> Il tester mostra ciò che ogni regola corrispondente scrive da sola. Non applica la [precedenza](#how-rules-are-applied) per dare i valori finali del canale o delle dimensioni: quando la regola di ripiego dice "default to `not-mapped`" accanto a una regola che imposta `google-ads`, la visita finisce come `google-ads`.

## ID di clic pubblicitari

Il tracker riconosce tredici ID di clic pubblicitari nell'URL di atterraggio, in questo ordine:
`gclid` (Google Ads), `fbclid` (Meta), `msclkid` (Microsoft), `dclid` (Google
Display), `twclid` (X), `ttclid` (TikTok), `li_fat_id` (LinkedIn), `wbraid` e
`gbraid` (Google Ads), `epik` (Pinterest), `ScCid` (Snapchat), `rdt_cid` (Reddit)
e `qclid` (Quora).

Il primo presente finisce in `utm_id`, e il parametro da cui proviene in
`utm_id_from`, così un clic a pagamento resta attribuibile anche quando la campagna
ha dimenticato i parametri UTM. "Primo" significa primo in quella lista, non primo
nell'URL: un link che contiene sia `gclid` sia `fbclid` viene attribuito a Google.

Il confronto ignora maiuscole e minuscole: `?sccid=`, `?ScCid=` e `?SCCID=` vengono
tutti riconosciuti, e `utm_id_from` registra sempre la grafia canonica indicata sopra,
che è quella su cui si basano le regole integrate.

> [!NOTE]
>
> Per catturare un tuo ID di clic **in aggiunta** a quei tredici, imposta
> `extraAdClickIds: ['myclid']` in `NotifuseAnalyticsConfig`. Esiste anche `adClickIds`,
> che però **sostituisce** del tutto la lista, e `adClickIds: []` non ne cattura nessuno:
> usalo solo se è proprio quello che vuoi. Una regola su `utm_id_from` scatta solo per
> un parametro che il tracker è stato configurato per catturare.

## Modificare le regole in seguito

Le regole vengono applicate quando una visita viene registrata, quindi modificarle cambia ciò che succede da quel momento, non ciò che è già successo. Per applicarle al traffico esistente, avvia un **backfill** dalla scheda Filtri.

Un backfill riscrive le colonne di attribuzione delle righe storiche di **sessioni e obiettivi**, e così aggiorna il "fatturato per canale" del traffico passato. Non aggiunge, non rimuove e non cambia mai l'orario del traffico, e le righe delle visualizzazioni di pagina non vengono toccate.

> [!WARNING]
>
> Un backfill **cancella** Canale e Gruppo di canali su ogni riga che le sue regole non scrivono.
> Questi due valori esistono solo perché una regola li ha scritti, quindi "nessuna regola corrisponde" significa vuoto.
>
> Le dimensioni personalizzate restano invariate, perché il tuo tracker può impostarle senza
> che intervenga alcuna regola. Una regola che ne ha una come destinazione riscrive comunque le righe
> che corrispondono, e una regola `unset_value` le cancella comunque, ma una riga a cui non corrisponde
> nessuna regola conserva ciò che il tuo sito ha inviato. Di conseguenza, un valore personalizzato
> scritto da una regola sopravvive all'eliminazione di quella regola, perché in seguito nulla
> lo distingue da un valore fornito dal tracker. Per cancellarlo usa una regola `unset_value` temporanea.

> [!WARNING]
>
> In ogni workspace viene eseguito un solo backfill alla volta. L'annullamento lo ferma dove si trova: le partizioni già riscritte mantengono i nuovi valori, quindi un'esecuzione annullata lascia i dati in uno stato misto finché non la avvii di nuovo.

## Da dove arriva il traffico

I broadcast aggiungono parametri UTM ai loro link (vedi [Campagne broadcast → Tracciamento UTM](https://www.notifuse.com/it/docs/features/broadcast-campaigns.md#utm-tracking)). La regola Email predefinita cerca quei parametri, quindi il traffico delle campagne viene classificato senza lavoro aggiuntivo.

## Note

- L'attribuzione viene determinata per sessione, a partire dalla pagina di atterraggio. Un visitatore che arriva da una ricerca e poi clicca una delle tue email avvia, una volta terminata la prima sessione, una nuova sessione con la sua attribuzione.
- Gli obiettivi partono dall'attribuzione della loro sessione, poi rieseguono le regole con il percorso di pagina _proprio_ dell'obiettivo. Un obiettivo ha la stessa attribuzione della sua sessione, a meno che una delle tue regole non verifichi il percorso corrente.
- Il set di regole ha una versione, un hash che il server ricalcola a ogni salvataggio. La console lo confronta con la versione dell'ultimo backfill completato per avvisarti quando il tuo storico è stato attribuito con un set di regole diverso. Un backfill riscrive tutte le righe storiche, non solo quelle non aggiornate.
- [Riferimento API](https://www.notifuse.com/docs/api-reference.md)
