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

В этом справочнике описаны методы, которые вы используете для настройки всех аспектов отчетов 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 Значение пользовательской переменной уровня посетителя. Возвращает неопределенное значение, если невозможно получить переменную для указанного индекса.

_initData()

_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)

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

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

_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() .

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

Примечание. Мы настоятельно рекомендуем сайтам с числом посещений более 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 для этого посетителя. Если этот метод реализован на вашем сайте и данные собираются с помощью этого метода, новый определенный сегмент появляется в отчетах , определяемых пользователем, в разделе «Посетители» аналитических отчетов. Кроме того, вы можете получить доступ к сегменту «Пользовательское значение» в отчете «Подробности контента», чтобы узнать, какой процент посетителей страницы принадлежит определенному вами сегменту.

параметры

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 Analytic Tracker). Если функции компоновщика включены, он пытается извлечь значения файлов cookie из URL-адреса. В противном случае он пытается извлечь значения cookie из document.cookie . Он также обновляет или создает файлы cookie по мере необходимости, а затем записывает их обратно в объект документа. Собирает все необходимые показатели для отправки в UCFE (интерфейсный интерфейс сборщика Urchin).

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

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

параметры

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