---
title: "Page events - EXM"
slug: "page-events---exm"
abstract: "Guide to how email related events are mapped from Sitecore 8.x to 9 in xDB Migration Tool."
---
# Page events - EXM

> [!note]
> For background information on page events, see the [Page events](https://doc.sitecore.com/xp/en/developers/dmt/30/xdb-data-migration-tool/page-events.html "Page events") page.

<details>
<summary><h2>Common email event mappings</h2></summary>

All email events described on this page include the following mappings:

| Value to write to event object | Property on event object |
| --- | --- |
| Constant value `1` | `EmailAddressHistoryEntryId` |
| `MessageId` from `CustomValues` from source object | `InstanceId` |
| `ManagerRootId` from `CustomValues` from source object | `ManagerRootId` |
| `MessageId` from `CustomValues` from source object | `MessageId` |
| `MessageLanguage` from `CustomValues` from source object | `MessageLanguage` |
| `TestValueIndex` from `CustomValues` from source object | `TestValueIndex` |
| `DateTime` from source object | `Timestamp` |

</details>

<details>
<summary><h2>Bounce events</h2></summary>

This section describes how bounce events are mapped from Sitecore 8.x to 9.

|     |     |
| --- | --- |
| Source object | Member of the array located at `PageEvents` on the page from the interaction |
| Event mapping definition | Event Mappings for MongoDB Page Events > Bounce Event |
| Event object type | `Sitecore.EmailCampaign.Model.XConnect.Events.BounceEvent` |
| Conditions | `PageEventDefinitionId` on source object is `{F7E054F5-6F73-4C09-82B0-9F36141BE42F}` |
| Field mapping definition | MongoDB to xConnect Event Mappings > MongoDB Page Event to xConnect Bounce Event |

In addition to the [common mappings](https://doc.sitecore.com/xp/en/developers/dmt/30/xdb-data-migration-tool/page-events---exm.html#UUID-754e7add-3334-48ce-70ad-9eb75e0b6362_N1529930410883 "Common email event mappings") that apply to all email events, the following event properties are also mapped:

| Value to write to event object | Property on event object |
| --- | --- |
| `BounceReason` from JSON string set on `Data` from source object | `BounceReason` |
| `BounceType` from JSON string set on `Data` from source object | `BounceType` |

</details>

<details>
<summary><h2>Dispatch failed events</h2></summary>

This section describes how dispatch failed events are mapped from Sitecore 8.x to 9.

|     |     |
| --- | --- |
| Source object | Member of the array located at `PageEvents` on the page from the interaction |
| Event mapping definition | Event Mappings for MongoDB Page Events > Dispatch Failed Event |
| Event object type | `Sitecore.EmailCampaign.Model.XConnect.Events.DispatchFailedEvent` |
| Conditions | `PageEventDefinitionId` on source object is `{691A6BF0-357B-426F-BF2E-C198A048E4ED}` |
| Field mapping definition | MongoDB to xConnect Event Mappings > MongoDB Page Event to xConnect Dispatch Failed Event |

In addition to the [common mappings](https://doc.sitecore.com/xp/en/developers/dmt/30/xdb-data-migration-tool/page-events---exm.html#UUID-754e7add-3334-48ce-70ad-9eb75e0b6362_N1529930410883 "Common email event mappings") that apply to all email events, the following event properties are also mapped:

| Value to write to event object | Property on event object |
| --- | --- |
| `FailureReason` from JSON string set on `Data` from source object | `FailureReason` |

</details>

<details>
<summary><h2>Email clicked events</h2></summary>

This section describes how email clicked events are mapped from Sitecore 8.x to 9.

|     |     |
| --- | --- |
| Source object | Member of the array located at `PageEvents` on the page from the interaction |
| Event mapping definition | Event Mappings for MongoDB Page Events > Email Clicked Event |
| Event object type | `Sitecore.EmailCampaign.Model.XConnect.Events.EmailClickedEvent` |
| Conditions | `PageEventDefinitionId` on source object is `{87431B9B-FA39-4780-BEB3-1047B9E61876}` |
| Field mapping definition | MongoDB to xConnect Event Mappings > MongoDB Page Event to xConnect Email Clicked Event |

In addition to the [common mappings](https://doc.sitecore.com/xp/en/developers/dmt/30/xdb-data-migration-tool/page-events---exm.html#UUID-754e7add-3334-48ce-70ad-9eb75e0b6362_N1529930410883 "Common email event mappings") that apply to all email events, the following event properties are also mapped:

| Value to write to event object | Property on event object |
| --- | --- |
| `Url.Path` from source object | `Url` |

</details>

<details>
<summary><h2>Email opened events</h2></summary>

This section describes how email opened events are mapped from Sitecore 8.x to 9.

|     |     |
| --- | --- |
| Source object | Member of the array located at `PageEvents` on the page from the interaction |
| Event mapping definition | Event Mappings for MongoDB Page Events > Email Opened Event |
| Event object type | `Sitecore.EmailCampaign.Model.XConnect.Events.EmailOpenedEvent` |
| Conditions | `PageEventDefinitionId` on source object is `{1AD8EBEB-24E3-46F1-9EDD-2295C5219C5E}` |
| Field mapping definition | MongoDB to xConnect Event Mappings > MongoDB Page Event to xConnect Email Event |

</details>

<details>
<summary><h2>Spam complaint events</h2></summary>

This section describes how spam complaint events are mapped from Sitecore 8.x to 9.

|     |     |
| --- | --- |
| Source object | Member of the array located at `PageEvents` on the page from the interaction |
| Event mapping definition | Event Mappings for MongoDB Page Events > Spam Complaint Event |
| Event object type | `Sitecore.EmailCampaign.Model.XConnect.Events.SpamComplaintEvent` |
| Conditions | `PageEventDefinitionId` on source object is `{D5AB8D8D-EFC1-4EEC-B7F1-80CDD05FEBD3}` |
| Field mapping definition | MongoDB to xConnect Event Mappings > MongoDB Page Event to xConnect Email Event |

</details>

<details>
<summary><h2>Unsubscribed from email events</h2></summary>

This section describes how unsubscribed from email events are mapped from Sitecore 8.x to 9.

|     |     |
| --- | --- |
| Source object | Member of the array located at `PageEvents` on the page from the interaction |
| Event mapping definition | Event Mappings for MongoDB Page Events > Unsubscribed From Email Event |
| Event object type | `Sitecore.EmailCampaign.Model.XConnect.Events.UnsubscribedFromEmailEvent` |
| Conditions | `PageEventDefinitionId` on source object is `{450ADCBF-9429-48D1-B87F-B45691833D1F}` |
| Field mapping definition | MongoDB to xConnect Event Mappings > MongoDB Page Event to xConnect Email Event |

</details>