> ## Documentation Index
> Fetch the complete documentation index at: https://docs.easyfy.click/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar o Rakuten

> Conecte sua conta do Rakuten Advertising e gere links das lojas em que você foi aprovado.

O Rakuten Advertising é uma rede de afiliados: em vez de uma loja só, você
tem acesso a todas as marcas em que foi aprovado — como Nuuvem, DJI, Insider
Store, Buser e ASUS. Você cola o link da loja e o Easyfy descobre sozinho de
qual marca ele é.

## Pré-requisitos

<Check>Ter uma conta de Publisher aprovada no [Rakuten Advertising](https://rakutenadvertising.com/).</Check>
<Check>Estar aprovado em pelo menos um programa de anunciante.</Check>

## Onde pegar as credenciais

<Steps>
  <Step title="Entre no portal de desenvolvedores">
    Acesse [developers.rakutenadvertising.com](https://developers.rakutenadvertising.com)
    com a sua conta de Publisher.
  </Step>

  <Step title="Abra a área de acessos">
    Procure por **Access Tokens**. Ali ficam os dois códigos da sua conta:
    o **Client ID** (o nome dela) e o **Client Secret** (a senha dela).
  </Step>

  <Step title="Anote o ID do site">
    Na mesma tela, o campo aparece como **Token Scope (sid)** — é um número,
    e é o ID do seu site no Rakuten.

    <Info>
      O painel do Rakuten dá um nome estranho a esse campo. No Easyfy ele se
      chama **ID do site**, que é o que o número realmente significa.
    </Info>
  </Step>

  <Step title="Guarde o Client Secret">
    <Warning>
      O Client Secret é exibido uma única vez. Copie e guarde com segurança.
    </Warning>
  </Step>
</Steps>

## Configurando no Easyfy

Em **Credenciais → Rakuten**, preencha:

| Campo         | Valor                                         |
| ------------- | --------------------------------------------- |
| Client ID     | O primeiro código, que identifica sua conta   |
| Client Secret | O segundo código, que funciona como senha     |
| ID do site    | O número que aparece como "Token Scope (sid)" |

Pronto. Ao colar o link de uma loja em **Gerar link**, o Easyfy reconhece a
loja entre as suas parcerias e gera o link de afiliado sozinho.

## Como funciona a geração

<Info>
  **Você não precisa dizer de que marca é o link.** O Easyfy pergunta ao
  Rakuten, um a um, entre os seus parceiros, e usa o que a rede confirmar.
</Info>

Título, preço e imagem vêm do **catálogo da própria marca**, e não da leitura
da página da loja. Na prática isso funciona melhor: há lojas cuja página o
Easyfy não consegue ler, e pelo catálogo os dados vêm completos mesmo assim.

Se o produto não estiver no catálogo, o Easyfy tenta ler a página, como faz
com as outras lojas. E se nem assim vier, você mesmo preenche título, preço e
imagem no editor. **O link de afiliado é gerado nos três casos** — o que pode
faltar é só o preenchimento automático.

## Problemas comuns

<AccordionGroup>
  <Accordion title="'Essa loja não está entre os seus programas ativos'">
    Suas credenciais estão certas — o que falta é a parceria com essa marca.
    Peça a aprovação no painel do Rakuten e tente de novo depois que ela sair.
  </Accordion>

  <Accordion title="'Rakuten recusou suas credenciais'">
    Aqui sim o problema é nos códigos: confira o Client ID, o Client Secret e
    o ID do site. Quando o Rakuten está apenas fora do ar, a mensagem é outra,
    pedindo para tentar mais tarde.
  </Accordion>

  <Accordion title="A marca não aceita link para a página do produto">
    Algumas marcas só permitem link para a página inicial da loja. Nesse caso,
    use o endereço da home em vez do endereço do produto.
  </Accordion>
</AccordionGroup>

## Recursos úteis

<CardGroup cols={2}>
  <Card title="Rakuten Advertising" icon="external-link" href="https://rakutenadvertising.com">
    Painel oficial
  </Card>

  <Card title="Ajuda do Rakuten" icon="book-open" href="https://developers.rakutenadvertising.com/documentation">
    Documentação oficial
  </Card>
</CardGroup>