Skip to main content

Métodos de importação

O Alana suporta múltiplos métodos de importação dependendo da sua fonte de dados: Após qualquer importação, o estágio Bronze executa automaticamente — produtos são ingeridos com chave de idempotência para prevenir duplicatas. A normalização Silver e o scoring Gold executam sob demanda ou via auto-trigger (configurável em Configurações do Pipeline).

Importação por URL (Bright Data)

Importe produtos fornecendo uma URL de página de produto. O Bright Data faz scraping da página e extrai dados estruturados do produto.
Veja o guia de Importação por URL para detalhes sobre gerenciamento de jobs e notificações via webhook.

Formatos de arquivo suportados

O endpoint de importação CSV/Excel aceita:
  • CSV (.csv) — separado por vírgula ou ponto e vírgula
  • Excel (.xlsx) — primeira planilha é usada

Colunas obrigatórias

Colunas adicionais são armazenadas como attributes flexíveis.

Importar via API

Resposta da importação

A importação retorna um resumo:

Processamento automático pelo pipeline após importação

Quando produtos são importados, o pipeline Bronze → Silver → Gold os processa automaticamente (se configurado) ou sob demanda:
  1. Bronze — produto bruto armazenado com chave de idempotência; importações duplicadas são ignoradas com segurança
  2. Silver — campos normalizados, duplicatas detectadas, URLs de imagem validadas
  3. Gold — pontuação de otimização (0–100) calculada em 7 estágios da rubrica; lista de gaps retornada
Acione Silver e Gold em massa via Ações em Lote, ou configure auto-trigger em Configurações do Pipeline.

Melhores práticas

Use um arquivo de teste pequeno (10-20 linhas) antes de importar seu catálogo completo. Verifique os detalhes de erro para corrigir problemas de formatação.
Siga um formato de hierarquia consistente: Nível 1 > Nível 2 > Nível 3. Caminhos inconsistentes criam categorias duplicadas.
Produtos com GTINs pontuam mais alto em otimização e são obrigatórios para a maioria dos feeds de compras (Google, Meta).
Após importar, execute Lote Silver para normalizar campos, depois Lote Gold para calcular pontuações de otimização. Isso fornece uma linha de base de qualidade antes de publicar. Veja Enriquecimento de Dados.
Última modificação em 18 de março de 2026