Код отслеживания: базовая конфигурация

В этом справочнике описаны методы, которые вы используете для настройки всех аспектов отчетов Google Analytics.

Основные методы ga.js

Детали метода

_deleteCustomVar()

_deleteCustomVar(index)

Этот метод удаляет переменную, назначенную указанному индексу, если он существует. Например, вы можете установить пользовательскую переменную уровня посетителя, а позже решить, что больше не хотите использовать эту переменную уровня посетителя.

Асинхронный фрагмент (рекомендуется)

_gaq.push(['_deleteCustomVar', 1]);

параметры

Int index Индекс удаляемой пользовательской переменной.

_getName()

_getName()

Возвращает имя, присвоенное трекеру при его создании.

Асинхронный фрагмент (рекомендуется)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var trackerName = pageTracker._getName();
});

возвращается

String Имя трекера.

_getAccount()

_getAccount()

Возвращает идентификатор Google Analytics для этого объекта отслеживания. Если вы отслеживаете страницы на своем веб-сайте в нескольких учетных записях, вы можете использовать этот метод для определения учетной записи, связанной с конкретным объектом отслеживания.

Асинхронный фрагмент (рекомендуется)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var accountId = pageTracker._getAccount();
});

возвращается

String Идентификатор учетной записи, с которой создается этот объект отслеживания.

_getVersion()

_getVersion()

Возвращает номер версии GATC.

Асинхронный фрагмент (рекомендуется)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var version = pageTracker._getVersion();
});

возвращается

String Номер версии GATC.

_getVisitorCustomVar()

_getVisitorCustomVar(index)

Возвращает значение пользовательской переменной уровня посетителя, назначенное для указанного индекса.

Асинхронный фрагмент (рекомендуется)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var visitorCustomVar1Value = pageTracker._getVisitorCustomVar(1);
});

параметры

Int index Индекс пользовательской переменной уровня посетителя.

возвращается

String Значение пользовательской переменной уровня посетителя. Возвращает значение undefined, если невозможно получить переменную для указанного индекса.

_инитдата()

_initData() . initData() теперь выполняется автоматически в коде отслеживания ga.js.

Инициализирует или повторно инициализирует объект GATC (код отслеживания Google Analytics).

var pageTracker = _gat._getTracker("UA-12345-1");
pageTracker._trackPageview();

_setAccount()

_setAccount(accountId)

Используется исключительно в асинхронном отслеживании. Задает идентификатор веб-ресурса для объекта отслеживания.

_gaq.push(['_setAccount', 'UA-XXXXX-X']);

параметры

String accountID Полный идентификатор веб-ресурса (например UA-65432-1 ) для объекта отслеживания.

_setCookiePersistence()

_setCookiePersistence(milliseconds)

Этот метод устарел. Вместо этого используйте _setVisitorCookieTimeout (cookieTimeoutMillis) .

Устанавливает срок действия файла cookie посетителя Google Analytics в миллисекундах. По умолчанию срок действия файла cookie посетителя составляет 2 года. При желании вы можете изменить дату истечения срока действия файла cookie посетителя, используя этот метод. Например, чтобы установить срок действия файла cookie посетителя на 7 дней, вы должны использовать следующий код:

pageTracker._setCookiePersistence(604800000);

параметры

Number milliseconds Время истечения срока действия файла cookie нового посетителя.

_setCustomVar()

_setCustomVar(index, name, value, opt_scope)

Задает пользовательскую переменную с указанным именем, значением и областью действия для переменной. Существует ограничение в 128 байтов для name и value вместе взятых.

Асинхронный фрагмент (рекомендуется)

_gaq.push(['_setCustomVar', 1, 'Section', 'Life & Style', 3]);

возвращается

Boolean Этот метод возвращает true , если пользовательская переменная была успешно установлена, и false , если нет (например, если длина строки имени/значения превышает 128 байт или если вы используете неверный слот).

параметры

Int index Обязательно. Слот, используемый для пользовательской переменной. Возможные значения: 1-5 включительно.

String name Обязательно. Имя пользовательской переменной.

String value Обязательно. Значение пользовательской переменной.

Int opt_scope Необязательный . Область, используемая для пользовательской переменной. Возможные значения: 1 для уровня посетителя, 2 для уровня сеанса и 3 для уровня страницы.

_setSampleRate()

_setSampleRate(newRate)

Устанавливает новую частоту дискретизации. Если ваш веб-сайт особенно велик и подвержен резким скачкам трафика, то настройка частоты выборки обеспечивает бесперебойное отслеживание отчетов. Выборка в Google Analytics выполняется последовательно для уникальных посетителей, поэтому даже при включенной выборке сохраняется целостность в тенденциях и отчетах, поскольку уникальные посетители остаются включенными или исключенными из выборки в соответствии с настройками с момента начала выборки.

Вам нужно только указать этот метод одновременно с вызовом _setAccount(), как правило, один раз для каждой страницы или приложения (где бы вы ни инициализировали сам код отслеживания). Имейте в виду, что указанное вами значение частоты дискретизации остается в силе до тех пор, пока сохраняется сам объект отслеживания.

Асинхронный фрагмент (рекомендуется)

_gaq.push(['_setSampleRate', '2.5']);

параметры

String newRate Новая частота дискретизации для установки. Укажите числовую строку от 0 до 100 (с точностью до двух знаков после запятой).

_setSessionTimeout()

_setSessionTimeout(newTimeout)

Этот метод устарел. Вместо этого используйте _setSessionCookieTimeout (cookieTimeoutMillis) .

Устанавливает время ожидания нового сеанса в секундах. По умолчанию время ожидания сеанса установлено на 30 минут (1800 секунд). Тайм-аут сеанса используется для подсчета посещений (см. раздел Определение сеанса в Analytics ). Если вы хотите изменить определение «сеанса» для ваших конкретных нужд, вы можете указать количество секунд, чтобы определить новое значение. Это повлияет на отчеты о посещениях в каждом разделе, где рассчитывается количество посещений и где посещения используются для вычисления других значений. Например, количество посещений обычно увеличивается, если вы сокращаете время ожидания сеанса, и обычно уменьшается, если вы увеличиваете время ожидания сеанса.

параметры

String newTimeout ожидания нового сеанса в секундах.

_setSessionCookieTimeout()

_setSessionCookieTimeout(cookieTimeoutMillis)

Устанавливает время ожидания нового файла cookie сеанса в миллисекундах. По умолчанию время ожидания сеанса установлено на 30 минут. Тайм-аут сеанса используется для подсчета посещений, поскольку посещение заканчивается через 30 минут бездействия браузера или после выхода из браузера. Если вы хотите изменить определение «сеанса» для ваших конкретных нужд, вы можете указать количество миллисекунд, чтобы определить новое значение. Это повлияет на отчеты о посещениях в каждом разделе, где рассчитывается количество посещений и где посещения используются для вычисления других значений. Например, количество посещений увеличится, если вы сократите время ожидания сеанса, и уменьшится, если вы увеличите время ожидания сеанса. Вы можете изменить время ожидания на 0, чтобы указать, что этот файл cookie должен быть удален при закрытии браузера.

Асинхронный фрагмент (рекомендуется)

_gaq.push(['_setSessionCookieTimeout', 1800000]);


параметры

Number cookieTimeoutMillis Новое время ожидания сеанса в миллисекундах или 0 для удаления файла cookie при закрытии браузера.

_setSiteSpeedSampleRate()

_setSiteSpeedSampleRate(sampleRate)

Определяет новый размер выборки для сбора данных о скорости сайта. По умолчанию фиксированная 1% выборка посетителей вашего сайта составляет пул данных, из которого получаются показатели скорости сайта. Если у вас относительно небольшое количество ежедневных посетителей вашего сайта, например 100 000 или меньше, вы можете увеличить частоту выборки. Это обеспечит повышенную детализацию времени загрузки страницы и других показателей скорости сайта. (Подробнее об отчетах «Скорость сайта» см. в разделе «Скорость сайта » в Справочном центре.)

Чтобы быть эффективным, метод _setSiteSpeedSampleRate() должен вызываться до _trackPageview() .

Аналитика ограничивает количество попаданий в коллекцию Site Speed ​​для одного ресурса 1 % пользователей или 10 000 обращений в день, чтобы обеспечить справедливое распределение системных ресурсов для этой функции.

Примечание. Мы настоятельно рекомендуем сайтам с более чем 1 миллионом посещений в день сохранять для выборки выборки значение по умолчанию 1 %. Увеличение размера выборки не приведет к увеличению размера выборки.

Асинхронный фрагмент (рекомендуется)

_gaq.push(['_setSiteSpeedSampleRate', 5]);
_gaq.push(['_trackPageview']);

параметры

Number sampleRate Значение от 0 до 100, чтобы определить процент посетителей вашего сайта, который будет измеряться для целей скорости сайта. Например, значение 5 задает для образца коллекции Site Speed ​​значение 5 %.

_setVisitorCookieTimeout()

_setVisitorCookieTimeout(cookieTimeoutMillis)

Устанавливает срок действия файла cookie посетителя Google Analytics в миллисекундах. По умолчанию срок действия файла cookie посетителя составляет 2 года. При желании вы можете изменить дату истечения срока действия файла cookie посетителя, используя этот метод. Вы можете изменить время ожидания на 0, чтобы указать, что этот файл cookie должен быть удален при закрытии браузера.

Асинхронный фрагмент (рекомендуется)

_gaq.push(['_setVisitorCookieTimeout', 63072000000]);

параметры

Number cookieTimeoutMillis Новый срок действия файла cookie посетителя в миллисекундах или 0, чтобы удалить файл cookie при закрытии браузера.

_setVar()

_setVar(newVal)

Этот метод устарел. Вместо этого используйте _setCustomVar() .

Задает или определяет настраиваемый сегмент посетителей с предоставленной строкой. Вы можете использовать это значение, чтобы обеспечить дополнительную сегментацию пользователей вашего веб-сайта. Например, у вас может быть страница входа или форма, которая активирует значение на основе ввода посетителя, например предпочтения, которое выбирает посетитель, или параметра конфиденциальности. Затем эта переменная обновляется в файле cookie для этого посетителя. При реализации на вашем сайте и сборе данных с помощью этого метода новый определенный сегмент появляется в отчетах « Определяемые пользователем » в разделе «Посетители» аналитических отчетов. Кроме того, вы можете получить доступ к сегменту User Defined Value в отчете Content Detail, чтобы увидеть, какой процент посетителей страницы относится к определенному вами сегменту.

параметры

String newVal Новое определяемое пользователем значение для установки.

_trackPageLoadTime()

_trackPageLoadTime()

Этот метод устарел, поскольку отчеты о скорости сайта автоматически включаются для всех пользователей. Пожалуйста, используйте _setSiteSpeedSampleRate() , чтобы настроить частоту выборки для отчетов о скорости сайта.

Включает отчеты о скорости сайта для этой страницы. Вставьте этот метод для каждой страницы вашего сайта, для которой вы хотите создать отчет о скорости сайта. Дополнительную информацию об отчетах «Скорость сайта» в Analytics можно найти в статье « Скорость сайта » в нашем Справочном центре.

Проверка ваших изменений

Если вы видите, что данные появляются в отчетах, ваша настройка верна. Если вы не видите никаких данных через 24 часа, проверьте свою настройку, чтобы убедиться, что вы не допустили ошибок. См. раздел «Устранение неполадок с кодом отслеживания» для получения списка распространенных ошибок кода отслеживания. Это руководство по устранению неполадок также содержит основные шаги по отладке и дополнительную информацию об отладке.

Имейте в виду, что включение отслеживания скорости сайта для вашего сайта приводит к дополнительному запросу к серверам Google Analytics, отдельному от запроса GIF отслеживания страницы, сделанного для просмотров страниц. Чтобы свести к минимуму влияние на общую задержку сайта, этот запрос отправляется только при выборке просмотров страниц вашего сайта. По этой причине вы не всегда можете увидеть запрос GIF скорости сайта при попытке отладки этой функции в Firebug или других инструментах. Это нормально и ожидаемо.

Асинхронный фрагмент (рекомендуется)

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview']);
_gaq.push(['_trackPageLoadTime']);

_trackPageview()

_trackPageview(opt_pagePath)

Основная логика для GATC (код Google Analytics Tracker). Если функции компоновщика включены, он пытается извлечь значения файлов cookie из URL-адреса. В противном случае он пытается извлечь значения cookie из document.cookie . Он также обновляет или создает файлы cookie по мере необходимости, а затем записывает их обратно в объект документа. Собирает все необходимые метрики для отправки в UCFE (внешний интерфейс сборщика данных Urchin).

Асинхронный фрагмент (рекомендуется)

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview', '/home/landingPage']);

параметры

String opt_pagePath Необязательный параметр, указывающий путь к странице для отслеживания метрик. При использовании этого параметра используйте начальную косую черту (/), чтобы указать путь к странице.