Extension:GoogleAnalyticsMetrics/ru

This extension is professionally maintained by the WikiTeq team.

WikiTeq provides official support for MediaWiki LTS releases only. It may work with other MediaWiki releases.

Справка по расширениям MediaWiki

GoogleAnalyticsMetrics Статус релиза: стабильно
Реализация	Функция парсера
Описание	Gets metrics from Google Analytics
Автор(ы)	Ike Hecht (Tosfosобсуждение)
Поддерживающий(ие)	WikiTeq team
Последняя версия	1.0.2 (январь 2023)
Политика совместимости	В расширении есть соответствуюшая ветвь для каждого релиза MediaWiki, который является релизом долгосрочной поддержки (Long Term Support release).
MediaWiki	1.35, 1.39
Изменения в БД	Нет
Composer	mediawiki/google-analytics-metrics
Лицензия	GNU General Public License 2.0 или позднее
Скачать	Скачать расширение Git [?]: скачать текущую версию исходника репозиторий (Phabricator · GitHub) история изменений список разработчиков (GitHub) code review
Параметры $wgGoogleAnalyticsMetricsViewId $wgGoogleAnalyticsMetricsExpiry $wgGoogleAnalyticsMetricsAllowed
Используемые хуки ParserFirstCallInit
Ежеквартальные загрузки	6 (Ranked 132nd)
Переведите расширение GoogleAnalyticsMetrics, если оно доступно на translatewiki.net
Проблемы	Открытые задачи · Сообщить об ошибке

The GoogleAnalyticsMetrics extension gets various metrics from Google Analytics and inserts them into a wiki page using a parser function. This extension was created for WikiWorks.

The GoogleAnalyticsMetrics extension may not be appropriate for your site if you have data security and privacy concerns. The extensions inserts JavaScript code in each page served, and the code causes the client to contact Google services to process and aggregate data. Your site's users will be subjected to tracking and data mining regardless of the Do Not Track or Global Privacy Control browser settings.

Установка

• Setup Google Analytics API by following Step 1 here
• Install the Google Client Library by following Step 2 here
• Enable Google Analytics Reporting API in your Google Cloud Console
• Скачайте и распакуйте файл(ы) в папку с названием GoogleAnalyticsMetrics в вашей папке extensions/.
  Вместо этого разработчикам и соавторам кода следует установить расширение из Git, используя:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/GoogleAnalyticsMetrics
• Если и только если устанавливаете из git, запустите Composer для установки зависимостей PHP, запустив composer install --no-dev в каталоге расширений. (Смотрите задача T173141 о возможных осложнениях.)
• Добавьте следующий код в конце вашего файла LocalSettings.php :

  wfLoadExtension( 'GoogleAnalyticsMetrics' );
  

•  Готово – Перейдите на страницу Special:Version на своей вики, чтобы удостовериться в том, что расширение успешно установлено.

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

The googleanalyticsmetrics parser function takes three parameters, in the form of:

{{#googleanalyticsmetrics: metric=Name of metric|page=Название страницы|startDate=Начальная дата|endDate=Конечная дата}}

Name of metric

The name of the Google Analytics Metric that should be displayed. The full list of Google Analytics metrics is here. Omit the ga: prefix.

Название страницы

The name of the page. This parameter is only used when the metric is a per page metric.

Начальная дата

Show the metric since this date (optional). Defaults to 2005-01-01, which is the beginning of time according to Google Analytics.

Конечная дата

Show the metric until this date (optional). Defaults to today.

Both date parameters use the form: Year-Month-Day.

Примеры

This example displays the number of page views for this site, from the beginning until the end of time:

{{#googleanalyticsmetrics: metric=pageviews}}

Show the number of sessions from February 3, 2011 until today.

{{#googleanalyticsmetrics: metric=session|startDate=2011-02-03}}

Show the average session duration until February 1 2012:

{{#googleanalyticsmetrics: metric=avgSessionDuration|endDate=2012-02-01}}

Show the number of page views for last month only, with the help of the ParserFunctions extension:

{{#googleanalyticsmetrics: metric=pageviews|startDate={{#time:Y-m-d|первый день прошлого месяца}}|endDate={{#time:Y-m-d|первый день этого месяца}}}}

Or, to make that nicer:

{{formatnum:{{#googleanalyticsmetrics: metric=pageviews|startDate={{#time:Y-m-d|первый день прошлого месяца}}|endDate={{#time:Y-m-d|первый день этого месяца}}}}}}

Show the number of page views for a page, from the beginning until the end of time:

{{#googleanalyticsmetrics: metric=pageviews|page=Main_Page}}

See this page for some help with formatting this extension's output.

There is also a {{#googleanalyticstrackurl:http://urlhere|link text}} function but it only works if the ga js library has already been loaded.

Параметры конфигурации

$wgGoogleAnalyticsMetricsAllowed

An array containing the name of Google Analytics metrics that are allowed to be retrieved by the extension. Defaults to *, which allows all metrics.

$wgGoogleAnalyticsMetricsEmail

The email address of the Google Analytics account.

$wgGoogleAnalyticsMetricsPath

Path to your certificate key file.

$wgGoogleAnalyticsMetricsViewId

Google Analytics View ID.

См. также

• Расширение:HitCounters
• Extension:GoogleAnalyticsTopPages
• Extension:Google Analytics Integration