> 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).
# Da Rakuten Advertising para o impact.com: principais etapas da transição
Sua migração para o 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ções. Conclua as etapas a seguir na ordem indicada:
{% stepper %}
{% step %}
## Revise os parâmetros da sua página de destino
Seus parâmetros de rastreamento existentes da Rakuten Advertising já estão pré-carregados na sua conta do impact.com, então não há nada que você precise configurar. Esta etapa explica como suas macros legadas da Rakuten Advertising se mapeiam para o impact.com, onde encontrá-las e duas mudanças às quais você deve ficar atento.
### Explicação dos modelos de rastreamento
No impact.com, os parâmetros da sua página de destino são gerenciados automaticamente usando [modelos de rastreamento do 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 aos URLs da sua página de destino 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 de analytics e codificados:** Seus parâmetros analíticos codificados manualmente existentes, como `utm_medium=rakuten`, são preservados, para que seus relatórios continuem consistentes. Você pode atualizá-los ou adicionar novos, como UTMs do Google Analytics, a qualquer momento.
### Acessar modelos de rastreamento do gateway
Você pode acessar esses modelos de rastreamento para revisá-los ou ajustá-los depois.
1. Na barra de navegação superior, selecione  **\[Perfil do usuário] → Configurações**.
2. Na *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 essenciais que já estão configuradas. Não as remova nem 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`. O impact.com exibe rótulos de texto legíveis em vez disso, por exemplo, `banner`, `texto`, ou `imagem` por meio de `{iradtype}`. Se seu banco de dados interno de analytics depende do formato numérico, avise seu desenvolvedor sobre essa mudança.
A referência abaixo mostra como suas macros legadas da Rakuten Advertising se mapeiam para os parâmetros do impact.com:
Referência de mapeamento de macros da Rakuten Advertising para o impact.com
| Macro da Rakuten Advertising | Parâmetro do impact.com | Descrição |
| ---------------------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------ |
| `` | `{ransiteid}` | ID do clique da Rakuten Advertising — o identificador exclusivo do clique. |
| `` | `{extract(ransiteid, "^([^-]+)", 1)}` | SID criptografado da Rakuten Advertising — isola seu ID histórico do parceiro. |
| `` | `{iradtype}` | Tipo de anúncio — texto descritivo como banner, texto ou imagem. |
| `` | `{irpid}` | ID do parceiro do impact.com — o ID exclusivo do parceiro de referência. |
| `` | `{iradid}` | ID do anúncio do impact.com — o recurso criativo específico usado. |
| `` | `{subId1}` | Valor de membro/usuário (U1) — o valor personalizado passado pelos parceiros. |
| `` | `{sharedid}` | Valor de sub-ID — a sub-ID especificada pelo parceiro. |
| `` | `{irmpname}` | Nome do parceiro — o nome do parceiro. |
| `` | `{iradname}` | Nome do link — o nome que você deu ao link criativo. |
| `` | `{irmpgroupname}` | Grupo de parceiros — qualquer grupo ao qual você tenha atribuído o parceiro. |
| `` | `{urlencode(datefmt("yyyy-MM-dd'T'HH:mm:ss'Z'", "UTC"))}` | Data e hora do clique — carimbo de data/hora UTC padronizado. |
| `` | `{googleaid}` | ID de publicidade do Google — usado para rastreamento de aplicativos móveis. |
| `` | `{appleifa}` | ID IFA da Apple — usado para rastreamento de apps iOS. |
{% endstep %}
{% step %}
## Gerenciar suas reversões
À medida que você faz a transição do seu programa de parcerias da Rakuten Advertising para o impact.com, a forma como você processa reversões de pedidos, como devoluções, cancelamentos ou edições, depende totalmente de quais métodos de rastreamento estão ativos no seu site em um determinado momento. Você deve evitar errar essa sequência, pois isso pode resultar em reversões perdidas ou crédito duplicado.
* [x] **Antes de mudar para o rastreamento do impact.com**: Assim que sua conta tiver sido migrada para o impact.com, seu site ainda poderá 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, e não para o impact.com.
* [x] **Depois de mudar para o rastreamento do impact.com**: Assim que você substituir o rastreamento da Rakuten pelo rastreamento do impact.com, você começará [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 o impact.com. Qualquer transação com data anterior à troca para o rastreamento do impact.com ainda deve ser reportada à Rakuten.
{% endstep %}
{% step %}
## Gerenciar 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ções enquanto você reintegra ao impact.com:
1. **Depois de migrar para o impact.com:** Seus parceiros de CSS devem continuar usando links de rastreamento apenas da Rakuten enquanto seu site ainda estiver executando o 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 do impact.com mais cedo, sem problemas).
2. **A fase de preparação:** Quando estiver pronto para integrar o rastreamento do impact.com, forneça ao seu Engenheiro de Integração do impact.com uma lista completa dos seus parceiros de CSS existentes. O impact.com configurará um mapeamento de roteamento duplo para você. Isso garante que os links de rastreamento legados da Rakuten e os novos links do impact.com sejam resolvidos e rastreados simultaneamente após a troca para o rastreamento do impact.com.
3. **Fase pós-integração:** Assim que sua equipe fizer a troca completa para o rastreamento do impact.com, seus parceiros de CSS estarão certificados para executar links da Rakuten e do impact.com sem lacunas de rastreamento.
{% endstep %}
{% step %}
## Veja os seus dados no nível de ação da Rakuten usando nomes de campos RAD
O relatório Advanced Action Listing da Rakuten Advertising (AAL) e o relatório AAL+SKU usam seu próprio conjunto de nomes de campos. Os relatórios Advanced Action Listing com campos RAD abaixo são iguais aos nossos relatórios padrão Advanced Action Listing, apenas renomeados com os nomes de campos da Rakuten, então, quando você fizer a transição para o impact.com, poderá visualizar seus dados no nível de ação usando a 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 do impact.com:
* [Advanced Action Listing com campos RAD](https://app.impact.com/secure/advertiser/report/viewReport.report?handle=18648)
* [Advanced Action Listing 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 se mapeiam para os parâmetros do impact.com:
Referência de mapeamento de campos
| Campo da Rakuten Advertising (RAD) | Correspondência no 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` |
| `Audiência dos publishers` | `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` |
{% endstep %}
{% endstepper %}
---
# 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/pt-br/what-would-you-like-to-learn-about/getting-started/rakuten-advertising-to-impact.com-key-transition-steps.md?ask=&goal=
```
`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.