> 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 tracking templates](/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。

### 访问网关跟踪模板

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

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. 在……中 *项目设置* 列（右侧），向下滚动到 *跟踪* 并选择 [**Gateway**](https://app.impact.com/secure/advertiser/fr/tracking-gateway-settings.ihtml).
3. 向下滚动到 *Program Tracking Template* 部分。

### 切换之前检查 2 件事

1. **保持跟踪开启——不要删除这些参数：** 您的 Program Tracking Template 包含已配置好的关键跟踪行。请不要删除或重命名它们，因为它们会将点击与成功转化连接起来：
   * `im_ref` 必须保持设置为 `{clickid}`
   * `ranSiteID` 必须保持设置为 `{ransiteid}`
2. **链接类型现在基于文本：** 旧版 Rakuten Advertising 宏会将链接类型显示为数字，例如 `3`。impact.com 则改为显示可读的文本标签，例如 `横幅`, `文本`，或 `图片` 到 `{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}`                                              | Sub-ID 值——合作伙伴指定的 sub-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 跟踪，您就开始 [将所有新的反向调整](/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 %}

## 管理 Comparison Shopping Service（CSS）合作伙伴

如果您与 Google Shopping 广告使用 Comparison Shopping Service（CSS）合作伙伴，请按以下步骤操作，以便在重新集成到 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`              | `活动 ID`                                      |
| `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`            | `文本1`                                        |
| `coupon`                     | `OrderPromoCode/ItemPromoCode[i]`            |
| `credit_card_last_four`      | `Text21`                                     |
| `credit_card_type`           | `PaymentType`                                |
| `currency`                   | `CurrencyCode`                               |
| `customer_id`                | `CustomerId`                                 |
| `customer_rank`              | `文本2`                                        |
| `customer_segment`           | `文本3`                                        |
| `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`                                     |
| `发布者受众`                      | `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`       | `事件日期`                                       |
| `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.