> ## 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 Dados Históricos

> Migração de dados de desempenho históricos para resolver o problema de cold start durante a transição de plataforma

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 dados históricos é o processo de transferência de métricas de desempenho e dados de eventos da plataforma de anúncios anterior de um cliente para acelerar os modelos de machine learning do Topsort e reduzir o período de aprendizado inicial durante a transição de plataforma.
</div>

## Problema

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  Quando os clientes migram para o Topsort, suas campanhas enfrentam um **problema de cold start** onde:
</div>

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  * **Sem Histórico de Desempenho**: Novas campanhas começam sem nenhum dado de desempenho histórico
  * **Período de Aprendizado**: Modelos de machine learning requerem 1-4 semanas para acumular dados suficientes para otimização
  * **Desempenho Subótimo**: Durante o cold start, as campanhas podem ter desempenho inferior devido à falta de dados de treinamento
  * **Frustração do Anunciante**: Anunciantes podem experimentar efetividade reduzida de campanha nas semanas iniciais
</div>

<Note>
  Enquanto a [Migração de Campanhas](/pt/knowledge-base/ad-platform/campaign-migration/)
  lida com a estrutura e configurações da campanha, a migração de dados históricos
  especificamente aborda dados de desempenho para acelerar o treinamento do modelo e
  otimização.
</Note>

## Solução

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  Nós fornecemos uma **solução de ingestão de dados históricos** que importa métricas de desempenho e dados de eventos da plataforma anterior do cliente. Estes dados servem como material de treinamento inicial para os modelos de machine learning do Topsort, reduzindo significativamente o período de cold start.
</div>

### Como os Dados Históricos Ajudam

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  **Aceleração do Treinamento do Modelo:**
</div>

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  * Fornece dados de treinamento imediatos para algoritmos de machine learning
  * Reduz o período de cold start de 4 semanas para 1-2 semanas
  * Permite otimização de campanha e decisões de lances mais rápidas
</div>

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

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  * As campanhas podem aproveitar padrões de desempenho históricos
  * Melhores recomendações de lance inicial baseadas em dados passados
  * Decisões de segmentação melhoradas a partir do comportamento histórico do usuário
</div>

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  **Redução de Risco:**
</div>

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  * Minimiza a queda de desempenho durante a transição de plataforma
  * Mantém a confiança do anunciante com níveis de desempenho familiares
  * Fornece métricas de linha de base para comparação e otimização
</div>

### Implementação Técnica

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  Nossa integração de dados históricos:
</div>

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  * **Ingere dados de eventos** incluindo impressões orgânicas, cliques e compras
  * **Processa métricas de desempenho** nos níveis de campanha, produto e usuário
  * **Treina modelos iniciais** usando dados históricos importados antes do go-live
  * **Calibra algoritmos** durante a operação inicial para desempenho ótimo
  * **Atualiza embeddings** para usuários, produtos e posicionamentos com base em padrões históricos
</div>

## Processo de Migração

<Steps>
  <Step title="Avaliação de Dados e Definição de Escopo">
    <div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
      **Avaliar Disponibilidade de Dados Históricos**
    </div>

    * Avaliar quais dados de desempenho estão disponíveis da plataforma anterior
    * Determinar a qualidade e completude dos dados
    * Definir o intervalo de tempo para dados históricos (tipicamente 3-6 meses)
    * Identificar métricas-chave que se alinham com o rastreamento do Topsort

    <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'}}>
      **Tipos de Dados Históricos Necessários:**
    </div>

    * Métricas de desempenho de campanha (impressões, cliques, conversões, gastos)
    * Dados de desempenho no nível do produto (taxas de cliques, taxas de conversão)
    * Eventos de comportamento do usuário (buscas, visualizações, compras)
    * Padrões de tráfego orgânico e tendências sazonais
    * Histórico de utilização de lances e orçamento

    <Note>
      Todos os dados históricos devem estar em conformidade com regulamentações de privacidade. Dados no nível de usuário
      devem ser anonimizados ou agregados quando exigido por leis locais de privacidade.
    </Note>
  </Step>

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

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

    * Validar completude e precisão dos dados
    * Normalizar métricas para corresponder ao esquema de dados do Topsort
    * Limpar e processar dados para treinamento do modelo
    * Identificar e lidar com anomalias ou outliers de dados

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

  <Step title="Treinamento e Calibração do Modelo">
    <div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
      **Processo de Treinamento Inicial:**
    </div>

    * Importar dados históricos para o pipeline de treinamento do Topsort
    * Treinar modelos iniciais de machine learning usando padrões históricos
    * Calibrar algoritmos para desempenho ótimo
    * Validar precisão do modelo em relação a resultados históricos conhecidos

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

  <Step title="Implantação em Produção e Monitoramento">
    <div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
      **Processo de Go-Live:**
    </div>

    * Implantar modelos treinados no ambiente de produção
    * Monitorar desempenho inicial em relação às linhas de base históricas
    * Ajustar finamente algoritmos com base em novos dados em tempo real
    * Gradualmente mudar da otimização de dados históricos para dados em tempo real
  </Step>
</Steps>

## Requisitos de Dados

### Métricas de Desempenho Necessárias

| Categoria de Métrica       | Campos Necessários                                                          | Formato de Exemplo                                          |
| -------------------------- | --------------------------------------------------------------------------- | ----------------------------------------------------------- |
| **Desempenho de Campanha** | campaign\_id, date, impressions, clicks, conversions, spend                 | `campaign-123, 2024-01-15, 1000, 50, 5, 25.00`              |
| **Desempenho de Produto**  | product\_id, campaign\_id, date, impressions, clicks, ctr, conversion\_rate | `prod-456, campaign-123, 2024-01-15, 100, 10, 0.10, 0.02`   |
| **Eventos de Usuário**     | user\_id (anonimizado), event\_type, product\_id, timestamp, value          | `user-789, purchase, prod-456, 2024-01-15T10:30:00Z, 49.99` |
| **Tráfego Orgânico**       | product\_id, date, organic\_impressions, organic\_clicks, search\_terms     | `prod-456, 2024-01-15, 500, 25, "summer shoes"`             |

### Exemplos de Formato CSV

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  **Dados de Desempenho de Campanha:**
</div>

```csv theme={null}
campaign_id,date,impressions,clicks,conversions,spend,ctr,conversion_rate
campaign-123,2024-01-15,1000,50,5,25.00,0.05,0.10
campaign-124,2024-01-15,800,40,3,20.00,0.05,0.075
```

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  **Dados de Desempenho de Produto:**
</div>

```csv theme={null}
product_id,campaign_id,date,impressions,clicks,conversions,revenue
prod-456,campaign-123,2024-01-15,100,10,2,49.98
prod-457,campaign-123,2024-01-15,150,8,1,24.99
```

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  **Dados de Eventos de Usuário:**
</div>

```csv theme={null}
user_id,event_type,product_id,timestamp,value,campaign_id
user-789,view,prod-456,2024-01-15T10:00:00Z,,
user-789,click,prod-456,2024-01-15T10:05:00Z,,campaign-123
user-789,purchase,prod-456,2024-01-15T10:30:00Z,49.99,campaign-123
```

## Processo de Treinamento do Modelo

### Treinamento de Integração

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  **Processamento de Dados Inicial:**
</div>

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  * Dados de eventos históricos são integrados aos pipelines de treinamento
  * Modelos são treinados usando 3-6 meses de dados de desempenho históricos
  * Embeddings iniciais são criados para usuários, produtos e campanhas
  * Previsões de desempenho de linha de base são estabelecidas
</div>

### Otimização Contínua

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  **Aprendizado Contínuo:**
</div>

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  * **Atualizações Diárias**: Embeddings de busca de ID atualizados com novos dados
  * **Retreinamento Semanal**: Retreinamento completo do modelo incorporando dados históricos e novos
  * **Adaptação em Tempo Real**: Embeddings de comportamento do usuário atualizados continuamente
  * **Monitoramento de Desempenho**: Comparação de desempenho histórico vs. atual
</div>

<Tip>
  A combinação de dados históricos e aprendizado em tempo real tipicamente alcança
  desempenho ótimo dentro de 2-3 semanas, comparado a 4-6 semanas apenas com cold start.
</Tip>

## Métricas de Sucesso

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

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  * **Período de Cold Start Reduzido**: Tempo de aprendizado diminuído de 4 semanas para 1-2 semanas
  * **Continuidade de Desempenho**: Desempenho de campanha dentro de 10-15% dos níveis históricos desde o primeiro dia
  * **Precisão do Modelo**: Precisão de previsão melhorada em 20-30% comparado a cenários de cold start
  * **Satisfação do Anunciante**: Confiança do anunciante mantida ou melhorada durante a transição
</div>

## Integração com Migração de Campanhas

### Processos Complementares

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  A migração de dados históricos funciona junto com a [Migração de Campanhas](/pt/knowledge-base/ad-platform/campaign-migration/):
</div>

1. **Estrutura de Campanha**: A migração básica de campanha lida com configurações, orçamentos e segmentação
2. **Dados de Desempenho**: A migração de dados históricos fornece a base de desempenho
3. **Benefício Combinado**: Juntos, eles garantem campanhas funcionais e desempenho otimizado desde o primeiro dia

### Sequência Recomendada

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  1. Completar a [Migração de Campanhas](/pt/knowledge-base/ad-platform/campaign-migration/) primeiro para estabelecer a estrutura da campanha
  2. Executar a migração de dados históricos em paralelo durante a fase de testes
  3. Implantar tanto a estrutura da campanha quanto os modelos treinados simultaneamente
  4. Monitorar desempenho em relação às linhas de base históricas
</div>

<Warning>
  A migração de dados históricos requer coordenação técnica adicional e pode
  estender o cronograma geral de migração em 1-2 semanas para treinamento e
  validação do modelo.
</Warning>

## Próximos Passos

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  Para clientes interessados em migração de dados históricos:
</div>

<div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
  1. **Avaliar disponibilidade de dados** da sua plataforma atual
  2. **Coordenar equipes técnicas** para discutir requisitos de dados históricos
  3. **Planejar extração de dados** junto com o cronograma de migração de campanha
  4. **Coordenar com a equipe de machine learning** para requisitos de treinamento do modelo
</div>

***

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