Customer merging is an important feature that allows you to identify a single customer across multiple devices and browsers. When a customer visits your website using their phone and later through a PC for example, Bloomreach Engagement sees this as two separate customers with 2 different cookies. However, once they get identified (after making a purchase or logging in) on both devices, these 2 customers will then be automatically merged into one, together with all their historic events and customer properties, where the properties will be compared and the newer customer property will override the older one in the resulting profile. After the merging, an event merge will be tracked. As the record is merged to one profile, duplicate profiles are avoided, and instead, you achieve a coherent and reliable tracking of your customers.

Merging rules

  • No 2 customers can exist with the same hard or soft ID at the same time in the same project.
  • It is not possible to merge customer profiles with different hard IDs of the same type.
  • If there is a “clash” of identical soft IDs of the same type in 2 customer profiles with different hard IDs of the same type, then the soft ID is transferred (or “stolen”) from the “older” profile and will remain only in the “newer” profile.
    • However, historic events are not moved from the “older” into the “newer” profile. This ensures the maintenance of your previous customer’s data.
    • The soft ID in the profile from which the cookie is stolen reverts back to being "not set". The cookie remains present only in the events on the profile, however, it cannot be found anymore by the customer filter.
  • Events are moved from source customers to destination customer. In this case, destination customers are those whose record in the database was created first - they have lower customer ID number and by default higher priority.
  • Properties from source customers are added to destination customer.
  • If destination customer already has a property with a given name, it is replaced.
  • The same rule that applies to properties applies also to assigned HTML campaigns.
  • Latest communication overwrites the older one .
  • Assigned A/B tests are merged in reversed order (the A/B test from a customer with newer (larger) internal ID wins over the older (smaller) one).
  • add_first_session flag is set only if any of the customers has it set to True.

Merge event

When the customer's IDs from multiple devices finally merge into one customer profile an event 'merge' is tracked with the following properties:

AttributeDescriptionExample
source_internal_idsInternal IDs of merged customers["58244a8dfb6009d9d3213198", "5820734f83043485f66795eb"]
destination_internal_idInternal ID of final customer"5820734f83043485f66795eb"
original_external_idsExternal IDs (registered, cookie) of merged customers{"5820734f83043485f66795eb":{"registered":["[email protected]"]},"58244a8dfb6009d9d3213198":{"cookie":["c50961e7-9086-4169-8066-1ee47615108b"]}}
final_external_idsList of all external IDs (registered, cookie) from two initial profiles{"cookie":["c50961e7-9086-4169-8066-1ee47615108b"],"registered":["[email protected]"]}
requested_idsList of external IDs (registered, cookie) in the request which merged the clients{"cookie":"c50961e7-9086-4169-8066-1ee47615108b","registered":"[email protected]"}

Merging problem

There is a case when wrong people might be merged together. This could happen in the following situation: customers in your project do not have hard IDs. When a Customer 1 comes on to your website on the device of a Customer 2, the system does not recognize Customer 1 as a unique customer. Instead, it sees them as an additional soft ID that will be added to the soft ID of Customer 2. Only one customer profile remains then even though they are, in fact, 2 unique customers.

You can prevent this from happening by setting an email as a hard ID. If for some reason you want to keep email as a soft ID you must set some other hard ID. Thanks to this when Customer 1 comes on the device of Customer 2 the system recognizes that a unique customer (with a unique hard ID) comes on the device of another unique customer (with another hard ID) and so the merging does not happen.

New soft IDs can be defined when creating a new project. If you want to add new soft IDs to an already existing project or just adjust the settings of your IDs, please contact your CSM.