> 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 traffico proveniente dai referral. Ad esempio, puoi usare un parametro per registrare *Email* come *canale di condivisione* ogni volta che qualcuno visita la pagina di destinazione del tuo programma di referral tramite un link email. In questo modo, è facile individuare le tendenze di rendimento del traffico proveniente dalle 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>

Puoi aggiungere parametri di tracciamento a:

* [**Link della pagina di destinazione**](https://help.impact.com/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, ovvero la pagina verso cui vuoi indirizzare il traffico.
* [**Link di condivisione**](https://help.impact.com/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 promotori usano per invitare amici al tuo programma.
* [**Link nei messaggi**](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/message-links-explained.md) — Messaggi che i tuoi promotori possono condividere su diverse piattaforme e che includono elementi dinamici, come il loro link di condivisione.

### Quali parametri contengono i miei link?

#### Parametri statici

Quando un visitatore apre un link di condivisione o arriva sulla tua pagina di destinazione, vengono aggiunti per impostazione predefinita i seguenti parametri. Sono parametri statici, ovvero hanno valori fissi che non cambiano:

* <mark style="color:rosso;">**`utm_source=invite`**</mark> — Indica la provenienza del visitatore. Impostiamo il valore su “invite” per segnalare che il traffico proviene dal referral di un promotore.
* <mark style="color:rosso;">**`utm_medium=link`**</mark> — Indica come il visitatore è arrivato sulla tua pagina. Impostiamo il valore su “link” per indicare, ad esempio, che ha fatto clic su un link di referral anziché su un annuncio.
* <mark style="color:rosso;">**`utm_campaign=saasquatch`**</mark> — Indica a quale programma è associata la visita. “Saasquatch” è un valore segnaposto che identifica il tuo programma Advocate.

#### Parametri dinamici

Oltre ai parametri statici, vengono aggiunti i seguenti parametri dinamici. I relativi valori cambiano a seconda del promotore che invita il cliente, del punto di contatto del programma con cui è entrato in contatto per la prima volta e del canale usato per condividere il link con gli amici:

* **`rsCode=JOHNDOE`** — Indica quale promotore ha condiviso il link e dovrebbe ricevere il premio se un nuovo cliente si iscrive tramite quel link; ad esempio, il referral è stato attribuito a John Doe.
* **`rsEngagementMedium=EMBED`** — Indica il punto di partenza del promotore quando ha interagito per la prima volta con il link; ad esempio, un widget di referral incorporato nella tua pagina web.
* **`rsShareMedium=Email`** — Indica il canale usato dal promotore per condividere il link con gli amici; ad esempio, ha inserito 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 %}

### Aggiungere parametri personalizzati

Puoi scegliere altri parametri di tracciamento da aggiungere alla fine dei link del tuo programma di referral. È utile per monitorare dettagli più specifici, come il codice sconto, così da offrire sconti agli amici invitati, oppure il gruppo di messaggi, per confrontare le prestazioni di un canale con quelle di un altro.

#### Regole per l'aggiunta di parametri

Prima di aggiungere parametri personalizzati, è importante capire come questa operazione influirà sul comportamento dei tuoi link:

* Tutti i parametri inclusi direttamente nell'URL configurato della pagina di destinazione verranno sempre mantenuti.
* Ti sconsigliamo di 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 eliminati.
* Per sovrascrivere in modo efficace i valori predefiniti, devi includere **tutti e tre i parametri UTM predefiniti** e i relativi nuovi valori nell'URL della pagina di destinazione.
* I parametri personalizzati che aggiungi devono avere valori statici definiti. I valori dinamici non sono supportati.
* Per garantire dati di reportistica coerenti, evita di aggiungere parametri personalizzati duplicati.

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

Usa questo approccio per trasmettere codici sconto e valori di tracciamento interni, oppure quando vuoi applicare una regola a ogni singolo visitatore invitato.

* Tutti i parametri inclusi direttamente nell'URL della landing page configurata vengono sempre mantenuti

{% hint style="info" %}
**Esempio:** Se aggiungi **`discountCode=REFERRED20`**, l'URL risultante della landing page sarà simile a questo: `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 monitorare i dati relativi a uno specifico promotore e vedere quanti clienti porta.

* Puoi passare parametri personalizzati tramite un link di condivisione, ma non puoi sovrascrivere gli UTM predefiniti
* I 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 link di condivisione, l'URL risultante della landing page sarà simile a questo: `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 nel messaggio

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

* Puoi passare parametri personalizzati tramite un link nel messaggio usando `rsLandingPage` come parametro
* Includi l'URL della landing page, insieme a eventuali parametri personalizzati, in `rsLandingPage` come valore

{% hint style="info" %}
**Esempio:** Se includi **`rsLandingPage={https://acmecorporation.com/signup-page?email_test_group=A}`** nel link del messaggio, l'URL risultante della landing page sarà simile a questo: `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.
