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

# Rakuten Advertising para impact.com: principais etapas da transição

Sua migração para a impact.com é um processo único e automatizado. Depois que sua conta estiver ativa, você precisará concluir algumas etapas para que seus relatórios de reversão e o rastreamento de parceiros sejam transferidos sem problemas. Conclua as etapas a seguir na ordem indicada:

{% stepper %}
{% step %}

## Revise os parâmetros da sua página de destino

Os parâmetros de rastreamento que você já usava na Rakuten Advertising foram pré-carregados na sua conta da impact.com, então não é necessário configurar nada. Nesta etapa, explicamos como as macros antigas da Rakuten Advertising correspondem aos parâmetros da impact.com, onde encontrá-las e duas mudanças importantes.

### Entenda os modelos de rastreamento

Na impact.com, os parâmetros da sua página de destino são gerenciados automaticamente usando [modelos de rastreamento do Gateway](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/account-administration/program-settings/tracking-settings/configure-gateway-tracking-settings.md). Esses modelos adicionam parâmetros de rastreamento aos URLs das suas páginas de destino sempre que alguém clica em um link de parceiro.

* **Valores dinâmicos:** Os parâmetros entre chaves são preenchidos automaticamente com os dados corretos do clique, como o ID do parceiro ou o ID do clique, quando alguém clica em um link.
* **Parâmetros de análise e definidos manualmente:** Os parâmetros de análise definidos manualmente que você já usa, como `utm_medium=rakuten`, são preservados para manter a consistência dos seus relatórios. Você pode atualizá-los ou adicionar novos a qualquer momento, como os parâmetros UTM do Google Analytics.

### Acesse os modelos de rastreamento do Gateway

Você pode acessar esses modelos de rastreamento mais tarde para revisá-los ou ajustá-los.

1. Na barra de navegação superior, selecione ![](https://526234278-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) **\[Perfil do usuário] → Configurações**.
2. Na coluna *Configurações do programa* (à direita), role para baixo até *Rastreamento* e selecione [**Gateway**](https://app.impact.com/secure/advertiser/fr/tracking-gateway-settings.ihtml).
3. Role para baixo até a seção *Modelo de rastreamento do programa* .

### Confira 2 itens antes de fazer a mudança

1. **Mantenha o rastreamento ativo — não exclua estes parâmetros:** O modelo de rastreamento do programa inclui linhas de rastreamento importantes que já estão configuradas. Não as remova nem renomeie, pois elas associam os cliques às conversões concluídas:
   * `im_ref` deve permanecer definido como `{clickid}`
   * `ranSiteID` deve permanecer definido como `{ransiteid}`
2. **Os tipos de link agora usam rótulos de texto:** As macros antigas da Rakuten Advertising indicam os tipos de link com números; por exemplo, `3`. Já a impact.com exibe rótulos de texto descritivos, como `banner`, `text`ou `image` por meio de `{iradtype}`. Se o banco de dados interno de análise depender do formato numérico, informe seu desenvolvedor sobre essa mudança.

A referência abaixo mostra como as macros antigas da Rakuten Advertising correspondem aos parâmetros da impact.com:

<details>

<summary>Referência de correspondência entre macros da Rakuten Advertising e parâmetros da impact.com</summary>

| Macro da Rakuten Advertising | Parâmetro da impact.com                                   | Descrição                                                                      |
| ---------------------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------ |
| `<LSNSITEID>`                | `{ransiteid}`                                             | ID do clique da Rakuten Advertising — identificador exclusivo do clique.       |
| `<LSNPUBID>`                 | `{extract(ransiteid, "^([^-]+)", 1)}`                     | SID criptografado da Rakuten Advertising — isola seu ID histórico de parceiro. |
| `<LSNLNKTYPE>`               | `{iradtype}`                                              | Tipo de anúncio — texto descritivo, como banner, texto ou imagem.              |
| `<LSNSID>`                   | `{irpid}`                                                 | ID do parceiro da impact.com — o ID exclusivo do parceiro que fez a indicação. |
| `<LSNCRTID>`                 | `{iradid}`                                                | ID do anúncio da impact.com — o recurso criativo específico usado.             |
| `<PUBU1>`                    | `{subId1}`                                                | Valor do membro/usuário (U1) — valor personalizado enviado pelos parceiros.    |
| `<LSNSUBID>`                 | `{sharedid}`                                              | Valor do Sub-ID — o Sub-ID especificado pelo parceiro.                         |
| `<LSNPUBNAME>`               | `{irmpname}`                                              | Nome do parceiro — o nome do parceiro.                                         |
| `<LSNLNKNAME>`               | `{iradname}`                                              | Nome do link — o nome que você deu ao link criativo.                           |
| `<LSNPUBGROUP>`              | `{irmpgroupname}`                                         | Grupo de parceiros — qualquer grupo ao qual você tenha atribuído o parceiro.   |
| `<LSNCLKDATE>`               | `{urlencode(datefmt("yyyy-MM-dd'T'HH:mm:ss'Z'", "UTC"))}` | Data e hora do clique — carimbo de data/hora UTC padronizado.                  |
| `<gaid_raw>`                 | `{googleaid}`                                             | ID de publicidade do Google — usado para rastreamento em aplicativos móveis.   |
| `<ifa_raw>`                  | `{appleifa}`                                              | ID IFA da Apple — usado para rastreamento em aplicativos iOS.                  |

</details>
{% endstep %}

{% step %}

## Gerenciar reversões

Ao migrar seu programa de parcerias da Rakuten Advertising para a impact.com, a forma de processar reversões de pedidos, como devoluções, cancelamentos ou edições, depende inteiramente dos métodos de rastreamento ativos no seu site em cada momento. É importante acertar a sequência para evitar reversões não registradas ou atribuição de crédito em duplicidade.

* [x] **Antes de mudar para o rastreamento da impact.com**: Depois que sua conta for migrada para a impact.com, seu site ainda poderá usar os métodos de rastreamento da Rakuten, e os parceiros continuarão gerando tráfego por meio dos links da Rakuten. Durante esse período, continue enviando suas reversões para a Rakuten, não para a impact.com.
* [x] **Depois de mudar para o rastreamento da impact.com**: Assim que substituir o rastreamento da Rakuten pelo rastreamento da impact.com, comece a [enviar todas as novas reversões](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md) diretamente para a impact.com. Toda transação datada de antes da mudança para o rastreamento da impact.com ainda deverá ser informada à Rakuten.
  {% endstep %}

{% step %}

## Gerenciar parceiros de serviços de comparação de preços (CSS)

Se você trabalha com um parceiro de serviço de comparação de preços (CSS) para seus anúncios do Google Shopping, siga estas etapas para que o rastreamento continue sem interrupções durante a reintegração à impact.com:

1. **Após a migração para a impact.com:** Se seu site ainda estiver usando o rastreamento da Rakuten, seus parceiros CSS deverão continuar usando exclusivamente os links de rastreamento da Rakuten. (Parceiros que não sejam CSS e não dependam de anúncios do Google Shopping podem fazer a transição para os links de rastreamento da impact.com antes, sem problemas.)
2. **Etapa de preparação:** Quando estiver pronto para integrar o rastreamento da impact.com, forneça ao engenheiro de integração da impact.com uma lista completa dos seus parceiros CSS atuais. A impact.com configurará um mapeamento de roteamento duplo para você. Assim, os links de rastreamento legados da Rakuten e os novos links da impact.com serão resolvidos e rastreados simultaneamente após a mudança para o rastreamento da impact.com.
3. **Fase pós-integração:** Quando sua equipe passar a usar totalmente o rastreamento da impact.com, seus parceiros CSS serão certificados para usar links da Rakuten e da impact.com sem falhas de rastreamento.
   {% endstep %}

{% step %}

## Visualize os dados de ação da Rakuten usando os nomes de campos da RAD

Os relatórios Advanced Action Listing (AAL) e AAL+SKU da Rakuten Advertising usam seus próprios conjuntos de nomes de campos. Os relatórios Advanced Action Listing w/RAD Fields abaixo são iguais aos nossos relatórios Advanced Action Listing padrão, mas com os nomes de campos da Rakuten. Assim, durante a transição para a impact.com, você poderá visualizar os dados de ação usando uma terminologia que já conhece.

Os relatórios personalizados a seguir usam os nomes de parâmetros da Rakuten para facilitar sua transição para os relatórios da impact.com:

* [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)

Esta referência mostra como os nomes de campos da Rakuten correspondem aos parâmetros da impact.com:

<details>

<summary>Referência de mapeamento de campos</summary>

| Campo da Rakuten Advertising (RAD) | Correspondência na 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/pt-br/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.
