Implementar schema markup avancado WordPress para consultoria SEO em Santo Andre — Guia técnico

Como fazer o Google entender que sua consultoria SEO atende especificamente Santo André e não apenas “São Paulo”? A resposta está no schema markup avançado — não no básico que plugins genéricos instalam, mas em uma implementação cirúrgica que comunica entidades, relacionamentos geográficos e ofertas de serviço com precisão técnica.

A maioria dos sites WordPress usa plugins que injetam schema genérico: Organization no header, WebSite na home, Article nos posts. Para consultoria SEO local, isso é insuficiente. Você precisa de ProfessionalService com areaServed definido por coordenadas, LocalBusiness com geo latitude/longitude de Santo André, FAQPage nas páginas de serviço e BreadcrumbList em toda a arquitetura. Tudo em JSON-LD válido, sem duplicação, performático.

Este guia mostra como implementar essa camada sem depender de plugins pesados, usando hooks nativos, Custom Post Types e campos estruturados. O resultado: rich snippets consistentes, melhor compreensão do Google sobre sua área de atuação e base técnica para escalar páginas de serviço.

Por que schema genérico falha em SEO local

Plugins como Yoast ou Rank Math geram schema padrão: Organization com logo, sameAs redes sociais, WebSite com SearchAction. Útil, mas genérico. Não informam que você presta “Consultoria SEO técnica” em “Santo André, SP” com coordenadas -23.6633, -46.5383. Não marcam suas páginas de serviço como ProfessionalService com offers, areaServed e hasOfferCatalog.

O Google usa dados estruturados para construir o Knowledge Graph. Se seu schema diz apenas “Organização em São Paulo”, a entidade fica difusa. Com ProfessionalService + LocalBusiness aninhados, areaServed como GeoCircle ou AdministrativeArea, e coordinates exatas, a entidade se torna “Consultoria SEO em Santo André” — muito mais acionável para buscas como “SEO Santo André” ou “consultoria SEO ABC Paulista”.

Além disso, schema genérico costuma duplicar: tema injeta Organization, plugin injeta outra. Duas entidades @type Organization na mesma página confundem validadores. A solução é assumir o controle: desativar schema do tema/plugins e implementar o seu via código.

Arquitetura de tipos para consultoria SEO em Santo André

A estrutura recomendada combina cinco tipos principais, cada um com papel definido:

1. Organization (apenas na home e páginas institucionais): identidade da marca, logo, contato, sameAs.
2. LocalBusiness (em todas as páginas): endereço físico, telefone, horários, geo coordinates, areaServed como AdministrativeArea “Santo André”.
3. ProfessionalService (nas páginas de serviço): tipo específico “SEO Consulting”, name, description, provider (Organization), areaServed, offers (PriceSpecification), hasOfferCatalog.
4. FAQPage (nas páginas de serviço e blog): mainEntity com Question/Answer reais de clientes.
5. BreadcrumbList (global): hierarquia de navegação em todas as páginas.

Esses tipos se conectam via @id e referências. Exemplo: ProfessionalService.provider aponta para @id da Organization. LocalBusiness contém a ProfessionalService via department ou makesOffer. BreadcrumbList itemListElement aponta para URLs canônicas.

A implementação deve ser condicional: Organization só na home/about; ProfessionalService só em CPT “servico_seo”; FAQPage só onde houver FAQs; BreadcrumbList em todo lugar. Isso evita markup irrelevante e poluição.

Implementação via hooks: JSON-LD dinâmico no functions.php

A abordagem recomendada: um plugin customizado ou mu-plugin que injeta JSON-LD no wp_head via hook, montando o objeto PHP e fazendo json_encode com JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES. Exemplo estruturado:

add_action( 'wp_head', 'devwp_inject_advanced_schema', 5 );

function devwp_inject_advanced_schema() {
    if ( is_singular( 'servico_seo' ) ) {
        $schema = devwp_build_service_schema();
    } elseif ( is_front_page() || is_page( 'sobre' ) ) {
        $schema = devwp_build_organization_schema();
    } else {
        $schema = devwp_build_localbusiness_schema();
    }
    
    // BreadcrumbList sempre
    $breadcrumb = devwp_build_breadcrumb_schema();
    
    // FAQPage se houver campo ACF
    if ( get_field( 'faq_items' ) ) {
        $faq = devwp_build_faq_schema();
        $schema = array_merge( (array) $schema, (array) $faq );
    }
    
    // Output como @graph para múltiplos tipos
    $graph = array_filter( [
        $schema,
        $breadcrumb,
        isset( $faq ) ? $faq : null
    ] );
    
    echo '<script type="application/ld+json">' . json_encode( [
        '@context' => 'https://schema.org',
        '@graph'   => array_values( $graph )
    ], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES ) . '</script>';
}

Cada função devwp_build_*_schema() retorna array associativo mapeando propriedades Schema.org. Use get_field() do ACF para dados dinâmicos: coordenadas, areaServed, preço, FAQs. Valide com json_last_error() antes de output.

Custom Post Type e ACF: dados estruturados na fonte

Crie CPT servico_seo com suporte a title, editor, thumbnail, custom-fields. No ACF, grupo de campos “Dados Schema” com:

• service_name (text) — ex: “Consultoria SEO Técnica”
• service_description (textarea)
• service_area (repeater: city, state, lat, lng, radius_km) — para areaServed como GeoCircle
• price_range (text) — ex: “2.000 reais - 8.000 reais/mês”
• price_currency (select: BRL)
• faq_items (repeater: question, answer)
• service_type (select: SEO Technical, SEO Content, SEO Local, Link Building)

No template single-servico_seo.php, o schema ProfessionalService puxa esses campos. Exemplo de areaServed como GeoCircle:

'areaServed' => [
    '@type' => 'GeoCircle',
    'geoMidpoint' => [
        '@type' => 'GeoCoordinates',
        'latitude'  => $lat,
        'longitude' => $lng
    ],
    'geoRadius' => '15000' // 15km em metros
]

Para múltiplas cidades (Santo André, São Bernardo, São Caetano), use array de GeoCircle ou AdministrativeArea. O Google aceita ambos; GeoCircle é mais preciso para raio de atuação.

BreadcrumbList global via Walker_Nav_Menu ou filtro

BreadcrumbList deve refletir a hierarquia real: Home > Serviços > SEO Técnico > Consultoria SEO Santo André. Duas abordagens:

1. Walker_Nav_Menu customizado: estende Walker_Nav_Menu, captura itens do menu ativo, monta itemListElement com position sequencial.
2. Filtro get_the_archive_title + lógica condicional: para arquivos de CPT/taxonomia, constrói breadcrumb baseado em get_post_type_archive_link e get_term_link.

Prefira a opção 1 se o menu reflete a arquitetura; opção 2 se a estrutura é baseada em CPT/taxonomia. Em ambos, gere @id único por breadcrumb (ex: https://seusite.com.br/#breadcrumb-3) e referencie no ProfessionalService via breadcrumb property.

Valide: cada ListItem tem item (WebPage com @id e name) e position (inteiro). O último item (página atual) pode omitir item ou incluir com url igual à canônica.

FAQPage: perguntas reais, não genéricas

FAQPage só agrega valor se as perguntas forem reais — extraídas de atendimentos, formulários, Search Console “Pessoas também perguntam”. Para consultoria SEO em Santo André, exemplos:

• “Quanto tempo leva para ver resultados de SEO em Santo André?”
• “Vocês atendem presencialmente em Santo André ou só remoto?”
• “Qual a diferença entre SEO local e SEO orgânico para empresas do ABC?”

Cada par Question/Answer vira mainEntity no schema. Respostas devem ter 2-4 frases, sem HTML, diretas. No ACF, repeater faq_items com campos question (text) e answer (textarea). No template, loop monta array.

Cuidado: não marque FAQ se a página não tem FAQ visível ao usuário. O Google penaliza markup de conteúdo oculto. Também evite duplicar FAQPage em múltiplas páginas — cada página tem seu conjunto.

Validação, monitoramento e armadilhas

Após implementar, teste todas as URLs principais no:

• Rich Results Test — foco em elegibilidade para rich snippets
• Schema Markup Validator — foco em sintaxe e completude

Erros comuns:

• @id duplicados ou ausentes em @graph
• areaServed como string em vez de objeto GeoCircle/AdministrativeArea
• offers sem priceSpecification com priceCurrency e price
• FAQPage sem mainEntity ou com Answer vazio
• Duas Organization na mesma página (tema + seu código)

No Search Console, monitore “Melhorias > Dados estruturados”. Acompanhe impressões/cliques de rich snippets via “Desempenho > Aparência na pesquisa”. Para consultoria local, o rich snippet de “Serviço” com preço e área aparece em buscas móveis.

Integração com gestão de tráfego e conversão

Schema markup avançado não vive isolado. Ele alimenta dados para pixels, APIs de conversão e ferramentas de automação. Um gestor de tráfego em Feira de Santana bem estruturado usa dados de schema (service type, price, area) para segmentar audiências em campanhas pagas, criar públicos lookalike baseados em leads de páginas com ProfessionalService válido, e otimizar lances por valor de serviço.

No lado técnico, o JSON-LD limpo no head não bloqueia renderização. Mantenha o script pequeno (< 2KB), evite dependências externas, use defer se mover para footer (wp_footer hook). Teste Core Web Vitals: LCP, CLS, INP não devem piorar. Schema é metadata, não UI.

Conclusão prática

Implementar schema markup avançado no WordPress para consultoria SEO em Santo André exige controle total sobre a saída JSON-LD, dados estruturados na fonte (CPT + ACF), validação contínua e integração com a estratégia de tráfego. Plugins genéricos não entregam a granularidade necessária para SEO local competitivo. Assuma o código, versiona, documente e monitore. O resultado é uma camada semântica que o Google entende, confia e recompensa com visibilidade qualificada.

Checklist prático

Perguntas frequentes