View Local Analytics for Smart Home Skills (Beta)


The Local Analytics page in the Alexa developer console provides business adoption metrics for smart home devices that connect to your Alexa smart home skill. You can view and analyze these metrics in the Local Analytics dashboard in the Alexa developer console. You can access this dashboard through a custom smart home URL that you receive from your Amazon Business Development representative.

About your local analytics metrics

The Local Analytics dashboard displays business adoption metrics for your smart home skill, such as the following:

  • Total number of unique appliances or other smart home devices registered with the skill over the selected time interval.
  • Total number of unique customers registered with the skill over the selected time interval.
  • Actions on the skill.

You can select the time interval to view the metrics. Options include Last 7 Days, Last 30 Days, Custom Range.

Access your local analytics dashboard

To access your Local Analytics dashboard

  1. Sign in to the Alexa developer console.
  2. Navigate to that Alexa smart home custom analytics URL that you received from your business representative.
  3. In the Summary page, you can see a high-level view of your devices, customers, and actions.

    Local Analytics Summary dashboard
    Local Analytics dashboard, Summary page
  4. In the left pane, to view details about customer engagement, click Customers.

    Sample graph of customer engagement trent over the last 30 days.
    Local Analytics dashboard, Customers page
  5. In the left pane, to view details about unique registered devices, click Devices.

    Sample graph of the unique registered devices over a custom date range, aggregated weekly.
    Local Analytics dashboard, Devices page
  6. In the left pane, to view details about skill actions, click Actions.

    Sample graph of Discovery, Query, and Capabilities directives over the last seven days, aggregated hourly.
    Local Analytics dashboard, Actions page
  7. To select the time interval, under Time Interval (UTC), click the Last 7 Days, Last 30 Days, or Custom Range button.
    If you select the custom range, on the calendar, click the start date, and then click the end date.
  8. In the Aggregation Period drop-down, choose the aggregation period for the time interval.
    Options include Hourly, Daily, Weekly. Available aggregation periods depend on the selected time interval.

Interpret metrics

The Summary section of the Local Analytics dashboard displays an overview of the metrics available for the skill:

  • Registered Unique Devices – Total number of unique smart home appliances registered with the skill during the selected time interval.

  • Registered Unique Customers – Total number of unique customers registered with the skill during the selected time interval.

  • CapabilityDirective – Total number of directives that Alexa sends to your skill to trigger a capability, such as turning on a light, when a customer asks Alexa to control their smart device. For the directives that this metric represents, see the documentation for each interface that your skill supports.

  • Discovery – Total number of Discovery requests that Alexa sends to your skill or to the customer's local network to discover your customer's smart devices.

    This metric is a sum of the following discover options:

    • Local route discovery – This flow enables local route adoption.
    • Smart home adoption – This feature uses local detection to discover Alexa-capable smart home appliances on a customer's local network. Local detection runs every few hours on all customer Echo devices.
    • Silent discovery – If any CapabilityDirective or Query request to the skill fails, Alexa triggers silent discovery, or rediscovery of already discovered appliances, to account for changes in properties, such as IP address.
  • Query – Total number of ReportState requests and endpoint health checks that Alexa sends to your skill to request the state of an endpoint.

    Most of the volume that you see comes from endpoint health check. Echo devices have a predetermined algorithm that checks periodically to see whether the Echo can reach the endpoint. The check determines if the local route to each smart home device is healthy.


Was this page helpful?

Last updated: Jun 20, 2024