Analytics (update): <Update to Explorer Analytics>

[niknak33]

Overview

Tool: <Explorer> Feature: <Filters, Panels, >

Description: Engagement is currently classed by any user who opens a dataset and selects color by cell type. Change the current exploring, interaction, engagement thresholds for Explorer. Most specifically Explorer engagements will now be measured at a higher level than previous. We believe this change will allow us to identify specific actions the users undertake, align with our new understanding of what engagement means for users vs old explorer analytics

Color by category events

EXPLORER_COLORBY_CATEGORY_EXPAND ✅

• visitor clicked to color by a category and either (1) a category/categories are already expanded OR (2) visitor then expands a category

EXPLORER_COLORBY_CATEGORY_HIGHLIGHT_HISTOGRAM ✅

• visitor clicked to color by a category and either (1) a histogram/histograms are already highlighted OR (2) visitor then highlights one of the histograms

rename EXPLORER_CENTROID_LABEL_TOGGLE_BUTTON_CLICKED -> EXPLORER_SHOW_LABELS ✅

• visitor clicked to color by a category and THEN turned on labels

EXPLORER_COLORBY_CATEGORY_CHANGE_EMBEDDING ✅

• visitor switched to a different embedding type and a category was colored by

Color by histogram events

EXPLORER_COLORBY_HISTOGRAM_EXPAND_CATEGORY ✅

• visitor clicked to color by a histogram and either (1) a category/categories are already expanded OR (2) visitor then expands a category

EXPLORER_COLORBY_HISTOGRAM_HIGHLIGHT_HISTOGRAM ✅

• visitor clicked to color by a histogram and either (1) a histogram/histograms are already highlighted OR (2) visitor then highlights one of the histograms

EXPLORER_COLORBY_HISTOGRAM_CHANGE_EMBEDDING ✅

• visitor switched to a different embedding type and a histogram was colored by

Select using lasso

EXPLORER_LASSO ✅

• visitor uses lasso to select a portion of data

EXPLORER_LASSO_CHANGE_EMBEDDING ✅

• visitor switched to a different embedding type and a portion of data was selected using lasso

BONUS changes:

1. EXPLORER_COLORBY_CATEGORIES_BUTTON_CLICKED and EXPLORER_COLORBY_HISTOGRAM_CONTINUOUS_BUTTON_CLICKED -> fire when color by is turned on AND off -> don't send events when OFF ✅
2. EXPLORER_SELECT_HISTOGRAM -> fires when histogram is selected and deselected -> don't send events when DESELECTED ✅

================= PART 2 ✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️✌️

Add gene

rename EXPLORER_SUGGEST_MENU_ITEM_CLICKED event to EXPLORER_ADD_GENE ✅

• adjust so that visitor adds a gene either by (1) selecting from the drop down menu or (2) pressing enter in the quick gene search bar

rename EXPLORER_COLORBY_GENE_BUTTON_CLICKED to EXPLORER_COLORBY_GENE ✅

• visitor colors by an individual gene whether the gene is part of a gene set or not

rename EXPLORER_MAXIMIZE_GENE_BUTTON_CLICKED to EXPLORER_GENE_VIEW_DISTRIBUTION ✅

• visitor expands an individual gene to see the distribution whether the gene is part of a gene set or not

rename EXPLORER_ADD_GENE_AND_SELECT_HISTOGRAM to EXPLORER_GENE_HISTOGRAM_HIGHLIGHT ✅

• visitor highlights a portion of the histogram for an individual gene whether the gene is part of a gene set or not
• adjust EXPLORER_SELECT_HISTOGRAM event to only fire if a histogram in the left side panel is highlighted but not any histograms that have to do with genes

rename EXPLORER_DISPLAY_SCATTERPLOT to EXPLORER_GENE_DISPLAY_PLOT ✅

• visitor clicks X and Y for an individual gene to display the plot whether the gene is part of a gene set or not

rename EXPLORER_GENE_INFO_BUTTON_CLICKED to EXPLORER_VIEW_GENE_INFO ✅

• visitor clicks the info button for a gene

Add gene set

rename EXPLORER_SUBMIT_GENESET_BUTTON_CLICKED to EXPLORER_ADD_GENE_SET ✅

• visitor successfully creates a gene set

rename EXPLORER_COLOR_BY_ENTIRE_GENESET_BUTTON_CLICKED to EXPLORER_COLORBY_GENE_SET ✅

• visitor colors by an entire gene set

rename EXPLORER_GENESET_EXPAND_BUTTON_CLICKED to EXPLORER_GENE_SET_VIEW_DISTRIBUTION ✅

• visitor expands the gene set heading to see the distribution of the entire gene set

EXPLORER_GENE_SET_HISTOGRAM_HIGHLIGHT ✅

• visitor highlights a portion of the histogram for the entire gene set
• adjust EXPLORER_ADD_GENE_AND_SELECT_HISTOGRAM event to not fire if the histogram for an entire gene set is highlighted
• adjust EXPLORER_SELECT_HISTOGRAM event to only fire if a histogram in the left side panel is highlighted but not any histograms that have to do with gene sets

Other

EXPLORER_CLIP ✅

• visitor clips all continuous values to percentile range

Events to remove

EXPLORER_ADD_GENE_AND_COLORBY ✅ EXPLORER_ADD_GENE_AND_DISPLAY_SCATTERPLOT ✅

Checklist

• [ ] Once event updates are deployed to Staging ping @ainfeld to check analytics
• [ ] Verify events are showing up in the Staging space in Plausible correctly
• [ ] Once event updates are deployed to Prod ping @ainfeld
• [ ] Confirm Plausible events are still showing up in the Prod space in Plausible correctly

People to cc

PM: @niknak33 DS: @ainfeld

Privacy policy: https://cellxgene.cziscience.com/privacy

[tihuan]

Hey @ainfeld thanks for all the event descriptions! One clarifying question - is clipping a histogram the same action as highlighting a histogram? If not, I might need help knowing the difference 🙏 Thank you!

[ainfeld]

Hey @tihuan thanks for checking!! The EXPLORER_CLIP event has to do with the button highlighted in the photo below.

[tihuan]

OH!!! I never knew that functionality existed LOL Makes sense now thank you so much 😆!