Pular para o conteúdo principal

GET /api/v1/analytics/:writeKey/gtm.js

Retorna um script JavaScript auto-contido que implementa tracking no browser — sem precisar instalar SDK. O script:

  • Gera e persiste anonymousId em localStorage (chave crm_anonymous_id).
  • Extrai UTMs da query string e os anexa ao context.campaign.
  • Mantém sessionId em localStorage (chave crm_session_id).
  • Expõe window._eapp como interface para disparar eventos e identificar usuários.
  • Chama internamente /track e /identify/public usando a Write Key embutida na URL.

Autenticação​

Nenhuma. A Write Key é parte da URL.

Path parameter​

ParâmetroTipoDescrição
writeKeyUUIDSua Write Key

Resposta​

200 OK

  • Content-Type: application/javascript
  • Body: código JavaScript pronto para uso em <script src=...>

Como integrar​

Adicione no <head> da sua página:

<script src="https://api-crm.ecommerceapp.com.br/api/v1/analytics/SEU-WRITE-KEY-UUID/gtm.js"></script>

Disparando eventos​

Defina window._eapp antes de carregar o script (ou após) para enviar um evento:

<script>
  window._eapp = {
    eventName: 'Product Viewed',
    data: {
      product_id: 'SKU-123',
      name: 'Camiseta Preta',
      price: 89.90,
      currency: 'BRL'
    },
    context: {
      page: { url: window.location.href, title: document.title }
    },
    userId: 'user-9182'  // opcional
  };
</script>
<script src="https://api-crm.ecommerceapp.com.br/api/v1/analytics/SEU-WRITE-KEY-UUID/gtm.js"></script>

Eventos suportados​

Use qualquer event key suportado no campo eventName.

Variáveis persistidas em localStorage​

ChaveConteúdo
crm_anonymous_idUUID gerado na primeira visita
crm_session_idULID da sessão ativa (rotaciona a cada 30 min de inatividade)

Erros​

Se o writeKey na URL não existir ou estiver inválido, o script retornará erro HTTP — verifique antes de publicar a tag.