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

### 切换前检查 2 件事

1. **保持跟踪处于启用状态——不要删除这些参数：** 你的程序跟踪模板包含已配置好的关键跟踪行。不要删除或重命名它们，因为它们会将点击与成功转化关联起来： 
   * `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 %}

## 管理比价购物服务（CSS）合作伙伴

如果你为 Google Shopping 广告与比价购物服务（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（带 RAD 字段）报表与我们标准的 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（如果不是通过引荐进行转化）`             |
| `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（如果不是通过引荐进行转化）`             |
| `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/zh/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.