> 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 tracciamento 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 traffico generato dai referral. Ad esempio, potresti usare un parametro per registrare *Email* come il *mezzo di condivisione* ogni volta che qualcuno visita la landing page del tuo programma referral tramite un link email. Questo rende facile individuare le tendenze delle prestazioni nel traffico email.<br>

<div data-with-frame="true"><figure><img src="/files/ebdc599996f1d9df10c63d2cee3284c0042de947" alt=""><figcaption></figcaption></figure></div>

I parametri di tracciamento possono essere aggiunti a:

* [**Link della landing page**](https://help.impact.com/brand/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/configure-your-advocate-program#step-1-set-up-your-program) — L'URL della pagina web del tuo programma referral, cioè dove vuoi indirizzare il traffico.
* [**Link di condivisione**](https://help.impact.com/brand/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/assign-vanity-share-links-or-referral-codes) — Link generati automaticamente che i tuoi advocate usano per segnalare amici al tuo programma.
* [**Link dei messaggi**](https://help.impact.com/brand/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/message-links-explained) — 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 landing page, 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” in modo che tu sappia che il traffico proviene da una segnalazione 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 invece che, 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 parametri statici, vengono aggiunti i seguenti parametri dinamici. I valori dei parametri dinamici cambiano a seconda di quale advocate segnala il cliente, del primo touchpoint del programma con cui ha interagito e del canale che ha usato per condividere il link con gli amici:

* **`rsCode=JOHNDOE`** — Questo mostra quale advocate ha condiviso il link e dovrebbe essere premiato se un nuovo cliente si iscrive tramite il link, ad esempio è stato accreditato John Doe.
* **`rsEngagementMedium=EMBED`** — Questo mostra il punto di partenza dell'advocate quando ha interagito per la prima volta con il link, ad esempio 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 esempio 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 parametri di tracciamento aggiuntivi da aggiungere alla fine dei link del tuo programma referral. È utile per tracciare dettagli più specifici, come il codice sconto per poter dare sconti agli amici segnalati, oppure il gruppo di messaggi per 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ò influirà sul comportamento dei tuoi link:

* Eventuali parametri inclusi direttamente nell'URL della landing page configurata verranno sempre mantenuti.
* Non è consigliato rimuovere o modificare il valore dei tre parametri UTM predefiniti.
* Se rimuovi o sovrascrivi uno dei 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 landing page.
* Tutti i parametri personalizzati che aggiungi devono avere valori impostati e statici. I valori dinamici non sono supportati.
* Per garantire dati di report coerenti, evita di aggiungere parametri personalizzati duplicati.

#### Passaggio 1: aggiungi parametri personalizzati a una landing page

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 landing page configurata verranno sempre mantenuti

{% hint style="info" %}
**Esempio:** Se aggiungi **`discountCode=REFERRED20`**, l'URL risultante della landing page sarà simile a: `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 landing page

{% hint style="info" %}
**Esempio:** Se aggiungi **`influencer_ID=carrie_oakey`** alla fine dell'URL del tuo sharelink, l'URL risultante della landing page sarà simile a: `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 landing page, insieme a eventuali 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 risultante della landing page sarà simile a: `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 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://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-tracking/advocate-tracking-parameters-explained.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.