[Integration]{class="badge positive"}

Ingest data using the Adobe Analytics source connector

The Adobe Analytics Source connector allows you to easily stream, map, and filter data from Adobe Analytics into Adobe Experience Platform’s Real-Time Customer Profile and Experience data lake. Learn how to use data prep features to create semantic and calculated fields to improve user experience in Segment Builder and Platform applications. Cross-regional report suites are supported for this connector. For more detailed product documentation, see Create an Adobe Analytics source connector in the UI.

In this video, I’ll explain how users can ingest their data from Adobe Analytics into Adobe Experience Platform and enable the data for platforms real time customer profile. These are the areas I’ll cover in this video analytics source connector. Workflow options for using a standard or custom schema. Use cases for custom schema. Data prep functions in the custom schema. Workflow. Filter rules to selectively include or exclude data from ingestion to the profile store. Configure analytics data objects for the real time customer profile, and monitor the analytics data flow. The analytics source connector isn’t the only way to get your analytics data into platform, but it’s the fastest method requiring the least level of effort. If you have use cases that require real time segmentation based on analytics attributes, review the tutorials and documentation about streaming, ingestion, and web SDK to set up the Adobe Analytics Source Connector, just log in to your experience platform and navigate to sources. To view the sources catalog. Under Adobe Applications, look for Adobe Analytics. Select the Adobe Analytics Source Connector to add data. In the Analytics Source Add Data step, you can choose the source data from any of your organization’s reports suites, each of which is considered a unique data set and platform. Notice my organization includes reports suites from multiple regions. This is possible as long as they’re mapped to the same organization as the Experience Platform Sandbox instance, in which the connection is being created. Grayed out report suites indicated data flow has already been created. Select the report suite you want to ingest data from in the list, and then at the top select next. There are two target schema choices Default and custom. There’s also an option to enable data to profile service. Before we go further in the workflow, I’ll spend some time reviewing the differences between the default and custom schema. First, what is a schema? It’s a set of rules that validate the structure and format of data, and it’s used by platform to ensure the consistency and quality of data coming in. Selecting the analytics default schema in the Source connector workflow will automatically map your reports with data to the default schema. Without any additional effort on your end. You don’t need to create a new schema for this option. Everything comes over as is. Selecting custom schema in the sources. Workflow does require you set up a new schema, because you’ll be mapping standard analytics attributes to new attributes. Let me show you what I mean. There are two feel groups that are a part of this schema. The first is the Adobe Analytics Experience Event template, which contains the standard analytics attributes. The second field group is reservation details. This is a user defined field group added to this schema. Here we see fields that have descriptive names like transaction cancellation and confirmation number. Later, I’ll map analytics variables to some of these new attributes in the Source Connector workflow. Before we go back to the workflow, here are the main use cases for using a custom analytics schema. First, you may want to see better semantic or descriptive attribute names in things like segmentation, service, and customer journey analytics. But let’s say you don’t want to change these in the Analytics report suite. Settings. You can do that using data prep features. Second, if you want a more standardized way of referencing the same data that might be captured differently across report suites, using custom attributes is the way to go, as you see illustrated in this table. Third, you may have data and analytics that is stored in pipe delimited format. Or maybe you want to join two values together in a single attribute. The data prep features accomplish this. And last, let’s say you want more flexibility for defining identities for your analytics data beyond the experience cloud ID you can do that by setting up a new attribute in your custom field group, and marking it as an identity field. Back in the UI, I’ll choose Enable Data to Profile Service. Later in the flow, I’ll show you how to apply filtering rules and conditions to selectively include or exclude data from ingestion to the profile service. Next, I’ll choose custom schema from the schema list. I’ll select Travel reservations. The Map Standard field section gives you details about the default mapping that occurs from your report suite to the analytics experience event field group in the schema. If there are descriptor conflicts when mapping your report suite to a preexisting schema, they’ll appear here. Now I’ll create some mapper functions, also known as data prep. First I’ll set up a pass through mapping. I’ll select the Add New mapping button under custom in the source field, which is coming from my report suite descriptors, I’m going to select Evar five. My report suite doesn’t have a label or descriptor for this variable, but it contains confirmation number values. I want to map this to the semantic field created in the Vehicle Reservations Custom field group. That’s part of the schema. Now in the target field I’ll select the confirmation number field. Next I’ll set up a calculated field. I’ll select the Add Calculated field button. This opens an editor that contains the functions, fields and operators on the left, as well as a text editor and a preview section in the middle. I’ll type in trim in the search box, and then I’ll click on the plus sign to add it to the editor. I’ll do the same for lower. Next I’ll select field at the top and type in Evar two, and I’ll click the plus sign again. So let’s say Evar two contains the transaction ID. What I want to do is trim any spaces and ensure the value is lowercase. Last, I’ll make sure to rearrange the formula so that the syntax is correct. Now there’s a preview button to see a sample or notice the green checkmark. To indicate proper syntax. I’ll click on the save button in the upper right corner. This adds the calculated field to the left. Now I’ll configure the target field on the right. I’ll select transaction ID in the transaction object and then I’ll click on select at the bottom. Now that all the mappings are addressed I can click on next in the upper right corner. This is the filtering step in the flow. This step only applies if enable for profile was selected earlier. Here’s a quick review of the Analytics to platform architecture using the Data Source connector. All analytics data automatically goes to the data lake, the repository that’s used for things like query service, customer journey, analytics, and other applications that use platform data. The profile store, on the other hand, is a separate repository used to create customer profiles and used by things like segmentation service customers who use Experience platform are discerning about the volume and nature of data they want to send to the profile store. The ability to filter analytics data is permitted only prior to this data entering profile. This means you need to set it up during the initial ingestion workflow. If you enable analytics data for profile at that time, there are two types of filter rules available. Row level filtering allows you to apply conditions that dictate which data to include for profile ingestion, whereas column level filtering allows you to specify which data to exclude. I’ll show you row level filtering first. Under row filter, I’ll enter country to filter for that column. Let’s say my analytics report suite contains reservations from multiple countries, but I only want to send data to the profile store related to reservation made in the United States. I’ll drag and drop the country attribute to the filtering canvas. There are many operators available, such as starts with exists, etc. but I’m going to keep this set to equals. I’ll enter United States in the text box and then I’ll press enter. Now I’ll click on the column filter. Let’s say I want to exclude some mobile application events. I’ll expand the hierarchy for application. Then I’ll select application closes and all the boolean type attributes on the data flow detail page. I’ll provide a name. Then I’m going to click on next in the upper right corner. All right. This takes us to the review step. We want to make sure everything looks good before clicking on the finish button in the upper right corner. Last, I’ll show you some other validations and configurations you can do once your analytics data has started to ingest, I’ll demonstrate using a different data flow. I’ll click on Data Flows at the top. Here in the sources section, I’ll filter Adobe Analytics by clicking the filter icon. Then I’ll select the last data flow in the list. This opens the Data set activity page. Under the Data Set Activity, there’s a quick summary of ingested batches and filled batches during a specific time window. As I scroll, I see ingested batch IDs. Each batch represents data ingested. There’s also some metadata about the records successfully ingested or failed. I’ll select preview data set in the upper right corner to show you what the last process batch looks like. If the data set is enabled for real time customer profile, the toggle for this setting would be green. In the properties panel to the right. Notice the link to the schema below the profile toggle if this data should be sent to the profile store. Confirm the setting for the schema as well. I’ll open the schema in a new window and check it out. In this example, the data set isn’t configured for profile what the schema is. This means data won’t be sent to the profile store, because the data set isn’t configured for profile. This concludes the demonstration for using the source connector to ingest data from analytics into experience platform. You should now understand all the configuration options available, as well as how to enable this data for the real time customer profile. Good luck!