イベント指標

This page is a translated version of the page Event Metrics and the translation is 33% complete.

イベント指標(Event Metrics、旧称は助成金の指標 Grant Metrics[1])を使って各種指標を得ると、エディタソンなどイベントやコンテンツ・キャンペーンの主催者は貢献の規模や影響度を示すことができます。ウィキメディア基金の受給者は事業の文書類の作成に、このプログラムを使うことができます(Grants:指標に列記された指標類など。)イベントの指標は以下のプロジェクトに対応します。ウィキペディア、ウィキボヤージュ、ウィクショナリー、コモンズ、ウィキデータ。

イベント指標を使い始めるには、主催者はまず最初にプログラムを作成して一連のイベントのシリーズを登録します。つまり個別のイベントはプログラムに収容されます。一例として、「小都市図書館イベント2019年版」というプログラムを仮定します。このプログラム内に「都市の歴史月間」あるいは「アースデー2019」などイベントが所属しています。利用者は個別のイベント単位で指標を算出したり、あるいは当該のプログラム総体として指標を観察したりできます。以下で、このアプリの使い方を詳しく見ていきましょう。

指標の定義

イベント指標レポートがいくつかありますので、指標とは何か具体的に把握、また属性(プロパティ)とデータ型ごとの制限も説明します。

  • [[<tvar name="1">Special:MyLanguage/Event Metrics/Definitions of metrics|指標の定義]]
 
扉のページ

始めてみよう

Landing page

When you go to Event Metrics for the first time, you are presented with a landing screen that looks like this. It prompts you to login with OAuth. The background image is pulled from Commons, so every time you refresh, you see a new one!

 
OAuth dialog box

Logging in

When you click on "Login with OAuth", you're presented with a dialog box which asks for your permission to provide Event Metrics with your username. The app doesn't pull any other data from your account.

My programs (Home page)

 
My programs page

ログインの時に OAuth(統一ログイン機能)の利用を承諾すると、「私のプログラム」というページが開きます。ここには皆さんが主催者を務めるプログラムの一覧があります。プログラムは誰でも作成できるし、誰でも既存のプログラムの主催者に後から追加できます。特定のプログラムにイベントを作ったり編集する権限は、そのプログラムの主催者に限定されます。

Note the two icons in front of every program? The gear icon is for modifying a program and the red delete icon is for deleting a program.

なお、内部にイベントが一つでもあるプログラムは除去できないこともお忘れなく。新しいプログラムを設けるには、画面右側にある〈新しいプログラムを作成〉ボタンを押します。

 
Creating a new program

The metrics you see next to the program and combined metrics for all of the events in a program. We'll touch upon how to generate them below.

Creating a new program

先ほどの画面キャプチャでお見せした〈新しいプログラムを作成〉ボタンを押すと、この画面に遷移します。ここではプログラムの題名、主催者(複数可能)を記入して新しく作成します。ここで注意したいのは、プログラム作成者は自動的に主催者に追加され、自分自身では名前を除去できない点です。もし皆さんが主催者として追加した利用者が、このアプリを登録していない場合、参加者一覧の保存ができません。

 
New program

New program on homepage

プログラムを追加すると、ホームページに戻ることができます(画面上部の「私のプログラム」リンクをクリック。)作ったばかりの新しいプログラムが、追加されましたね!ただしまだイベントを登録していないため、一つ作ってみましょう。プログラム名をクリックすると中に入れます。この場合、ウィメン・イン・レッド「Women in Red」をサンプルにします。

 
Inside a program

Program page

これがプログラムの閲覧ページです。左の一覧が主催者陣。利用者名をクリックすると、メタウィキにある利用者ページが開きます。今はまだイベントを登録してないので、プログラムは空っぽです。ページ下部の「新しいイベントを作成」ボタンを押すと、新しいプログラムを開設できます。


Creating a new event

 
Creating an event

皆さんが前の画面で「新しいイベントを作成」ボタンを押してあると、「イベント設定」ページに移ります。新しいイベント作成の準備として、画面左にある画像のように設定欄に記入していきます。

  • A unique title for the event
  • Wikis on which the event will run: Enter the wikis where you want to track metrics. Start typing the language code for any wiki, and a menu will offer to autocomplete. Contributions will be tracked on the specified wikis only. But impact metrics will not be limited to these wikis. E.g., if you specify Commons, you’ll get metrics about the files you upload to Commons. But you’ll get pageview metrics for those files from every wiki where those files get placed.
  • Per-wiki limit of 50,000 pages tracked: For each wiki in your event, Event Metrics will track a maximum of 50,000 pages (on Wikipedias and similar projects). On Commons, it will track up to 50,000 files, and on Wikidata that same number of items. If you expect your event to be bigger than that, try breaking it up. E.g, instead of trying to track all the categories or users in one event, spread them over multiple events.
  • Date and time for the event duration (along with your preferred timezone).

保存ボタンを押すと、保存された設定に基づいてシステムがイベントを作成し、皆さんはイベントのまとめページに進むことができます(Event Summary。)でも、まだ手を止めないでください。フィルタの設定が待っています。

Filtering

 
The Event Summary page when no filters have been applied yet. A red error message explains the filtering requirements.

Filtering is required

You can save an event without filters, but you won’t get metrics for the event until you add either Participants or Categories filtering—you can also combine both types. Here's a summary of the basic filtering requirements and of how the two filter types interact. The system will remind you of these rules during setup (see illustration).

  • You must provide filtering for every wiki for which you want metrics.
  • Participants filtering applies to all wikis and satisfies all minimum filtering requirements by itself.
  • Category filters are specific to individual wikis because each wiki has different categories.
  • If you use Categories without Participants, you must provide a category for every wiki for which you want metrics. If you provide categories for some wikis only, you’ll get metrics only for those wikis.
  • If you combine Categories and Participants, contributions tracked will be those that satisfy both filters (i.e., Category AND Participants).

The two filtering type have different properties and restrictions, which are explained in the next sections.

 
Adding Participants. The red icon indicates an invalid username. The system won't Save any of the names until you correct or remove the invalid one.

Filter by Participants

To filter an event by Participants, you enter and save a list of wiki usernames. Once you do, reports for that event will track contributions only from those users.

  • Covers all minimum filtering requirements: If you use a Participants list, you will get results for all wikis you specified in Event Settings and for all contribution types. If Wikidata is part of your event, you must supply Participants (Wikidata doesn't use Categories, so Category filtering is not available there).

参加者を追加するには

  • ウィキに登録してある利用者名をコピーペストもしくは入力するとき、大きな文字記入ボックスのなかで1名ごとに改行します(挿絵)。その一覧を保存。利用者名に使える文字列には空きスペース、アンダーバー(「_」と「_」)も使えます。
  • Username validation: The list will update, as pictured. The green ticks indicate valid—meaning registered—usernames. The red symbol indicates that the username does not exist.
  • You must remove or fix invalid usernames and click 'Save Participants' in order for your changes to be saved. Invalid names will prevent you from Saving any of the names. If you're having trouble saving a username, check for incorrect spelling, capitalization and extra formatting like bullets, spaces, commas etc.
  • Automatic formatting of wiki lists: You can copy paste participants directly from on-wiki lists and they should be formatted correctly. For example, you can select all the participants you see on this page and paste them in the input box on Event Metrics and they appear formatted correctly, one per line.
 
Adding Categories. You must enter a wiki name for each category.

カテゴリでしぼりこむ

カテゴリを使ってしぼりこむと、特定のカテゴリもしくはその複数の組み合わせという大枠を置いて、指標の対象ははその中にあるページやファイル単位に限定します。

  • カテゴリはウィキごとに固有:選んだカテゴリはどのウィキのものか、1件ごとに指定します。すると、指定したウィキでのみそのカテゴリが表示されます。
  • メイン名前空間に限定:フィルタを使う目標として、カテゴリを適用できるのはメインすなわち記事の名前空間に属するページに限られます。一例として、トークページを分類するカテゴリは対象になりません。ただしコモンズは 例外とします(下記ご参照ください。)
  • Applies to files on Commons: On Commons only, Category filtering works for uploaded files, including images, videos, audio files, etc.
  • Subcategories are not tracked automatically. If you want to include subcategories, you must specify them directly.
  • Hidden categories are allowed by the system. (Make sure to check with the policies and practices governing the use of hidden categories on your local wiki).

Categories without Participants

  • Categories are wiki-specific: If you use Categories filtering without Participant filtering, you must supply a category for every wiki about which you want metrics. If you don’t, you'll get metrics only for the wikis that are filtered. (As described above, Participants filtering automatically covers every wiki and contribution type.)
  • No Wikidata metrics: Categories don’t exist on Wikidata (in the normal sense), so if you don’t supply  a Participants list, you will see no metrics about Wikidata items
  • No local file uploads: Category filtering applies only to pages on all wikis except Commons; it won’t work for files uploaded directly to Wikipedias. So if you want to track uploads directly to Wikipedias, you must include a  Participants list.
 
Adding categories. The red icon indicates an invalid entry. When saving a group of categories, you must remove or fix all invalid entries before any valid entries can be saved.

To add categories

  • First enter the wiki name by typing the abbreviation for the name of a  wiki (see list of wikis with language abbreviations). A menu should appear to offer to autocomplete. Next enter the category name; again, a menu should appear to autocomplete (it's always safer to select from the menu if you can). Add one category per line; click the + Add category link to add as many lines as you need. When you are finished, Save the list.
  • Category validation: The list will update, as pictured. The red symbol indicates an invalid name.
  • You must remove or fix invalid categories and click Save in order for any of your changes to be saved. Invalid categories will prevent valid ones from being saved as well. If you're having trouble saving a category, check for incorrect spelling, capitalization and extra formatting like bullets, spaces, commas etc. Always use autocomplete when possible, to ensure accuracy.

Getting reports

Event Metrics provides four downloadable reports (links are to a list of the metrics in each report):

  • Event Summary offers an overview of event contributions, impact and participation.
  • 作成したページには、イベント期間中に保存されたページをすべて一覧にしてあり、それぞれの詳細情報として累計訪問者数と当日の訪問者数ほかが表示されます。
  • 改善したページとは作成したページに似ていますが、パッとみてわかりやすい構造で、イベント期間中に編集を行なった記事を全て表示されます。
  • All Edits is a chronological list of every action saved by event participants.

To download a report

  • You must ‘Update data’ Make sure your metrics are up to date by selecting the ‘Update data’ button. Updating is always manual; the system will not recalculate metrics unless you tell it to. Every downloded report includes a “Last updated” notation that tells you how fresh the figures are, and the current update date is displayed next to the ‘Update data’ button.
  • Use the ‘Download reports’ menu to select the desired report.
  • Select wikitext or spreadsheet (csv): Once you select a report, a popup selector will ask you to choose one of two formats: Wikitext, which you can paste directly into a wiki page in order to share metrics publicly; or Spreadsheet files (csv), which let you sort metrics and publish them in reports.

〈全ての編集〉を見る

Clicking the "View all edits" link next to the Contributions label on the Event Summary page takes you to the All Edits page. There you'll see a reverse-chronological list of every edit made by participants on your list, on the wikis your event ran on, over the duration of the event.

データは「全ての編集」(All Edits)を押して表形式 CSV ファイルとしてダウンロードするか、「レポートをダウンロード」(Download Reports)を押してウィキテーブル・ファイルでエクスポートできます。

トラブルシューティング

どうも思ったように動作しないんだけど? 対策としては例えば……

  • 別のブラウザを使う
  • 参加者の人数、ウィキの件数、イベントの開催期間のいずれかを制限する

バグが見つかりましたか、よかったです! 入念にテストをしておいたのですが、見つけたのですね。ご面倒ですがバグ報告の投稿をファブリケータ(Phabricator)お願いします。あるいはその件を議論のページに書いて教えてください。できるだけ速やかにご連絡します。

注記

  1. この文書で採用した画像の中に、旧称の "Grant Metrics" と表示されるものがあります。ワークフローと機能に変更はありません。