Plataforma

Shopify

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

1 Pré-requisitos

Google Tag Manager configurado na loja (via app ou código no tema)
Permissão para publicar containers no GTM
O domínio da loja (ex: minhaloja.myshopify.com ou domínio customizado)

ℹ 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

O Shopify expõe os dados do produto via objeto global ShopifyAnalytics, disponível em páginas de produto de praticamente todos os temas.

Crie uma variável do tipo Custom JavaScript:

Campo	Valor
Nome da variável	`dlv - Content ID`
Tipo	Custom JavaScript

function() {
  var meta = window.ShopifyAnalytics && window.ShopifyAnalytics.meta;
  if (meta && meta.product) {
    return String(meta.product.id);
  }
  return undefined;
}

⚠ Se a sua loja usa uma integração customizada que não expõe ShopifyAnalytics, consulte o guia Genérico para alternativas.

3 Criar a variável de timestamp

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 por tema

Tema	Seletor
Dawn (padrão Shopify)	`.product__description`
Outros temas	`.product-description` ou `#product-description`

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

5 Configurar o gatilho

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

ℹ Use DOM Ready (e não Page View) para garantir que ShopifyAnalytics já foi inicializado quando o script executar.

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 variável retorna undefined

Abra o console do browser na página de produto e execute window.ShopifyAnalytics.meta.product — se retornar erro, o objeto não está disponível no tema
Temas headless ou com carregamento customizado podem não expor ShopifyAnalytics — use o guia Genérico

A descrição não aparece

Confirme que o domínio da loja está ativado
Verifique se o seletor do container está correto inspecionando o elemento na página
Confirme que a tag disparou no GTM Preview Mode

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.