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:

  1. 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.
  2. 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.
  3. 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:image da 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

Experimente gratuitamente — sem necessidade de registo

Pré-visualize e teste imagens OG dinâmicas em segundos.

Abrir o Testador Gratuito de Imagens OG