> 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. Assim que sua conta estiver ativa, você precisará concluir alguns itens de ação para que seus relatórios de reversão e o rastreamento de parceiros sejam transferidos sem interrupção. Conclua as etapas a seguir na ordem:

{% stepper %}
{% step %}

## Revise os parâmetros da sua landing page

Seus parâmetros de rastreamento existentes da Rakuten Advertising já estão pré-carregados na sua conta da impact.com, então não há nada que você precise configurar. Esta etapa explica como suas macros legadas da Rakuten Advertising são mapeadas para a impact.com, onde encontrá-las e duas mudanças das quais você deve estar ciente.

### Explicação dos modelos de rastreamento

Na impact.com, os parâmetros da sua landing page são gerenciados automaticamente usando [modelos de rastreamento Gateway](/brand/pt-br/what-would-you-like-to-learn-about/account-administration/program-settings/tracking-settings/configure-gateway-tracking-settings.md). Esses modelos anexam parâmetros de rastreamento às URLs da sua landing page sempre que alguém clica em um link de parceiro.

* **Valores dinâmicos:** 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 um usuário clica em um link.
* **Parâmetros analíticos e codificados manualmente:** Seus parâmetros analíticos codificados manualmente existentes, como `utm_medium=rakuten`, são preservados, para que seus relatórios permaneçam consistentes. Você pode atualizar esses parâmetros ou adicionar novos, como UTMs do Google Analytics, a qualquer momento.

### Acesse os modelos de rastreamento Gateway

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

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. No *Configurações do programa* coluna (à 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 *Modelo de rastreamento do programa* seção.

### Verifique 2 coisas antes de fazer a troca

1. **Mantenha o rastreamento ativo — não exclua estes parâmetros:** Seu Modelo de rastreamento do programa inclui linhas de rastreamento importantes que já estão configuradas. Não as remova nem as renomeie, pois elas conectam os cliques às conversões bem-sucedidas:
   * `im_ref` deve permanecer definido como `{clickid}`
   * `ranSiteID` deve permanecer definido como `{ransiteid}`
2. **Os tipos de link agora são baseados em texto:** As macros legadas da Rakuten Advertising mostram os tipos de link como números, por exemplo, `3`. A impact.com exibe rótulos de texto legíveis em vez disso, por exemplo, `banner`, `texto`, ou `imagem` por meio de `{iradtype}`. Se o seu banco de dados interno de analytics depende do formato numérico, informe seu desenvolvedor sobre essa mudança.

A referência abaixo mostra como suas macros legadas da Rakuten Advertising são mapeadas para os parâmetros da impact.com:

<details>

<summary>Referência de mapeamento de macros da Rakuten Advertising para a impact.com</summary>

| Macro da Rakuten Advertising | Parâmetro da impact.com                                   | Descrição                                                                      |
| ---------------------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------ |
| `<LSNSITEID>`                | `{ransiteid}`                                             | ID de clique da Rakuten Advertising — o 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 ativo criativo específico usado.               |
| `<PUBU1>`                    | `{subId1}`                                                | Valor de membro/usuário (U1) — o valor personalizado enviado pelos parceiros.  |
| `<LSNSUBID>`                 | `{sharedid}`                                              | Valor de Sub-ID — a Sub-ID especificada 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 do parceiro — qualquer grupo ao qual você atribuiu 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 de aplicativos móveis.   |
| `<ifa_raw>`                  | `{appleifa}`                                              | ID IFA da Apple — usado para rastreamento de apps iOS.                         |

</details>
{% endstep %}

{% step %}

## Gerencie suas reversões

À medida que você faz a transição do seu programa de parceria da Rakuten Advertising para a impact.com, a forma como você processa reversões de pedidos, como devoluções, cancelamentos ou edições, depende inteiramente de quais métodos de rastreamento estão ativos no seu site em qualquer momento. Você quer evitar errar essa sequência, o que pode resultar em reversões perdidas ou crédito em duplicidade.

* [x] **Antes de mudar para o rastreamento da impact.com**: Assim que sua conta for migrada para a impact.com, seu site ainda pode estar usando métodos de rastreamento da Rakuten, e os parceiros continuarão direcionando tráfego por meio de links da Rakuten. Durante esse período, você continua 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 você trocar o rastreamento da Rakuten pelo rastreamento da impact.com, você passa a [enviar todas as novas reversões](/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. Qualquer transação datada antes da troca para o rastreamento da impact.com ainda deve ser reportada à Rakuten.
  {% endstep %}

{% step %}

## Gerencie parceiros de Comparison Shopping Service (CSS)

Se você trabalha com um parceiro de Comparison Shopping Service (CSS) para seus anúncios do Google Shopping, siga estas etapas para que o rastreamento continue sem interrupção enquanto você reintegra à impact.com:

1. **Após a migração para a impact.com:** Seus parceiros CSS devem continuar usando links de rastreamento exclusivos da Rakuten enquanto seu site ainda estiver usando rastreamento da Rakuten. (Parceiros não CSS que não dependem de anúncios do Google Shopping podem fazer a transição para links de rastreamento da impact.com mais cedo sem problemas).
2. **A fase de preparação:** Quando estiver pronto para integrar com o rastreamento da impact.com, forneça ao seu Engenheiro de Integração da impact.com uma lista completa dos seus parceiros CSS existentes. A impact.com configurará um mapeamento de roteamento duplo para você. Isso garante que os links de rastreamento legados da Rakuten e os novos links da impact.com serão resolvidos e rastreados simultaneamente após a troca para o rastreamento da impact.com.
3. **Fase pós-integração:** Assim que sua equipe mudar completamente para o rastreamento da impact.com, seus parceiros CSS serão certificados para executar tanto links da Rakuten quanto da impact.com sem lacunas de rastreamento.
   {% endstep %}

{% step %}

## Veja seus dados de ação da Rakuten usando nomes de campos RAD

O relatório Advanced Action Listing (AAL) e o relatório AAL+SKU da Rakuten Advertising usam seu próprio conjunto de nomes de campos. Os relatórios Advanced Action Listing w/RAD Fields abaixo são iguais aos nossos relatórios padrão de Advanced Action Listing, apenas renomeados com os nomes de campos da Rakuten, então, ao fazer a transição para a impact.com, você pode visualizar seus dados em nível de ação usando uma terminologia com a qual já está familiarizado.

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

* [Listagem Avançada de Ações com Campos RAD](https://app.impact.com/secure/advertiser/report/viewReport.report?handle=18648)
* [Listagem Avançada de Ações com SKU com Campos RAD](https://app.impact.com/secure/advertiser/report/viewReport.report?handle=18608)

Esta referência mostra como esses nomes de campos da Rakuten são mapeados para os 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`                    | `ID da campanha`                                    |
| `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`                  | `Texto1`                                            |
| `coupon`                           | `OrderPromoCode/ItemPromoCode[i]`                   |
| `credit_card_last_four`            | `Text21`                                            |
| `credit_card_type`                 | `PaymentType`                                       |
| `currency`                         | `CurrencyCode`                                      |
| `customer_id`                      | `CustomerId`                                        |
| `customer_rank`                    | `Texto2`                                            |
| `customer_segment`                 | `Texto3`                                            |
| `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 (para conversões se não for por referência)` |
| `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 (para conversões se não for por referência)` |
| `transaction_datetime`             | `Data do evento`                                    |
| `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.
