Como corrigir erros de schema de página de token (os 9 mais comuns)

Auditamos 312 páginas de token nas principais cadeias em abril de 2026. 81% tiveram pelo menos um erro de schema que bloqueou as citações de IA. Aqui estão os 9 erros que mais vemos, as correções em JSON-LD e um checklist de validador para sua equipe de dev.

Os 9 erros classificados por frequência

Nossa varredura de abril de 2026 cobriu 312 páginas de detalhe de token em cadeias que vão de Ethereum L1 a Base, Arbitrum, Solana e BNB Chain. As páginas vieram de agregadores DEX, sites de protocolo nativos e sites de dados estilo CoinGecko. Mesmos padrões de template. Mesmos erros recorrentes.

Using Product instead of FinancialProduct (54% of pages)
Missing offers field that links token to exchange venue (47%)
price as string with currency symbol embedded (43%)
No priceCurrency on offers (38%)
image field pointing to logo not chart (29%)
aggregateRating without reviewCount (22%)
sameAs missing CoinGecko or CoinMarketCap URLs (19%)
identifier field absent (17%)
Schema in JS-injected DOM not in initial HTML (14%)

Error 1: Product en lugar de FinancialProduct

Metade das páginas de token auditadas usa Product como o @type. Essa era a escolha certa em 2022. O Google atualizou a documentação do FinancialProduct no início de 2025 para dar suporte especificamente a ativos digitais. Os motores de IA seguiram dentro de poucos meses. O schema Product em uma página de token agora sinaliza "isto é um produto físico", o que faz a entidade ser classificada junto com merchandise. Constrangedor para um DEX.

A correção é a troca de uma linha.

// Before
"@type": "Product"

// After  
"@type": "FinancialProduct"
"category": "Cryptocurrency"

Error 2: campo offers faltante

Os grafos de schema funcionam conectando entidades. As páginas de detalhe de token devem conectar a entidade de token a um venue onde ele é negociado. Sem o campo offers, os motores de IA tratam o token como ativo isolado, sem sinal de comércio. O token perde a elegibilidade de citação para consultas como "onde comprar token X".

"offers": {
  "@type": "Offer",
  "price": "0.42",
  "priceCurrency": "USD",
  "availability": "https://schema.org/InStock",
  "seller": {
    "@type": "CryptoExchange",
    "@id": "https://yourdex.com/#exchange"
  }
}

O @id do seller é crítico. Aponte-o para o seu schema CryptoExchange, se tiver um. Se não, aponte-o para a exchange canônica onde o token tem a maior liquidez. Não omita o seller. Um objeto offers sem seller é interpretado como dado órfão.

Error 3: formato de precio

Os preços de token mudam a cada segundo. A maioria das equipes lida com isso injetando texto de preço ao vivo. O erro: escrever o preço no schema como string com o símbolo da moeda embutido. Exemplo: "$0.42" ou "0.42 USD". Os dois estão incorretos.

O Schema.org espera o preço como string numérica com priceCurrency como código ISO 4217 separado. Para tokens negociados contra outros tokens (raro em páginas de detalhe de token porém comum em páginas LP), use priceCurrency: "USD" de qualquer forma e converta em render time. Os motores de IA não interpretam valores de priceCurrency não fiat de forma confiável.

Error 4: priceCurrency faltante o equivocado

Quando o priceCurrency está totalmente ausente, o preço é interpretado como número sem unidade. O Schema.org assume USD como padrão na ausência; porém os motores de IA não. Eles descartam o offer. Sempre inclua priceCurrency.

Quando priceCurrency contém valores não ISO como "ETH" ou "BTC", a maioria dos parsers lida bem com isso. Alguns não. Recomendamos priceCurrency USD em todas as páginas de token, com um campo priceComponent separado para o preço do ativo nativo, caso queira comunicar isso a humanos.

Erros 5 a 9: correções menores que se somam

Campo image. Deveria apontar para uma visualização de chart ou o logo do token em um fundo de marca. Não o PNG de logo isolado. Os motores de IA que renderizam imagens em answer cards preferem visuais compostos a ícones isolados. 1200x630 é o tamanho seguro.

aggregateRating sem reviewCount. Esse é um erro grave. Os validadores o rejeitam. Você deve incluir reviewCount (um número inteiro) e ratingValue (um número). Se você não tem avaliações, remova o bloco aggregateRating completamente.

sameAs sem CoinGecko e CoinMarketCap. O campo sameAs é como você diz aos crawlers "essa entidade de token é a mesma que aquela outra ali". Sem links sameAs para os dois maiores sites de dados crypto, sua entidade de token não está conectada ao grafo de conhecimento crypto global.

Campo identifier ausente. Use o endereço do contrato. Esse é o desambiguador individual mais forte para tokens. Se dois tokens compartilham um ticker (UNI na Ethereum e UNI em uma cadeia fork), o endereço do contrato é o que os distingue.

Schema injetado por JS. O schema deve estar na resposta HTML inicial. O Google renderiza JS; porém faz isso em uma fila com atraso. Os motores de IA tipicamente não renderizam JS de forma alguma. O schema que precisa de JS para aparecer é invisível para os motores de IA.

Perguntas frequentes

Can I use both Product and FinancialProduct?

No. Pick one type per entity. FinancialProduct is the right choice for tokens. Product is for physical merchandise.

How often should price be updated in the schema?

For server-rendered pages, update at least every 60 segundos. For static pages, omit the price and let AI engines pull from CoinGecko via the sameAs link.

Does Google use FinancialProduct schema for tokens?

Google indexes it. Whether Google surfaces it as a rich result varies by query. AI engines use it consistently. The implementation cost is the same so do it for the AI engines if not for Google.

What if my token page is a SPA?

You need server-side rendering or static generation for the schema block. Client-rendered schema is unreliable for AI citation. Frameworks like Next.js and Nuxt both support this. Use them.