Plataforma

VTEX

Passo a passo para ativar as descrições via Google Tag Manager em lojas VTEX Store Framework.

1 Pré-requisitos

Confirme que você tem acesso a:

Google Tag Manager configurado na loja
Permissão para publicar containers no GTM
O domínio da loja (ex: minhaloja.vtexcommercestable.com.br)

ℹ O domínio da loja precisa estar previamente ativado. Se ainda não solicitou a ativação, entre em contato antes de prosseguir.

2 Criar a variável de Content ID

No GTM, crie uma variável do tipo Data Layer Variable. O GTM app nativo da VTEX empurra o ID do produto para o datalayer em páginas de produto.

Campo	Valor
Nome da variável	`dlv - Content ID`
Tipo	Data Layer Variable
Data Layer Variable Name	`ecommerce.detail.products.0.id`

⚠ Se a sua loja usa uma estrutura de datalayer customizada, consulte o desenvolvedor responsável para identificar o caminho correto até o Product ID.

3 Criar a variável de timestamp

Crie uma variável do tipo Custom JavaScript para garantir cache busting diário:

Campo	Valor
Nome da variável	`Custom - Day Timestamp`
Tipo	Custom JavaScript

function() {
  return Math.floor(Date.now() / 86400000);
}

4 Criar a tag

Crie uma nova tag do tipo Custom HTML. Substitua .SELETOR-DO-CONTAINER pelo seletor CSS do elemento onde a descrição deve ser renderizada.

<script>
  window.BDESC = window.BDESC || [];
  BDESC.push({
    pageid: '{{dlv - Content ID}}',
    target: '.SELETOR-DO-CONTAINER'
  });
</script>
<script src="https://content-descriptions.pages.dev/tag.js?cv={{Custom - Day Timestamp}}" async></script>

Seletor no Store Framework

No tema padrão do Store Framework, o container da descrição geralmente é:

.vtex-store-components-3-x-productDescriptionContainer

Inspecione o elemento na página de produto da sua loja para confirmar o seletor correto antes de publicar.

5 Configurar o gatilho

Associe a tag a um gatilho de páginas de produto. Duas opções:

Opção A — Evento customizado (recomendado)

Campo	Valor
Tipo	Custom Event
Event name	`productDetail`

Opção B — Page View com condição

Campo	Valor
Tipo	Page View
Condição	`{{dlv - Content ID}}` não é igual a `undefined`

6 Publicar e validar

Publique uma nova versão do container GTM
Abra uma página de produto da loja
Use o GTM Preview Mode para confirmar que a tag disparou
Verifique se {{dlv - Content ID}} está retornando o ID correto
Confirme que a descrição aparece no lugar certo e responde em mobile

✓ Se a descrição aparecer corretamente na página de produto, a implantação está concluída.

Solução de problemas

A descrição não aparece

Confirme que o domínio da loja está ativado
Verifique se {{dlv - Content ID}} está retornando um valor no GTM Preview
Confirme que o seletor do container está correto inspecionando o elemento na página
Verifique se a tag disparou no GTM Preview Mode

A variável retorna undefined

O GTM app da VTEX pode não estar instalado — verifique em Apps > Google Tag Manager no admin
Inspecione o datalayer no console do browser: window.dataLayer

A altura está cortando o conteúdo

O iframe ajusta automaticamente via ResizeObserver — aguarde o carregamento completo
Se o problema persistir, entre em contato

Precisa de ajuda? Entre em contato com o suporte para ativação de domínio, dúvidas sobre a implantação ou para reportar problemas.