debian-mirror-gitlab/.gitlab/issue_templates/Snowplow event tracking.md

4.0 KiB

Structured Snowplow events to track

  • Category: The page or backend area of the application. Unless infeasible, please use the Rails page attribute by default in the frontend, and namespace + classname on the backend. If you're not sure what it is, work with your engineering manager to figure it out.
  • Action: A string that is used to define the user action. The first word should always describe the action or aspect: clicks should be click, activations should be activate, creations should be create, etc. Use underscores to describe what was acted on; for example, activating a form field would be activate_form_input. An interface action like clicking on a dropdown would be click_dropdown, while a behavior like creating a project record from the backend would be create_project
  • Label: Optional. The specific element, or object that's being acted on. This is either the label of the element (e.g. a tab labeled 'Create from template' may be create_from_template) or a unique identifier if no text is available (e.g. closing the Groups dropdown in the top navbar might be groups_dropdown_close), or it could be the name or title attribute of a record being created.
  • Property: Optional. Any additional property of the element, or object being acted on.
  • Value: Optional, numeric. Describes a numeric value or something directly related to the event. This could be the value of an input (e.g. 10 when clicking internal visibility)
Category Action Label Property Feature Issue Additional Information
cell cell cell cell cell cell
cell cell cell cell cell cell

Snowplow event tracking checklist

  • Engineering complete work and deploy changes to GitLab SaaS
  • Verify the new Snowplow events are listed in the Snowplow Event Exploration dashboard
  • Create chart(s) to track your event(s) in the relevant dashboard

/label ~devops:: ~group: ~Category: /label ~"snowplow tracking events"