Provador virtual em WooCommerce: integração simples

WooCommerce e WordPress no varejo

WooCommerce, plugin oficial de e-commerce do WordPress, roda em mais de 6 milhões de sites no mundo. No Brasil, é a opção preferida de marcas que querem controle total sobre o storefront, customização ampla e custo recorrente baixo. Marcas DTC, brechós digitais e operações de moda autoral frequentemente escolhem WordPress + WooCommerce.

A flexibilidade do WordPress, no entanto, traz fragmentação. Cada loja tem combinação própria de tema (Astra, Storefront, Flatsome, Divi, GeneratePress, Avada), plugins de cache (WP Rocket, W3 Total Cache, LiteSpeed) e construtores visuais (Elementor, Bricks, Gutenberg). Isso significa que não há um único caminho oficial para inserir um script de terceiros: há três caminhos viáveis, e qual escolher depende do contexto.

Este guia cobre os três, com atenção a performance, cache e compatibilidade com themes mais populares no varejo de moda brasileiro. O Provou é uma tag de script com 18 KB gzip, render em Shadow DOM, sem dependência do framework.

Antes de começar

• WordPress + WooCommerce instalados.
• Acesso de admin (preferencialmente via FTP ou SSH para edições rápidas).
• Cadastro Provou ativo (use o cadastro gratuito, 14 dias sem cartão).
• Slug da loja no painel Provou.
• Tabela de medidas em CSV ou feed GMC.
• Backup recente do site.

Tempo estimado: 10 a 20 minutos, dependendo do caminho escolhido.

Onde inserir o snippet (3 caminhos)

O snippet base do Provou:

``html <script src="https://cdn.provou.app.br/v1.js" data-store="sua-loja" async></script> ``

Caminho 1: via tema (functions.php)

O caminho mais robusto para quem se sente confortável com PHP. Edite functions.php do tema (preferencialmente um child theme):

``php add_action('wp_head', function() { if (is_woocommerce() || is_product() || is_shop()) { echo '<script src="https://cdn.provou.app.br/v1.js" data-store="sua-loja" async></script>'; } }); ``

Isso restringe o widget a páginas WooCommerce (PDPs e listagens). Se preferir carregar em todo o site, remova o if.

Alternativa mais formal usando wp_enqueue_script:

``php add_action('wp_enqueue_scripts', function() { wp_enqueue_script( 'provou', 'https://cdn.provou.app.br/v1.js', [], null, ['strategy' => 'async', 'in_footer' => false] ); wp_script_add_data('provou', 'data-store', 'sua-loja'); }); ``

Em WordPress 6.3+, o strategy => async é suportado nativamente.

Caminho 2: via plugin Insert Headers and Footers

Para lojistas que evitam editar PHP, o caminho via plugin é seguro:

1. Instale o plugin Insert Headers and Footers (oficial WPBeginner) ou WPCode.
2. Acesse Configurações > Insert Headers and Footers.
3. Cole o snippet no campo "Scripts no Header".
4. Salve.

O plugin injeta automaticamente em wp_head em todas as páginas. Não há filtragem por contexto sem edição.

Caminho 3: via Google Tag Manager

Para lojas que já gerenciam tags via GTM, esse é o caminho mais limpo:

1. Em GTM: Tags > New > Custom HTML.
2. Cole o snippet completo.
3. Trigger: All Pages ou só PDPs (Page Path matches /produto/).
4. Save and Publish.

Vantagem: zero acoplamento ao tema ou plugin. Toda a configuração vive em GTM.

Desvantagem: depende de GTM já instalado e configurado corretamente.

Importação de tabelas de medidas

WooCommerce expõe REST API e tem export CSV nativo. O Provou aceita:

1. CSV upload: exporte produtos do admin WooCommerce (Produtos > Exportar), complemente com colunas de medidas, importe no painel Provou.
2. WooCommerce REST API: para automação, gere um par de chaves (Consumer Key + Secret) e conecte no painel Provou.
3. Feed GMC: se sua loja já alimenta Google Shopping (via plugin Product Feed PRO ou similar), aponte o feed.

Para detalhes sobre estrutura ideal de tabela, veja o guia de tabela de medidas.

Compatibilidade com themes populares

| Theme | Status | Observação | |---|---|---| | Storefront (oficial WooCommerce) | Compatível direto | Sem ajustes | | Astra | Compatível direto | Sem ajustes | | Flatsome | Compatível direto | Atenção a modais customizados | | Divi | Compatível direto | Use Code Module se preferir | | GeneratePress | Compatível direto | Sem ajustes | | Avada | Compatível direto | Sem ajustes |

Em todos esses themes, o widget detecta automaticamente o seletor de variantes WooCommerce padrão. Se sua loja usa um plugin de variantes alternativo (Advanced Custom Product Options, Product Add-Ons), pode ser necessário ajustar o ponto de ancoragem via data-anchor.

Cache e performance

WordPress costuma rodar com cache agressivo. Após instalar o snippet:

1. WP Rocket / W3 Total Cache / LiteSpeed: limpe o cache de página.
2. Cloudflare (se em uso): limpe via dashboard ou via API.
3. OPcache: reinicie via cPanel ou WP-CLI se editou functions.php.

O Provou em si não consome recursos do servidor: o script é servido por CDN externa. O impacto em Lighthouse Mobile é zero em testes em themes padrão.

Se sua loja usa lazy loading agressivo de scripts (plugins como WP Rocket com defer everything), confirme que v1.js está na lista de exclusões do defer agressivo. O Provou já carrega async; não precisa de defer adicional.

Staging e testes antes de publicar

Quase todos os hosts gerenciados de WordPress (Kinsta, WP Engine, SiteGround, Hostinger Brasil) oferecem staging. Use:

1. Clone produção para staging.
2. Aplique o snippet em staging.
3. Valide PDPs em mobile e desktop.
4. Promova staging para produção (ou aplique diff manual).

Se sua loja não tem staging, use o kill switch do Provou: instale em produção, valide em janela de baixo tráfego, desabilite via painel se algo der errado.

Boas práticas

• Use child theme para edições em functions.php. Updates do parent theme não vão sobrescrever.
• Aplique o snippet só em páginas WooCommerce se sua loja tem blog/landing fora do shop. Reduz custo cognitivo de auditoria.
• Conecte eventos do widget ao GA4 via dataLayer.push para enriquecer analytics.
• Mantenha SKUs sincronizados entre WooCommerce e painel Provou. Atualizações automáticas via API evitam drift.
• Documente a integração no manual interno do time. WooCommerce muda menos que SaaS, mas devs novos precisam saber onde está o snippet.

Para começar, abra o cadastro gratuito, copie o slug, escolha um dos três caminhos, valide e publique. Em uma tarde sua loja WordPress + WooCommerce está com Provou rodando.

Para outras plataformas, veja os guias de Shopify e Magento no blog. Para o panorama estratégico, leia o post sobre aumentar conversão em e-commerce de moda.

Métricas e analytics em WooCommerce

Depois da instalação, vem a medição. WooCommerce + WordPress aceita virtualmente qualquer stack de analytics. Os caminhos canônicos para integrar eventos do Provou:

• GA4 via Site Kit by Google (plugin oficial) ou MonsterInsights.
• Meta Pixel via plugin oficial Meta for WooCommerce.
• Tag Manager via plugin GTM4WP ou Insert Headers and Footers.
• Klaviyo via integração oficial Klaviyo for WooCommerce.

O Provou emite cinco eventos no window (provou:loaded, provou:opened, provou:chart_viewed, provou:recommendation, provou:closed) e replica via dataLayer.push quando GTM está presente. Para encaminhar a GA4 manualmente:

``javascript window.addEventListener('provou:recommendation', (e) => { if (window.gtag) { window.gtag('event', 'size_recommended', { sku: e.detail.sku, size: e.detail.size, confidence: e.detail.confidence, }); } }); ``

KPIs primários para acompanhar:

• Taxa de abertura: % de visitantes da PDP que clicaram. Esperado: 10% a 16% em moda.
• Completude: % dos abridores que preencheram tudo. Esperado: 70% a 85%.
• Aplicação: % que escolheram o tamanho sugerido. Esperado: 65% a 80%.
• Lift de conversão: diferença entre cohorts. Esperado: +2 a +4 pp.
• Redução de devoluções por tamanho: 60 a 90 dias. Esperado: -25% a -42%.

Compatibilidade com WordPress Multisite e B2B

Lojas WordPress + WooCommerce em arquiteturas avançadas merecem atenção extra:

WordPress Multisite: redes com múltiplas lojas (uma matriz, várias filiais por marca ou região). O Provou suporta múltiplos slugs por instalação. Cada subsite mantém sua tabela de medidas independente, com governança centralizada via API. A injeção do snippet pode acontecer em functions.php do parent theme com is_main_query() ou no mu-plugins para granularidade fina.

WooCommerce B2B: lojas atacadistas com login obrigatório, preços diferenciados por cliente, embalagens em fardo ou caixa fechada. O widget continua funcional para indicar tamanho, mas a recomendação é ajustada para a unidade de venda (camiseta individual em B2C vs caixa de 12 em B2B). Configure no painel se sua operação tem essa peculiaridade.

WooCommerce headless: storefronts em Next.js, Astro ou outros frameworks consumindo WooCommerce REST/Storefront API. O caminho de integração migra para o frontend custom. Veja o guia para storefronts custom.

WooCommerce com WPML/Polylang: lojas multilíngues. O Provou detecta o idioma do navegador e mostra a UI no idioma correto. Tabelas podem ser por idioma se a modelagem varia por região; do contrário, uma tabela global serve.

Para começar, faça o cadastro gratuito, escolha o caminho de instalação que melhor se encaixa na sua operação e teste em staging. WooCommerce não é a plataforma mais simples, mas é a mais flexível. O Provou se adapta a essa flexibilidade.

WordPress + WooCommerce é a combinação mais flexível do mercado. O preço dessa flexibilidade é a responsabilidade pelo stack. Adicionar um provador virtual é um dos pontos onde a flexibilidade trabalha a favor: três caminhos, cada um adequado a um perfil de operação.