Skip to main content
waffle.svg
Domo Knowledge Base

Adobe Analytics Connector

Version 21

 

Intro

 

Adobe Analytics helps you create a holistic view of your business by turning customer interactions into actionable insights. Domo's Adobe Analytics connector allows you to retrieve data through pre-built reports or customized reports or by submitting a query to the Adobe Analytics API. You can then combine metrics with data from CRM, POS, or any other system to make faster, better-informed business decisions. To learn more about the Adobe Analytics API, visit their website ( https://marketing.adobe.com/developer/en_US/get-started/introduction/c-introduction ).

You connect to the Adobe Analytics API in the Data Center.

This topic discusses the fields and menus that are specific to the Adobe Analytics connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in Adding a DataSet Using a Data Connector.

Prerequisites

To connect to the Adobe Analytics and create a DataSet, you must have the Client ID and Client Secret associated with your Adobe Analytics account.

Visit Adobe Oauth Connection documentation to learn more about obtaining your Client ID and Client Secret.

Creating a new OAuth project in Adobe Developer Console

To create a new OAuth project in Adobe Developer Console, do the following:

  1. Log into https://console.adobe.io/projects.
  2. Click Create new project button.
  3. Click on Add API to start using the Adobe services.

clipboard_e9fa4bfa5ba02957d8e4ca627dca3f9c2.png

4. The APIs available to you will be listed in the Add an API window. Select Adobe Analytics

Add an API.png

5. Now, you need to select the authentication type. Select OAuth here.

clipboard_e1a46218118a0066dcc9218c9df957152.png

6. Select the Web platform to configure the API.

    Enter the Default redirect URI as https://oauth.domo.com/api/data/v2/oauth/providers/adobe-analytics-oauth/exchange
    
Enter the Redirect URI pattern as https://oauth//.domo//.com/api/data/v2/oauth/providers/adobe-analytics-oauth/exchange

clipboard_e8e74daa5473b691a6f6f3adacb8b31a2.png

7. Click Save configured API.

Connecting to the Adobe Analytics API

This section enumerates the options in the Credentials and Details panes in the Adobe Analytics connector page. The components of the other panes in this page, Scheduling and Name & Describe Your DataSet, are universal across most connector types and are discussed in greater length in Adding a DataSet Using a Data Connector.

Credentials Pane

This pane contains fields for entering credentials to connect to the Adobe Analytics API. The following table describes what is needed for each field:

Field 

Description

Client ID Enter the client ID associated with your Adobe Analytics account.
Client Secret Enter the client secret associated with your Adobe Analytics account.

Once you have entered valid credentials, you can use the same account any time you go to create a new Adobe Analytics DataSet. You can manage connector accounts in the Accounts tab in the Data Center. For more information about this tab, see Managing User Accounts for Connectors.   

Details Pane

This pane contains two menus, Report Suite and Report Type, which allow you to select a predefined Adobe Analytics report.

Menu

Description

Company Enter your company's name as featured on Adobe Analytics, which is used as a parameter for the Company.GetEndpoint method (see https://github.com/AdobeDocs/analyti...GetEndpoint.md)

Report Suite

Select the Adobe Analytics Report Suite you want to pull data from.

Predefined Report

Select an Adobe Analytics report type. The following table lists all of the available predefined reports:

Base Metrics

Returns data about page views; average time spent on website; unique visitors by month, week, and day; new visitors; etc. 

Commerce Metrics

Returns data about number of visits, orders, checkouts, revenue, new and returning customers, etc.

Existing Customer Campaigns

Returns data about visits, orders, and revenue, broken down by existing customer campaign.

Existing Customer Products

Returns data about existing customer visits, orders, checkouts, and revenue, broken down by product.

Mobile Device Types

Returns data about mobile views, visits, and daily unique visitors, broken down by device type.

Mobile Metrics

Returns metrics about mobile device usage, such as device type, OS, views, visits, and daily unique visitors.

Natural Search Conversion

Returns data about number of visits, orders, and revenue, broken down by natural search keyword. 

Natural Search Visits 

Returns data about number of visits, page views, and daily unique visitors, broken down by natural search keyword. 

New Visitor Best Campaigns 

Returns data about visits, orders, revenue, and units, broken down by new visitor campaign. 

New Visitor Geo 

Returns data about visits, orders, revenue, and units, broken down by region.

New Visitor Geo Country 

Returns data about visits, orders, revenue, and units, broken down by country. 

New Visitor Keywords 

Returns data about visits, orders, revenue, and units, broken down by paid search keyword. 

New Visitor Products 

Returns data about new customer visits, orders, checkouts, revenue, units, etc., broken down by product.  

New Visitor Traffic Source 

Returns data about visits, orders, revenue, and units, broken down by referrer type. 

Page Effectiveness Returns data about page visits, entries and exists, bounces, and bounce rate, broken down by page.
Page Metrics Returns data about page views, visits, daily unique visitors, and exists, broken down by page.
Paid Search Conversion Returns data about visits, orders, and revenue, broken down by paid search keyword.
Paid Search Visits Returns data about page views, daily unique visitors, and visits, broken down by paid search keyword.

Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see Adding a DataSet Using a Data Connector.

FAQ

Q: I successfully created an Adobe Analytics OAuth account, but about two weeks later I got an alert: "Account Adobe Analytics OAuth Account has been Deactivated". Why is this happening and what can I do about it?

A: Adobe Analytics OAuth has a refresh token that expires after two weeks (see Adobe documentation for details.) This causes Adobe OAuth to no longer authenticate after two weeks. This is an Adobe limitation. Older datasets use WSSE authentication (Username:Company, Password), but Adobe has deprecated WSSE authentication. Please contact Adobe support to request a resolution to this issue.

Q: My Adobe Analytics datasets are failing intermittently and displaying unhelpful error messages like "Unable to complete report at this time. Please try again later." What should I do?

A: This error originates on Adobe’s end. Unfortunately, it is nothing we at Domo have direct control over, but we are working with Adobe to improve these types of errors. That said, you can take steps to alleviate the occurrence of these errors, which include reducing the number of connectors, the frequency at which they try to pull data, and the size of their requests. Attempting to schedule requests to run at different times can also help. Another possible solution is to use the “retry” setting in the connector.