Page MenuHomePhabricator

Reading Lists - Begin Instrumentation
Closed, ResolvedPublic3 Estimated Story Points

Description

Background

With reference to the Instrumentation Spec and Parent Ticket, this task is for instrumenting all part of the Reading List Experiment for which the UI is present and ready.

Design requirements

Instrumentation Workflow Reading List.jpg (540×960 px, 78 KB)
clicks on article view

Requirements

  • A custom instrument is written to enable click tracking for the initial Reading list on web experiment
  • Implement the following instrumentation events:
  • Page load event - Whenever a page loads and the user is in the experiment
action: page_load
action_source: internal_referer / external_referer
  • Save/remove entry point clicks - When user clicks the bookmark button from either toolbar, sticky header or page tools.
action: click
action_subtype: save_article_to_reading_list / remove_article_from_reading_list
action_source:sticky_header / toolbar
action_context={article_count: <INT>}
  • Views of reading list from article page - User clicks to view reading list icon on the top of the page
action: click
action_subtype: view_reading_list
action_source: top_right

Event Timeline

SToyofuku-WMF set the point value for this task to 3.
LMora-WMF renamed this task from Placeholder ticket for specific instrumentation to Reading Lists - Begin Instrumentation.Sep 11 2025, 8:03 PM
LMora-WMF updated the task description. (Show Details)

Change #1187522 had a related patch set uploaded (by LorenMora; author: LorenMora):

[mediawiki/extensions/ReadingLists@master] Add source to locate bookmark click event

https://gerrit.wikimedia.org/r/1187522

Change #1187523 had a related patch set uploaded (by LorenMora; author: LorenMora):

[mediawiki/skins/Vector@master] Copy mwListPageCount from toolbar to sticky header

https://gerrit.wikimedia.org/r/1187523

Change #1187524 had a related patch set uploaded (by LorenMora; author: LorenMora):

[mediawiki/extensions/WikimediaEvents@master] Instrument ReadingListAB

https://gerrit.wikimedia.org/r/1187524

Locally I am seeing all these events and action_source is correctly identifying between toolbar, sticky_header, and page_tools

Change #1187913 had a related patch set uploaded (by Jdlrobson; author: Jdlrobson):

[mediawiki/extensions/ReadingLists@master] Centralize reading list size

https://gerrit.wikimedia.org/r/1187913

Change #1187523 abandoned by LorenMora:

[mediawiki/skins/Vector@master] Copy mwListPageCount from toolbar to sticky header

Reason:

Abondoning for different approach

https://gerrit.wikimedia.org/r/1187523

Change #1187913 merged by jenkins-bot:

[mediawiki/extensions/ReadingLists@master] Centralize reading list size

https://gerrit.wikimedia.org/r/1187913

Change #1187522 merged by jenkins-bot:

[mediawiki/extensions/ReadingLists@master] Add source to locate bookmark click event

https://gerrit.wikimedia.org/r/1187522

Change #1187524 merged by jenkins-bot:

[mediawiki/extensions/WikimediaEvents@master] Instrument ReadingListAB

https://gerrit.wikimedia.org/r/1187524

Unable to QA as the import is commented out, but code looks reasonable from what I've seen and we will do a full instrumentation QA as part of the parent ticket! Signing this one off