Adobe Analytics extension
Once you have installed the analytics integration framework, you must connect to your data supplier. This page describes how to connect to a Adobe Analytics data supplier.
You must have an appropriate account and credentials to connect to Adobe Analytics.
Accessing Adobe Client Credentials
To get your values for the credential parameters below:
-
Log into https://developer.adobe.com/console/
-
Select the Project tab at the top of the page and create new project.
-
Select the project you just created.
-
Go to OAuth Server-to-Server in the Credentials section on the left.
-
Take the values from this section and add them as values to the corresponding properties in your
adobeDataSupplier.yaml
configuration file.
Connecting Adobe Analytics as your data supplier
Define the data supplier(s) for the charts to be displayed in the Analytics app dashboard. Marketers or editors can select the data suppliers you configure when they create dashboards and widgets in the Analytics app.
Data suppliers are defined under: /<module name>/dataSuppliers/<dataSupplierRegistryFile.yaml>
.
class: info.magnolia.analytics.adobe.datasource.AdobeDataSupplier
credentials:
parameters:
serviceUrl: https://analytics.adobe.io/api/exchan213/reports
imsHost: https://ims-na1.adobelogin.com
imsExchange: https://ims-na1.adobelogin.com/ims/token/v3
companyId: <your companyId>
clientId: <your clientId>
clientSecret: <your clientSecret>
scope: <your scope>
orgId: <your orgId>
technicalAccountId: <your technicalAccountId>
parameters:
rsid: emagmgnl
gFilterType: dateRange
startDate: '2020-01-01'
endDate: '2020-01-15'
metricId: metrics/revenue
dimension: variables/daterangeday
Property | Description | ||
---|---|---|---|
|
required info.magnolia.analytics.adobe.datasource.AdobeDataSupplier |
||
|
required |
||
|
required |
||
|
required The URL for your Adobe Analytics service, which includes your For example: |
||
|
required Your client ID. To find your client ID, see Accessing Adobe Client Credentials above. |
||
|
required Client secret for your Adobe Analytics account or the path to the Magnolia Passwords app. To find your client secret, see Accessing Adobe Client Credentials above. |
||
|
required Scopes control the access and privileges an Adobe user grants authorization to a third-party application for. For example: See the Adobe OAuth scopes documentation. |
||
|
required Your Company ID issued by Adobe when you register. You can also use the Adobe swagger API to retrieve it (login required): https://adobedocs.github.io/analytics-2.0-apis/ |
||
|
required Your Organization ID. To find your Organization ID, see Accessing Adobe Client Credentials above. |
||
|
required Your Technical Account ID. To find your Technical Account ID, see Accessing Adobe Client Credentials above. |
||
|
required Adobe IMS (Identity Management System) host URL typically refers to the base domain used for authentication and identity-related services within Adobe’s ecosystem. Currently it’s: https://ims-na1.adobelogin.com This is the host URL where OAuth token requests are directed. |
||
|
required Adobe IMS (Identity Management System) server URL used for authentication and authorization when integrating with Adobe services. Currently it’s: https://ims-na1.adobelogin.com/ims/token/v3 This is the endpoint where OAuth requests are directed.
|
||
|
required The parameters used in the REST call to configure the JSON results retrieved. These parameters vary depending on the data supplier used. Each parameter is a key-value pair. All the parameters shown in the example are required:
|
Further reading
-
Adobe Experience Cloud https://experience.adobe.com/#/@magnoliaexchange/home This is the Adobe Analytics UI. It’s a little different from Google Analytics. You drag-and-drop metrics and filters (Adobe term for dimensions, but it’s really the same thing) to create reports/charts.
-
Adobe metrics reference https://experienceleague.adobe.com/docs/analytics/components/metrics/overview.html?lang=en
-
Adobe dimensions reference https://experienceleague.adobe.com/docs/analytics/components/dimensions/compatibility.html?lang=en
-
Adobe Swagger for querying the API https://adobedocs.github.io/analytics-2.0-apis/ Use rsid value emagmgnl
-
Adobe Analytics for GA users https://experienceleague.adobe.com/docs/analytics/technotes/ga-to-aa/home.html?lang=en Documentation that helps you to learn core concepts and workflows in Adobe Analytics, focusing on key similarities and differences between Adobe and other popular tools (GA). This guide is designed for analysts who are familiar with basic digital analytics concepts, but new to Adobe Analytics.