Home Energy AnalysisOracle v2

The Home Energy Analysis v2 is a visual, interactive tool that prompts customers to answer simple questions about their home attributes and energy habits, and generates a breakdown of their top energy use in specific categories. The Home Energy Analysis consists of multiple widgets that must be embedded separately. Your Delivery Team will work with you to identify the optimal placement.

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 disaggregation experience (widget-usage-categories) 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.

Image of a home energy analysis pre-survey

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 view individual energy use categories to see what percentage of their home’s energy use it comprises, find tips for their top three energy use categories, and access more ways to save.

This experience is provided as part of the widget-usage-categories 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-usage-categories opower-instance="widget-usage-categories"></opower-widget-usage-categories>

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

Image of disaggregation after a customer complete the home energy analysis survey

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 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 pre-authenticated 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-usage-categories opower-instance="widget-usage-categories-easyopen"></opower-widget-usage-categories>

  • Full survey questions:

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

Back to Top