Integrate Adobe Analytics with Demandbase

  • Updated

Context

The Demandbase Account Connector for Adobe Analytics assigns Company Profile Attributes to conversion variables and traffic variables in Adobe Analytics. Account Connector works with Context Variables in Platform 15 and thus requires s_code H23 and above. There are options for how conversion variables can be assigned depending on your business needs and how your Adobe Analytics instance is configured.

Follow the steps below to set up the integration.

Step 1: Confirm Your Adobe Analytics System

Ensure Adobe Analytics is actively used and confirm the version.

Step 2: Select Demandbase Attributes

Identify the Demandbase attributes you want to access within Adobe Analytics in addition to the standard attributes.

Standard Attributes

For identified companies, Demandbase automatically sends the following attributes to one conversion variable.

  • company_id
  • company_name
  • industry
  • sub_industry
  • employee_range
  • revenue_range
  • audience
  • audience_segment

Using a second conversion variable, you can integrate an additional 8 Demandbase attributes, including any custom Account Watch attribute.

Step 3: Add and Set the Conversion Variables

Add the custom variables (eVars) you want to map to the Demandbase attributes and apply recommended settings. Then you'll enable the eVars for both Staging and Production.

3.1. Add an unused eVar to the report suite.

3.1.1. Click Add New.

3.1.2. Select the eVar fields you want to modify.

3.1.3. Adjust the settings.

3.1.4. Click Save.

Recommended eVar Settings

The appropriate settings for an eVar are driven by business requirements and definitions as well as the type of reports an analyst wishes to run. The following settings recommendations are based on current best approaches used by marketers. Verify the appropriate settings with business users as well as analysts before deploying your solution.

Any eVars receiving Demandbase attributes should have the following settings.

Setting Recommended Value Description
Status Enabled Turns the eVar on for receiving data.
Type Text String Data type to be stored. 
Allocation Most Recent (Last) Determine which value persists for a visitor - either the first one set or the most recent value.
Expire After Visit Indicates when value can be rewritten for a particular visitor.
Reset Do Not Reset Unless overwriting/replacing a previously used eVar.
Enable Merchandising Disabled Enables eVar for Merchandising reports for eCommerce sites.

 Example Conversion Variable Setup

Example Conversion Variable.png

3.2. Enable the eVars for both Staging and Production

3.2.1. To enable eVars in the Admin Console, first check the Status box.

3.2.2. Select Enable.

Step 4: Configure Adobe Data Connector

The fastest and easiest way to add Demandbase to Adobe Analytics is through the Demandbase Adobe Data Connector (formerly known as the Genesis platform). The Data Connector provides an easy-to-follow wizard interface for capturing attributes into eVars as well as creating dashboards and starter reports.

Leveraging the newest features of the Adobe Analytics platform, the latest Adobe Data Connector enables the integration of up-to 40 Demandbase attributes using up to 5 conversion variables. This is achieved using contextData and a combination of Processing Rules and Auto Classification rules. The Data Connector wizard handles the setup of the Processing Rules and Auto Classification rules. Administrators only need to provision new conversion variables (eVars), as described earlier in this article.

Tip

We recommend completing this step along with Step 5 in Staging first, then repeating Steps 4 and 5 again in Production when you are ready.

Here is a video walk through of the steps for version 3 of the Data Connector, and written instructions are provided below. If you need to get instructions for version 2 of the Data Connector you can access them here

4.1. Go to Admin > DataConnectors.

4.2. Locate the Demandbase Connector in the Other category, then drag and drop it to begin configuration. Make sure you see the orange v3 next to the Demandbase logo.

4.3. Enter all the basic information and click Save.

NOTE: Your Tag UID and API Key will be provided to you by Demandbase team during the implementation.

Screen_Shot_2017-03-15_at_3.56.01_PM.png

4.4. Select the eVars you provisioned to capture the concatenated attributes.

NOTE: If you're switching from the Legacy version of the connector, it's best to reset your eVars, or provision new ones.

Screen_Shot_2017-03-15_at_3.53.54_PM.png

4.5. Set the names of the attributes you want to use in the Auto Classifications. The first 8 are filled automatically, and the second 8 should be filled in as needed.

4.6. Under Classification Rule Sets, always check the first box. Check the other boxes only if using more than the 8 standard attributes.

Screen_Shot_2017-03-15_at_3.56.36_PM.png

4.7. Check the box next to Demandbase Integration to create a default report.

Screen_Shot_2017-03-15_at_3.58.07_PM.png

4.8. Review your setup.

Step 5: Deploy Scripts

At the end of running Demandbase Data Connector V3, under the Support tab you'll find 2 links for downloading 3 scripts. The first set of scripts is for deploying the API call and the callback script. The second is the snippet for your AppMeasurement library.

Tip

We recommend completing this step in Staging first immediately after also completing Step 4 in staging, then repeating Steps 4 and 5 again in Production when you are ready.

Script Deployment Options

Option 1: Deploy Scripts Inline (Recommended deployment)

5.1. Deploy 2 tags to the head in the global template to optimize against racing condition with Adobe's image request.

5.2. Deploy another snippet for s_code.js to read the cache.

Example HTML Setup: Changes to your global template.

Example HTML Setup.png

Example S-Code Changes: You only need to add a small snippet in the s_code to read the cached data.

Screen_Shot_2017-03-15_at_3.30.17_PM.png

Option 2: Deploy Scripts through a Tag Manager

Deploying using a tag manager means you will introduce another layer of asynchronicity (the tag manager code is async as well) and other variables of the TMS such as firing order and priority. This means Demandbase cannot guarantee you're optimized, and you may need your own technical resources to improve the identification rate.

5.1. Deploy 2 tags to the head in your tag manager.

5.2. Deploy another snippet for s_code.js to read the cache.

For more instructions to how to deploy via different tag managers see this article.

NOTE: After the code deployment additional configuration tweaks might be required before implementation can be considered complete. A Demandbase Engineer will identify those during the Technical Implementation Call.

Step 6: Set up Basic Reports

Follow the steps in the Adobe Analytics Report Set Up Guide to set up your basic reports.

The Adobe Data Connector will automatically create Auto Classifications as shown below. Auto Classifications are an innovation and relatively new feature of Adobe Analytics. Unlike a traditional (SAINT) Classification, which requires an offline process and uploading of data, Auto Classifications are run automatically. Further, Demandbase attributes are captured in real-time.

Using Classification Rules, several Demandbase attributes (generally up-to 7) can be sent to a single eVar then broken-out into a Classification.

Important: There is a 255-character limit on eVars. If this limit is exceeded the image request will fail. When combining attributes into a single eVar, be sure to cap the maximum length of each eVar.

For further details on Classification Rules, talk to your Adobe Customer Care Representative.

Report 1.png

Report 2.png

Data Flow Summary

Data Flow.png

Was this article helpful?

0 out of 0 found this helpful