To configure this feature:

1. Ensure Configuring Approved Email is complete.

2. Grant System Admins the following permissions:

   Object	Object Permission	Object Types	Fields	Field Permission
   multichannel_message__v	CRED	approved_email_action__v	message_identifier__v html_message_file__v. mc_activity_recordtype__v consent_confirm_html_file__v [optional]	Edit

3. Create all appropriate custommultichannel_activity__v object types.
4. Grant System Admins access to all created object types.

To configure this feature:

1. Ensure Configuring Approved Email is complete.

2. Grant Integration Users the following permissions:

   Object	Object Permission	Object Types	Fields	Field Permission
   multichannel_message__v	CRED	approved_email_action__v	message_identifier__v html_message_file__v mc_activity_recordtype__v consent_confirm_html_file__v [optional]	Edit

3. Grant Integration Users access to all created object types.

To configure this feature:

1. Ensure Configuring Approved Email is complete.

2. Grant Content Admin users the following permissions:

   Object	Object Permission	Object Types	Fields	Field Permission
   multichannel_message__v	CRED	approved_email_action__v	message_identifier__v html_message_file__v mc_activity_recordtype__v consent_confirm_html_file__v [optional]	Edit

3. Create and grant Content Admin users visibility to tabs for the following objects:

   • multichannel_activity__v
   • multichannel_message__v
4. Grant Content Admin users access to all created object types.

To configure this feature:

1. Ensure Configuring Approved Email is complete.

2. Grant end users the following permissions:

   Object	Object Permission	Object Types	Fields	Field Permission
   multichannel_message__v	R	approved_email_action__v	message_identifier__v html_message_file__v mc_activity_recordtype__v consent_confirm_html_file__v [optional]	Edit

3. Grant end users access to all created object types.

Creating Multichannel Messages

Multichannel Messages display both the recipients of Approved Emails as well as end users reviewing 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}} 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:

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>

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.