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

В этом документе показаны иллюстрации кода отслеживания для различных распространенных настроек отслеживания. Если ваш фрагмент отслеживания 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 Ads составляет 6 месяцев. Вы можете настроить продолжительность кампаний с помощью _setCampaignCookieTimeout() .

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

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

Наверх

Поля кампании — настраиваемые

Google Analytics автоматически собирает ваши данные Google Ads, если вы связали свою учетную запись Google Ads со своей учетной записью 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']);

Наверх