Pular para o conteúdo principal

​
Visão geral

Este guia percorre o ciclo de vida completo de publicação de um catálogo no Marketplace Hub: configurar definições, definir precificação, ir ao ar, monitorar engajamento, gerenciar assinantes, lidar com conflitos de sincronização e despublicar.

​
Pré-requisitos

Antes de publicar, certifique-se de que seu catálogo atende aos padrões mínimos de qualidade:
  • Pelo menos o estágio Silver do pipeline concluído (dados normalizados)
  • Catálogo tem nome e descrição descritivos
  • Uma categoria está atribuída
  • Pelo menos 10 produtos (recomendado: 50+)
  • Imagem de capa ou imagens representativas dos produtos presentes
Catálogos com pontuações Gold acima de 70 convertem visitantes em assinantes a uma taxa 3× maior. Execute o lote Analisar antes de publicar.

​
Passo 1 — Configurar definições do marketplace

  1. Abra seu catálogo → aba Configurações
  2. Role até a seção Marketplace
  3. Preencha:
    • Nome de exibição — como o catálogo aparece no Hub (pode diferir do nome interno)
    • Descrição curta — 140 caracteres, exibida nos cards do catálogo
    • Descrição longa — descrição completa exibida na página de detalhe do catálogo
    • Categoria — categoria principal para navegação/filtro
    • Tags — até 10 tags para relevância de pesquisa
    • Imagem de capa — carregada ou selecionada automaticamente do produto principal

​
Passo 2 — Definir precificação

Navegue até Configurações → Marketplace → Precificação.

​
Catálogo gratuito

Defina a precificação como Gratuito. Qualquer pessoa com uma conta Alana pode clonar ou assinar sem custo.

​
Catálogo pago

  1. Selecione Pago
  2. Escolha o modelo de precificação:
    • Avulso — pagamento único para acesso perpétuo
    • Assinatura mensal — taxa recorrente para acesso contínuo à sincronização
  3. Insira o preço (USD)
  4. Um produto e preço Stripe são criados automaticamente via integração Alana → Stripe
  5. Consumidores verão um fluxo de Stripe Checkout antes de clonar ou assinar
Você precisa ter uma conta Stripe conectada no seu workspace para oferecer catálogos pagos. Vá para Configurações → Integrações → Stripe para conectar.
  1. Navegue até seu catálogo → aba Marketplace
  2. Revise o preview — é assim que seu catálogo aparecerá no Hub
  3. Clique em Publicar no Hub
  4. O catálogo fica visível imediatamente no feed de navegação do Hub

​
Via API

curl -X POST "https://app.alana.shopping/api/hub/catalogs" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "catalogId": "CATALOG_ID",
    "displayName": "Roupas Primavera 2026",
    "description": "Mais de 500 SKUs de roupas de primavera curadas das melhores marcas europeias.",
    "category": "apparel",
    "tags": ["primavera", "2026", "europeu", "moda"],
    "pricing": { "model": "free" }
  }'

​
Passo 4 — Monitorar analytics

Acompanhe o desempenho do catálogo em Marketplace → Analytics.
MétricaDescrição
VisualizaçõesTotal de aberturas de preview (únicas + repetidas)
ClonesCópias únicas realizadas
Assinantes ativosWorkspaces com assinaturas ativas
ReceitaTotal coletado (somente catálogos pagos)
Histórico de versõesCada versão publicada com contagens de alterações

​
Via API

curl "https://app.alana.shopping/api/hub/catalogs/CATALOG_ID/analytics" \
  -H "Authorization: Bearer SUA_API_KEY"

​
Passo 5 — Gerenciar assinantes

Veja todos os assinantes em Marketplace → aba Assinantes. Para cada assinante você pode ver:
  • Nome e ID do workspace
  • Versão atual em uso
  • Estratégia de sincronização (auto/manual)
  • Timestamp da última sincronização
  • Status da assinatura (ativo/pausado/cancelado)
Você não pode forçar atualizações nos assinantes. Eles controlam quando as sincronizações acontecem com base na estratégia escolhida.

​
Passo 6 — Lidar com conflitos de sincronização

Quando assinantes têm resolução de conflito manual_review, os conflitos aparecem na fila deles. Como publicador, você pode ver quais campos são mais comumente contestados via analytics. Se quiser comunicar mudanças significativas (por exemplo, renomear SKUs ou reestruturar categorias), use o campo Changelog ao publicar uma nova versão:
  1. Faça suas alterações no catálogo
  2. Antes de publicar a nova versão, adicione uma mensagem de Changelog da versão
  3. Assinantes recebem esta mensagem com a notificação de versão

​
Passo 7 — Despublicar (retirar do ar)

Para remover seu catálogo do Hub:
  1. Navegue até o catálogo → aba Marketplace
  2. Clique em Despublicar
  3. Confirme a ação
O que acontece com os assinantes:
  • O catálogo desaparece do feed de navegação do Hub imediatamente
  • Assinantes existentes mantêm seus dados locais
  • Sincronizações pendentes são canceladas
  • Novos clones e assinaturas são bloqueados
  • Assinantes pagos recebem uma notificação

​
Via API

curl -X DELETE "https://app.alana.shopping/api/hub/catalogs/CATALOG_ID" \
  -H "Authorization: Bearer SUA_API_KEY"

​
Checklist de publicação

  • Pipeline Silver concluído em todos os produtos
  • Pontuações Gold acima de 65 para produtos-chave (recomendado)
  • Nome de exibição e descrição preenchidos
  • Categoria e tags configuradas
  • Modelo de precificação selecionado e Stripe conectado (se pago)
  • Imagem de capa carregada
  • Preview revisado — aparece corretamente no card do Hub
  • Publicado e visível no feed de navegação do Hub
  • Aba Analytics acessível e exibindo dados
Last modified on March 18, 2026