Detecção automática

Provador virtual para WooCommerce

O WooCommerce publica uma interface própria de leitura de catálogo, e ela basta: com o endereço da loja, produtos, variações, estoque real, imagens e categorias entram sem credencial e sem plugin. Na loja, a tag no tema cuida do provador e da medição do funil.

Catálogo
Sem credencial
Instalação
1 linha no tema
Plugin
Nenhum
  • Catálogo pela API pública da própria loja, só com o endereço
  • Estoque real, imagens e categorias, não só nome e preço
  • Nenhum plugin instalado no WordPress
  • Uma única tag <script>, em todas as páginas da loja

Uma tag, em todas as páginas

No header.php do tema, antes do fechamento do <head>, ou por um plugin de cabeçalho que você já use.

<script src="https://unpkg.com/mk-sdk-git@1/dist/mk-sdk.js"
        data-mk-project="SEU_PROJECT_ID"
        data-mk-product="mk-fashion"
        async></script>

Troque SEU_PROJECT_ID pelo identificador do seu projeto. O atributo async garante que a tag não bloqueia o carregamento da página, e @1 fixa a major da versão: você recebe correção sem risco de um release novo mudar a loja sem aviso.

  1. Receba o seu projectId

    A metaKosmos cria o projeto e envia o identificador. Ele é o único valor que muda na tag, e não é segredo: vai no HTML público da loja.

  2. Informe o endereço da loja

    Só isso. O WooCommerce publica uma interface de leitura de catálogo aberta, e é por ela que produtos, variações, estoque, imagens e categorias entram. Nenhuma chave, nenhum usuário, nenhum plugin instalado.

  3. Cole a tag no tema

    No header.php do tema, antes do fechamento do <head>, ou por um plugin de cabeçalho que a sua operação já use. Evite editar o tema pai diretamente: uma atualização do tema apagaria a alteração. Use tema filho ou o plugin.

  4. Abra uma PDP e confirme

    Com o catálogo importado, o botão de provar aparece nos produtos que têm provador. Vale confirmar dois pontos no seu tema: que a página de produto publica o código da peça de forma legível por máquina, e que o botão de comprar responde ao acionamento do provador.

Observações importantes

  • Fixe a major da versão (@1) em vez de @latest: você recebe correção sem risco de um release novo mudar a loja sem aviso.
  • Não edite o header.php do tema pai: a próxima atualização apaga. Use tema filho ou um plugin de cabeçalho.
  • Na loja, o provador usa o caminho genérico: identifica o produto pelos dados estruturados da página e aciona o botão de compra do tema. Não há módulo escrito para as particularidades do WooCommerce.
  • O WordPress tem ecossistema de tema e plugin muito variado, então confirmamos esses dois pontos na sua loja antes de produção: identificação da peça e acionamento do botão.
  • O SDK não precisa de Google Analytics, Tag Manager nem dataLayer, e não pede nenhum evento manual da loja.

O que o adapter de WooCommerce resolve

  • Catálogo sem credencial e sem plugin

    O WooCommerce já expõe uma interface pública de leitura de catálogo. Basta o endereço da loja: nenhuma chave de API a gerar, nenhum acesso ao painel, nenhum plugin instalado no WordPress.

  • Estoque real, não aproximação

    Essa interface entrega disponibilidade de verdade por variação, além de imagens e categorias. É catálogo de qualidade de conector, por uma via pública, o que não acontece na maioria das plataformas.

  • Importação em lote

    A leitura traz cem produtos por requisição, então catálogo grande entra rápido e a loja não sente a importação.

  • Instalação sem mexer em código

    Se a operação já usa um plugin de cabeçalho, a tag entra por lá e nenhum arquivo de tema é tocado. Isso também protege a alteração da próxima atualização do tema.

  • Botão sem componente novo

    O botão de provar é injetado em Shadow DOM fechado, ancorado ao lado do comprar, com aparência controlada pelo painel. O CSS da loja e o nosso ficam isolados.

  • Funil medido sem instrumentação

    Visita, produto, carrinho e compra são detectados por sinais que a loja já emite. Nenhum evento manual, nenhuma mudança no checkout.

Duas metades, e aqui a do catálogo é a forte

Na maioria das plataformas, o catálogo exige credencial e o storefront tem módulo dedicado. No WooCommerce é quase o inverso, e vale entender por quê.

O catálogo é a metade forte: a plataforma publica uma interface própria de leitura, aberta, que entrega produtos, variações, disponibilidade real, imagens e taxonomia. Sem chave, sem acesso ao painel e sem plugin. Na prática, dá para importar o catálogo de uma loja WooCommerce sabendo apenas o endereço dela, o que torna a prova de conceito quase imediata.

A loja usa o caminho genérico: o provador identifica o produto pelos dados estruturados da página e aciona o botão de compra do próprio tema. Funciona, mas não é um módulo escrito para as particularidades do WooCommerce, e o ecossistema de temas do WordPress é o mais variado de todos.

Onde colar a tag, e por que não no tema pai

A tag vai no cabeçalho, para valer em todas as páginas. O caminho direto é o header.php do tema, antes do fechamento do head.

Só que editar o tema pai é a forma mais comum de perder a alteração: a próxima atualização do tema sobrescreve o arquivo, e a integração some sem ninguém perceber. Semanas depois o painel simplesmente para de receber dados.

Prefira tema filho ou um plugin de cabeçalho, que é o caminho que a maioria das operações já tem instalado. A alteração sobrevive à manutenção do site.

O que confirmamos antes de liberar

Dois pontos, e eles se verificam em minutos: se a página de produto publica o código da peça de forma legível por máquina, e se o botão de comprar responde ao acionamento do provador.

Essa confirmação importa mais aqui do que em plataforma fechada, porque no WordPress o tema pode ter sido feito por qualquer pessoa e alterado várias vezes ao longo dos anos.

Existe uma extensão de navegador que injeta o SDK em qualquer loja e mostra exatamente isso, sem a loja instalar nada. É assim que conferimos a sua antes de qualquer alteração no tema.

mK Fashion+ na WooCommerce

Preciso instalar um plugin no meu WordPress?

Não. O catálogo entra pela interface de leitura que o próprio WooCommerce publica, e a tag vai no cabeçalho do tema. Se você já usa um plugin de cabeçalho, pode usá-lo, mas nenhum plugin novo é necessário.

Preciso gerar chave de API?

Não. Basta o endereço da loja. É uma das poucas plataformas em que o catálogo completo, com estoque real, entra sem credencial nenhuma.

O estoque fica correto no provador?

Sim. A interface pública do WooCommerce entrega disponibilidade por variação, então a grade que o provador mostra reflete o que está de fato à venda.

Onde exatamente colo a tag?

No header.php do tema, antes do fechamento do head, ou por um plugin de cabeçalho. Não edite o tema pai: a próxima atualização apagaria a alteração. Use tema filho ou o plugin.

Existe módulo específico para WooCommerce?

Para o catálogo, a via pública da plataforma é usada de forma dedicada. Na loja, o provador usa o caminho genérico e confirmamos na sua instalação a identificação da peça e o acionamento do botão, porque o ecossistema de temas do WordPress é muito variado.

Preciso de Google Analytics, Tag Manager ou dataLayer?

Não. A medição do funil usa sinais que a loja já emite, como URL, dados estruturados e cliques. Nenhum evento manual é necessário e o checkout não é alterado.