> 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 tua migrazione a impact.com è un processo unico e automatizzato. Una volta che il tuo account sarà attivo, dovrai completare alcuni elementi di azione affinché la reportistica delle rettifiche e il tracciamento dei partner vengano trasferiti senza problemi. Completa i seguenti passaggi nell'ordine:

{% stepper %}
{% step %}

## Rivedi i parametri della tua landing page

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

### Spiegazione dei modelli di tracciamento

In impact.com, i parametri della tua landing page vengono gestiti automaticamente utilizzando [modelli di tracciamento Gateway](/brand/it/what-would-you-like-to-learn-about/account-administration/program-settings/tracking-settings/configure-gateway-tracking-settings.md). Questi modelli associano i parametri di tracciamento agli URL della tua landing page ogni volta che qualcuno fa clic su un link di un partner.

* **Valori dinamici:** I parametri racchiusi tra parentesi graffe si compilano 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 Analytics e codificati staticamente:** I tuoi parametri di Analytics codificati staticamente esistenti, come `utm_medium=rakuten`, vengono mantenuti, così la tua reportistica rimane coerente. 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 rivederli o modificarli in seguito.

1. Dalla 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 *Impostazioni del programma* colonna (a destra), scorri fino a *Tracciamento* e seleziona [**Gateway**](https://app.impact.com/secure/advertiser/fr/tracking-gateway-settings.ihtml).
3. Scorri fino alla *Modello di tracciamento del programma* sezione.

### Controlla 2 cose prima di effettuare il passaggio

1. **Mantieni attivo il tracciamento — non eliminare questi parametri:** Il tuo Modello di tracciamento del programma include righe di tracciamento chiave già configurate. Non rimuoverle né rinominarle, poiché collegano i clic alle conversioni riuscite:&#x20;
   * `im_ref` deve rimanere impostato su `{clickid}`&#x20;
   * `ranSiteID` deve rimanere impostato su `{ransiteid}`
2. **I tipi di link ora si basano sul testo:** Le macro legacy di Rakuten Advertising mostrano i tipi di link come numeri, ad esempio, `3`. impact.com mostra invece etichette di testo leggibili, ad esempio, `banner`, `testo`, o `immagine` tramite `{iradtype}`. Se il tuo database di analisi interno si basa sul formato numerico, informa il tuo sviluppatore di questa modifica.

Il riferimento seguente mostra come le tue macro legacy di Rakuten Advertising si mappano sui parametri di impact.com:

<details>

<summary>Riferimento di mappatura delle macro da Rakuten Advertising a impact.com</summary>

| Macro di Rakuten Advertising | Parametro impact.com                                      | Descrizione                                                                 |
| ---------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------- |
| `<LSNSITEID>`                | `{ransiteid}`                                             | ID clic di Rakuten Advertising — l'identificatore univoco del clic.         |
| `<LSNPUBID>`                 | `{extract(ransiteid, "^([^-]+)", 1)}`                     | SID crittografato di Rakuten Advertising — isola il tuo ID partner storico. |
| `<LSNLNKTYPE>`               | `{iradtype}`                                              | Tipo di annuncio — testo descrittivo come 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 — l'asset creativo specifico utilizzato.          |
| `<PUBU1>`                    | `{subId1}`                                                | Valore membro/utente (U1) — il valore personalizzato passato dai partner.   |
| `<LSNSUBID>`                 | `{sharedid}`                                              | Valore Sub-ID — il sub-ID specificato dal partner.                          |
| `<LSNPUBNAME>`               | `{irmpname}`                                              | Nome del partner — il nome del partner.                                     |
| `<LSNLNKNAME>`               | `{iradname}`                                              | Nome del link — il nome che hai assegnato al link creativo.                 |
| `<LSNPUBGROUP>`              | `{irmpgroupname}`                                         | Gruppo partner — qualsiasi 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 pubblicitario Google — usato per il tracciamento delle app mobili.       |
| `<ifa_raw>`                  | `{appleifa}`                                              | ID Apple IFA — usato per il tracciamento delle app iOS.                     |

</details>
{% endstep %}

{% step %}

## Gestisci le rettifiche

Mentre trasferisci il tuo programma di partnership da Rakuten Advertising a impact.com, il modo in cui elabori le rettifiche degli ordini, come resi, cancellazioni o modifiche, dipende interamente dai metodi di tracciamento attivi sul tuo sito in un dato momento. Devi evitare di sbagliare questa sequenza, perché potrebbe causare rettifiche mancate o doppi accrediti.

* [x] **Prima di passare al tracciamento di impact.com**: Una volta che il tuo account è migrato a impact.com, il tuo sito potrebbe ancora usare metodi di tracciamento Rakuten e i partner continueranno a generare traffico tramite link Rakuten. Durante questo periodo, continuerai a inviare le rettifiche a Rakuten, non a impact.com.
* [x] **Dopo il passaggio al tracciamento di impact.com**: Non appena sostituisci il tracciamento Rakuten con quello di impact.com, inizi [a inviare tutte le nuove rettifiche](/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. Qualsiasi transazione con data precedente al passaggio al tracciamento di impact.com deve comunque essere segnalata a Rakuten.
  {% endstep %}

{% step %}

## Gestisci i partner Comparison Shopping Service (CSS)

Se lavori con un partner Comparison Shopping Service (CSS) per i tuoi annunci Google Shopping, segui questi passaggi affinché il loro tracciamento continui senza interruzioni mentre reintegri con impact.com:

1. **Dopo la migrazione a impact.com:** I tuoi partner CSS devono continuare a usare link di tracciamento solo Rakuten finché il tuo sito utilizza ancora il tracciamento Rakuten. (I partner non CSS che non fanno affidamento sugli annunci Google Shopping possono passare ai link di tracciamento impact.com in anticipo senza problemi).
2. **La fase di preparazione:** Quando sei pronto a integrare il tracciamento impact.com, fornisci al tuo Integration Engineer di impact.com un elenco completo dei tuoi partner CSS esistenti. impact.com configurerà per te una mappatura a instradamento doppio. In questo modo, i link di tracciamento legacy Rakuten e i nuovi link impact.com si risolveranno e verranno tracciati in parallelo dopo il passaggio al tracciamento impact.com.
3. **Fase successiva all'integrazione:** Una volta che il tuo team passerà completamente al tracciamento impact.com, i tuoi partner CSS saranno certificati per usare sia i link Rakuten sia quelli impact.com senza interruzioni di tracciamento.
   {% endstep %}

{% step %}

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

Il report Advanced Action Listing (AAL) di Rakuten Advertising e il report AAL+SKU utilizzano un proprio insieme di nomi di campo. I report Advanced Action Listing w/RAD Fields riportati di seguito sono gli stessi dei nostri report standard Advanced Action Listing, solo rinominati con i nomi dei campi di Rakuten, così quando passi a impact.com puoi visualizzare i dati a livello di azione usando una terminologia già familiare.

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

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

Questo riferimento mostra come quei nomi di campo Rakuten si mappano sui parametri di impact.com:

<details>

<summary>Riferimento di mappatura dei campi</summary>

| Campo Rakuten Advertising (RAD) | Corrispondenza 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 (for conversions if not on referral)` |
| `publisher_lead_id`             | `Text40`                                     |
| `Audience 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 (for conversions if not on 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 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/getting-started/rakuten-advertising-to-impact.com-key-transition-steps.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.
