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.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:- Bronze — produto bruto armazenado com chave de idempotência; importações duplicadas são ignoradas com segurança
- Silver — campos normalizados, duplicatas detectadas, URLs de imagem validadas
- Gold — pontuação de otimização (0–100) calculada em 7 estágios da rubrica; lista de gaps retornada
Melhores práticas
Valide antes de importar
Valide antes de importar
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.
Use caminhos de categoria consistentes
Use caminhos de categoria consistentes
Siga um formato de hierarquia consistente:
Nível 1 > Nível 2 > Nível 3. Caminhos inconsistentes criam categorias duplicadas.Inclua GTINs quando possível
Inclua GTINs quando possível
Produtos com GTINs pontuam mais alto em otimização e são obrigatórios para a maioria dos feeds de compras (Google, Meta).
Execute Silver + Gold após importação
Execute Silver + Gold após importação
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.