> 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/partner/pt-br/sobre-o-que-voce-gostaria-de-aprender/getting-started/migrate-your-rakuten-advertising-tracking-to-impact.com.md).

# Migre seu rastreamento do Rakuten Advertising para a impact.com

Este artigo mostra aos parceiros como migrar sua infraestrutura de rastreamento da Rakuten Advertising (LinkShare) para o impact.com. Use-o para mapear parâmetros dinâmicos, configurar payloads de segmentação de público e evitar lacunas no rastreamento. Para dúvidas sobre vinculação de contas, redirecionamentos de links existentes e pagamentos, consulte o [Rakuten Advertising para impact.com: FAQ de Migração de Parceiros](/partner/pt-br/sobre-o-que-voce-gostaria-de-aprender/getting-started/rakuten-advertising-to-impact.com-partner-migration-faq.md).

## Comparação da estrutura de links

Veja como um link de rastreamento legado da Rakuten Advertising é traduzido para seu equivalente nativo no impact.com:

```
Link legado da Rakuten 
https://click.linksynergy.com/fs-bin/click?id=[SID]&offerid=[MID]&type=3&subid=ABC&u1=QWERTYQWERTY&u5=eyI0MSI6ICIxMjMsNDU2NyJ9

Link equivalente nativo do impact.com 
https://brand.sjv.io/c/[MPID]/[AdID]/[CampaignID]?sharedid=ABC&subId1=QWERTYQWERTY&audiences=WyIxMjMiLCI0NTY3Il0
```

## Referência de mapeamento de parâmetros

| Parâmetro da Rakuten Advertising | Parâmetro do impact.com       | Finalidade e descrição                                                                                                           | Visibilidade nos relatórios                                                     |
| -------------------------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| `subid`                          | `sharedid` *(ou `subacctid`)* | ID do subparceiro: identifica subparceiros ou fontes de sub-rede downstream.                                                     | Visível para a marca e o parceiro (suporta regras personalizadas de pagamento). |
| `u1`                             | `subId1`                      | ID de clique do parceiro ou de membro: usado para IDs exclusivos de membros de fidelidade, tokens de clique ou IDs de transação. | Privado para o parceiro (visível nos relatórios de desempenho do parceiro).     |
| `u5`                             | `audiences`                   | Segmento de público: metadados de cliente segmentados (veja os formatos detalhados abaixo).                                      | Visível para a marca e o parceiro.                                              |

Para saber mais sobre como `sharedid` e `subId1` funcionam, veja [Explicação dos Parâmetros de Sub ID e Shared ID para Parceiros](/partner/pt-br/sobre-o-que-voce-gostaria-de-aprender/platform-features/tracking/tracking-links/link-parameters/sub-id-and-shared-id-parameters-explained-for-partners.md).

## Configuração do parâmetro de público (`u5` → `audiences`)

Nos links do impact.com, os metadados de público vão no `audiences` parâmetro (plural). Como as duas plataformas tratam os metadados de forma diferente, copiar seus payloads legados diretamente quebra seu rastreamento.

A principal diferença:

* **Rakuten Advertising (`u5`):** Espera um objeto JSON codificado em base64 padrão, *objeto*, por exemplo `{"41": "123,4567"}`.
* **impact.com (`audiences`):** Espera um array JSON, *array*, por exemplo `["123","4567"]`, usando codificação base64url ou um payload bruto codificado em URL.

Use um destes dois formatos para mapear seus `u5` payloads legados para o `audiences`:

{% tabs %}
{% tab title="Método A: codificação base64url (recomendado)" %}
O impact.com suporta o alfabeto base64url (RFC 4648 Seção 5), *não* base64 padrão.

* Por que usar: o base64 padrão usa caracteres como `+`, `/`, e `=`, que os servidores web podem remover ou interpretar incorretamente durante redirecionamentos. O base64url substitui esses caracteres, então o rastreamento permanece limpo.
  {% endtab %}

{% tab title="Método B: JSON codificado em URL (integração de código mais simples)" %}
Se sua equipe de engenharia quiser evitar refatorar bibliotecas padrão de base64, você pode passar o array JSON diretamente, desde que ele esteja codificado em porcentagem (URL-encoded) exatamente uma vez.
{% endtab %}
{% endtabs %}

## Exemplos de conversão de payload suportados

Use estes exemplos para mapear payloads legados para o `audiences` parâmetro:

| Dados armazenados de destino | Array JSON bruto | Método legado da Rakuten Advertising (u5) | Parâmetro do impact.com mapeado (audiences)                                                                 |
| ---------------------------- | ---------------- | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| 123,4567                     | `["123","4567"]` | `&u5=eyI0MSI6ICIxMjMsNDU2NyJ9`            | `&audiences=WyIxMjMiLCI0NTY3Il0` *(base64url)* ou `&audiences=%5B%22123%22%2C%224567%22%5D` *(URL-encoded)* |
| 98765                        | `["98765"]`      | `&u5=eyI0MSI6ICI5ODc2NSJ9`                | `&audiences=WyI5ODc2NSJd` *(base64url)*                                                                     |
| 123,4567 (*numérico*)        | `[123,4567]`     | `&u5=eyI0MSI6WzEyMyw0NTY3XX0=`            | `&audiences=WzEyMyw0NTY3XQ` *(base64url, sem o preenchimento final)*                                        |

## Configurações a evitar

Seus scripts de validação devem sinalizar e impedir estes erros comuns de formatação:

| Exemplo de parâmetro de consulta   | Por que não é suportado ou quebra o rastreamento                                                                               |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `audiences=123,4567`               | *Lista com vírgulas soltas.* Isso não é JSON válido.                                                                           |
| `audiences=123`                    | *Número JSON.* É analisado como um número JSON, que não é nem um array nem um objeto.                                          |
| `audiences=WyJhw77DvsO%2BIl0%3D`   | *Base64 padrão.* Contém caracteres padrão do base64 como `+`, que o decodificador base64url não suporta.                       |
| `audiences=%255B%252212%2522%255D` | *Codificado em porcentagem duas vezes.* Decodifica para `%5B%2212%22%5D` em vez de uma string limpa. Codifique apenas uma vez. |

## Modelo de código para desenvolvedores

Este exemplo em JavaScript mostra como atualizar sua lógica de geração de links da Rakuten Advertising para o impact.com:

```javascript
// ❌ LÓGICA LEGADA DE LINK DA RAKUTEN (u5)
const legacyAudience = {"41": "123,4567"};
const standardBase64 = btoa(JSON.stringify(legacyAudience)); // eyI0MSI6ICIxMjMsNDU2NyJ9
const rakutenLink = `https://click.linksynergy.com/fs-bin/click?id=AysPbYF8&u5=${encodeURIComponent(standardBase64)}`;

// LÓGICA NATIVA DE LINK DO impact.com (audiences)
const audienceArray = ["123", "4567"];
const jsonArrayString = JSON.stringify(audienceArray); // '["123","4567"]'

// Converta base64 padrão para base64url (substitui +, / e remove o = final)
const base64UrlPayload = btoa(jsonArrayString)
  .replace(/\+/g, '-')
  .replace(/\//g, '_')
  .replace(/=+$/, ''); // WyIxMjMiLCI0NTY3Il0

const impactLink = `https://brand.sjv.io/c/123456/789012/3456?sharedid=ABC&subId1=QWERTYQWERTY&audiences=${base64UrlPayload}`;
```

## Recursos adicionais

* [Rakuten Advertising para impact.com: FAQ de Migração de Parceiros](/partner/pt-br/sobre-o-que-voce-gostaria-de-aprender/getting-started/rakuten-advertising-to-impact.com-partner-migration-faq.md) — Obtenha respostas sobre vinculação de contas, redirecionamentos de links, pagamentos e relatórios durante a migração.
* [Referência de terminologia da Rakuten para o impact.com](/partner/pt-br/sobre-o-que-voce-gostaria-de-aprender/getting-started/rakuten-to-impact.com-terminology-reference.md) — Encontre o recurso do impact.com que corresponde a cada termo da Rakuten.
* [Explicação dos Parâmetros de Sub ID e Shared ID para Parceiros](/partner/pt-br/sobre-o-que-voce-gostaria-de-aprender/platform-features/tracking/tracking-links/link-parameters/sub-id-and-shared-id-parameters-explained-for-partners.md) — Saiba como Sub IDs e Shared IDs funcionam e formas comuns de usá-los para rastreamento.
* [Criar links de rastreamento](/partner/pt-br/sobre-o-que-voce-gostaria-de-aprender/platform-features/tracking/tracking-links/create-and-manage-links/create-tracking-links.md) — Obtenha links de rastreamento do impact.com para os assets de uma marca e adicione parâmetros de rastreamento.


---

# 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/partner/pt-br/sobre-o-que-voce-gostaria-de-aprender/getting-started/migrate-your-rakuten-advertising-tracking-to-impact.com.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.