> 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/zh/what-would-you-like-to-learn-about/getting-started/rakuten-advertising-to-impact.com-key-transition-steps.md).

# 从 Rakuten Advertising 迁移到 impact.com：关键过渡步骤

迁移到 impact.com 是一个自动化的一站式流程。账户上线后，您需要完成几项操作，确保转化回传报告和合作伙伴跟踪无缝衔接。请按顺序完成以下步骤：

{% stepper %}
{% step %}

## 检查您的落地页参数

您现有的 Rakuten Advertising 跟踪参数已预先加载到 impact.com 账户中，因此无需进行任何设置。本步骤将说明旧版 Rakuten Advertising 宏如何映射到 impact.com、在哪里可以找到这些参数，以及需要注意的两项变化。

### 跟踪模板说明

在 impact.com 中，您的落地页参数由以下功能自动管理： [Gateway 跟踪模板](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/account-administration/program-settings/tracking-settings/configure-gateway-tracking-settings.md)。每当有人点击合作伙伴链接时，这些模板都会将跟踪参数附加到您的落地页 URL 中。

* **动态值：** 用花括号括起来的参数会在用户点击链接时自动填入正确的点击数据，例如合作伙伴 ID 或点击 ID。
* **分析参数和硬编码参数：** 您现有的硬编码分析参数（例如 `utm_medium=rakuten`）会保留，因此报告能够保持一致。您可以随时更新这些参数，或添加新的参数，例如 Google Analytics UTM 参数。

### 访问 Gateway 跟踪模板

您可以访问这些跟踪模板，以便日后查看或调整。

1. 在顶部导航栏中，选择 ![](https://1186853034-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) **\[用户个人资料] → 设置**.
2. 在 *Program Settings* 列（右侧）中向下滚动至 *Tracking* ，然后选择 [**Gateway**](https://app.impact.com/secure/advertiser/fr/tracking-gateway-settings.ihtml).
3. 向下滚动至 *Program Tracking Template* 部分。

### 切换前请检查以下两项

1. **保持跟踪正常运行——不要删除以下参数：** 您的 Program Tracking Template 包含已配置好的关键跟踪行。请勿删除或重命名这些行，因为它们用于将点击与成功转化关联起来：
   * `im_ref` 必须保持设置为 `{clickid}`
   * `ranSiteID` 必须保持设置为 `{ransiteid}`
2. **链接类型现在使用文本标签：** 旧版 Rakuten Advertising 宏使用数字表示链接类型，例如 `3`。impact.com 则改用易读的文本标签，例如 `banner`, `text`或 `image` ，对应 `{iradtype}`。如果您的内部分析数据库依赖数字格式，请告知开发人员此项变化。

下方的对照表展示了旧版 Rakuten Advertising 宏与 impact.com 参数之间的映射关系：

<details>

<summary>Rakuten Advertising 到 impact.com 宏映射对照表</summary>

| Rakuten Advertising 宏 | impact.com 参数                                             | 说明                                            |
| --------------------- | --------------------------------------------------------- | --------------------------------------------- |
| `<LSNSITEID>`         | `{ransiteid}`                                             | Rakuten Advertising 点击 ID——用于标识点击的唯一标识符。      |
| `<LSNPUBID>`          | `{extract(ransiteid, "^([^-]+)", 1)}`                     | Rakuten Advertising 加密 SID — 用于识别您的历史合作伙伴 ID。 |
| `<LSNLNKTYPE>`        | `{iradtype}`                                              | 广告类型 — 描述性文本，例如横幅、文本或图片。                      |
| `<LSNSID>`            | `{irpid}`                                                 | impact.com 合作伙伴 ID — 引荐合作伙伴的唯一 ID。            |
| `<LSNCRTID>`          | `{iradid}`                                                | impact.com 广告 ID — 所用的具体创意素材。                 |
| `<PUBU1>`             | `{subId1}`                                                | 会员/用户值 (U1) — 合作伙伴传递的自定义值。                    |
| `<LSNSUBID>`          | `{sharedid}`                                              | 子 ID 值 — 合作伙伴指定的子 ID。                         |
| `<LSNPUBNAME>`        | `{irmpname}`                                              | 合作伙伴名称 — 合作伙伴的名称。                             |
| `<LSNLNKNAME>`        | `{iradname}`                                              | 链接名称 — 您为创意链接指定的名称。                           |
| `<LSNPUBGROUP>`       | `{irmpgroupname}`                                         | 合作伙伴组 — 您将合作伙伴分配到的任何组。                        |
| `<LSNCLKDATE>`        | `{urlencode(datefmt("yyyy-MM-dd'T'HH:mm:ss'Z'", "UTC"))}` | 点击日期和时间 — 标准化的 UTC 时间戳。                       |
| `<gaid_raw>`          | `{googleaid}`                                             | Google 广告 ID — 用于移动应用跟踪。                      |
| `<ifa_raw>`           | `{appleifa}`                                              | Apple IFA ID — 用于 iOS 应用跟踪。                   |

</details>
{% endstep %}

{% step %}

## 管理冲销

将合作伙伴计划从 Rakuten Advertising 迁移到 impact.com 时，如何处理订单冲销（例如退货、取消或编辑），完全取决于您网站在任何给定时刻启用的跟踪方式。您需要避免弄错这一流程，否则可能会漏报冲销或重复记账。

* [x] **切换到 impact.com 跟踪之前**：账户迁移到 impact.com 后，您的网站可能仍在使用 Rakuten 跟踪方式，合作伙伴也会继续通过 Rakuten 链接带来流量。在此期间，您应继续向 Rakuten 而非 impact.com 提交冲销。
* [x] **切换到 impact.com 跟踪之后**：一旦将 Rakuten 跟踪切换为 impact.com 跟踪，就应开始 [将所有新冲销](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md) 直接提交给 impact.com。切换到 impact.com 跟踪之前日期的任何交易仍应报告给 Rakuten。
  {% endstep %}

{% step %}

## 管理比价购物服务 (CSS) 合作伙伴

如果您与比价购物服务 (CSS) 合作伙伴合作投放 Google Shopping 广告，请按照以下步骤操作，以便在重新集成到 impact.com 期间，确保其跟踪不中断：

1. **迁移到 impact.com 后：** 只要您的网站仍在运行 Rakuten 跟踪，CSS 合作伙伴就必须继续使用仅适用于 Rakuten 的跟踪链接。（不依赖 Google Shopping 广告的非 CSS 合作伙伴可以较早切换到 impact.com 跟踪链接。）
2. **准备阶段：** 准备好集成 impact.com 跟踪后，请向 impact.com 集成工程师提供现有 CSS 合作伙伴的完整名单。impact.com 将为您配置双路由映射，确保切换到 impact.com 跟踪后，旧的 Rakuten 跟踪链接和新的 impact.com 链接都能正常解析并同时进行跟踪。
3. **集成后阶段：** 团队完全切换到 impact.com 跟踪后，您的 CSS 合作伙伴将获得认证，可以同时运行 Rakuten 和 impact.com 链接，且不会出现跟踪缺口。
   {% endstep %}

{% step %}

## 使用 RAD 字段名称查看 Rakuten 操作级数据

Rakuten Advertising 的 Advanced Action Listing (AAL) 报告和 AAL+SKU 报告使用各自的一套字段名称。以下 Advanced Action Listing w/RAD Fields 报告与我们的标准 Advanced Action Listing 报告相同，只是改用了 Rakuten 的字段名称。因此，切换到 impact.com 后，您可以使用熟悉的术语查看操作级数据。

以下自定义报告使用 Rakuten 参数名称，帮助您更轻松地过渡到 impact.com 报告：

* [带 RAD 字段的 Advanced Action Listing](https://app.impact.com/secure/advertiser/report/viewReport.report?handle=18648)
* [带 SKU 和 RAD 字段的 Advanced Action Listing](https://app.impact.com/secure/advertiser/report/viewReport.report?handle=18608)

本参考说明了这些 Rakuten 字段名称与 impact.com 参数的对应关系：

<details>

<summary>字段映射参考</summary>

| Rakuten Advertising (RAD) 字段 | 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`                                     |
| `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`                                     |

</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/zh/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.
