Настройка кода счётчика для отслеживания AJAX-сайтов

На сайтах, построенных на основе технологии AJAX, большинство действий пользователя не приводит к перезагрузке страницы, что затрудняет сбор статистики традиционными методами. Код счётчика Openstat можно настроить для сбора статистики о произвольных событиях, даже если они не приводят к перезагрузке страницы.

Передача осуществляется посредством имитации загрузки дополнительной страницы сайта. В статистике такие события будут отражаться как обычные загрузки страниц (с произвольными фиктивными адресами).

Модифицируйте: HTML-код страницы сайта для отслеживания событий

Шаг 1. До вызова счётчика и выполнения действий пользователем определяется массив, который будет использоваться для передачи данных о событиях:

Рекомендуется выполнять определение массива в начале HTML-кода страницы. Вместо o может использоваться любое другое имя.

Шаг 2. При вызове счётчика указывается имя массива в параметре queue:

<script type="text/javascript">
var openstat = { counter: FIX-COUNTER-ID, queue: o, next: openstat };
(function(d, t, p) {
var j = d.createElement(t); j.async = true; j.type = "text/javascript";
j.src = ("https:" == p ? "https:" : "http:") + "//openstat.net/cnt.js";
var s = d.getElementsByTagName(t)[0]; s.parentNode.insertBefore(j, s);
})(document, "script", document.location.protocol);
</script>

Вместо:

• FIX-COUNTER-ID должен присутствовать реальный ID зарегистрированного для сайта счётчика.

Выделите: Действия, которые нужно отслеживать

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

Например:

• Отследить нажатия на ссылку do something можно так:

<a href="#" onclick="o.push({ url: '/ajax/dosomething', referrer: '/ajax/referrer', title: 'do something' })">do something</a>

• Отследить факт заполнения формы enter something можно так:

<form name="enter something" onsubmit="o.push({ url: '/ajax/entersomething', referrer: '/ajax/referrer', title: 'enter something' })">

Параметры, указанные при вызове функции push(), означают:

• url - фиктивный адрес страницы, которая будет считаться загруженной.
• referrer - адрес ссылающейся страницы.
• title - заголовок страницы.

Возможно упрощённое использование функции push():

• Задание в качестве параметра функции строки. Предполагается, что строка является url. Таким образом, вызовы o.push('/event') и o.push({url: '/event'}) идентичны.
• Без параметра referrer. В этом случае в качестве referrer используется предыдущий url или адрес загруженной страницы сайта, если это первый вызов.
• Без параметра title. В этом случае в качестве title используется предыдущий заголовок или заголовок загруженной страницы.
• В адреса страниц, передаваемые в url и referrer, которые начинаются на '/', автоматически добавляется протокол и доменная часть.

Смотрите: Статистику в обычных отчётах

Информация по событиям будет доступна в обычных отчётах, таких как "Популярные страницы" и "Ссылающиеся страницы".

Передавайте: Переменные с помощью технологии AJAX

При отслеживании действий можно также предавать пользовательские переменные через параметр vars. Если параметр vars при вызове push:

• не задан, то значение vars берётся из основного кода счётчика.
• задан, то его значение объединяется с vars из основного кода. При объединении можно переопределять значения пользовательских переменных, заданных в основном коде счётчика.

Например, в коде задано значение

vars: { login: 'username', order_id: 12345 }

Событие отслеживается следующим образом:

<a href="#" onclick="o.push({ url: '/ajax/dosomething', referrer: '/ajax/referrer', title: 'do something', vars: { time: 30 } })">do something</a>

В таком случае в событии будут переданы следующие пользовательские переменные

vars: {
  login: 'username',
  order_id: 12345,
  time: 30
}

Внимание!

• Если статистика по AJAX-сайту собирается в дополнение к обычной статистике посещаемости, то мы рекомендуем задавать фиктивные адреса, характеризующие действия пользователей, таким образом, чтобы их можно было отличить от статистики обычных страниц.
• Не рекомендуется использовать символ '#' в параметре url. Адреса страниц с таким символом будут обработаны для представления части после '#' на отдельном, 5-ом, уровне агрегации в отчёте, который не выведен для отображения. Таким образом, статистику по страницам 'http://example.com/page.htm#1' и 'http://example.com/page.htm#2' в отчёте отличить нельзя - суммарная статистика посещаемости обеих страниц будет представлена в отчёте атрибутом 'http://example.com/page.htm'.
• При задании адресов страниц следует учитывать настройки по определению множества адресов страниц (URL), относящихся к счётчику, для того, чтобы статистику по переданным страницам можно было увидеть в отчётах.