This tutorial provides steps for creating an Adobe Analytics source connection in the UI to bring Analytics Report Suite data into Adobe Experience Platform.
This tutorial requires a working understanding of the following components of Adobe Experience Platform:
It is important to understand the following key terms used throughout this document:
In the Platform UI, select Sources from the left navigation to access the Sources workspace. The Catalog screen displays a variety of sources that you can create an account with.
You can select the appropriate category from the catalog on the left-hand side of your screen. You can also use the search bar to narrow down the displayed sources.
Under the Adobe applications category, select Adobe Analytics and then select Add data.
The Analytics source add data step appears. Select Report Suite to start creating a source connection for Analytics Report Suite data, and then select the Report Suite you would like to ingest. Report Suites that are not selectable have already been ingested, either in this sandbox or in a different sandbox. Select Next to proceed.
Multiple in-bound connections can be made to bring in multiple Report Suites, however only one Report Suite may be used with Real-time Customer Data Platform at a time.
The Data Prep support feature for the Analytics source is in beta.
The Mapping page provides an interface to map source fields to their appropriate target schema fields. From here, you can map custom variables to new schema field groups and apply calculations as supported by Data Prep. Select a target schema to start the mapping process.
Only schemas that have the Analytics template field group are displayed in the schema selection menu. Other schemas are omitted. If there are no appropriate schemas available for your Report Suite data, then you must create a new schema. For detailed steps on creating schemas, see the guide on creating and editing schemas in the UI.
The Map standard fields section displays panels for Standard mappings applied, Non matching standard mappings and Custom mappings. See the following table for specific information regarding each category:
|Map standard fields||Description|
|Standard mappings applied||The Standard mappings applied panel displays the total number of mapped attributes. Standard mappings refer to mapping sets between all attributes in the source Analytics data and corresponding attributes in Analytics field group. These are pre-mapped and cannot be edited.|
|Non matching standard mappings||The Non matching standard mappings panel refers to the number of mapped attributes that contain friendly name conflicts. These conflicts appear when you are re-using a schema that already has a populated set of field descriptors from a different Report Suite. You can proceed with your Analytics dataflow even with friendly name conflicts.|
|Custom mappings||The Custom mappings panel displays the number of mapped custom attributes, including eVars, props, and lists. Custom mappings refer to mapping sets between custom attributes in the source Analytics data and attributes in custom field groups included in the selected schema.|
To preview the Analytics ExperienceEvent template schema field group, select View in the Standard mappings applied panel.
The Adobe Analytics ExperienceEvent Template Schema Field Group page provides you with an interface to use for inspecting the structure of your schema. When finished, select Close.
Platform automatically detects your mapping sets for any friendly name conflicts. If there are no conflicts with your mapping sets, select Next to proceed.
If there are friendly name conflicts between your source Report Suite and your selected schema, you can still continue with your Analytics dataflow, acknowledging that the field descriptors will not be changed. Alternatively, you can opt to create a new schema with a blank set of descriptors.
Select Next to proceed.
To use Data Prep functions and add new mapping or calculated fields for custom attributes, select View custom mappings.
Next, select Add new mapping.
Depending on your needs, you can select either Add new mapping or Add calculated field from the options that appear.
An empty mapping set appears. Select the mapping icon to add a source field.
You can use the interface to navigate through the source schema structure and identify the new source field that you want to use. Once you have selected the source field that you want to map, select Select.
Next, select the mapping icon under Target Field to map your selected source field to its appropriate target field.
Similar to the source schema, you can use the interface to navigate through the target schema structure and select the target field you want to map to. Once you have selected the appropriate target field, select Select.
With your custom mapping set completed, select Next to proceed.
The following documentation provides further resources on understanding Data Prep, calculated fields, and mapping functions:
The Dataflow detail step appears, where you must provide a name and an optional description for the dataflow. Select Next when finished.
The Review step appears, allowing you to review your new Analytics dataflow before it is created. Details of the connection are grouped by categories, including:
Once your dataflow has been created, you can monitor the data that is being ingested through it. From the Catalog screen, select Dataflows to view a list of established flows associated with your Analytics account.
The Dataflows screen appears. On this page is a pair of dataset flows, including information about their name, source data, creation time, and status.
The connector instantiates two dataset flows. One flow represents backfill data and the other is for live data. Backfill data is not configured for Profile but is sent to the data lake for analytical and data-science use-cases.
For more information on backfill, live data, and their respective latencies, see the Analytics Data Connector overview.
Select the dataset flow you wish to view from the list.
The Dataset activity page appears. This page displays the rate of messages being consumed in the form of a graph. Select Data governance from the top header to access the labelling fields.
You can view a dataset flow’s inherited labels from the Data governance screen. For more information on how to label data coming from Analytics, visit the data usage labels guide.
To delete a dataflow, head to the Dataflows page and then select the ellipses (
...) beside the dataflow name and then select Delete.
Once the connection is created, the dataflow is automatically created to contain the incoming data and populate a dataset with your selected schema. Furthermore, data back-filling occurs and ingests up to 13 months of historical data. When the initial ingestion completes, Analytics data and be used by downstream Platform services such as Real-time Customer Profile and Segmentation Service. See the following documents for more details:
The following video is intended to support your understanding of ingesting data using the Adobe Analytics Source connector:
The Platform UI shown in the following video is out-of-date. Please refer to the documentation above for the latest UI screenshots and functionality.