O Guia da Plataforma FastOG
O FastOG constrói a imagem que aparece quando alguém partilha uma das suas páginas — o produto, a categoria, a página inicial, o artigo do blog. Substitui o padrão estático por uma capa dinâmica: a fotografia do produto, o preço atual, a avaliação, o seu logótipo e o título que escolher.
Este guia é o mapa. Abrange o que cada funcionalidade faz, onde a alterar em cada plataforma e que plano a inclui. Para a API, a assinatura HMAC e os tutoriais de frameworks, comece na referência da API.
Onde o FastOG é executado
| Plataforma | Onde a aplicação está | O que o comerciante abre |
|---|---|---|
| WooCommerce | Administração do WordPress → FastOG | Studio para editar capas, Plan para alterar o plano, Support para um ticket, Tools para a ligação |
| Shopify | Administração do Shopify → Apps → FastOG | Covers, Plan, Support; os detalhes avançados da ligação estão na parte inferior da aplicação |
| Wix | Painel do Wix → Apps → FastOG | Covers, Customize, Plans |
Da primeira vez que abre a aplicação, esta propõe uma configuração rápida: escolha que tipos de página recebem uma capa e escolha um aspeto inicial. Pode alterar ambos mais tarde — nada na configuração é permanente.
Como é escolhida uma capa
O FastOG assina um URL para a página que está a ser partilhada. O pedido transporta a loja e o tipo de página, e o servidor aplica a regra guardada para esse tipo de página:
- A regra do tipo de página — a capa que editou em Covers para produtos, coleções/categorias, página inicial ou publicações do blog.
- Uma regra mais específica, se existir uma correspondência — uma regra para uma etiqueta, categoria, fornecedor ou coleção prevalece sobre a regra do tipo de página.
- Uma capa por produto, se estiver guardada — a mais específica de todas; disponível no Pro e acima.
Se nenhuma delas corresponder, a página mantém a imagem do seu tema. Cada plataforma atribui a cada tipo de página a sua própria capa, pelo que alterar a capa de um produto não afeta a página inicial.
Capas e tipos de página
Abra Capas (Shopify, Wix) ou FastOG → Studio (WooCommerce) e escolha o tipo de página acima da pré-visualização.
| Plataforma | Tipos de página |
|---|---|
| WooCommerce | Produto, Categoria, Início, Publicação do blog |
| Shopify | Produto, Coleção, Início, Publicação do blog |
| Wix | Produto, Coleção, Início, Publicação do blog, Página do site |
Cada separador tem o seu próprio aspeto, o seu próprio texto e os seus próprios interruptores em tempo real. Guardar um tipo de página nunca altera outro. A pré-visualização é a capa real: é renderizada a partir do mesmo template e das mesmas props que a página em direto vai usar.
O WooCommerce também coloca um pequeno painel de capa no ecrã de edição do produto, para que você possa ver e alterar a capa sem sair do produto. O Shopify coloca um bloco FastOG na página do produto no admin pelo mesmo motivo. O Wix mantém tudo na app.
Escolher um visual
O visual é o layout que a capa desenha — o template. O seletor mostra o catálogo completo, com os visuais bloqueados assinalados para o plano que os desbloqueia.
| Plano | Visuais |
|---|---|
| Community | O conjunto gratuito |
| Starter | O conjunto Starter curado |
| Pro | Todos os templates |
| Scale | Todos os templates, mais renderização prioritária |
Um visual bloqueado é uma montra, não uma escolha: pode pré-visualizá-lo, e o pedido de upgrade indica o plano que o desbloqueia. A gravação é recusada do lado do servidor, para que a pré-visualização e a capa em produção não possam divergir.
O mesmo seletor é usado quando começa a partir do assistente de configuração, e pode alterar o visual de um tipo de página sem mexer nos outros.
Copiar e estilizar
Depois do visual, o editor tem dois grupos de campos:
- Conteúdo — o título, o subtítulo, o badge, as linhas de características, a imagem e tudo o mais que o template apresente. Os campos deixados vazios recorrem aos dados da própria loja quando o template os consegue preencher.
- Estilo — tema, cores, tipo de letra, padrão e acabamento. Os estilos são por template: um valor que faz sentido num layout não é imposto a outro.
No WooCommerce e Shopify, todos os planos podem editar o texto e o estilo da regra para toda a loja. No Wix, os campos de conteúdo e estilo de forma livre são o construtor personalizado Pro: o Starter escolhe o visual, e os campos fixos da predefinição são apresentados em vez de editados livremente.
O editor por produto, exclusivo do Pro, aplica os mesmos campos a um item (ver abaixo), além da substituição do logótipo.
Um campo marcado como nunca preenchível é um campo que a FastOG se recusa a inventar. As avaliações são o caso comum: uma linha de estrelas vazia não é preenchida com uma média falsa.
Sinais em tempo real
Os sinais em tempo real são interruptores nos bastidores, não texto que você escreve. Decidem se a capa pode mostrar o valor que o FastOG já conhece no momento da partilha:
| Sinal | O que mostra | Plano |
|---|---|---|
| Preço | O preço atual, incluindo um preço riscado de comparação quando o produto está em promoção | Todos os planos |
| Promoção | A faixa de promoção / tratamento de preço riscado | Todos os planos |
| Stock | Stock baixo ("Apenas 3 restantes") e esgotado | Todos os planos |
| Classificação e número de avaliações | A média real e o número de avaliações da loja | Starter e superiores |
| Limiar de classificação | Oculta toda a linha de estrelas abaixo de uma classificação ou número de avaliações mínimo | Pro e superiores |
O objetivo do interruptor é permitir que você mantenha um campo no layout mas o oculte quando os dados são fracos. Um produto com 3,1 estrelas e duas avaliações costuma ficar melhor sem linha de estrelas do que com uma linha fraca ao lado do preço.
Desativar um sinal não apaga nada: o valor continua a ser lido da loja e a capa simplesmente não o imprime. Voltar a ativá-lo mostra-o novamente na renderização seguinte.
Capas por produto e por artigo
Uma capa por produto é uma capa guardada para um artigo, sobreposta à regra do tipo de página. É uma funcionalidade Pro e Scale.
| Plataforma | Onde a abrir |
|---|---|
| WooCommerce | Ecrã de edição do produto → o painel Capa FastOG → Personalizar capa |
| Shopify | Abra o produto no admin da Shopify → o bloco de produto FastOG → Personalizar capa |
| Wix | Ainda não disponível por artigo; use a capa do tipo de página ou um look que funcione bem para todos os produtos |
No Pro pode alterar o look, o texto, os badges e o estilo para esse produto específico. Os produtos sem uma sobreposição continuam a usar a regra do tipo de página. Limpar a sobreposição num produto repõe a capa partilhada; a escolha guardada é mantida, não destruída, se o plano mudar mais tarde.
O painel do produto também tem uma ligação para o Studio, para que a regra de toda a loja esteja a um clique quando o produto não precisa da sua própria capa.
Regras para linhas de produtos
Uma regra com âmbito refina a capa do produto para um grupo de produtos — uma etiqueta, uma categoria, um tipo de produto, uma coleção (Shopify) ou um fornecedor. É uma funcionalidade Scale.
Abra Covers → Covers for specific products (o título é o mesmo no WooCommerce e no Shopify). Adicione uma regra, escolha o âmbito e o aspeto, e guarde. Os produtos que correspondem usam o aspeto e o texto da regra; todos os outros mantêm a capa do tipo de página.
A correspondência mais específica ganha, por isso não precisa de gerir uma ordem. O contador de regras mostra quantas do limite do plano já utilizou; uma regra pode ser eliminada a qualquer momento. O Wix ainda não expõe regras com âmbito.
Campanhas e reversões agendadas
Uma reversão agendada é a metade segura de uma campanha: publica agora uma capa de Black Friday ou Sazonal e escolhe a data e a hora a que deve voltar à capa que estava ativa antes. A metade da reversão está disponível em todos os planos, incluindo o Community.
Um início agendado é a metade Scale. No Scale também pode definir a data em que a capa da campanha entra em direto; abaixo do Scale o início fica em pausa, com o design e as datas guardados para que um upgrade o possa retomar. Ambas as transições são verificadas a cada cinco minutos, e as horas usam o fuso horário apresentado sob os campos.
Ambas as metades precisam de um fim: uma campanha com início mas sem fim nunca seria retirada, por isso o formulário recusa-a. Limpar o fim cancela a campanha. Nada é eliminado por uma interrupção do plano — as datas e o design mantêm-se.
Exportar um PNG
A ação Transferir PNG renderiza a capa que está a visualizar a 1200×630 e transfere-a. É uma funcionalidade Pro e Scale no WooCommerce e no Shopify; o Wix ainda não a disponibiliza.
O ficheiro é criado a partir do próprio template e props do editor, pelo que corresponde à pré-visualização e não a um template de exportação separado. Use-o para uma listagem num marketplace, uma apresentação ou uma publicação manual em que não possa usar o URL em direto.
Planos, cobertura e limites
O FastOG vende cobertura, não créditos de renderização. Um plano cobre um determinado número de itens do seu próprio catálogo e um conjunto de funcionalidades; as renderizações não têm limite.
| Community | Starter | Pro | Scale | |
|---|---|---|---|---|
| Preço | Grátis | $19 / mês | $49 / mês | $119 / mês |
| Itens cobertos | 100 | 250 | 1.000 | Ilimitado |
| Tipos de página | Todos | Todos | Todos | Todos |
| Looks | Conjunto gratuito | Conjunto curado | Todos | Todos |
| Preço, promoção e stock | Sim | Sim | Sim | Sim |
| Avaliações (estrelas + contagem) | — | Sim | Sim | Sim |
| Limite mínimo de avaliação | — | — | Sim | Sim |
| Capa por produto | — | — | Sim | Sim |
| Mapeamento de metafields | — | — | Sim | Sim |
| Exportação PNG | — | — | Sim | Sim |
| Regras para linhas de produto | — | — | — | Sim |
| Início de campanha | — | — | — | Sim |
| Retorno agendado | Sim | Sim | Sim | Sim |
| Renderização prioritária | — | — | — | Sim |
O painel de cobertura mostra quantos dos seus itens o plano cobre, discriminados por produtos, categorias, página inicial e publicações do blog. Se o catálogo crescer além do limite, o painel indica o plano seguinte e o respetivo limite; não deixa de renderizar silenciosamente. Faça o upgrade a partir de Plan (WooCommerce, Shopify) ou Plans (Wix).
A faturação anual corresponde ao mesmo nível a 10 meses por um ano de 12 meses. A Wix fatura através da Wix; a WooCommerce e a Shopify faturam através da vista de planos na aplicação.
A Wix usa a mesma escala, mas ainda não disponibiliza a substituição por produto, as regras com âmbito definido nem a exportação PNG. O plano continua a controlar a cobertura, os looks, as avaliações e o construtor personalizado nessa plataforma.
Verificações de estado e atualizações de cache
A aplicação executa uma verificação de estado breve e mantém a lista completa em Detalhes / O que verificámos. Responde às perguntas que realmente quebram uma pré-visualização:
- O FastOG consegue ler os dados e o catálogo desta loja?
- O
og:imageda loja aponta para o FastOG, ou é um tema ou plugin de SEO a ganhar? - O produto de exemplo é real, e a pré-visualização usa-o?
- A chave de assinatura e a ligação continuam válidas?
Cada constatação traz uma correção quando existe uma. O relatório é o bloco a copiar para uma mensagem de suporte; foi concebido para ser colado, não interpretado.
Uma capa que mudou não é necessariamente uma capa que a plataforma voltou a ler. O URL assinado é determinístico, por isso a imagem em si atualiza-se; o que fica em cache é a cópia da pré-visualização da página que a plataforma guarda. Volta a fazer o scrape ou espera que a cache da plataforma expire — consulta o guia de cache e forçar uma atualização no Facebook. Se o og:image da página continuar a ser o do tema, a verificação de estado mostrará que outro plugin ou o tema está a ganhar.
Suporte
Use Suporte para um problema de configuração, entrega de capas, faturação ou produto. Inclua a página ou o produto afetado, o que esperava e o que aconteceu; o relatório de estado é o anexo mais rápido. Trata-se de suporte de produto assíncrono, não de chat em direto nem de consultoria geral.
Antes de abrir um ticket, experimente a verificação de estado: deteta as causas comuns (não ligado, sem servir capas, um plugin de SEO a substituir og:image, uma cache da plataforma desatualizada).
Resolução de problemas numa página
| Sintoma | Verificar primeiro |
|---|---|
| A ligação partilhada não tem imagem | Verificação de estado → a loja og:image do FastOG? O tipo de página está abrangido? |
| A pré-visualização mostra o preço antigo | A cache da plataforma; o URL em direto é assinado a cada renderização. Volte a fazer o scrape da página |
| A capa tem o aspeto errado | A regra do tipo de página, uma regra com âmbito, ou uma substituição por produto (a mais específica prevalece) |
| Um aspeto bloqueado não guarda | Pertence a um plano superior; o seletor indica o plano |
| Falta uma avaliação | O produto ainda não tem avaliações, ou o plano é inferior ao Starter, ou o interruptor de avaliações está desligado |
| Uma alteração por produto não fez nada | As capas por produto são Pro/Scale, e o servidor recusa a gravação abaixo disso |
| A capa está desfocada no WhatsApp | Consulte Tamanho da imagem OG e Pré-visualizações no WhatsApp |
Relacionado
Experimente gratuitamente — sem necessidade de registo
Pré-visualize e teste imagens OG dinâmicas em segundos.
Abrir o Testador Gratuito de Imagens OG