Skip to main content
waffle.svg
Domo Knowledge Base

Adobe Analytics v2 OAuth Partition Connector

Version 18

 

Intro

Adobe Analytics helps you create a holistic view of your business by turning customer interactions into actionable insights. Domo's Adobe Analytics v2 connector allows you to retrieve data through prebuilt reports. 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 API v2 and create a DataSet, you must have the Client ID and Client Secret associated with your Adobe Analytics v2 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 redirect URI 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 v2

This section enumerates the options in the Credentials and Details panes in the Adobe Analytics v2 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 v2. The following table describes what is needed for each field:

Field 

Description

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

Once you have entered valid credentials, you can use the same account any time you go to create a new Adobe Analytics v2 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 the information about the predefined Adobe Analytics v2 reports.

Menu

Description

Predefined Report

Select the Adobe Analytics v2 report you want to run:

Calculated Metrics This report returns a list of calculated metrics.
Collections This report returns a list of report suites.
Dimensions This report returns a list of dimensions for a given report suite.
Metrics This report returns a list of metrics for a given report suite.
Report This report returns reporting data for the requested metric and dimension for the given date range.
Segments This report returns a list of segments.
Users This report returns a list of users for the company.
Include Type Include additional calculated metrics not owned by user. The “All” option takes precedence over “Shared.”
Report Suite ID Select a report suite id.
Metrics Select a metric from the available metrics.
Dimensions Select a dimension.

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.

FAQs

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?

Use the Adobe Analytics v2 JWT connector to avoid this issue. 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. Adobe recommends JWT authentication instead.

What's the difference between the Adobe Analytics v2 OAuth and Adobe Analytics v2 JWT connectors?

The Adobe Analytics v2 connector uses the OAuth authentication whereas the Adobe Analytics API v2 Connector with JWT authentication uses the JWT authentication. Adobe recommends that you use JWT authentication, as you will have to refresh the OAuth account every two weeks because the OAuth refresh token expires.

What version of the Adobe Analytics API does this connector use?

This connector uses the version 2 of the Adobe Analytics API (https://analytics.adobe.io/api/2).

What is the redirect URI I need to register in the project in the Adobe Developer Console?

The redirect URI to be registered in the project in the Adobe Developer Console is: https://oauth.domo.com/api/data/v2/o...oauth/exchange

Which endpoint(s) does each report call in this connector?
Report Name Endpoint URL(s)
Calculated Metrics /calculatedmetrics
Collections /collections/suites
Dimensions /dimensions
Metrics /metrics
Report /reports
Segments /segments
Users /users
What kind of credentials do I need to power up this connector?

You need the Client ID and Client Secret associated with your Adobe Analytics v2 account. 

Are there any API limits that I need to know?

In order to run a report with multiple dimensions in Adobe Analytics API 2.0, Domo gets the data in multiple small API calls. If getting data for many dimensions or over a long time period, the dataset might timeout after 24 hours. To prevent this, pull a smaller amount of data or fewer dimensions.

Which Adobe Analytics connector should I use?

Adobe recommends that you use Adobe Analytics v2 with JWT authentication. Adobe OAuth refresh tokens expire after two weeks, which requires you to refresh your account.