Pular para o conteúdo principal

​
Visão geral

O enriquecimento de dados é o processo de pegar registros brutos de produtos e melhorar progressivamente sua qualidade pelos estágios do pipeline. Este guia cobre o fluxo completo — desde o import inicial pelo Bronze, normalização Silver, pontuação Gold — até o enriquecimento avançado via web scraping com Bright Data.

​
Passo 1 — Import (Bronze)

O primeiro passo é colocar seus dados no sistema. Todos os imports chegam na camada Bronze: brutos, sem modificação e idempotentes.

​
Métodos de import

MétodoMelhor para
Upload CSV/ExcelPlanilhas de fornecedores existentes
Import por URLRaspar páginas de produto diretamente da web
API (POST /api/workspace/{workspaceId}/catalogs/{catalogId}/products)Feeds programáticos
Feed MCPSincronização de catálogo em tempo real de sistemas externos
Após o import, produtos ficam visíveis no catálogo com pipeline_stage: "bronze".

​
Passo 2 — Silver (Normalizar)

O Silver limpa e normaliza seus dados brutos: padroniza capitalização, valida URLs de imagens, detecta duplicatas e mapeia campos para o schema da Alana.

​
Executar Silver via UI

  1. Abra seu catálogo
  2. Selecione os produtos que deseja normalizar (ou use Selecionar Todos)
  3. Clique em Ações em Lote → Normalizar
  4. Um indicador de progresso exibe normalizado / total
  5. Quando concluído, revise o painel de resultados: campos mapeados, duplicatas encontradas, URLs quebradas

​
Executar Silver via API

curl -X POST "https://app.alana.shopping/api/workspace/WORKSPACE_ID/catalogs/CATALOG_ID/batch/silver" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"scope": "all"}'

​
Resultados do Silver

Após o Silver, cada produto contém:
  • fieldsNormalized — quantidade de campos transformados
  • duplicateOf — ID do produto se uma duplicata foi detectada
  • urlsValidated — quantidade de URLs de imagens/mídia verificadas
  • pipeline_stage: "silver"

​
Passo 3 — Gold (Pontuar & Analisar)

O Gold produz uma pontuação de otimização (0–100) e uma lista de lacunas — os campos que, se preenchidos, mais aumentariam a pontuação.

​
Executar Gold via UI

  1. Selecione produtos no catálogo
  2. Clique em Ações em Lote → Analisar
  3. Um indicador de progresso exibe analisados / total
  4. Quando concluído, cada produto exibe seu badge de pontuação e destaques de lacunas

​
Executar Gold via API

curl -X POST "https://app.alana.shopping/api/workspace/WORKSPACE_ID/catalogs/CATALOG_ID/batch/gold" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"scope": "all"}'

​
Passo 4 — Revisar pontuações no Canvas

Após o Gold, abra o Canvas para revisar e agir sobre os resultados do enriquecimento:
  1. Ordene produtos por pontuação (crescente) para encontrar os itens de menor qualidade
  2. Para cada produto, o painel Lacunas mostra exatamente quais campos estão ausentes
  3. Use o editor inline para preencher lacunas diretamente no Canvas
  4. Execute novamente o Gold nos produtos editados para atualizar a pontuação

​
Passo 5 — Enriquecimento via Bright Data

Para produtos com dados incompletos, a Alana integra com o Bright Data para enriquecer via web scraping, análise SERP e presets de datasets.

​
Import por URL com web scraping

Ao importar via URL de produto, o Web Scraper do Bright Data extrai dados estruturados diretamente da página do produto. 
curl -X POST "https://app.alana.shopping/api/workspace/WORKSPACE_ID/url-import" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/produto/tenis-running-azul",
    "catalogId": "CATALOG_ID",
    "method": "web_scraper"
  }'

​
Análise SERP para SEO

Use a API SERP do Bright Data para descobrir palavras-chave de alto valor para seus produtos. Os resultados são usados para otimizar títulos, descrições e campos meta durante a pontuação Gold. 
curl -X POST "https://app.alana.shopping/api/workspace/WORKSPACE_ID/catalogs/CATALOG_ID/enrich/serp" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "productIds": ["prod_123", "prod_456"],
    "locale": "pt-BR"
  }'

​
Presets de datasets para análise competitiva

Os presets de datasets do Bright Data extraem dados estruturados de concorrentes por categorias como eletrônicos, roupas e produtos domésticos — úteis para comparar seu catálogo com os líderes de mercado. Presets disponíveis:
  • electronics_specs — especificações técnicas de grandes varejistas
  • apparel_sizing — tabelas de tamanho e dados de caimento
  • grocery_nutrition — informações nutricionais e ingredientes
  • home_goods_dimensions — dimensões físicas e materiais

​
Fluxo completo de enriquecimento

​
Boas práticas

A pontuação Gold depende de dados normalizados. Executar Gold em dados Bronze brutos produz pontuações artificialmente baixas porque campos como marca e categoria ainda não estão vinculados.
A análise SERP tem um custo por consulta. Execute-a nos SKUs de maior tráfego ou novos lançamentos de produtos, não em catálogos inteiros.
A lista de lacunas é ordenada por impacto. Preencher a primeira lacuna aumentará mais a pontuação do que preencher a última. Foque nas 2–3 primeiras lacunas por produto.
As pontuações não são ao vivo — elas refletem a última vez que o Gold foi executado. Execute o Gold novamente após preencher lacunas para obter pontuações atualizadas.
Last modified on March 18, 2026