Home Energy Analysis v1

The Home Energy Analysis v1 is a visual, interactive tool that prompts customers to answer simple questions about their home attributes and energy habits, and generates a breakdown of energy use in specific categories. The Home Energy Analysis consists of multiple widgets that must be embedded separately.

On this page:

Pre-Survey

For customers who have not yet started the survey, the Home Energy Analysis displays information about the survey and provides the first question to begin the analysis. This messaging can include information on the estimated time it would take to complete the survey, as well as the benefits of completing the analysis. Customers who select to take the survey are directed to the full survey.

This experience is provided as part of the widget-survey widget. It must be placed alongside the post-survey experience (widget-disaggregation) to provide a single, authenticated location for customers to interact with the Home Energy Analysis. This pre-survey content is fully hidden for customers after they complete the survey.

To support this behavior, the widget must define an opower-instance attribute as part of the embedded tag. The full embedded tag definition is as follows:

Copy
<opower-widget-survey opower-instance="widget-survey-splash"></opower-widget-survey>

Note: If a customer starts but does not complete the survey, progress information and a link to complete the survey is displayed. This experience is provided through the embeddable widget and redirects customers to the survey, which must also be embedded on a separate page.

Landing page for the Home Energy Analysis survey, which allows customers to answer questions about their home characteristics to receive better energy use recommendations.

Back to Top

Survey

The survey is designed to be easy to understand and simple to complete. Customers should be able to answer all of the questions they are asked, even if their answer is to skip the question. It is required to embed the survey, provided with the widget-survey widget (the same widget used for the pre-survey experience), on a separate webpage devoted to hosting the survey questions. This webpage must not include a footer, as well as exclude navigation panels on the sides of the webpage to provide an optimal user experience when completing the survey.

To support this behavior, the widget must define an opower-instance attribute as part of the embedded tag. The full embedded tag definition is as follows:

Copy
<opower-widget-survey opower-instance="widget-survey-full"></opower-widget-survey>

Back to Top

Disaggregation

After the customer answers the last question and finishes the survey, the Home Energy Analysis displays their energy use breakdown based on their responses. Customers can select each individual energy use category to see what percentage of their home’s energy use it comprises, category-specific tips, and a list of what contributes to energy use for the category.

This experience is provided as part of the widget-disaggregation widget. It must be placed alongside the pre-survey experience to provide a single location for customers to interact with the Home Energy Analysis. This content is fully hidden for customers until they complete the survey. To support this behavior, the widget must define an opower-instance attribute as part of the embedded tag. The full embedded tag definition is as follows:

Copy
<opower-widget-disaggregation opower-instance="widget-disaggregation"></opower-widget-disaggregation>

Embed this widget in proximity to billing information to provide further context and insights into a customer's energy costs.

Results after completing the Home Energy Analysis, which displays energy use categories and their total energy use percentage as a pie chart. A link is included for energy saving tips related to the highest energy use category.

Back to Top

Pre-Authenticated - EasyOpen Workflow

In addition to the standard authenticated workflow for the Home Energy Analysis, you can allow customers to access the survey without logging in to their utility account. For example, customers of Email Home Energy Reports can follow a link from within their email to begin the survey, which includes a token to automatically identify the customer. If the customer navigates directly to the survey rather than following the email link in their email, they are prompted to provide their billing account number and their full name as it appears on their bill.

To support the embedding of the EasyOpen workflow, you must duplicate the same embedding strategy described above, but embed the widgets on pre-authenticated pages. This includes one pre-authenticated page for the pre-survey and post-survey disaggregation experiences, and one pre-authenticated page for the full survey questions. All other requirements listed above apply for the pre-authenticated versions of the widgets. To use the pre-authenticated experience, the widgets must define an opower-instance attribute as part of the embedded tag. The full embedded tags are listed below:

  • Pre survey:

    Copy
    <opower-widget-survey opower-instance="widget-survey-easyopen-splash"></opower-widget-survey>
  • Post-survey disaggregation:

    Copy
    <opower-widget-disaggregation opower-instance="widget-disaggregation-easyopen"></opower-widget-disaggregation>
  • Full survey questions:

    Copy
    <opower-widget-survey opower-instance="widget-survey-easyopen-full"></opower-widget-survey>

Back to Top