Decibel Insight integration

With Decibel Insight you can playback website visitor sessions, create heat maps and analyze your forms. Integrating Usabilla for Websites and Decibel Insight will help you to identify the most valuable tracked sessions. 

How does the integration work?

The Decibel Insight - Usabilla integration is a two-way integration that can push information from Decibel to Usabilla and vice versa. 

1. Send Decibel Insight Session IDs to Usabilla

A Decibel Insight Session ID will be included in your Usabilla feedback items and Campaign results. If you have the Decibel browser plugin installed and you're are logged into Decibel, the Session ID will then automatically become a clickable link to the session recording.

2. Send Usabilla data to Decibel Insight

The following interactions with Usabilla will be pushed to Decibel Insight:

• Feedback Open - when a visitor clicks the feedback button
• Feedback Success - when a visitor submits a feedback item. The Mood score will be sent to Decibel as well.
• Campaign Open - When a visitor sees a campaign. The campaign's Analytics ID will be sent to Decibel as well.
• Campaign Success - When a visitors submits a campaign response. The campaign's Analytics ID will be sent to Decibel as well.

Within Decibel, it's possible to set up Segments based on these interactions. You can, for instance, create a Segment for sessions during which visitors left negative feedback through Usabilla or a Segment for visitors that have filled in a Usabilla campaign.

Setting up the integration

The integration set up is a three-step process:

1. Implement the integration script
2. Enable the integration of the Decibel Insight platform
3. Create Segments in Decibel Insight

1. Implement the integration script

The following script should be loaded after the regular Usabilla button script, on all pages where Decibel and Usabilla for Websites are both implemented:

// Send Decibel session ID to Usabilla; if you already send custom variables to Usabilla, include the variable there or other custom variables will get overwritten

window.usabilla_live('data', {custom: {
        'Decibel Insight Session ID': decibelInsight.getSessionId() || ''
            }
});

// Send integration data to Decibel Insight

window.usabilla_live('setEventCallback', function(category, action, label, value) {

    if (typeof decibelInsight !== 'undefined' && decibelInsight !== null) {

        if(action === 'Feedback:Open') {
            decibelInsight('sendIntegrationData', 'Usabilla', {
                f: 'Open'
            });
        }

        if(action === 'Feedback:Success') {
            decibelInsight('sendIntegrationData', 'Usabilla', {
                f: 'Success',
                s: value
            });
        }

        if(action === 'Campaign:Open') {
            decibelInsight('sendIntegrationData', 'Usabilla', {
                c: 'Open',
                i: label
            });
        }

        if(action === 'Campaign:Success') {
            decibelInsight('sendIntegrationData', 'Usabilla', {
                c: 'Success',
                i: label
            });
        }
    }
});

Please note that if you are already sending Custom Variables to Usabilla, these will get overwritten. Merge all of your custom variables into one call to our Javascript API to prevent this from happening.

2. Enable the integration in the Decibel Insight platform

1. Log into Decibel Insight
2. Navigate to Settings and then integrations
3. Click the VoC tab
4. Click Usabilla
5. Check the box 'Usabilla Enabled' and click Save

3. Set up Segments in Decibel Insight

Now that the integration has been set up, we can filter out session recordings and heatmaps in Decibel based on Usabilla events. In order to do this, you can create Segments.

Setting up a Segment that only contains session in which a visitor left negative feedback through Usabilla can be set up as follows.

1. Log into Decibel Insight
2. Navigate to Segments
3. Click 'Add Segment' 
4. Insert a name, for instance: 'Usabilla - negative feedback submitted'
5. Click 'Add filters'
6. Click 'Integrations'
7. Choose the relevant dimension, in this case, 'Usabilla Mood Score'
8. Choose 'one of' as the operator and set 1, 2 and 3 as the values
9. Click 'Save changes'
10. Repeat this process for other Segments you want to create.
11. When you have created a new Segment it takes time before this has been processed and applied to existing sessions.

Negative feedback submitted

Campaign submitted