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

# Migração de Campanhas

> Migrando campanhas existentes de outras plataformas de anúncios para a Topsort

export const LastUpdatedPt = ({date}) => {
  const label = "Última atualização:";
  return <>
      <style>{`
        .last-updated-component {
          display: inline-flex;
          align-items: center;
          gap: 8px;
          padding: 10px 16px;
          border-radius: 8px;
          margin-top: 12px;
          margin-bottom: 16px;
          font-size: 14px;
          background-color: rgba(0, 0, 0, 0.05);
          border: 1px solid rgba(0, 0, 0, 0.12);
          color: rgba(0, 0, 0, 0.75);
          line-height: 1;
        }

        .last-updated-component svg {
          flex-shrink: 0;
          vertical-align: middle;
        }

        .last-updated-component span {
          display: inline-flex !important;
          align-items: center !important;
          line-height: 1 !important;
        }

        [data-theme="dark"] .last-updated-component {
          background-color: #3a3a3a;
          border: 2px solid #888888;
          color: #ffffff;
        }

        [data-theme="dark"] .last-updated-component svg {
          stroke: #ffffff;
        }
      `}</style>
      <div className="last-updated-component">
        <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
          <circle cx="12" cy="12" r="10" />
          <polyline points="12 6 12 12 16 14" />
        </svg>
        <span>
          <strong style={{
    fontWeight: 600
  }}>{label}</strong> 
          <time dateTime={date}>{date}</time>
        </span>
      </div>
    </>;
};

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  A migração de campanhas é o processo de transferir campanhas publicitárias existentes da plataforma de anúncios atual de um cliente para a Topsort. Isso garante uma transição suave que mantém a continuidade das campanhas enquanto os clientes integram nosso ecossistema de publicidade.
</div>

## Problema

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  Muitos clientes já operam negócios publicitários estabelecidos com campanhas ativas em outras plataformas. Ao fazer a transição para a Topsort, eles precisam que seus dados de campanha existentes sejam migrados para:
</div>

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  * **Manter a continuidade dos negócios**: Evitar interrupções nos esforços publicitários em andamento
  * **Preservar relacionamentos com anunciantes**: Garantir que os anunciantes tenham uma transição perfeita
  * **Habilitar produtividade imediata**: Permitir que os anunciantes continuem suas campanhas sem começar do zero
</div>

<Note>
  Esta migração foca apenas na estrutura e configurações de campanhas ativas.
  Dados históricos de desempenho e métricas passadas de plataformas anteriores não são
  transferidos, garantindo um começo limpo dentro do ecossistema Topsort.
</Note>

## Solução

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  Fornecemos uma **solução de automação baseada em script** que lê dados de campanha de arquivos estruturados e cria automaticamente campanhas equivalentes no Serviço de Campanhas da Topsort. Esta abordagem transforma dados de campanha da plataforma anterior do cliente em campanhas totalmente funcionais em nosso ecossistema.
</div>

### Abordagem de Migração Baseada em Arquivos

<Note>
  A abordagem baseada em arquivos significa que os clientes exportam seus dados de campanha em um
  formato de arquivo CSV (valores separados por vírgula) padronizado, em vez de conectar
  sistemas diretamente através de APIs. Este arquivo serve como a ponte entre a plataforma antiga
  e a Topsort.
</Note>

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  **Como Funciona:**
</div>

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  1. **Exportação de Dados:** O cliente exporta manualmente detalhes de campanha de sua plataforma atual para um arquivo CSV
  2. **Transferência de Arquivo:** O cliente fornece o arquivo CSV diretamente à Topsort
  3. **Processamento de Script:** Nossos scripts automatizados leem os dados do CSV e criam campanhas via APIs da Topsort
  4. **Validação:** As campanhas recém-criadas são verificadas em relação aos dados originais
</div>

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  **Por Que Esta Abordagem:**
</div>

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  * **Limitações da Plataforma:** Muitas plataformas de anúncios legadas carecem de APIs modernas para extração de dados
  * **Sistemas Descontinuados:** Plataformas sendo descontinuadas frequentemente têm suporte técnico limitado ou inexistente
  * **Confiabilidade:** Transferência baseada em arquivo garante captura completa de dados sem limites de taxa de API ou problemas de conectividade
  * **Flexibilidade:** O formato CSV pode acomodar várias estruturas de dados de diferentes plataformas de origem
  * **Controle:** Os clientes têm visibilidade completa de exatamente quais dados estão sendo migrados
</div>

### Implementação Técnica

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  Nossos scripts de migração são projetados para:
</div>

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  * **Analisar dados CSV** com tratamento robusto de erros e validação
  * **Mapear campos de dados** da estrutura da plataforma de origem para o esquema de campanha da Topsort
  * **Criar campanhas** usando as APIs de Campanha da Topsort com autenticação adequada
  * **Aplicar padrões** como configurar todas as campanhas para autobidding e formato de listagem
  * **Gerar relatórios** de migrações bem-sucedidas e quaisquer problemas encontrados
</div>

## Processo de Migração

<Steps>
  <Step title="Avaliação de Dados e Planejamento">
    <div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
      **Avaliar Portfólio de Campanhas Atual**
    </div>

    * Revisar campanhas existentes e sua complexidade
    * Identificar quais campanhas devem ser migradas
    * Avaliar capacidades de exportação de dados da plataforma atual
    * Desenvolver cronograma de migração e requisitos de recursos

    <div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
       
    </div>
  </Step>

  <Step title="Exportação e Preparação de Dados">
    <div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
      **Informações de Campanha Padrão Necessárias:**
    </div>

    * Identificação da campanha (nome, ID único, informações do anunciante/fornecedor)
    * Configuração da campanha (tipo, formato, configurações de segmentação)
    * Configurações de orçamento (valor, tipo: diário/semanal/mensal)
    * Duração da campanha e datas de término
    * Informações de produto e identificadores

    <Note>
      Este método é usado quando a plataforma de anúncios anterior não possui APIs disponíveis para
      transferência direta de dados, está sendo descontinuada ou tem suporte limitado para
      extração de dados.
    </Note>
  </Step>

  <div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
     
  </div>

  <Step title="Teste de Amostra">
    <div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
      **Processo de Validação:**
    </div>

    * O cliente fornece uma pequena amostra de campanhas (tipicamente 3-5)
    * As campanhas são processadas em nosso ambiente de teste
    * O cliente revisa as campanhas migradas através da interface Topsort
    * Quaisquer ajustes são feitos com base no feedback

    <div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
       
    </div>
  </Step>

  <Step title="Execução Completa da Migração">
    <div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
      **Padrões de Processamento:**
    </div>

    * Todas as campanhas migradas são marcadas com identificadores especiais para rastreamento
    * As campanhas começam do zero sem dados históricos de lances
    * As configurações de segmentação são padronizadas de acordo com as melhores práticas da plataforma
    * As configurações originais de orçamento e duração são mantidas

    <div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
       
    </div>
  </Step>

  <Step title="Verificação e Ativação">
    <div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
      **Etapas de Garantia de Qualidade:**
    </div>

    * Verificar se todos os detalhes da campanha foram transferidos corretamente
    * Confirmar que as campanhas operam conforme esperado
    * Testar a funcionalidade da interface do anunciante
    * Obter aprovação final do cliente antes da ativação
  </Step>
</Steps>

## Requisitos de Dados

### Campos de Campanha Obrigatórios

| Campo              | Descrição                                                       | Exemplo                         |
| ------------------ | --------------------------------------------------------------- | ------------------------------- |
| ID do Fornecedor   | Identificador do anunciante em seu catálogo                     | `vendor-123`                    |
| Nome da Campanha   | Nome descritivo da campanha                                     | `Promoções de Verão 2025`       |
| Tipo de Campanha   | Sempre definido como `autobidding`                              | `autobidding`                   |
| Formato do Anúncio | Sempre definido como `listing` para migrações                   | `listing`                       |
| Segmentação        | Definido como `autotargeting` com gatilhos de produto/categoria | `autotargeting`                 |
| Valor do Orçamento | Valor do orçamento da campanha                                  | `400`                           |
| Tipo de Orçamento  | Frequência do orçamento                                         | `monthly`, `daily`, `weekly`    |
| Data de Término    | Data de término da campanha                                     | `2025-08-15T23:55:00+02:00`     |
| ID Externo         | Número de referência da plataforma anterior                     | `PO-12345`                      |
| IDs de Produtos    | Array de IDs de produtos do seu catálogo                        | `[1001590556, 1001590557, ...]` |

### Exemplo de Formato CSV

```csv theme={null}
Vendor_id,campaignType,name,promotionType.adFormat,triggers,budget.amount,budget.type,endDate,externalCampaignID,productIDs
vendor-123,autobidding,Promoções de Verão 2025,listing,autotargeting,400,monthly,2025-08-15T23:55:00+02:00,PO-12345,"1001590556,1001590557,1001590559"
```

## Planejamento de Contingência

### Procedimentos de Rollback

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  Se surgirem problemas durante ou após a migração, as campanhas podem ser rapidamente revertidas:
</div>

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  1. **Identificação:** Campanhas migradas são facilmente identificáveis através de marcação especial
  2. **Processo de Remoção:** Scripts automatizados podem remover campanhas migradas se necessário
  3. **Verificação:** Confirmar rollback bem-sucedido através de verificações do sistema
  4. **Comunicação:** Notificar todas as partes interessadas sobre a conclusão do rollback
</div>

### Estratégias de Mitigação de Riscos

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  * **Estratégia de Backup:** Os dados originais da campanha são preservados durante todo o processo
  * **Abordagem Faseada:** Migrações grandes são divididas em lotes gerenciáveis
  * **Ambiente de Teste:** Todas as migrações são testadas antes da implantação em produção
  * **Suporte Especializado:** Equipe técnica disponível durante todo o processo de migração
</div>

## Métricas de Sucesso

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  O sucesso da migração é medido por:
</div>

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  * **Precisão de Dados:** 100% das configurações de campanha transferidas corretamente
  * **Satisfação do Anunciante:** Experiência de transição suave com curva de aprendizado mínima
  * **Aderência ao Cronograma:** Migração concluída dentro do prazo acordado
  * **Desempenho Pós-Migração:** Campanhas operando efetivamente no novo ambiente
</div>

## Próximos Passos

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  Para clientes considerando migração de campanhas:
</div>

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  1. **Entre em contato com seu gerente de conta** para discutir requisitos de migração
  2. **Agende uma avaliação** do portfólio de campanhas atual
  3. **Planeje o cronograma de migração** com base nas prioridades de negócio
  4. **Inicie a preparação de dados** e processos de integração de catálogo
</div>

<Warning>
  Garanta que seu catálogo de produtos esteja totalmente integrado e validado antes de começar
  a migração de campanha para evitar problemas de mapeamento de dados.
</Warning>

***

<LastUpdatedPt date="2025-11-18" />