Source: https://vaultcrmhelp.veeva.com/doc/Content/CRM_topics/Multichannel/ApprovedEmail/ReportAE/TrackMCActivitesAE.htm

## Tracking Multichannel Activities from Approved Emails

Multichannel Activities alert end users when certain activities associated with the Approved Email, for example, opens, link selections, or unsubscribes, have occurred. Being aware of these actions helps end users plan for future interactions with the account and enables them to stay informed on how their sent emails are used.

Content creators can add tokens to Approved Email content referencing a Multichannel Activity. When the end user sends an Approved Email including the token for the Multichannel Activity, the token displays to the recipient as a link. When the recipient selects the link, the end user is notified of the activity.

**Who can use this feature?**

* Content Admin Users — Browser
* [Creating Multichannel Messages](#Creating)
* [Adding Multichannel Activity Tracking to Approved Email Content](#Adding)
* End Users — Browser, iPad, iPhone
* [Using Multichannel Activity Tracking](#Using)
* Users require an Approved Email license

### Configuring Multichannel Activity Tracking for

[![Closed](../../../../../Skins/Default/Stylesheets/Images/transparent.gif)System Admins](#)

To configure this feature:

1. Ensure [Configuring Approved Email](../InitialConfig/ConfiguringAE.htm) is complete.
2. Grant the following permissions:

   | Object | Object Permission | Object Types | Fields | Field Permission |
   | --- | --- | --- | --- | --- |
   | multichannel\_message\_\_v | CRED | approved\_email\_action\_\_v | * consent\_confirm\_html\_file\_\_v [optional] * created\_by\_\_v * created\_date\_\_v * html\_message\_file\_\_v * message\_identifier\_\_v * modified\_by\_\_v * modified\_date\_\_v * mc\_activity\_recordtype\_\_v | Edit |
3. Create all appropriate custom **multichannel\_activity\_\_v** object types.
4. Grant access to all created object types.

[![Closed](../../../../../Skins/Default/Stylesheets/Images/transparent.gif)Integration Users](#)

To configure this feature:

1. Ensure [Configuring Approved Email](../InitialConfig/ConfiguringAE.htm) is complete.
2. Grant the following permissions:

   | Object | Object Permission | Object Types | Fields | Field Permission |
   | --- | --- | --- | --- | --- |
   | multichannel\_message\_\_v | CRED | approved\_email\_action\_\_v | * consent\_confirm\_html\_file\_\_v [optional] * created\_by\_\_v * created\_date\_\_v * html\_message\_file\_\_v * mc\_activity\_recordtype\_\_v * message\_identifier\_\_v * modified\_by\_\_v * modified\_date\_\_v | Edit |
3. Grant access to all created object types.

[![Closed](../../../../../Skins/Default/Stylesheets/Images/transparent.gif)Content Admins](#)

To configure this feature:

1. Ensure [Configuring Approved Email](../InitialConfig/ConfiguringAE.htm) is complete.
2. Grant the following permissions:

   | Object | Object Permission | Object Types | Fields | Field Permission |
   | --- | --- | --- | --- | --- |
   | multichannel\_message\_\_v | CRED | approved\_email\_action\_\_v | * consent\_confirm\_html\_file\_\_v [optional] * created\_by\_\_v * created\_date\_\_v * mc\_activity\_recordtype\_\_v * message\_identifier\_\_v * modified\_by\_\_v * modified\_date\_\_v * html\_message\_file\_\_v | Edit |
3. Create and grant visibility to tabs for the following objects:

   * multichannel\_activity\_\_v
   * multichannel\_message\_\_v
4. Grant access to all created object types.

[![Closed](../../../../../Skins/Default/Stylesheets/Images/transparent.gif)End Users](#)

To configure this feature:

1. Ensure [Configuring Approved Email](../InitialConfig/ConfiguringAE.htm) is complete.
2. Grant the following permissions:

   | Object | Object Permission | Object Types | Fields | Field Permission |
   | --- | --- | --- | --- | --- |
   | multichannel\_message\_\_v | R | approved\_email\_action\_\_v | * consent\_confirm\_html\_file\_\_v [optional] * html\_message\_file\_\_v * mc\_activity\_recordtype\_\_v * message\_identifier\_\_v | Edit |
3. Grant access to all created object types.

### Using Multichannel Activity Tracking as

[![Closed](../../../../../Skins/Default/Stylesheets/Images/transparent.gif)Content Admins](#)

#### Creating Multichannel Messages

Content admins define Multichannel Messages for tracked activity related to an Approved Email message. These messages display to recipients of Approved Emails when they take action in the email, and to end users when they review an account's Multichannel Activities.

To create Multichannel Messages:

1. Navigate to the **Multichannel Message** tab.
2. Select **New**.
3. Enter the following information:

   * Name
   * Message Identifier – This field is used by the {{approvedEmailAction}} token to identify this record
   * html\_message\_file\_\_v – Defines the HTML that displays to recipients when the action is taken. This field also displays to end users reviewing an account's Multichannel Activity.
   * consent\_confirm\_html\_file\_\_v – Defines the HTML for a confirmation step. This prevents systems from unintentionally submitting a response for a recipient.

     Select this option to display the confirmation message and the content defined in the html\_message\_file\_\_v field. [optional]
   * MC Activity RecordType – Corresponds to a object type on the multichannel\_activity\_\_v object

   The file uploaded for html\_message\_file\_\_v and consent\_confirm\_html\_file\_\_v must have a file type of HTML.
4. Select **Save**.

#### Adding Multichannel Activity Tracking to Approved Email Content

To track Multichannel Activities, content creators should add the [{{approvedEmailAction}}](../CreatingContent/ConfigTokens.htm#approvedEmailAction) token to the appropriate Approved Email content and populate the following parameters in the following format:

```
{{approvedEmailAction[LandingPageURL,MessageIdentifier]}}
```

##### Parameters of the {{approvedEmailAction}} Token

* LandingPageURL – The external, customer managed landing page. See the Landing Page Requirements section for more information.
* MessageIdentifier – The value of a message\_identifier\_\_v field of a specific multichannel\_message\_\_v object

For example:

```
{{approvedEmailAction[http://example.com/verteoMCMessageLanding,RequestResource]}}
```

Where **example.com** represents the external landing page and **RequestResource** represents the value of the message\_identifier\_\_v field of a specific Multichannel Message.

Alternatively, if no landing page is used for a Multichannel Action, the LandingPageURL parameter may be left blank:

```
{{approvedEmailAction[,MessageIdentifier]}}
```

##### Landing Page Requirements

Content creators need to add the following HTML snippet containing JavaScript to the external, customer owned landing page to ensure the appropriate Multichannel Activity is tracked:

[Copy](javascript:void(0);)

```
1
2
3
4
5
6
7
8
9
10
11
12
13
<div align="center" id="multichannelmessage"></div>
<!-- The iFrame and Multichannel Message Page will replace the above <div> tag. Please note that the id of the <div> matches the first parameter of the constructor -->
<script>
  var tag = document.createElement('script');
  tag.src = "//cdnmc1.vod309.com/multichannel/veeva/js/externalrequest/embed-multichannelmessage.js";
  var firstScriptTag = document.getElementsByTagName('script')[0];
  firstScriptTag.parentNode.insertBefore(tag, firstScriptTag);
  // This function creates an <iframe> (and multichannelmessage iframe viewer) after the API code downloads.
  var multichannelMessage;
  function onMultichannelMessageAPIReady() {
    multichannelMessage= new MUL.Frame('multichannelmessage', {height: '600px',width: '80%',});
  }
</script>
```

### Using Multichannel Activity Tracking as

[![Closed](../../../../../Skins/Default/Stylesheets/Images/transparent.gif)End Users](#)

To use Multichannel Activity tracking, end users can create and send an Approved Email message that includes a Multichannel Activity token. When the recipient interacts with the link in the email message, the end user receives a notification of the activity.

### Related Topics

[Creating Approved Email Templates](../CreatingContent/CreatingAETemplates.htm)

[Approved Email Configuration Tokens](../CreatingContent/ConfigTokens.htm)