Looker Overview
Vitally's native integration with Looker allows you to embed your Looker dashboards and graphs directly into any Vitally dashboard alongside your other widgets.
Enabling the Looker integration
Enabling the Looker integration requires access to your Embed Secret.
In Vitally navigate to your Settings (⚙️) by selecting your Account Logo on the top left and under Operations select Integrations. Then select Looker (or via Quick Jump Mac: ⌘ + j Windows: Alt + j). Once you toggle on Looker on the top right, you'll be asked for that Embed Secret:
If your Looker Dashboard shows a 'refused to connect' message, it may be because the website it's supplied on has 'X-Frame-Options' set to 'sameorigin', which means no browser will load it in an iframe within a different website.
If you're receiving a '401—You are not authenticated to view this page' error, it may be due to your access permission or because your browser is blocking third-party cookies.
Adding Looker reports to a Vitally dashboard
Navigate to a Vitally dashboard > +Add > iframe
Navigate to Looker to copy the iframe URL for the report or dashboard
Use Lookers URL Validator to confirm the configuration is correct
An iFrame-capable URL will contain the word
embedin it
Add a title and paste the dashboard URL
Using External IDs for Dynamic iFrame URLs
When adding an iframe URL, you may notice messaging in the UI that references using an external ID to dynamically change the embedded content.
Vitally supports one dynamic replacement parameter in iframe URLs:
{externalId}When {externalId} is included in the iframe URL, Vitally will automatically replace it at render time with the external ID of the Account, User, or Organization whose 360 profile you are viewing. This allows you to embed external dashboards or pages that are specific to each customer or user, such as a filtered Looker dashboard.
{externalId} is the only value Vitally can dynamically inject into an iframe URL
Vitally cannot pass additional information such as:
Vitally user ID
Name
Email
Any custom traits or fields
Vitally does not send data through the iframe. The external system must already support receiving and handling the external ID via the URL itself