Árvore de categorias no produto do checkout

Anteriormente, a etapa de checkout retornava apenas o nível macro da categoria do item (category), mantendo o campo googleCategory não preenchido. Essa limitação impedia que ferramentas de inteligência analítica, como o Google Analytics 4 (GA4), registrassem a hierarquia mercadológica completa no evento de conversão (purchase).

Na prática, um produto detalhado na vitrine com múltiplos níveis hierárquicos chegava ao fechamento do pedido apenas com a sua categoria genérica, prejudicando o acompanhamento de subcategorias no fundo do funil de vendas. Para contornar esse gargalo, equipes de desenvolvimento precisavam executar consultas paralelas via JavaScript no tema para cruzar os dados, um processo manual e vulnerável a inconsistências.

A nova funcionalidade elimina a necessidade de contornos técnicos ao expor a árvore de categorias nativamente no retorno das chamadas do checkout.

O que mudou?

• Novo Campo productCategories: Inclusão da propriedade productCategories: [ProductCategory] no produto do pedido no checkout, reutilizando a mesma estrutura e subatributos já presentes nas consultas de catálogo (id, name, url, active, main, hierarchy e googleCategories).
• Abrangência de Cobertura: Os dados ficam acessíveis em orders.products, nos produtos que compõem kits no pedido e no retorno da mutation checkoutComplete.
• Arquitetura 100% Aditiva: Os campos legados category e googleCategory permanecem inalterados, garantindo total retrocompatibilidade e risco zero de quebra (breaking change) em integrações ativas.

Principais Benefícios:

• Paridade de Dados Analíticos (GA4): Garante a mesma precisão e profundidade de dados de categorias da página de produto (PDP) até a confirmação de compra (purchase), permitindo análises detalhadas de conversão e abandono por subcategoria em toda a jornada.
• Eliminação de Workarounds no Front-End: O data layer passa a consumir a hierarquia de categorias diretamente da resposta da requisição, dispensando chamadas adicionais de API e códigos de cruzamento de dados no tema.
• Custo Computacional Zero: O carregamento da hierarquia ocorre sob demanda, sendo executado exclusivamente quando o campo é explicitamente selecionado na query, preservando a performance das requisições existentes.
• Tratamento Defensivo e Resiliente: Em cenários em que o item não for localizado no catálogo no momento da consulta, o campo retornará vazio ou nulo sem gerar mensagens de erro ou interromper a resposta do checkout.
• Disponibilidade Imediata: Atualização disponibilizada via API pública para toda a base de lojas, sem necessidade de parametrização no painel Admin ou dependência de atualização da versão do tema.

Ainda sobrou alguma dúvida ou quer entender todos os detalhes de configuração e começar a aplicar agora mesmo? Confira o passo a passo completo na nossa documentação oficial:

🔗 Categorias do Produto no Checkout 

Publicado em 10/08/2026