Embedding Insights

Using the following steps, you can embed (using iFrame) Insights into your app.

The embedded app refers to Tellius, whereas the embedding app refers to the app in which Tellius components are to be integrated.

Get the embedding URL from Tellius.
Include the embedding URL in the HTML of the required app.
Connect the app with Tellius.

Getting the embedding URL

Navigate Settings → Embed → Insight. The list of existing Insights is displayed.
For the required Insight, click on the Copy button under Embed URL.

Including the obtained URL

An embedding URL looks like the following:

https://domain/discover/insight/insightID/driverID?utm_source=ID

Once you embed the URL, the required Insight will be loaded.

Components of the embedding URL

insightID - the ID of the Insight to be embedded
driverID - the ID of the driver from an Insight

Connecting with Tellius

The embedding app needs to send a message INITIALIZE to connect with Tellius.
Tellius validates and responds with TELLIUS_INITIALIZED message as an acknowledgment.

The following is a sample code to connect with Tellius:

var telliusFrame ;
    document.querySelector("iframe").addEventListener("load", function() {
        telliusFrame = document.getElementsByTagName("iframe")[0].contentWindow;
        telliusFrame.postMessage('INITIALIZE', "*");
    })
    function receiveMessage(event) {
        if(event.data === 'TELLIUS_INITIALIZED') {
            telliusFrame.postMessage({   //if you want to include an actionType 
                actionType: "required_actionType",
             }, "*");
        }
    }
window.addEventListener("message", receiveMessage, false);

As furnished in the code above, we use window.postMessage for communication between Tellius and the embedding app (two-way communication). The messages which are sent to Tellius from the embedding app are included in telliusFrame.postMessage(). With the help of the function postMessage, required actions can be performed.

To enable this communication and to receive messages, the embedding app needs to have eventListener. For every point clicked, or area selected/highlighted in the chart, Tellius will send a message to the embedding app.

PreviousRow-level policy filters NextCreating and Viewing Insights

Last updated 23 days ago

Was this helpful?

var telliusFrame ; document.querySelector("iframe").addEventListener("load", function() { telliusFrame = document.getElementsByTagName("iframe")[0].contentWindow; telliusFrame.postMessage('INITIALIZE', "*"); }) function receiveMessage(event) { if(event.data === 'TELLIUS_INITIALIZED') { telliusFrame.postMessage({ //if you want to include an actionType actionType: "required_actionType", }, "*"); } } window.addEventListener("message", receiveMessage, false);