امتداد:GoogleAnalyticsMetrics

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.

الدليل المرجعي لامتدادات ميدياويكي

GoogleAnalyticsMetrics حالة الإصدار مستقر
تنفيذ	دوال المحلل اللغوي
بيان	الحصول على مقاييس من Google Analytics
المؤلف/المؤلفون	Ike Hecht (Tosfosنقاش)
القائم/القائمون بالصيانة	WikiTeq team
آخر إصدار	1.0.2 (يناير 2023)
سياسة التوافق	لكل إصدار ميديايويكي يكون إصدار دعم طويل الأجل يوجد فرع مخصص له في الامتداد.
MediaWiki	1.35, 1.39
تغييرات قاعدة البيانات	لا
Composer	mediawiki/google-analytics-metrics
ترخيص	رخصة جنو العمومية 2.0 أو ما بعدها
التنزيل	تنزيل الامتداد غت [?]: تنزيل ملف غت الرئيسي تصفح المستودع (Phabricator · GitHub) تاريخ الالتزام مساهمو المستودع (غت هب) مراجعة الكود البرمجي
المتغيرات $wgGoogleAnalyticsMetricsViewId $wgGoogleAnalyticsMetricsExpiry $wgGoogleAnalyticsMetricsAllowed
الروابط المستخدمة ParserFirstCallInit
تنزيلات ربع سنوية	6 (Ranked 134th)
ترجم الامتداد GoogleAnalyticsMetrics لو كان متوفرا على translatewiki.net
المسائل	المهام المفتوحة · الإبلاغ عن عطل تقني

يحصل امتداد GoogleAnalyticsMetrics على مقاييس متنوعة من Google Analytics ويضيفها إلى صفحة ويكي مستخدما دالة المحلل اللغوي. صمم هذا الامتداد لأغراض 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/‎ لديك.
  يجب على مطوري البرمجيات والمساهمين بالكود البرمجي تثبيت الامتداد من غت بدلا من ذلك، مستخدمين:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/GoogleAnalyticsMetrics
• حينما تثبته مستخدما غت شغّل Composer كي تثبت اعتمادات بي إتش بي، وذلك عن طريق إصدار composer install --no-dev في مجلد الامتداد. (طالع مهمة T173141 لتطلع على التعقيدات المحتملة.)
• أضف الكود التالي في الجزء الأسفل من ملف LocalSettings.php :

  wfLoadExtension( 'GoogleAnalyticsMetrics' );
  

•  تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.

الاستخدام

تستعين دالة المحلل اللغوي googleanalyticsmetrics بثلاثة متغيرات وهي كما يلي:

{{#googleanalyticsmetrics: metric=اسم المقياس|page=اسم الصفحة|startDate=تاريخ البدء|endDate=تاريخ الانتهاء}}

اسم المقياس

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.

يستعين كلا من متغيري التاريخ بالصيغة التالية: سنة-شهر-يوم (Year-Month-Day).

أمثلة

يعرض هذا المثال عدد مرات عرض الصفحة لهذا الموقع، من البداية حتى نهاية الزمن:

{{#googleanalyticsmetrics: metric=pageviews}}

عرض عدد جلسات العرض من يوم 3 فبراير/شباط 2011 حتى اليوم.

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

عرض متوسط مدة كل جلسة عرض حتى يوم 3 فبراير/شباط 2012:

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

عرض عدد مرات عرض الصفحة طوال الشهر الماضي فقط، بمساعدة امتداد ParserFunctions :

{{#googleanalyticsmetrics: metric=pageviews|startDate={{#time:Y-m-d|اليوم الأول من الشهر الماضي}}|endDate={{#time:Y-m-d|اليوم الأول من الشهر الجاري}}}}

أو، لتبسيط هذا الأمر:

{{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.

انظر أيضا

• Extension:HitCounters
• Extension:GoogleAnalyticsTopPages
• Extension:Google Analytics Integration