Folha de dicas das APIs Legadas do Google Analytics (analytics.js / ga.js)

[!NOTE] analytics.js (Universal Analytics) e ga.js sao bibliotecas herdadas substituidas pelo Google Analytics 4 (GA4 via gtag.js). Este guia serve como referencia de arquivo historico.

Universal Analytics (analytics.js)

Visualizacoes de pagina (Pageviews)

ga('create', 'UA-XXXX-Y', 'auto')
ga('create', 'UA-XXXX-Y', { userId: 'USER_ID' })

ga('send', 'pageview')
ga('send', 'pageview', { 'dimension15': 'My custom dimension' })

Rastreamento de eventos (Event Tracking)

ga('send', 'event', 'button', 'click', { color: 'red' });

ga('send', 'event', 'button', 'click', 'nav buttons', 4);
/*                  ^category ^action ^label         ^value (int) */

Rastreamento de excecoes (Exception Tracking)

ga('send', 'exception', {
  exDescription: 'DatabaseError',
  exFatal: false,
  appName: 'myapp',
  appVersion: '0.1.2'
})

---

Google Analytics classico (ga.js)

Sintaxe arquivada para implementacoes historicas de snippets ga.js.

Rastreamento de eventos (Event Tracking)

// [..., category, action, label, value (int), noninteraction (bool)]
_gaq.push(['_trackEvent', 'Videos', 'Play', 'Birthday video', true]);
_gaq.push(['_trackEvent', 'Projects', 'Donate', 'Project name']);
_gaq.push(['_trackEvent', 'Accounts', 'Login']);

Variaveis personalizadas (Custom Variables)

// [..., index (1-5), name, value, scope (optional)]
_gaq.push(['_setCustomVar', 1, 'Logged in', 'Yes', 2]);

// Escopo Scope: 1 (visitante), 2 (sessao), 3 (pagina, padrao)

---

Referencias relacionadas

• Guia de migracao do Google Analytics
• Documentacao do Universal Analytics (analytics.js)
• Folha de dicas de HTML Meta Tags
• Folha de dicas da JavaScript Fetch API