---
title: "User Matching"
slug: "mapp-intelligence-android-sdk-v5-user-matching"
description: "Configure user matching in Mapp Intelligence Android SDK v5 and connect app users with Mapp Engage identifiers."
updated: 2026-04-24T10:43:31Z
published: 2026-04-24T10:43:31Z
canonical: "docs.mapp.com/mapp-intelligence-android-sdk-v5-user-matching"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# User Matching

User matching connects Mapp Intelligence with the Mapp Engage SDK so that the Engage `dmcUserId` can also be used in Intelligence. This helps align data across both products.

> [!WARNING]
> Important
> 
> User matching does not work while anonymous tracking is enabled.

## Requirements

- Mapp Intelligence Android SDK v5.1.5 or later
- Mapp Engage Android SDK `com.mapp.sdk:mapp-android:6.1.3` or later
- Anonymous tracking must be disabled

## Configuration options

| Method | Description |
| --- | --- |
| `WebtrekkConfiguration.Builder(...).setUserMatchingEnabled(true)` | Enables user matching during SDK initialization. |
| `Webtrekk.getInstance().setUserMatchingEnabled(enabled)` | Enables or disables user matching at runtime. |
| `Webtrekk.getInstance().getDmcUserId()` | Returns the current Engage user ID when user matching is enabled. Otherwise the SDK returns `null`. |

## Enable during initialization

```kotlin
val configuration = WebtrekkConfiguration.Builder(trackIds, trackDomain)
    .setUserMatchingEnabled(true)
    .build()
```

## Change at runtime

```kotlin
Webtrekk.getInstance().setUserMatchingEnabled(true)

val dmcUserId = Webtrekk.getInstance().getDmcUserId()
```

## Things to keep in mind

- User matching depends on the Mapp Engage SDK providing a `dmcUserId`.
- If user matching is disabled, `getDmcUserId()` returns `null`.
- If anonymous tracking is enabled, user matching is effectively unavailable.

Related pages: [Anonymous Tracking](https://docs.mapp.com/docs/en/mapp-intelligence-android-sdk-v5-anonymous-tracking), [Retrieve Active Global Configuration](https://docs.mapp.com/docs/en/mapp-intelligence-android-sdk-v5-retrieve-active-global-configuration).