Section 35: Glossário e Conceitos-Chave do CatalogPilot

Catálogo

Seu catálogo de produtos conforme existe na sua plataforma de e-commerce (produtos, categorias, variantes, imagens, preços, disponibilidade).

O CatalogPilot não substitui seu catálogo. Ele o lê e cria uma cópia enriquecida externa.

Cópia do catálogo (cópia externa)

Uma cópia segura e somente leitura do seu catálogo, criada por meio de uma conexão via API.

Essa cópia:

• Existe fora da sua plataforma
  
• É usada para enriquecimento, validação e entrega
  
• Pode ser removida a qualquer momento sem impacto na loja
  

Enriquecimento

O processo de geração de conteúdo estruturado e legível por máquinas para produtos, categorias, variantes e imagens.

O enriquecimento pode incluir:

• Títulos e descrições
  
• Metadados de SEO (título, descrição, cabeçalhos)
  
• Texto alternativo acessível (ADA)
  
• Campos estruturados compatíveis com schema
  
• Campos semânticos e de classificação para IA
  

O enriquecimento nunca sobrescreve dados da plataforma.

Aprovação

A etapa obrigatória na qual o comerciante revisa e aprova o conteúdo enriquecido antes da entrega.

A aprovação:

• Evita deriva e alucinação
  
• Garante controle em nível corporativo
  
• Pode ser feita individualmente ou em lote (“Aprovar tudo”)
  
• O conteúdo aprovado permanece sempre editável
  

Original vs. Aprovado

• Original: conteúdo vindo da sua plataforma e storefront
  
• Aprovado: conteúdo gerado e confirmado pelo CatalogPilot
  

Ambas as versões permanecem disponíveis para comparação.

Lote (Batch)

Um grupo de itens enriquecidos em conjunto.

Os lotes podem ser criados por:

• Automático (itens não enriquecidos mais antigos primeiro)
  
• Seleção manual de produtos
  
• Seleção por categoria
  

Nenhum lote é iniciado sem confirmação.

Estimativa

Uma prévia de custo antes do início do enriquecimento.

As estimativas:

• Mostram quantidades e preços
  
• Incluem apenas itens elegíveis
  
• Não geram cobrança sem confirmação
  

Fila de revisão

Uma área temporária que contém itens recém-enriquecidos aguardando aprovação.

Projetada para:

• Comparação visual
  
• Validação rápida
  
• Baixa carga cognitiva
  

A maioria dos comerciantes aprova sem alterações.

Galeria de produtos

A principal visualização de comparação, exibindo:

• Conteúdo legível por humanos
  
• Conteúdo legível por máquinas
  
• Dados de acessibilidade e estrutura
  

Esta é a superfície de revisão mais importante do CatalogPilot.

Abas de produto

Painéis secundários de edição localizados abaixo da galeria.

Usados para:

• Ajustes direcionados
  
• Substituições campo a campo
  
• Revisão avançada (opcional)
  

A galeria é primária; as abas são complementares.

Variantes

Variações individuais do produto (ex.: tamanho, cor) tratadas como registros estruturados independentes.

O CatalogPilot cria registros separados para que:

• Cada variante possa ser indexada independentemente
  
• Schema específico por variante seja entregue
  
• A descoberta seja ampliada sem duplicação de URLs
  

O conteúdo das variantes herda majoritariamente do produto pai.

Imagens / ADA

Enriquecimento no nível da imagem, incluindo:

• Títulos de imagem
  
• Texto alternativo
  
• Legendas
  
• Descrições de acessibilidade
  

Esses campos são principalmente legíveis por máquinas e raramente precisam de edição manual.

Atributos

Características padronizadas de produtos para motores de busca e plataformas de compras.

Incluem campos exigidos pelo Google como:

• Disponibilidade
  
• Condição
  
• Tipo de produto
  
• Taxonomias de categoria
  

Campos destacados em amarelo são opcionais e devem ser preenchidos apenas quando a informação for conhecida com certeza.

Schema

Dados estruturados (JSON-LD) entregues em tempo de renderização para descrever produtos, categorias e variantes.

O schema:

• É injetado dinamicamente
  
• Não modifica arquivos de tema
  
• Pode ser desativado instantaneamente
  

Entrega ao storefront

A entrega de conteúdo estruturado aprovado durante o carregamento da página.

A entrega:

• Ocorre em tempo de renderização
  
• Não é destrutiva
  
• Reflete apenas conteúdo aprovado
  

Interruptor FailSafe

Um interruptor global que desativa imediatamente toda a entrega do CatalogPilot.

Quando desativado:

• A loja retorna ao comportamento nativo
  
• Nenhuma reversão é necessária
  
• Os dados enriquecidos permanecem armazenados com segurança
  

Entrada (sincronização do catálogo)

Uma conexão segura e somente leitura que lê dados do catálogo da plataforma para o CatalogPilot.

O CatalogPilot:

• Apenas lê dados
  
• Nunca grava de volta
  
• Respeita a autoridade da plataforma
  

Saída (entrega)

Entrega controlada de conteúdo enriquecido ao storefront por meio de um script leve.

A entrega:

• É opcional
  
• Pode ser pausada ou desativada
  
• Não afeta pagamentos ou transações
  

Tags

Elementos individuais de dados estruturados gerados durante o enriquecimento.

Um produto pode gerar dezenas de tags por meio de:

• Campos de produto
  
• Imagens
  
• Variantes
  
• Categorias
  
• Camadas semânticas e de IA
  

Um número elevado de tags representa profundidade, não duplicação.

Registro de atividades

Uma linha do tempo detalhada de todas as ações realizadas no CatalogPilot.

Inclui:

• Enriquecimentos
  
• Aprovações
  
• Edições
  
• Mudanças de status de lote
  
• Ações faturáveis (quando aplicável)
  

Uso

Registro em tempo real das atividades de enriquecimento faturáveis.

O uso é:

• Detalhado
  
• Com carimbo de data/hora
  
• Automaticamente vinculado às faturas
  

Fatura

Um resumo semanal do uso de enriquecimento.

As faturas:

• Agrupam o uso em uma única linha
  
• Referenciam registros detalhados de atividade
  
• São separadas da cobrança de assinatura
  

Assinatura

O plano base que define:

• Limites de tamanho do catálogo
  
• Níveis de acesso
  
• Disponibilidade de recursos
  

As assinaturas são cobradas separadamente do uso.

Tradução

Enriquecimento opcional de conteúdo aprovado para idiomas já existentes na plataforma.

As traduções:

• Ocorrem somente após a aprovação principal
  
• Aplicam-se apenas a idiomas existentes
  

São cobradas com tarifa reduzida