Сравнение синтаксиса

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

Переход на асинхронное отслеживание

Чтобы преобразовать страницы для использования асинхронного фрагмента:

  1. Удалите существующий фрагмент кода отслеживания и все внесенные вами настройки.

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

  2. Вставьте асинхронный фрагмент внизу раздела <head> ваших страниц после любых других скриптов, которые могут использовать ваша страница или шаблон.

    Одним из основных преимуществ асинхронного фрагмента кода является то, что его можно разместить в верхней части HTML-документа. Это увеличивает вероятность того, что маяк отслеживания будет отправлен до того, как пользователь покинет страницу. Мы определили, что на большинстве страниц оптимальное расположение асинхронного фрагмента — внизу раздела <head> , непосредственно перед закрывающим тегом </head> .

  3. Измените метод _setAccount , указав идентификатор вашего веб-ресурса.

    Дополнительную информацию об идентификаторах веб-ресурсов см. в разделе « Веб-ресурс » документа « Учетные записи и представления (профили)» .

  4. Добавьте свои настройки обратно, используя асинхронный синтаксис. Используйте настройки, описанные в оставшейся части этого руководства. Подробную информацию о коде асинхронного отслеживания см. в Руководстве по использованию асинхронного отслеживания.

Примечание. Чтобы обеспечить максимально оптимизированную работу асинхронного фрагмента по отношению к другим скриптам, мы рекомендуем размещать другие скрипты на своем сайте одним из следующих способов:

  • Перед фрагментом кода отслеживания в разделе <head> вашего HTML-кода.
  • После фрагмента кода отслеживания и всего содержимого страницы (например, в нижней части тела HTML).

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

Базовое отслеживание страниц

Базовое отслеживание страниц — лучший способ ознакомиться с асинхронным синтаксисом. В этих примерах для объекта отслеживания настраивается правильная учетная запись и вызывается метод отслеживания страницы.

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

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

Вернуться к вершине

Обнаружение настроек браузера

Эти примеры иллюстрируют настройку параметров браузера, например отключение обнаружения Flash, отключение определения имени/версии браузера и т. д.

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

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setClientInfo', false]);
_gaq.push(['_setAllowHash', false]);
_gaq.push(['_setDetectFlash', false]);
_gaq.push(['_setDetectTitle', false]);
_gaq.push(['_trackPageview']);

Вернуться к вершине

Продолжительность кампании

По умолчанию продолжительность кампании Google Рекламы установлена ​​на 6 месяцев. Вы можете настроить продолжительность кампаний с помощью метода _setCampaignCookieTimeout() .

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

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

Вернуться к вершине

Поля кампании — пользовательские

Google Analytics автоматически собирает ваши данные Google Рекламы, если вы связали свою учетную запись Google Рекламы со своей учетной записью Google Analytics. Чтобы отслеживать ссылки на ключевые слова из других рекламных источников, а также из кампаний по электронной почте или аналогичных источников, вы можете создать настраиваемые поля кампаний, используя методы, описанные ниже. Более подробную информацию см. в разделе « Отслеживание кампании » руководства «Источники трафика ».

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

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setCampNameKey', 'ga_campaign']);    // name
_gaq.push(['_setCampMediumKey', 'ga_medium']);    // medium
_gaq.push(['_setCampSourceKey', 'ga_source']);    // source
_gaq.push(['_setCampTermKey', 'ga_term']);        // term/keyword
_gaq.push(['_setCampContentKey', 'ga_content']);  // content
_gaq.push(['_setCampNOKey', 'ga_nooverride']);    // don't override
_gaq.push(['_trackPageview']);

Вернуться к вершине

Отслеживание кампании — отключено

Google Analytics автоматически включает отслеживание кампаний, но вы можете отключить его с помощью метода _setCampaignTrack() .

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

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setCampaignTrack', false]);    // Turn off campaign tracking
_gaq.push(['_trackPageview']);

Вернуться к вершине

Междоменное связывание

Чтобы отслеживать трафик между доменами, вы можете использовать функцию _setAllowLinker() для отслеживания кликов пользователей между двумя доменами. Подробную информацию о настройке междоменного отслеживания см. в разделе Междоменное отслеживание .

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

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setDomainName', 'none']);
_gaq.push(['_setAllowLinker', true]);
_gaq.push(['_trackPageview']);
...
<a href="http://example.com/test.html"
onclick="_gaq.push(['_link', 'http://example.com/test.html']); return false;">click me</a>

Вернуться к вершине

Данные междоменной формы

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

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

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setDomainName', 'none']);
_gaq.push(['_setAllowLinker', true]);
_gaq.push(['_trackPageview']);
...
<form name="f" method="post" onsubmit="_gaq.push(['_linkByPost', this]);">
...
</form>

Вернуться к вершине

Отслеживание электронной торговли

Отслеживание электронной торговли предполагает вызов трех ключевых методов в настройках отслеживания. Подробности см. в разделе «Отслеживание электронной торговли» .

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

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_trackPageview']);
_gaq.push(['_addTrans',
  '1234',           // order ID - required
  'Mountain View',  // affiliation or store name
  '11.99',          // total - required
  '1.29',           // tax
  '5',              // shipping
  'San Jose',       // city
  'California',     // state or province
  'USA'             // country
]);
_gaq.push(['_addItem',
  '1234',           // order ID - required
  'DD44',           // SKU/code
  'T-Shirt',        // product name
  'Green Medium',   // category or variation
  '11.99',          // unit price - required
  '1'               // quantity - required
]);
_gaq.push(['_trackTrans']);

Вернуться к вершине

Отслеживание событий

Использование отслеживания событий предполагает вызов события в соответствующем месте на ваших страницах, например в обработчике onclick . Дополнительную информацию об отслеживании событий см. в Руководстве по отслеживанию событий . Примечание. Отслеживание событий недоступно с помощью кода отслеживания urchin.js.

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

В этом разделе показаны два способа настройки отслеживания с использованием асинхронного синтаксиса. При отслеживании событий обработчик onclick использует тот же синтаксис.

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_trackPageview']);
...
<a onclick="_gaq.push(['_trackEvent', 'category', 'action', 'opt_label', opt_value]);">click me</a> 

Вернуться к вершине

Тайм-аут сеанса

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

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

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

Вернуться к вершине

Источники — поисковые системы, ключевые слова, рефереры.

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

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

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_addIgnoredOrganic', 'ignore']);
_gaq.push(['_addIgnoredRef', 'urchin.com']);
_gaq.push(['_addOrganic', 'new_search_engine', 'q']);
_gaq.push(['_trackPageview']);

Вернуться к вершине

Отслеживание ограничено подкаталогом

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

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

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setCookiePath', '/path/of/cookie/']);
_gaq.push(['_trackPageview']);

Вернуться к вершине

Использование локального сервера

Используйте эти методы, если вы отслеживаете свой веб-сайт с помощью автономного программного обеспечения Urchin, а также с помощью Google Analytics. Подробную информацию см. в разделе «Сервер Urchin» справочника по API отслеживания .

Асинхронный фрагмент

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

Вернуться к вершине

Виртуальные просмотры страниц

Используйте метод _trackPageview() вместе с созданным вами URL-адресом, чтобы отслеживать клики пользователей, которые не ведут на реальные страницы вашего сайта. В общем, мы рекомендуем вам использовать отслеживание событий для отслеживания загрузок, исходящих ссылок, PDF-файлов или аналогичных видов взаимодействия с пользователем. Это связано с тем, что виртуальные просмотры страниц увеличивают общее количество просмотров страниц.

Асинхронный фрагмент

_gaq.push(['_trackPageview', '/downloads/pdfs/corporateBrief.pdf']);

Вернуться к вершине