Data dictionary: VA.gov Forms KPIs
Definitions of metrics used on the Standardized VA.gov Forms KPI dashboard and guidance for how to interpret them.
Highlights
Chart title | Definition | How should I use this? |
---|---|---|
Successful submissions | Unique form submission events. Calculated by counting each session where an event with a “submission-successful” occurred. | An increase means more people are completing your form! A decrease could be fewer people starting the form or that fewer users are completing the process of submitting it. |
Forms by status | Form total for each category, calculated by looking at the event labels for each distinct session and form name combination. Successful: form session (session + form name) has a “successful-submission” event label, even if a failure occurred before. Failed: form session has a “submission-failed” event label and was not later successfully submitted. Not submitted: form session has a “start-form” event label or “introduction” in previous page path AND has no subsequent failure or successful submission events. | Are the number of successfully submitted forms changing over time? How about failed forms? Drill down to view each category by month or go to the “Form completion” section to learn more. |
Unique users | Unique users identified as new vs. returning. | Learn whether new or returning users are driving your overall traffic. |
Form completion
Chart title | Definition | How should I use this? |
---|---|---|
Forms started | Unique events where user started a form. Calculated by counting each session with a “start-form” event label or the form’s “introduction” page was viewed. | Helps contextualize forms submitted and the form completion rate. |
Forms submitted | Unique form submission events. Calculated by counting each session where an event with a “submission-successful” occurred. | If the total number of forms submitted and the completion rate are both increasing, your form is performing well. |
Form completion rate | Total users who submitted each form ÷ total users who started each form. | Of the forms that were started, what percentage were successfully submitted? In an ideal world, this would be as close to 1 as possible! |
Completion rate by step | Step: Number of step and page title. Users: Unique users who viewed each step. Completed step: Percent of users from the first page who made it to each step. | Both table and funnel chart show the same information in two different ways. They should help you identify at what points in your form users are abandoning the process, or where most of them successfully continue to the next step. |
Completion funnel | Visualizes the “completed step” column in table above (i.e. percent of users from the first page who made it to each step). | See above. |
Form timing & exits
Chart title | Definition | How should I use this? |
---|---|---|
Avg. minutes to complete | Coming soon. | |
Cumulative time spent on each step | Coming soon. | |
Exit rate by step | Step: Step number and page title. Viewed this step: Total users who visited the page. Exit rate: Total users who exited ÷ total users who viewed. | See if there are certain steps where users are exiting the funnel at unusually high rates. Is that page particularly long or confusing? |
Avg. sessions to complete | Total sessions where user viewed form ÷ total users, filtered for users who completed the form. | Similar to above, this helps us estimate how much time/effort the form takes users to complete. |
Sessions to complete distribution | Distribution of sessions where user viewed form for users who later successfully completed the form. | If the form is getting easier, we’d expect to see the distribution of sessions shift to the left (more 1 session users, fewer 3+ session users). |
Completed in 1 session | Counts how many sessions it took for each user to complete the form, and then filters only users who completed the form in 1 session. | This KPI could be impacted by both how long it takes the user to complete the form or by any overall increases/decreases in form completion. |
Finding the form
Chart title | Definition | How should I use this? |
---|---|---|
Top pages viewed before accessing the form | Page: URL of the page viewed before a form step. Excludes other steps in form process and form landing pages. Unique users: Unique users who viewed each page before engaging with the form. | Where are your users coming from directly before visiting your form? Does it match your expectations? |
Devices used to access the form | Total users who visited the first step of the form, broken out by type of device used. | How are people accessing your content pages? This information can be used to identify potential device-specific bugs or prioritize future improvements. |
Top browser types used to access the form | Total users who visited the first step of the form, broken out by type of browser used. | See above. |
Landing page
Chart title | Definition | How should I use this? |
---|---|---|
Unique visitors | Unique users who visited the landing page. | Knowing how many people make it to your landing page helps put other KPIs about user behavior in context. |
Avg. visits per user | Total visits to the landing page ÷ unique users. | The closer to 1 this number is, the fewer repeat visitors your landing page has. This could mean that people are making it through the form in fewer sessions – or that fewer people are deciding to start the form at all. Compare this with “Left without visiting form” KPI and the other metrics in the form completion and form timing & exits sections to clarify what trends may be driving these changes. |
Avg. minutes on page | Total minutes on page ÷ total sessions. | More time on page could mean that the information is useful and engaging – or it could mean that it’s dense and difficult to understand. Likewise, less time on page could mean users are getting to the form quickly or that they’re leaving the site. Compare this KPI to trends in scroll depth and percent of users who leave without visiting the form to interpret this data. |
Avg. scroll depth | Scroll events capture when a visitor has made it through 25%, 50%, 75%, or 100% of the landing page. Calculated by averaging the maximum scroll depth per session on landing page. Not configured for all landing pages. | The higher the percentage, the further down the page readers are scrolling. |
Left without visiting form | Combined total of visits that were exits or bounces ÷ total sessions. | The higher this percentage is, the fewer users made it to the form or continued to look for what they needed on the VA website. |
Top sources | Top 5 sources of traffic, sorted by unique users. | Are your referral sources similar over time, or do they change month to month? |
Top campaigns | Top 5 referral campaigns, sorted by unique users. | How much traffic are campaigns driving to the landing page? |
User surveys
Chart title | Definition | How should I use this? |
---|---|---|
Avg. star rating | User ratings on their form experience, scored on a 1-5 scale. Card cannot be filtered by device and browser. | More stars = happier users! But averages can hide changes at the margins. They can also be impacted by weeks with small numbers of surveys submitted. When clicking through to the detailed view of averages by week, check the hover text to view the total number of surveys received. |
Ratings distribution | Number of survey responses per rating and percent of total responses. Card cannot be filtered by device and browser. | A 3-star average could describe many different ratings distributions. Are most of your surveys clustered towards the middle? Or are most reviews mostly positive, but a segment of users are having very negative experiences? Looking at your distribution of survey results – especially over time – can help surface patterns that an average alone may hide. |
Help and feedback
Get help from the Platform Support Team in Slack.
Submit a feature idea to the Platform.