How to Install & Setup the Adobe Ads Integration

Updated 

Adobe Analytics setup is a straight forward process and it can be done by anyone who has admin access to the Adobe Analytics account

Please follow the below steps and prepare all the metrics,dimensions and identify the unique identifiers to have a seamless experience during the configuration.

Before you Begin

  • Ensure user adding the Adobe Analytics in Sprinklr Marketplace have Admin permissions in Google Analytics.

  • Understand the Metrics which you want to track in Sprinklr.

  • Identify the Unique Identifier in your URLs which will help you to map the data to the best possible granular level.

Integration Steps

You are required to raise a support ticket with Sprinklr Support requesting the Public Certificate which is required for the configuration of the Adobe Analytics connector. The support team will provide you with the certificate which will be used in Step 2.2.

Tip

  • The Support Team is required to verify the accessibility of the Integration user.

  • Since Integration User is the sole Administrator, the customer is required to verify the accessibility for the Report Suites, Metrics, and Dimensions, and inform the same to the support team to get the certificate which will be used in Step 2.2.

  1. The customer is required to navigate to the following URL: https://adminconsole.adobe.com. Note that you can only access the site as an Administrator.

  2. Find Adobe Analytics under the Product tab.

    Note

    The name - Adobe Analytics - will vary depending on how the customer has named Adobe Analytics in their environment.

  3. Next, navigate to Product Profiles inside the Adobe Analytics product.AdminConsole_Products_AdobeAnalytics_ProductProfiles.png

  4. Edit and verify if you have access to the desired Report SuitesMetrics, and Dimensions.AdobeAnalytics_ReportSuites.png

    1. Additionally, click Edit alongside the desired entity and add, update, or remove the permissions. AdobeAnalytics_Permissions.png

  5. After the verification, confirm that the Integration User has access to Report SuitesMetrics, and Dimensions. And now request for a certificate from the Support Team.

Once you've got the certificate from the Sprinklr support team, you are now required to create an API Integration within the Adobe IO Console. For more information, see Creating an API Integration.

  1. Navigate to the following URL: https://console.adobe.io/.

  2. Within the Project tab, click the Create new project button.AdobeConsole_Projects_CreateNewProject.png

  3. Click the Add to Project button and select API from the drop-down menu. AdobeConsole_Projects_CreateNewProject_AddToProject.png

  4. On the Add an API pop-up window, select Adobe Analytics and click Next in the bottom right corner of the Add an API pop-up window.AdobeConsole_Projects_CreateNewProject_AdobeAnalytics.png

  5. On the Configure API pop-up window, select Service Account (JWT). Next, use the Public Certificate shared by the Sprinklr support team and select the Product Profiles to assign the integration to a specific Cloud Manager role.

    Select Service Account (JWT) in the Configure API pop-up window.

    AnalyticsGuide_ConfigureAPI.png

    Upload the Public Certificate shared by the Sprinklr support team in the Configure API pop-up window.

    AnalyticsGuide_ConfigureAPI_PublicKey.png

    Select the Product Profiles in the Configure API pop-up window.

    AnalyticsGuide_ConfigureAPI_ProductProfiles.png

  6. Click Save configured API in the bottom right corner of the Configure API pop-up window. Once you save the configured API, an Integration is created message will appear on the window.

  • Your client is now created. Notice your client has a Client ID (sometimes referred to as an API Key), an Organization ID, Technical Account ID, and Client Secret values.

  • You can get all the relevant API keys Under APIS. Note that the following information is available, you can copy/save the info to install Adobe APIs in the Sprinklr Marketplace as mentioned in Step 4.

    • API Key (client_id)

    • Client Secret (client_secret)

    • TECHNICAL ACCOUNT ID (sub)

    • ORGANIZATION ID (iss)
      AdobeAnalytics_ServiceAccount.png

  1. Open a new tab and scroll down to Platform Modules.

  2. Click All Marketplace within Integrations.

  3. In the Marketplace window, go to the Adobe Analytics and click Install.​

  4. In the Install Adobe Analytics pop-up window, enter a Name and Description.

  5. Click Save in the bottom-right corner.​

  6. Go to Adobe Analytics Users, click +Add Adobe Analytics User to authenticate Adobe Analytics into Sprinklr.​

  7. In the Add Client Details pop-up window, enter the obtained details from Step 3 and click Add in the bottom right corner.​

  8. Click Save in the top right corner to configure Adobe Analytics in Sprinklr.

  1. On the Market Place window, click Installed from the top dashboard bar.

  2. Go to the Adobe Analytics app you want to configure and click Edit.

  3. On the Configuration window, you can view and configure the application further. For more information, see Configure Adobe Analytics — Descriptions.

Note

  • If you do not have the appropriate permissions to add an Adobe Analytics account and proceed to give Sprinklr permission for fetching the data, you will be prompted with an error message to get the desired permissions and then add the account.

  • If you have selected incompatible metrics and dimensions in your Adobe Analytics configuration, you will receive an error message that the dimensions and metrics which you have added are not compatible with each other, on saving the configuration.

By default, the validation will be enabled. To learn more about getting this capability disabled in your environment, please work with your Success Manager.

Internal Note:

Use these DPs:

  • OMNITURE_DATAWAREHOUSE_REQUEST_NEW_VERSION_ENABLED("omniture.datawarehouse.request.new.verion.enabled", BOOLEAN, PARTNER),

  • OMNITURE_VALIDATION_DISABLED("omniture.validation.disabled", BOOLEAN, PARTNER)

Enablement of this capability requires additional setup.

4. Click Save in the top-right corner.

Configure Adobe Analytics — Descriptions

Term
Description
Adobe Analytics Details

View the Adobe Analytics details such as the Name, Client, etc.

Adobe Analytics Users

View the users that are added to configure the Adobe Analytics. You can click the +Add Adobe Analytics User box to add multiple users.

Report Suite

A report suite defines the complete, independent reporting on a chosen website, set of websites, or a subset of web pages.

Select a report suite from the Select a report suite drop-down menu. You can also click the Addition icon alongside to add multiple report suites.

For each report suite, you can further configure the details given below.

Dimensions

Configure the following:

  • Parameter

  • Name

  • Data Type

  • Description

  • Hidden Parameters

  • Profile Parameters

  • Post Parameters

  • Account Parameters

  • Ad Parameters

Note

  • Sprinklr will fetch data in any scenario and will try to map it to the ad entity level at which we are able to find the unique ad identifier that you have defined in the configuration. If you haven't defined any unique identifier, data will reflect in Sprinklr but won’t be associated with any Ad.

  • For Adobe Analytics data to populate correctly in Ads Reporting, ensure that you select 'URL Parameter' instead of 'Containing' as the Condition Type while configuring Ad Parameters.

Report Configuration

Ensure exact matching of segmented Parameters selected in the Dimensions section in your configuration to align with widgets in your Reporting Dashboards.

Measurements

Configure the following:

  • Parameter

  • Name

  • Data Type

  • Description

  • Hidden Parameters

Single Dimension Measurements

Configure the following:

  • Measurement

  • Selected Dimension

  • Name

  • Data Type

  • Description

Measurement Interval Configuration

Configure the following:

  • Measurement Parameter

  • Interval Type

The default interval is hourly for all measurements.

Data Configuration

Configure the following:

  • Warehouse

    • Client ID

    • Client Secret

    • Mandatory Parameters

  • Streaming

    • Streaming URL

    • Mandatory Parameters

Site Catalyst Report Suite

Visibility

Define the Client/Groups and Users/Groups you want to share this application across.

Site Catalyst Visibility