Embedding Metrics

Grow has recently released an Embedding API, which essentially allows for metrics built in Grow to be displayed in other applications outside of Grow.

Grow embedding is handled with an iFrame where you embed an HTML page into another HTML page, it basically creates a “window” on a web page that displays another web page.

Alternatively, you can also access the Embedding section from the Dashboards page.

  1. Navigate to the Dashboards tab.
  2. Click the ellipses icon to expand the menu drop-downavailable for every individual metric in the Dashboards page.
  3. Select Embedding.
    This makes the embedded metrics setup easier and provides you with a URL for the same.

You can follow these steps to generate the URL:

  1. Select an API token.
  2. Choose either Allow Public Access or Show User Filters.
  3. Generate the URL.
    You can now track your Embed Tokens and their details from the Embedding section in Settings.
  1. Click on and navigate to Embedding.

Benefits of Embedding Metrics

  • You can embed a metric in another application.
  • The metric will stretch size to whatever it is embedded in.
  • You can apply filters to the embedded metric, as well as in the API which pulls in the embedded metric to the application.
  • You can only embed metrics that are already built in Grow. The user setting up the embedded metric can only embed metrics they have access to see within Grow.
  • Customize: There are also several visual customization options that you can pick from within the API such as adjusting the size of the metric, showing key values if they are configured, showing the metrics title or not, and having it in light or dark mode.
  • The setup can restrict metric access. Filtering is completely disabled for metrics marked as Public access. For metrics which are marked Private, an apiToken is required and all filtering must be encrypted with a secret key.

Limitations

  • You can only embed a metric, not a dashboard.
  • When embedded, you can hover over the metric but cannot click on it.
  • You cannot expand the embedded metric.
  • You also aren’t able to build metrics through the API, they need to be built first in Grow and then embedded to show up elsewhere.
  • Currently the filtering only supports a Simple Where, which is a single statement, as well as a Nested Where, which is the same as our Where transform in the builder.

  • It is not nearly as interactive. Integrated embedded metrics are read-only, but stand alone ones can be manipulated to get the desired information.

There is a difference between standalone and integrated embedding.Integrated embedded metrics are read only, therefore no interactions.However, is safe to use, as your data is encrypted. Prophet 21 has already been embedded with Grow metric.

For more information, refer to our API documentation https://app.gogrow.com/api-docs#/embedding/.

Was this article helpful?