Шпаргалка по устаревшим API Google Analytics (analytics.js / ga.js)

[!NOTE] analytics.js (Universal Analytics) и ga.js — устаревшие клиентские библиотеки, замененные на Google Analytics 4 (GA4 через gtag.js). Это руководство сохранено в архивных целях.

Universal Analytics (analytics.js)

Просмотры страниц (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' })

Отслеживание событий (Event Tracking)

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

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

Отслеживание исключений (Exception Tracking)

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

---

Классический Google Analytics (ga.js)

Архивный синтаксис для синхронных и асинхронных сниппетов отслеживания ga.js.

Отслеживание событий (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']);

Пользовательские переменные (Custom Variables)

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

// Область действия Scope: 1 (посетитель), 2 (сессия), 3 (страница, по умолчанию)

---

Связанные руководства

• Руководство по миграции Google Analytics
• Документация Universal Analytics (analytics.js)
• Шпаргалка по HTML Meta-тегам
• Шпаргалка по JavaScript Fetch API