> 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/getting-started/rakuten-advertising-to-impact.com-key-transition-steps.md).

# Da Rakuten Advertising a impact.com: passaggi chiave della transizione

La migrazione a impact.com è un unico processo automatizzato. Una volta attivato l'account, dovrai completare alcune operazioni affinché i report sugli storni e il tracciamento dei partner continuino senza interruzioni. Completa i seguenti passaggi nell'ordine indicato:

{% stepper %}
{% step %}

## Controlla i parametri della pagina di destinazione

I tuoi parametri di tracciamento Rakuten Advertising esistenti sono già precaricati nel tuo account impact.com, quindi non devi configurare nulla. Questo passaggio spiega come le tue macro Rakuten Advertising precedenti corrispondono ai parametri di impact.com, dove trovarle e quali sono le due modifiche di cui tenere conto.

### Come funzionano i modelli di tracciamento

In impact.com, i parametri della pagina di destinazione sono gestiti automaticamente tramite i [modelli di tracciamento Gateway](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/account-administration/program-settings/tracking-settings/configure-gateway-tracking-settings.md). Questi modelli aggiungono parametri di tracciamento agli URL delle pagine di destinazione ogni volta che qualcuno fa clic su un link di un partner.

* **Valori dinamici:** I parametri racchiusi tra parentesi graffe vengono compilati automaticamente con i dati corretti del clic, come l'ID del partner o l'ID del clic, quando un utente fa clic su un link.
* **Parametri di analisi e con valori fissi:** I parametri di analisi esistenti con valori fissi, come `utm_medium=rakuten`, vengono mantenuti per garantire la coerenza dei report. Puoi aggiornarli o aggiungerne di nuovi, come gli UTM di Google Analytics, in qualsiasi momento.

### Accedi ai modelli di tracciamento Gateway

Puoi accedere a questi modelli di tracciamento per esaminarli o modificarli in seguito.

1. Nella barra di navigazione superiore, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Profilo utente] → Impostazioni**.
2. Nella colonna *Impostazioni del programma* a destra, scorri fino a *Tracciamento* e seleziona [**Gateway**](https://app.impact.com/secure/advertiser/fr/tracking-gateway-settings.ihtml).
3. Scorri fino alla sezione *Modello di tracciamento del programma* .

### Controlla 2 aspetti prima di passare a impact.com

1. **Mantieni attivo il tracciamento: non eliminare questi parametri:** Il modello di tracciamento del programma include righe di tracciamento essenziali già configurate. Non rimuoverle né rinominarle, perché collegano i clic alle conversioni riuscite:
   * `im_ref` deve rimanere impostato su `{clickid}`
   * `ranSiteID` deve rimanere impostato su `{ransiteid}`
2. **I tipi di link sono ora indicati con testo:** Le macro Rakuten Advertising precedenti indicano i tipi di link con numeri, ad esempio `3`. impact.com mostra invece etichette testuali leggibili, ad esempio `banner`, `text`o `image` tramite `{iradtype}`. Se il tuo database di analisi interno utilizza il formato numerico, informa lo sviluppatore di questa modifica.

La tabella di riferimento seguente mostra la corrispondenza tra le tue macro Rakuten Advertising precedenti e i parametri di impact.com:

<details>

<summary>Tabella di corrispondenza delle macro da Rakuten Advertising a impact.com</summary>

| Macro Rakuten Advertising | Parametro impact.com                                      | Descrizione                                                                            |
| ------------------------- | --------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| `<LSNSITEID>`             | `{ransiteid}`                                             | ID clic di Rakuten Advertising: l'identificativo univoco del clic.                     |
| `<LSNPUBID>`              | `{extract(ransiteid, "^([^-]+)", 1)}`                     | SID crittografato di Rakuten Advertising: identifica il tuo ID partner storico.        |
| `<LSNLNKTYPE>`            | `{iradtype}`                                              | Tipo di annuncio: testo descrittivo, ad esempio banner, testo o immagine.              |
| `<LSNSID>`                | `{irpid}`                                                 | ID partner di impact.com: l'ID univoco del partner di riferimento.                     |
| `<LSNCRTID>`              | `{iradid}`                                                | ID annuncio di impact.com: la specifica risorsa creativa utilizzata.                   |
| `<PUBU1>`                 | `{subId1}`                                                | Valore membro/utente (U1): il valore personalizzato trasmesso dai partner.             |
| `<LSNSUBID>`              | `{sharedid}`                                              | Valore Sub-ID: il Sub-ID specificato dal partner.                                      |
| `<LSNPUBNAME>`            | `{irmpname}`                                              | Nome partner: il nome del partner.                                                     |
| `<LSNLNKNAME>`            | `{iradname}`                                              | Nome del link: il nome che hai assegnato al link creativo.                             |
| `<LSNPUBGROUP>`           | `{irmpgroupname}`                                         | Gruppo partner: un eventuale gruppo a cui hai assegnato il partner.                    |
| `<LSNCLKDATE>`            | `{urlencode(datefmt("yyyy-MM-dd'T'HH:mm:ss'Z'", "UTC"))}` | Data e ora del clic: timestamp UTC standardizzato.                                     |
| `<gaid_raw>`              | `{googleaid}`                                             | ID pubblicità Google: utilizzato per il monitoraggio delle app per dispositivi mobili. |
| `<ifa_raw>`               | `{appleifa}`                                              | ID IFA Apple: utilizzato per il monitoraggio delle app iOS.                            |

</details>
{% endstep %}

{% step %}

## Gestisci gli storni

Durante la migrazione del tuo programma di partnership da Rakuten Advertising a impact.com, il modo in cui elabori gli storni degli ordini, ad esempio resi, annullamenti o modifiche, dipende interamente dai metodi di tracciamento attivi sul tuo sito in un determinato momento. È importante seguire la sequenza corretta, per evitare storni mancanti o doppi accrediti.

* [x] **Prima di passare al tracciamento di impact.com**: Una volta migrato il tuo account a impact.com, il tuo sito potrebbe continuare a utilizzare i metodi di tracciamento di Rakuten e i partner continueranno a generare traffico tramite i link Rakuten. Durante questo periodo, continua a inviare gli storni a Rakuten, non a impact.com.
* [x] **Dopo il passaggio al tracciamento di impact.com**: Non appena sostituisci il tracciamento di Rakuten con quello di impact.com, inizi a [inviare tutti i nuovi storni](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md) direttamente a impact.com. Le transazioni con data antecedente al passaggio al tracciamento di impact.com devono essere comunque segnalate a Rakuten.
  {% endstep %}

{% step %}

## Gestisci i partner del servizio di comparazione dei prezzi (CSS)

Se collabori con un partner CSS (Comparison Shopping Service) per i tuoi annunci Google Shopping, segui questi passaggi per garantire che il tracciamento continui senza interruzioni durante la reintegrazione con impact.com:

1. **Dopo la migrazione a impact.com:** I partner CSS devono continuare a utilizzare esclusivamente i link di tracciamento Rakuten finché il tuo sito utilizza il tracciamento Rakuten. (I partner non CSS che non si affidano agli annunci Google Shopping possono passare senza problemi ai link di tracciamento di impact.com in anticipo.)
2. **Fase di preparazione:** Quando sei pronto a integrare il tracciamento di impact.com, fornisci al tuo Integration Engineer di impact.com un elenco completo dei partner CSS esistenti. impact.com configurerà una mappatura a doppio instradamento. In questo modo, dopo il passaggio al tracciamento di impact.com, i link di tracciamento Rakuten esistenti e i nuovi link di impact.com potranno essere risolti e tracciati contemporaneamente.
3. **Fase post-integrazione:** Quando il tuo team passerà completamente al monitoraggio di impact.com, i tuoi partner CSS saranno certificati per utilizzare sia i link Rakuten sia quelli di impact.com senza lacune nel monitoraggio.
   {% endstep %}

{% step %}

## Visualizza i dati a livello di azione di Rakuten usando i nomi dei campi RAD

I report Advanced Action Listing (AAL) e AAL+SKU di Rakuten Advertising utilizzano un proprio insieme di nomi di campo. I report Advanced Action Listing w/RAD Fields riportati di seguito corrispondono ai nostri report Advanced Action Listing standard, con la sola differenza che usano i nomi dei campi di Rakuten. In questo modo, durante la migrazione a impact.com, puoi visualizzare i dati a livello di azione usando una terminologia che già conosci.

I seguenti report personalizzati utilizzano i nomi dei parametri Rakuten per agevolare la migrazione alla reportistica di impact.com:

* [Advanced Action Listing w/RAD Fields](https://app.impact.com/secure/advertiser/report/viewReport.report?handle=18648)
* [Advanced Action Listing with SKU w/RAD Fields](https://app.impact.com/secure/advertiser/report/viewReport.report?handle=18608)

Questo riferimento mostra la corrispondenza tra i nomi dei campi Rakuten e i parametri di impact.com:

<details>

<summary>Riferimento per la corrispondenza dei campi</summary>

| Campo di Rakuten Advertising (RAD) | Corrispondenza in impact.com                               |
| ---------------------------------- | ---------------------------------------------------------- |
| `advertiser_id`                    | `CampaignId`                                               |
| `alternative_order_id`             | `Text4`                                                    |
| `artist_curation_id`               | `Text12`                                                   |
| `autopay`                          | `Text42`                                                   |
| `cancel_deadline_datetime`         | `Date8`                                                    |
| `check_in_datetime`                | `Date9`                                                    |
| `check_out_datetime`               | `Date10`                                                   |
| `click_id`                         | `ClickId`                                                  |
| `consumed_datetime`                | `Date2`                                                    |
| `consumer_country`                 | `CustomerCountry`                                          |
| `consumer_operating_system`        | `DeviceOS`                                                 |
| `consumer_region`                  | `CustomerRegion`                                           |
| `conversion_type`                  | `Text1`                                                    |
| `coupon`                           | `OrderPromoCode/ItemPromoCode[i]`                          |
| `credit_card_last_four`            | `Text21`                                                   |
| `credit_card_type`                 | `PaymentType`                                              |
| `currency`                         | `CurrencyCode`                                             |
| `customer_id`                      | `CustomerId`                                               |
| `customer_rank`                    | `Text2`                                                    |
| `customer_segment`                 | `Text3`                                                    |
| `customer_state`                   | `Text11`                                                   |
| `customer_status`                  | `CustomerStatus`                                           |
| `designated_marketing_area`        | `Text41`                                                   |
| `discount_amount`                  | `OrderDiscount/ItemDiscount[i]`                            |
| `discount_type`                    | `Text23 / ItemText20`                                      |
| `estimated_aum`                    | `Text26`                                                   |
| `event_datetime`                   | `Date1`                                                    |
| `home_ownership`                   | `Text43`                                                   |
| `income_aum`                       | `Text27`                                                   |
| `income_band`                      | `Text28`                                                   |
| `is_weekend`                       | `Text44`                                                   |
| `landing_datetime`                 | `Date3`                                                    |
| `loan_amount_requested`            | `Text29`                                                   |
| `loan_approval_datetime`           | `Date4`                                                    |
| `loan_apr`                         | `Text30`                                                   |
| `loan_funded_datetime`             | `Date5`                                                    |
| `loan_model_number`                | `Text31`                                                   |
| `loan_offer_apr`                   | `Text32`                                                   |
| `loan_offer_badge`                 | `Text33`                                                   |
| `loan_offer_term`                  | `Text34`                                                   |
| `loan_origination_fee`             | `Text35`                                                   |
| `loan_purpose`                     | `Text36`                                                   |
| `loan_purpose_applicant`           | `Text37`                                                   |
| `loan_term_in_months`              | `Text38`                                                   |
| `mobile_device_id`                 | `AppleIfa/GoogAid`                                         |
| `monthly_housing_payment`          | `Text39`                                                   |
| `o2o_bank_partner`                 | `Text20`                                                   |
| `o2o_store_address`                | `Text13`                                                   |
| `o2o_store_city`                   | `Text14`                                                   |
| `o2o_store_country`                | `Text15`                                                   |
| `o2o_store_id`                     | `Text16`                                                   |
| `o2o_store_name`                   | `Text17`                                                   |
| `o2o_store_state`                  | `Text18`                                                   |
| `o2o_store_zip`                    | `Text19`                                                   |
| `order_id`                         | `OrderId`                                                  |
| `order_status`                     | `Text5`                                                    |
| `placement`                        | `Text6 (per le conversioni se non provengono da referral)` |
| `publisher_lead_id`                | `Text40`                                                   |
| `Pubblico dei publisher`           | `Text8`                                                    |
| `purchase_site`                    | `Text10`                                                   |
| `reservation_end_datetime`         | `Date11`                                                   |
| `reservation_length_in_days`       | `Numeric2`                                                 |
| `reservation_start_datetime`       | `Date7`                                                    |
| `ship_country`                     | `Text22`                                                   |
| `shipped_datetime`                 | `Date6`                                                    |
| `store_category`                   | `Text24`                                                   |
| `store_id`                         | `Text25`                                                   |
| `tracking_source`                  | `Text7`                                                    |
| `traffic_source`                   | `Text9 (per le conversioni se non provengono da referral)` |
| `transaction_datetime`             | `EventDate`                                                |
| `travel_reason`                    | `Text45`                                                   |

</details>
{% endstep %}
{% endstepper %}

<br>


---

# 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/getting-started/rakuten-advertising-to-impact.com-key-transition-steps.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.
