> 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/what-would-you-like-to-learn-about/getting-started/rakuten-advertising-to-impact.com-key-transition-steps.md).
# Rakuten Advertising to impact.com: Key Transition Steps
Your migration to impact.com is a single, automated process. Once your account is live, you'll need to complete a few action items so your reversal reporting and partner tracking carry over seamlessly. Complete the following steps in order:
{% stepper %}
{% step %}
## Review your landing page parameters
Your existing Rakuten Advertising tracking parameters are already preloaded into your impact.com account, so there's nothing you need to set up. This step explains how your legacy Rakuten Advertising macros map to impact.com, where to find them, and two changes to be aware of.
### Tracking templates explained
In impact.com, your landing page parameters are managed automatically using [Gateway tracking templates](/brand/what-would-you-like-to-learn-about/account-administration/program-settings/tracking-settings/configure-gateway-tracking-settings.md). These templates attach tracking parameters to your landing page URLs whenever someone clicks on a partner link.
* **Dynamic values:** Parameters wrapped in curly brackets automatically populate with the correct click data, such as the partner's ID or the click ID, when a user clicks a link.
* **Analytics and hardcoded parameters:** Your existing hardcoded analytics parameters, such as `utm_medium=rakuten`, are preserved, so your reporting stays consistent. You can update these or add new ones, like Google Analytics UTMs, at any time.
### Access gateway tracking templates
You can access these tracking templates to review or adjust them later.
1. From the top navigation bar, select  **\[User profile] → Settings**.
2. In the *Program Settings* column (right), scroll down to *Tracking* and select [**Gateway**](https://app.impact.com/secure/advertiser/fr/tracking-gateway-settings.ihtml).
3. Scroll down to the *Program Tracking Template* section.
### Check 2 things before you switch
1. **Keep tracking active — don't delete these parameters:** Your Program Tracking Template includes key tracking rows that are already configured. Don't remove or rename them, as they connect clicks to successful conversions:
* `im_ref` must remain set to `{clickid}`
* `ranSiteID` must remain set to `{ransiteid}`
2. **Link types are now text-based:** Legacy Rakuten Advertising macros show link types as numbers, for example, `3`. impact.com displays readable text labels instead, for example, `banner`, `text`, or `image` through `{iradtype}`. If your internal analytics database relies on the numbered format, let your developer know about this change.
The reference below shows how your legacy Rakuten Advertising macros map to impact.com parameters:
Rakuten Advertising to impact.com macro mapping reference
| Rakuten Advertising macro | impact.com parameter | Description |
| ------------------------- | --------------------------------------------------------- | ------------------------------------------------------------------------ |
| `` | `{ransiteid}` | Rakuten Advertising click ID — the unique identifier for the click. |
| `` | `{extract(ransiteid, "^([^-]+)", 1)}` | Rakuten Advertising encrypted SID — isolates your historical partner ID. |
| `` | `{iradtype}` | Ad type — descriptive text such as banner, text, or image. |
| `` | `{irpid}` | impact.com partner ID — the unique ID of the referring partner. |
| `` | `{iradid}` | impact.com ad ID — the specific creative asset used. |
| `` | `{subId1}` | Member/user value (U1) — the custom value passed by partners. |
| `` | `{sharedid}` | Sub-ID value — the partner-specified sub-ID. |
| `` | `{irmpname}` | Partner name — the name of the partner. |
| `` | `{iradname}` | Link name — the name you gave the creative link. |
| `` | `{irmpgroupname}` | Partner group — any group you've assigned the partner to. |
| `` | `{urlencode(datefmt("yyyy-MM-dd'T'HH:mm:ss'Z'", "UTC"))}` | Click date and time — standardized UTC timestamp. |
| `` | `{googleaid}` | Google advertising ID — used for mobile app tracking. |
| `` | `{appleifa}` | Apple IFA ID — used for iOS app tracking. |
{% endstep %}
{% step %}
## Manage your reversals
As you transition your partnership program from Rakuten Advertising to impact.com, how you process order reversals, like returns, cancellations, or edits, depends entirely on which tracking methods are active on your site at any given moment. You want to avoid getting this sequencing wrong, which can result in missed reversals or double-crediting.
* [x] **Before switching to impact.com tracking**: Once your account has migrated to impact.com, your site may still be using Rakuten tracking methods, and partners will keep driving traffic through Rakuten links. During this period, you continue sending your reversals to Rakuten, not impact.com.
* [x] **After switching to impact.com tracking**: As soon as you swap your Rakuten tracking for impact.com tracking, you start [sending all new reversals](/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md) directly to impact.com. Any transaction dated before switching to impact.com tracking should still be reported to Rakuten.
{% endstep %}
{% step %}
## Manage Comparison Shopping Service (CSS) partners
If you work with a Comparison Shopping Service (CSS) partner for your Google Shopping ads, follow these steps so their tracking continues without a gap while you reintegrate to impact.com:
1. **After migrating to impact.com:** Your CSS partners must continue using Rakuten-only tracking links while your site is still running Rakuten tracking. (Non-CSS partners who do not rely on Google Shopping ads can comfortably transition to impact.com tracking links earlier).
2. **The preparation phase:** When you're ready to integrate with impact.com tracking, provide your impact.com Integration Engineer with a complete list of your existing CSS partners. impact.com will configure a dual-routing mapping for you. This ensures that legacy Rakuten tracking links and new impact.com links will resolve and track concurrently post-switch to impact.com tracking.
3. **Post-integration phase:** Once your team fully switches to impact.com tracking, your CSS partners will be certified to run both Rakuten and impact.com links without tracking gaps.
{% endstep %}
{% step %}
## View your Rakuten action-level data using RAD field names
Rakuten Advertising's Advanced Action Listing (AAL) report and AAL+SKU report use their own set of field names. The Advanced Action Listing w/RAD Fields reports below are the same as our standard Advanced Action Listing reports, just relabeled with Rakuten's field names, so when you transition to impact.com, you can view your action-level data using terminology you're already familiar with.
The following customized reports use Rakuten parameter names to help ease your transition to impact.com reporting:
* [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)
This reference shows how those Rakuten field names map to impact.com's parameters:
Field mapping reference
| Rakuten Advertising (RAD) field | impact.com match |
| ------------------------------- | -------------------------------------------- |
| `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` |
| `Publishers Audience` | `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` |
{% 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 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/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 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.