Our Adobe Analytics integration allows you to pull through segments created in Adobe Analytics and use them in Decibel in the same way you would use segments created in the app. You can segment Sessions and Session Replays, Heatmaps, Forms and much more.
Begin by logging in to your Adobe Analytics account as well as your Decibel account. You will need to activate the integration in Adobe Analytics by going to Admin and then Data Connectors, such as in the image below.
You will now need to search for Decibel in the Integrations list and click the blue Activate button.
You will now be presented with the following which will enable you to activate the integration and the relevant eVar for the integration. You will need to tick I accept these terms and conditions, select the relevant Report Suite that you want to apply the integration to, along with adding a name for the Data Connector.
On the following step, select the relevant eVar that you want to use for the integration from the SiteCatalyst eVar dropdown, while you can also add a name to the eVar which is optional. Click Save and Continue to Next Step before clicking Activate Now on the Review Summary.
The final step is to configure the relevant permissions. Click Admin and then Analytics Users & Assets.
Choose the user you would like to associate with Decibel, you need to ensure that they are either an Administrator or at least have Web Service Access. You may wish to create a new user account for Decibel with only Web Services permissions. Please speak to your Adobe Experience Cloud administrator if you would like a dedicated account setup for Decibel. Once you have identified the appropriate user from the list, click on their name and you will see the following screen:
In the users details screen, scroll down to the Web Service Credentials. You will need to add the Web Service Credentials (User Name and Shared Secret) to Decibel .
In Decibel, navigate to Settings > Integrations > Analytics > Adobe Analytics. Click the checkbox to tick “Adobe Analytics Integration Enabled” before entering the User Name and Secret in the boxes below. Then click Check Details to validate that the Username and Secret is correct.
You will now be presented with further options such as in the image below. For API Version, you are advised to select 1.4. Having verified the Username and Secret credentials, Decibel will now load the list of report suites belonging to these, and you can select the one that you want to use from the Report Suite dropdown, before selecting the Custom variable that you want to use to pass the data through, which is the eVar that you will have previously created.
You will now need to select your Request Type from one of the following:
- Legacy - Sends an API request with each Page View
- Default (Selected by default) - Sends an API request with each Session
- Manual - This allows the implementation of custom API calls e.g. using the Adobe Integrate Module via DTM.
Tracking Object or a Function (only available if selecting the Legacy or Default Request Type) defines the global variable or function that returns the tracking object from Adobe Analytics. If this is left empty, the default ‘s’ object will be used, which is the default configuration for Adobe Analytics, and unless you have changed this when implementing Adobe Analytics, this will be the object that is used on your website. Use with caution.
Tracking Function Parameters (only available if selecting the Legacy or Default Request Type) are the parameters passed to the Tracking Suite function, however if your implementation uses an object, then this should be left empty. An example of a parameter would be ‘someRSID’.
The Use Cookie for Tracking option enables you to turn on the ability to utilize a first-party cookie to reduce network requests made to Adobe when a domain change occurs.
The Use Shared Segments option should be ticked if you want to pull through Segments that have been shared with the relevant User or Report Suite.
The Hide Segments by Default option allows newly imported Segments to be hidden by default, which can then be selectively enabled to integrate data between Adobe Analytics and Decibel This is recommended for Adobe Analytics configurations with large numbers of segments. You can find out more about showing and hiding segments here.
If you have multiple domains under the property that you are configuring the implementation for, you can select which of these domains to enable or disable for the integration.
The integration page will also show you the current status of the integration and the segment data being collected. Decibel runs nightly checks for Adobe Analytics integration data, so upon enabling the integration, you will need to wait up to 24 hours for your segments and relevant data to come through. You can use the Force Segment Data Fetch button to force Decibel to fetch the segment data, however the time it takes for this to complete will depend on the speed at which Adobe processes this fetch.
Once happy with your integration settings, click Save.
Once the implementation has been setup, you can begin to use your Segments in Decibel. See below for further information regarding using Adobe Analytics segments.
Viewing Decibel Session Replays from Adobe Analytics
To view Decibel Session Replays from within Adobe Analytics, simply create a report that includes the same Custom Variable (eVar) that you used to set up the integration between Adobe Analytics and Decibel. You will need to have the Decibel Heatmap Helper Extension installed, and once it is, you will be able to see that all of the Session IDs become links which, when clicked, will take you to the relevant Session Replay for that session.