Merge policies overview

Adobe Experience Platform enables you to bring data fragments together from multiple sources and combine them in order to see a complete view of each of your individual customers. When bringing this data together, merge policies are the rules that Platform uses to determine how data will be prioritized and what data will be combined to create a unified view.

Using RESTful APIs or the user interface, you can create new merge policies, manage existing policies, and set a default merge policy for your organization. This document provides an overview of merge policies and the role they play within Experience Platform.

Getting started

This guide requires a working understanding of several important Experience Platform features. Before following this guide and working with merge policies, please review the documentation for the following services:

Understanding merge policies

Adobe Experience Platform enables you to bring data fragments together from multiple sources and combine them in order to see a complete, unified view of each of your individual customers. When bringing this data together, merge policies are the rules that Platform uses to determine how data will be prioritized and what data will be combined to create that unified view.

For example, if a customer interacts with your brand across several channels, your organization will have multiple profile fragments related to that single customer appearing in multiple datasets. When these fragments are ingested into Platform, they are merged together in order to create a single profile for that customer.

When the data from multiple sources conflicts (for example one fragment lists the customer as “single” while the other lists the customer as “married”) the merge policy determines which information to include in the profile for the individual.

Merge policies are private to your organization, allowing you to create different policies to merge schemas in the specific ways that you need. You can also specify a default merge policy that will be used if one is not explicitly provided. See the section on default merge policies later in this document to learn more. Please note that there is a maximum of five merge policies allowed per organization.

Merge methods merge-methods

Each profile fragment contains information for just one identity out of the total number of identities that could exist for an individual. When merging that data together to form a customer profile, there is the potential for that information to conflict and priority must be specified.

Selecting a merge method allows you to specify which dataset attributes to prioritize if a merge conflict occurs between datasets.

There are two possible merge methods available for merge policies. Each of these methods are summarized below with additional details provided in the sections that follow:

Dataset precedence dataset-precedence

When Dataset precedence is selected as the merge method for a merge policy, you are able to give priority to profile fragments based on the dataset from which they came. An example use case would be if your organization had information present in one dataset that is preferred or trusted over data in another dataset.

In order to create a merge policy using Dataset precedence, you must select the Profile and ExperienceEvent datasets that are included and then you can manually order the Profile datasets for precedence. Once the datasets have been selected and ordered, the top dataset will be given highest priority, the second dataset will be second-highest, and so on.

Timestamp ordered timestamp-ordered

As profile records are ingested into Experience Platform, a system timestamp is obtained at the time of ingestion and added to the record. When Timestamp ordered is selected as the merge method for a merge policy, profiles are merged based on the system timestamp. In other words, merging is done based on the timestamp for when the record was ingested into Platform.

Identity stitching id-stitching

Identity stitching (ID stitching) is the process of identifying data fragments and combining them together to form a complete profile record. To help illustrate the different stitching behaviors, consider a single customer who interacts with a brand using two different email addresses.

To learn more about identities and their role in generating profiles and audiences, please begin by reading the Identity Service overview.

Default merge policy default-merge-policy

An organization can create a default merge policy for their organization to use when merging profile fragments. This allows users to easily select the default policy when performing actions in Experience Platform such as viewing customer profiles or creating audiences. In most cases, unless another merge policy is specified, the default merge policy will be used.

Each organization can create multiple merge policies related to a single XDM schema class, however they can only have one default merge policy declared for each class. For example, your organization could have a default merge policy related to the XDM Individual Profile class and a different default merge policy for a custom-built Product Inventory class.

If you create a new merge policy and set it as the default, the previous default merge policy will be automatically updated by the system to no longer be the default.

Next steps

After reading this guide you now know what merge policies are and the role they play within Experience Platform. To begin working with merge policies in the Experience Platform UI, please refer to the merge policies UI guide. To work with merge policies using the API, visit the merge policies API endpoint guide.