> 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/partner/it/di-cosa-vorresti-saperne-di-piu/getting-started/migrate-your-rakuten-advertising-tracking-to-impact.com.md).

# Migra il tuo tracciamento Rakuten Advertising su impact.com

Questo articolo spiega ai partner come migrare la propria infrastruttura di tracciamento da Rakuten Advertising (LinkShare) a impact.com. Usalo per mappare i parametri dinamici, configurare i payload di segmentazione del pubblico e prevenire lacune nel tracciamento. Per domande sul collegamento degli account, sui reindirizzamenti dei link esistenti e sui pagamenti, consulta le [Domande frequenti sulla migrazione dei partner da Rakuten Advertising a impact.com](https://help.impact.com/partner/it/di-cosa-vorresti-saperne-di-piu/getting-started/rakuten-advertising-to-impact.com-partner-migration-faq.md).

## Confronto della struttura dei link

Ecco come un link di tracciamento legacy di Rakuten Advertising corrisponde al link equivalente nativo di impact.com:

```
Link Rakuten legacy 
https://click.linksynergy.com/fs-bin/click?id=[SID]&offerid=[OfferID]&type=3&subid=ABC&u1=QWERTYQWERTY&u5=eyI0MSI6ICIxMjMsNDU2NyJ9

Link equivalente nativo di impact.com 
https://brand.sjv.io/c/[MPID]/[AdID]/[CampaignID]?sharedid=ABC&subId1=QWERTYQWERTY&audiences=WyIxMjMiLCI0NTY3Il0
```

## Riferimento per la mappatura dei parametri

| Parametro di Rakuten Advertising | Parametro di impact.com      | Finalità e descrizione                                                                                                                        | Visibilità nei report                                                         |
| -------------------------------- | ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| `subid`                          | `sharedid` *(o `subacctid`)* | ID del sub-partner: identifica i sub-partner a valle o le fonti delle sub-reti.                                                               | Visibile al brand e al partner (supporta regole di pagamento personalizzate). |
| `u1`                             | `subId1`                     | ID del clic o del membro del partner: usato per gli ID univoci dei membri dei programmi fedeltà, i token dei clic o gli ID delle transazioni. | Visibile solo al partner (nei report sulle prestazioni del partner).          |
| `u5`                             | `audiences`                  | Segmento di pubblico: metadati dei clienti target (vedi i formati dettagliati qui sotto).                                                     | Visibile al brand e al partner.                                               |

Per saperne di più sul funzionamento di `sharedid` e `subId1` consulta [Spiegazione dei parametri Sub ID e Shared ID per i partner](https://help.impact.com/partner/it/di-cosa-vorresti-saperne-di-piu/platform-features/tracking/tracking-links/link-parameters/sub-id-and-shared-id-parameters-explained-for-partners.md).

## Configurazione del parametro audience (`u5` → `audiences`)

Nei link di impact.com, i metadati del pubblico sono inseriti nel parametro `audiences` (al plurale). Poiché le due piattaforme gestiscono i metadati in modo diverso, copiare direttamente i payload legacy interrompe il tracciamento.

La differenza principale:

* **Rakuten Advertising (`u5`):** Si aspetta un oggetto JSON standard codificato in Base64 *object*, ad esempio `{"41": "123,4567"}`.
* **impact.com (`audiences`):** Si aspetta un array JSON *array*, ad esempio `["123","4567"]`, usando la codifica base64url oppure un payload con codifica URL.

Usa uno di questi due formati per mappare i tuoi payload legacy `u5` su `audiences`:

{% tabs %}
{% tab title="Metodo A: codifica base64url (consigliata)" %}
impact.com supporta l’alfabeto base64url (RFC 4648, sezione 5), *non* la base64 standard.

* Perché usarla: la base64 standard utilizza caratteri come `+`, `/`e `=`, che i server web possono rimuovere o interpretare in modo errato durante i reindirizzamenti. base64url sostituisce questi caratteri, mantenendo pulito il tracking.
  {% endtab %}

{% tab title="Metodo B: JSON con codifica URL (integrazione più semplice nel codice)" %}
Se il tuo team di sviluppo vuole evitare di modificare le librerie base64 standard, puoi passare direttamente l’array JSON, purché venga codificato in percentuale (codifica URL) esattamente una volta.
{% endtab %}
{% endtabs %}

## Esempi di conversione dei payload supportati

Usa questi esempi per mappare i payload legacy al parametro `audiences` :

| Dati archiviati di destinazione | Array JSON non codificato | Metodo legacy di Rakuten Advertising (u5) | Parametro impact.com mappato (audiences)                                                                             |
| ------------------------------- | ------------------------- | ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| 123,4567                        | `["123","4567"]`          | `&u5=eyI0MSI6ICIxMjMsNDU2NyJ9`            | `&audiences=WyIxMjMiLCI0NTY3Il0` *(base64url)* oppure `&audiences=%5B%22123%22%2C%224567%22%5D` *(con codifica URL)* |
| 98765                           | `["98765"]`               | `&u5=eyI0MSI6ICI5ODc2NSJ9`                | `&audiences=WyI5ODc2NSJd` *(base64url)*                                                                              |
| 123,4567 (*numerico*)           | `[123,4567]`              | `&u5=eyI0MSI6WzEyMyw0NTY3XX0=`            | `&audiences=WzEyMyw0NTY3XQ` *(base64url, senza padding)*                                                             |

## Configurazioni da evitare

Gli script di convalida devono segnalare e impedire questi comuni errori di formattazione:

| Esempio di parametro di query      | Perché non è supportato o interrompe il tracking                                                                                                   |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `audiences=123,4567`               | *Elenco separato da virgole senza altro formato.* Non è JSON valido.                                                                               |
| `audiences=123`                    | *Numero JSON.* Viene interpretato come un numero JSON, che non è né un array né un oggetto.                                                        |
| `audiences=WyJhw77DvsO%2BIl0%3D`   | *Base64 standard.* Contiene caratteri tipici della base64 standard, come `+`, che il decoder base64url non supporta.                               |
| `audiences=%255B%252212%2522%255D` | *Codificato due volte con la codifica percentuale.* Viene decodificato in `%5B%2212%22%5D` anziché in una stringa pulita. Codifica una sola volta. |

## Schema di codice per gli sviluppatori

Questo esempio JavaScript mostra come aggiornare la logica di generazione dei link da Rakuten Advertising a impact.com:

```javascript
// ❌ LOGICA LEGACY DEI LINK RAKUTEN (u5)
const legacyAudience = {"41": "123,4567"};
const standardBase64 = btoa(JSON.stringify(legacyAudience)); // eyI0MSI6ICIxMjMsNDU2NyJ9
const rakutenLink = `https://click.linksynergy.com/fs-bin/click?id=AysPbYF8&u5=${encodeURIComponent(standardBase64)}`;

// LOGICA NATIVA DEI LINK IMPACT.COM (audiences)
const audienceArray = ["123", "4567"];
const jsonArrayString = JSON.stringify(audienceArray); // '["123","4567"]'

// Converti base64 standard in base64url (sostituisce + e / e rimuove gli = finali)
const base64UrlPayload = btoa(jsonArrayString)
  .replace(/\+/g, '-')
  .replace(/\//g, '_')
  .replace(/=+$/, ''); // WyIxMjMiLCI0NTY3Il0

const impactLink = `https://brand.sjv.io/c/123456/789012/3456?sharedid=ABC&subId1=QWERTYQWERTY&audiences=${base64UrlPayload}`;
```

## Risorse aggiuntive

* [Da Rakuten Advertising a impact.com: domande frequenti sulla migrazione](https://help.impact.com/partner/it/di-cosa-vorresti-saperne-di-piu/getting-started/rakuten-advertising-to-impact.com-partner-migration-faq.md) — Trova le risposte alle domande sul collegamento degli account, i reindirizzamenti dei link, i pagamenti e la reportistica durante la migrazione.
* [Riferimento alla terminologia: da Rakuten a impact.com](https://help.impact.com/partner/it/di-cosa-vorresti-saperne-di-piu/getting-started/rakuten-to-impact.com-terminology-reference.md) — Scopri quale funzionalità di impact.com corrisponde a ciascun termine di Rakuten.
* [Parametri Sub ID e Shared ID: spiegazione per i partner](https://help.impact.com/partner/it/di-cosa-vorresti-saperne-di-piu/platform-features/tracking/tracking-links/link-parameters/sub-id-and-shared-id-parameters-explained-for-partners.md) — Scopri come funzionano i Sub ID e gli Shared ID e quali sono gli usi più comuni per il monitoraggio.
* [Crea link di tracciamento](https://help.impact.com/partner/it/di-cosa-vorresti-saperne-di-piu/platform-features/tracking/tracking-links/create-and-manage-links/create-tracking-links.md) — Ottieni link di tracciamento impact.com per le risorse di un brand e aggiungi parametri di tracciamento.


---

# 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/partner/it/di-cosa-vorresti-saperne-di-piu/getting-started/migrate-your-rakuten-advertising-tracking-to-impact.com.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.
