> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-tracking/advocate-tracking-parameters-explained.md).

# Spiegazione dei parametri di tracking Advocate

I parametri di tracciamento sono frammenti di testo che possono essere aggiunti alla fine di un link. Consentono di inviare a impact.com dati specifici sul tuo traffico di referral. Ad esempio, puoi usare un parametro per registrare *Email* come il *mezzo di condivisione* ogni volta che qualcuno visita la pagina di destinazione del tuo programma di referral tramite un link email. Questo rende facile individuare le tendenze di performance nel tuo traffico email.<br>

<div data-with-frame="true"><figure><img src="https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FLWCRiIPynY7zLQ7P96hK%2FScreenshot%202026-02-19%20at%204.11.23%E2%80%AFPM.png?alt=media&amp;token=5761f8cd-4e3d-421f-b77c-df545151efd6" alt=""><figcaption></figcaption></figure></div>

I parametri di tracciamento possono essere aggiunti a:

* [**Link della pagina di destinazione**](/brand/it/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/configure-your-advocate-program.md#step-1-set-up-your-program) — L'URL della pagina web del tuo programma di referral, cioè dove vuoi che vada il traffico.
* [**Link di condivisione**](/brand/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/assign-vanity-share-links-or-referral-codes.md) — Link generati automaticamente che i tuoi advocate usano per segnalare amici al tuo programma.
* [**Link dei messaggi**](/brand/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/message-links-explained.md) — Messaggi che i tuoi advocate possono condividere su diverse piattaforme, che includono elementi dinamici come il loro link di condivisione.

### Quali parametri hanno i miei link?

#### Parametri statici

Quando un visitatore apre un link di condivisione o arriva sulla tua pagina di destinazione, i seguenti parametri vengono aggiunti per impostazione predefinita. Questi parametri sono statici, il che significa che hanno valori impostati che non cambiano:

* <mark style="color:rosso;">**`utm_source=invite`**</mark> — Questo mostra da dove proviene il visitatore. Impostiamo il valore su “invite” così sai che il traffico proviene da un referral di un advocate.
* <mark style="color:rosso;">**`utm_medium=link`**</mark> — Questo mostra come il visitatore è arrivato alla tua pagina. Impostiamo il valore su “link”, il che significa che ha fatto clic su un link di referral anziché, ad esempio, su un annuncio.
* <mark style="color:rosso;">**`utm_campaign=saasquatch`**</mark> — Questo mostra a quale programma è associata la visita. “Saasquatch” è un valore segnaposto per indicare il tuo programma Advocate.

#### Parametri dinamici

Oltre ai tuoi parametri statici, vengono aggiunti i seguenti parametri dinamici. I valori dei parametri dinamici cambiano a seconda di quale advocate segnala il cliente, con quale punto di contatto del programma ha avuto il primo contatto e quale canale ha usato per condividere il link con gli amici:

* **`rsCode=JOHNDOE`** — Questo mostra quale advocate ha condiviso il link e dovrebbe essere ricompensato se un nuovo cliente si registra tramite il link, ad es. John Doe è stato accreditato.
* **`rsEngagementMedium=EMBED`** — Questo mostra il punto di partenza dell'advocate quando ha interagito per la prima volta con il link, ad es. tramite un widget di referral incorporato nella tua pagina web.
* **`rsShareMedium=Email`** — Questo mostra quale canale l'advocate ha usato per condividere il link con gli amici, ad es. ha incluso il link in un'email.

{% hint style="info" %}
**Esempio:** `https://acmecorporation.com/signup-page?`<mark style="color:$primary;">**`utm_source=invite&utm_medium=link&utm_campaign=saasquatch`**</mark>**`&rsCode=OLIVERSUTTON&rsEngagementMedium=POPUP&rsShareMedium=WHATSAPP`**
{% endhint %}

### Aggiungi parametri personalizzati

Puoi scegliere ulteriori parametri di tracciamento che vuoi aggiungere alla fine dei link del tuo programma di referral. Questo è utile per tracciare dettagli più specifici, come il codice sconto, così puoi offrire sconti agli amici segnalati, oppure il gruppo del messaggio, così puoi confrontare le prestazioni di un canale rispetto a un altro.

#### Regole per l'aggiunta dei parametri

Prima di aggiungere parametri personalizzati, devi capire in che modo ciò influenzerà il comportamento dei tuoi link:

* Eventuali parametri inclusi direttamente nell'URL della tua pagina di destinazione configurata verranno sempre passati.
* Non è consigliato rimuovere o modificare il valore dei tuoi tre parametri UTM predefiniti.
* Se rimuovi o sovrascrivi uno dei tuoi parametri UTM predefiniti (ad es.  `utm_source=referral`), gli altri due verranno rimossi.
* Per sovrascrivere efficacemente i valori predefiniti, devi includere **tutti e tre i parametri UTM predefiniti** e i loro nuovi valori nell'URL della tua pagina di destinazione.
* Eventuali parametri personalizzati che aggiungi devono avere valori statici impostati. I valori dinamici non sono supportati.
* Per garantire dati di reporting coerenti, evita di aggiungere parametri personalizzati duplicati.

#### Passaggio 1: Aggiungi parametri personalizzati a una pagina di destinazione

Usa questo approccio per passare codici sconto e valori di tracciamento interni, oppure ogni volta che vuoi che una regola si applichi a ogni singolo visitatore segnalato.

* Eventuali parametri inclusi direttamente nell'URL della tua pagina di destinazione configurata verranno sempre passati

{% hint style="info" %}
**Esempio:** Se aggiungi **`discountCode=REFERRED20`**, l'URL della pagina di destinazione risultante avrà questo aspetto: `https://acmecorporation.com/signup-page?`**`discountCode=REFERRED20`**`&utm_source=invite&utm_medium=link&utm_campaign=saasquatch&rsCode=OLIVERSUTTON&rsEngagementMedium=POPUP&rsShareMedium=WHATSAPP`
{% endhint %}

#### Passaggio 2: Aggiungi parametri personalizzati a un link di condivisione

Usa questo approccio per tracciare dati relativi a un advocate specifico, così puoi vedere quanti clienti porta.

* Puoi passare parametri personalizzati tramite un link di condivisione, ma non puoi sovrascrivere gli UTM predefiniti
* Eventuali parametri personalizzati vengono aggiunti dopo i parametri della pagina di destinazione

{% hint style="info" %}
**Esempio:** Se aggiungi **`influencer_ID=carrie_oakey`** alla fine dell'URL del tuo link di condivisione, l'URL della pagina di destinazione risultante avrà questo aspetto: `https://acmecorporation.com/signup-page?discountCode=REFERRED20&utm_source=invite&utm_medium=link&utm_campaign=saasquatch&rsCode=OLIVERSUTTON&rsEngagementMedium=POPUP&rsShareMedium=WHATSAPP&`**`influencer_ID=carrie_oakey`**
{% endhint %}

#### Passaggio 3: Aggiungi parametri personalizzati a un link del messaggio

Usa questo approccio per tracciare e confrontare le prestazioni delle comunicazioni mirate.

* Puoi passare parametri personalizzati tramite un link del messaggio usando il `rsLandingPage` parametro
* Includi l'URL della tua pagina di destinazione — insieme a tutti i parametri personalizzati — all'interno del `rsLandingPage` valore

{% hint style="info" %}
**Esempio:** Se includi **`rsLandingPage={https://acmecorporation.com/signup-page?email_test_group=A}`** nel tuo link del messaggio, l'URL della pagina di destinazione risultante avrà questo aspetto: `https://acmecorporation.com/signup-page?discountCode=REFERRED20&utm_source=invite&utm_medium=link&utm_campaign=saasquatch&rsCode=OLIVERSUTTON&rsEngagementMedium=POPUP&rsShareMedium=WHATSAPP&influencer_ID=carrie_oakey&`**`email_test_group=A`**
{% endhint %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-tracking/advocate-tracking-parameters-explained.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.