Pular para o conteúdo principal

Visão geral

O Marketplace Hub é uma exchange de conteúdo B2B onde proprietários de workspace podem publicar catálogos para outras empresas descobrirem, clonarem ou assinarem. Funciona tanto como canal de distribuição (perspectiva do publicador) quanto como ferramenta de sourcing de conteúdo (perspectiva do consumidor).

Perspectiva do publicador

Como publicador, você expõe seu catálogo ao ecossistema do marketplace — seja gratuitamente ou mediante cobrança.
  1. Certifique-se de que seu catálogo completou pelo menos o estágio Silver do pipeline
  2. Navegue até o catálogo → aba Marketplace
  3. Configure visibilidade, precificação e categoria
  4. Clique em Publicar no Hub
Após publicado, seu catálogo aparece no feed de navegação do Hub e é pesquisável por nome, categoria e tags.

Modelos de precificação

ModeloDescrição
GratuitoO catálogo pode ser clonado e assinado sem custo
Pago (via Stripe)Consumidores pagam uma taxa única ou recorrente gerenciada via Stripe Checkout
O acesso a catálogos pagos é controlado no nível da API — o status da assinatura é verificado em cada operação de clone e assinatura.

Versionamento de catálogos

Cada vez que você atualiza um catálogo publicado (adiciona produtos, executa Silver/Gold, edita metadados), uma nova versão é criada automaticamente. Versões são snapshots imutáveis.
Campo de versãoDescrição
versionInteiro auto-incrementado (v1, v2, v3…)
createdAtTimestamp da versão
changeCountNúmero de produtos adicionados/atualizados/removidos
publishedByMembro que acionou a publicação
Assinantes recebem uma notificação quando uma nova versão está disponível e podem escolher sincronizar no momento que for conveniente.

Analytics do publicador

Acompanhe o desempenho do catálogo na aba Analytics ou via API:
  • Visualizações — quantas vezes o preview do catálogo foi aberto
  • Clones — total de cópias únicas realizadas
  • Assinantes ativos — workspaces com assinaturas ativas
  • Receita — total coletado (para catálogos pagos)
Consulte a API de Analytics do Publicador para detalhes.

Despublicar / retirar do ar

Para remover um catálogo do Hub:
  1. Navegue até o catálogo → aba Marketplace
  2. Clique em Despublicar
Despublicar remove o catálogo do feed de navegação imediatamente. Assinantes existentes mantêm seus dados locais, mas param de receber notificações de novas versões. Sincronizações pendentes são canceladas.
Despublicar não exclui os dados dos assinantes. Workspaces que já clonaram seu catálogo mantêm sua cópia local.

Perspectiva do consumidor

Como consumidor, você navega pelo Hub para descobrir catálogos, visualizar produtos e clonar ou assinar. A página de navegação do Hub suporta:
  • Pesquisa por palavra-chave (nome do catálogo, marca, descrição)
  • Filtro por categoria, preço (gratuito/pago), pontuação mínima
  • Ordenação por: Popular, Recente, Pontuação de Otimização
Cada card de catálogo exibe: nome, publicador, contagem de produtos, categoria, pontuação média e contagem de assinantes.

Preview sem compromisso

Todo catálogo publicado oferece um preview dos primeiros 10 produtos mais estatísticas agregadas (total, pontuação média, principais categorias, principais marcas) — sem necessidade de clone. Use o preview para avaliar a adequação antes de assinar.

Clone — cópia única

Clone cria um snapshot local do catálogo no seu workspace. Não estabelece uma conexão contínua.
  • Todos os produtos são copiados para um novo catálogo no seu workspace
  • Você pode editar, enriquecer e redistribuir livremente
  • Sem sincronização — você não receberá atualizações futuras do publicador

Assinar — sincronização ao vivo

Assinar cria um link ao vivo entre seu workspace e o catálogo do publicador. Quando o publicador lança uma nova versão, você é notificado e pode sincronizar.

Estratégias de sincronização

EstratégiaComportamento
autoNovas versões são aplicadas automaticamente ao seu catálogo local
manualVocê revisa e aprova cada sincronização via UI ou API

Estratégias de resolução de conflitos

Quando um produto sincronizado tem edições locais que conflitam com atualizações do publicador, a estratégia de resolução de conflitos determina o resultado:
EstratégiaComportamento
keep_localSuas edições locais sempre prevalecem; alterações do publicador são descartadas para aquele campo
accept_remoteAlterações do publicador sempre prevalecem; suas edições locais são sobrescritas
manual_reviewConflitos são enfileirados para resolução manual — nenhum lado vence automaticamente
Use manual_review para catálogos de alto valor onde as edições locais representam trabalho significativo (descrições personalizadas, ajustes de preço). Use accept_remote para feeds de fornecedores brutos onde o publicador é o dono dos dados.

Fluxo de resolução de conflitos


Modelo de versionamento de catálogos

Cada assinante pode estar em uma versão diferente. A sincronização sempre avança — não é possível voltar a uma versão anterior do publicador.

Controle de acesso

AçãoQuem pode fazer
Publicar catálogoProprietário ou admin do workspace
Definir precificaçãoSomente proprietário do workspace
Ver analyticsProprietário ou admin do workspace
DespublicarSomente proprietário do workspace
Clonar/assinarQualquer workspace autenticado
PreviewQualquer pessoa (público)

Boas práticas

Os consumidores julgam a qualidade do catálogo pelos dados normalizados. Publique após o Silver (e idealmente o Gold) para maximizar a descoberta e conversão de assinantes.
Cada salvamento em um catálogo publicado cria uma nova versão e notifica os assinantes. Agrupe suas edições e publique uma vez, em vez de fazer muitas pequenas alterações.
Defina keep_local quando sua equipe downstream adiciona descrições ou preços personalizados. Defina accept_remote para feeds de fornecedores que você usa verbatim.
Muitas visualizações com poucos clones indicam uma incompatibilidade entre os metadados do catálogo e o conteúdo. Melhore seu título, descrição e tags de categoria.
Last modified on March 18, 2026