> 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 che il tuo account sarà attivo, dovrai completare alcune attività affinché il reporting degli storni e il tracciamento dei partner vengano trasferiti senza interruzioni. Completa i passaggi seguenti in ordine:
{% stepper %}
{% step %}
## Rivedi i parametri della tua landing page
I tuoi parametri di tracciamento esistenti di Rakuten Advertising 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 da tenere presenti.
### Spiegazione dei modelli di tracciamento
In impact.com, i parametri della tua landing page vengono gestiti automaticamente tramite [i 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 partner.
* **Valori dinamici:** I parametri racchiusi tra parentesi graffe vengono compilati automaticamente con i dati di clic corretti, come l'ID del partner o l'ID del clic, quando un utente fa clic su un link.
* **Analytics e parametri codificati manualmente:** I tuoi parametri analytics codificati manualmente esistenti, come `utm_medium=rakuten`, vengono mantenuti, così il tuo reporting 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. Nella barra di navigazione superiore, seleziona  **\[Profilo utente] → Impostazioni**.
2. Nel *Impostazioni del programma* colonna (a destra), scorri verso il basso 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, perché collegano i clic alle conversioni andate a buon fine:
* `im_ref` deve rimanere impostato su `{clickid}`
* `ranSiteID` deve rimanere impostato su `{ransiteid}`
2. **I tipi di link sono ora basati sul testo:** Le macro legacy di Rakuten Advertising mostrano i tipi di link come numeri, ad esempio, `3`. impact.com mostra invece etichette testuali leggibili, ad esempio, `banner`, `testo`, oppure `immagine` tramite `{iradtype}`. Se il tuo database di analytics 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:
Riferimento di mappatura macro da Rakuten Advertising a impact.com
| Macro di Rakuten Advertising | Parametro impact.com | Descrizione |
| ---------------------------- | --------------------------------------------------------- | -------------------------------------------------------------------------------- |
| `` | `{ransiteid}` | ID clic di Rakuten Advertising — l'identificatore univoco del clic. |
| `` | `{extract(ransiteid, "^([^-]+)", 1)}` | SID crittografato di Rakuten Advertising — isola il tuo ID storico del partner. |
| `` | `{iradtype}` | Tipo di annuncio — testo descrittivo come banner, testo o immagine. |
| `` | `{irpid}` | ID partner di impact.com — l'ID univoco del partner che ha generato il referral. |
| `` | `{iradid}` | ID annuncio di impact.com — l'asset creativo specifico utilizzato. |
| `` | `{subId1}` | Valore membro/utente (U1) — il valore personalizzato trasmesso dai partner. |
| `` | `{sharedid}` | Valore Sub-ID — il Sub-ID specificato dal partner. |
| `` | `{irmpname}` | Nome partner — il nome del partner. |
| `` | `{iradname}` | Nome link — il nome che hai dato al link creativo. |
| `` | `{irmpgroupname}` | Gruppo partner — qualsiasi gruppo a cui hai assegnato il partner. |
| `` | `{urlencode(datefmt("yyyy-MM-dd'T'HH:mm:ss'Z'", "UTC"))}` | Data e ora del clic — timestamp UTC standardizzato. |
| `` | `{googleaid}` | ID pubblicitario di Google — usato per il tracciamento delle app mobili. |
| `` | `{appleifa}` | ID IFA di Apple — usato per il tracciamento delle app iOS. |
{% endstep %}
{% step %}
## Gestisci i tuoi storni
Mentre trasferisci il tuo programma di partnership da Rakuten Advertising a impact.com, il modo in cui elabori gli storni degli ordini, come resi, cancellazioni o modifiche, dipende interamente dai metodi di tracciamento attivi sul tuo sito in un dato momento. È fondamentale non sbagliare questa sequenza, perché può causare storni mancati o accrediti doppi.
* [x] **Prima di passare al tracciamento impact.com**: Una volta che il tuo account è stato migrato a impact.com, il tuo sito potrebbe ancora utilizzare i metodi di tracciamento di Rakuten e i partner continueranno a generare traffico tramite link Rakuten. Durante questo periodo, continuerai a inviare i tuoi storni a Rakuten, non a impact.com.
* [x] **Dopo il passaggio al tracciamento impact.com**: Non appena sostituisci il tracciamento Rakuten con il tracciamento impact.com, inizi [a inviare tutti i nuovi storni](/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 datata prima del passaggio al tracciamento impact.com dovrebbe essere ancora segnalata a Rakuten.
{% endstep %}
{% step %}
## Gestisci i partner del 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 ti reintegri con impact.com:
1. **Dopo la migrazione a impact.com:** I tuoi partner CSS devono continuare a usare link di tracciamento esclusivi Rakuten mentre il tuo sito sta ancora utilizzando il tracciamento Rakuten. (I partner non CSS che non si basano sugli annunci Google Shopping possono passare ai link di tracciamento impact.com più presto, senza problemi).
2. **La fase di preparazione:** Quando sei pronto a integrarti con 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 doppio instradamento. Questo garantisce che i link di tracciamento legacy Rakuten e i nuovi link impact.com si risolvano e vengano tracciati contemporaneamente dopo il passaggio al tracciamento impact.com.
3. **La fase post-integrazione:** Una volta che il tuo team passa completamente al tracciamento impact.com, i tuoi partner CSS saranno certificati per usare sia i link Rakuten sia quelli impact.com senza lacune di tracciamento.
{% endstep %}
{% step %}
## Visualizza i tuoi 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 uguali ai nostri report standard Advanced Action Listing, solo rinominati con i nomi dei campi di Rakuten, quindi quando passerai a impact.com potrai visualizzare i tuoi dati a livello di azione usando una terminologia che già conosci.
I seguenti report personalizzati utilizzano i nomi dei parametri Rakuten per facilitare il tuo passaggio al reporting impact.com:
* [Elenco azioni avanzato con campi RAD](https://app.impact.com/secure/advertiser/report/viewReport.report?handle=18648)
* [Elenco azioni avanzato con SKU e campi RAD](https://app.impact.com/secure/advertiser/report/viewReport.report?handle=18608)
Questo riferimento mostra come quei nomi di campo di Rakuten si mappano sui parametri di impact.com:
Riferimento di mappatura dei campi
| Campo di 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 (per le conversioni se non su 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 su referral)` |
| `transaction_datetime` | `EventDate` |
| `travel_reason` | `Text45` |
{% endstep %}
{% endstepper %}
---
# 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=&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.