Feed

Salesforce Marketing Cloud is a platform that enables marketers to provide engaging and personalized customer experiences through automation of timely and relevant messages across e-mail, mobile and social at massive scale.

Enable the Feed

To enable this feed, you will need to create SFTP credentials and perform separate configuration in mParticle and Salesforce.

Create SFTP Credentials

To configure the feed, you will need to create SFTP credentials. These same credentials will be used for all feeds you have set up across your organization account. Any password changes must be coordinated with mParticle.

1. mParticle will provide you with a Username based on your mParticle Org ID in the format customer_<org_id>.

2. Create a password and encrypt credentials:

   1. Create a password. To be accepted, your password must be at least 16 characters in length and contain at least one of each of the following:

      • Uppercase alphabet characters (A–Z)
      • Lowercase alphabet characters (a–z)
      • Base 10 digits (0 through 9)
      • Non alphanumeric characters: ~!@#$%^&*_-+=`&#124;\(){}[]:;"'<>,.?/
   2. Create a basic text file containing the Username/Password

   3. Encrypt the file using the mParticle PGP public key. You can use softward like GPG Tools for OS X or Windows. Under no circumstances should you ever use web based tools to encrypt, hash, or encode data.

      -----BEGIN PGP PUBLIC KEY BLOCK-----
      Version: GnuPG v2
      mQENBFRKgRIBCACXmtK5WGdBDk/JWqzYdCd8uiKPJrnY0cAqfM6Rv1IhAl38IRKz
      9rsfcK1z3bIZYGwfOk1SPBZmSxLERF1DgwhhInrXf+OojxGiRmMRK7QQ1zE/sqvW
      RZqPeP+fRquK8BTP37Q+h8aophWBqaVfpejAaJtC+Xqe2xeGvBpnA8wu1c+Z1mLg
      UfuKfRcadHQ1Ej99kWpIHyXh0D83yV1HbG0Gh8x0USKYiLK0Nn0ykVyAB9mk0GjF
      3RoynGNHrbn3CH3f0J6ib+u7aVcZ9Y+E0E8KSI4h/4WhpIEWwicolMNeA+mTfySy
      HKOUGkGy0k6+ltrA1H9ti/nmBkR9brJKP/7pABEBAAG0I05heWRlbiBLb2xldiA8
      bmtvbGV2QG1wYXJ0aWNsZS5jb20+iQE5BBMBAgAjBQJUSoESAhsPBwsJCAcDAgEG
      FQgCCQoLBBYCAwECHgECF4AACgkQK48THX7ssvDsVQf/XZRuWWme2NvxSa+Ce/hB
      E6jIVLu5mw/snVo7PuGYRT0SoCRjEgx4J7tsmVlraRzBWAYYLdNd0pLAdkF+8rrh
      9klxbDAIuXE1KlyjXIifVQZH6I9Ujnnx+IZd+Ev/+FBLDBaEpcQSN1fEvI+MIotp
      9Q/7N+uts7DFFt1z7W/L9v0ujf4/t/L8DjYKm3AK+1DpbTlMt31YHoAuCs165pi/
      ZSy61BJM1N1XKAUPR7bcUw+ahhlMF7b3nyVQppmasqUdVLKTApCICX6yjooj0RDV
      0xcCNATCQJw/X7kL30Svi1C9oUro0KbRKa9O2ObODfBLt+XcrIqOxBwOcHzIg0bv
      Gw===fzFR
      -----END PGP PUBLIC KEY BLOCK-----

Share the encrypted file with mParticle. mParticle will notify you when the setup is complete.

Configure the Feed in mParticle

1. From the Directory, select the SFDC - Email tile and add the Feed integration
2. Name the configuration and select which mParticle User Identity type your Salesforce Subscriber Key should be mapped to.
3. Click Create and Copy the SFTP Hostname and Path. You will need these values in Salesforce.

Configure the Feed in Salesforce

Configure a File Location

From the Admin dashboard of your Salesforce account, select Data Management > File Locations. And create a new location. Set the following parameters:

• Name — this can be any string
• Location Type — set to External SFTP
• URL — set to sftp.mparticle.com/<path> - using the Path you copied from the mParticle dashboard.
• Port — You can find this 4-digit number at the end of the Hostname you copied from the mParticle.
• Auth Type — set to Password
• Username / Password — give the username and password you provided to mParticle as an encrypted text file.

Create a Data Extract

Follow Salesforce’s instructions to create a Data Extract. As you create the activity set the following parameters:

1. Set the Data Extract to the File Location you created in the previous step.
2. For your File Naming Pattern, you must ensure the file names will be unique, so append date to the file name to ensure uniqueness in the form of %%Year%%, %%Month%%, %%Day%%.
3. Select Tracking Extract for the Extract Type
4. Select the Rolling Range option and then specify the number of days for the Extract Range
5. Enter UTF-8 for Character Encoding
6. Select [Comma] for Column Delimiter
7. Check the boxes for 1 or more Extract Types to include. Supported extract types are listed below. Be sure not to include unsupported extract types.
8. Select CSV for Format
9. Check Quote Text
10. Select UTC for Timezone
11. Check Unicode Output

Make sure to follow Salesforce’s instructions to Create a Zip Data Extract to be able to upload them to the mParticle SFTP servers set up in the Create SFTP Credentials section.

Supported Extract Types

The following Extract Types can be configured to be forwarded to mParticle. Events will be mapped as follows:

• Event Type = Custom Event
• Custom Event Type = Other
• Event Name = See table

Extract Type	Event Name
Bounces	Email Tracking - Bounces
ClickImpressions	Email Tracking - Click Impressions
Clicks	Email Tracking - Clicks
Conversions	Email Tracking - Conversions
NotSent	Email Tracking - Not Sent
Opens	Email Tracking - Opens
Sent	Email Tracking - Sent
SentImpression	Email Tracking - Sent Impression
StatusChanges	Email Tracking - Subscriber Status Change
Surveys	Email Tracking - Surveys
Unsubs	Email Tracking - Unsubscription

Identity and Attribute Mapping

Events are mapped as follows:

Salesforce Field	mParticle Mapping
SubscriberKey	mParticle will map to the user identity type specified in the Subscriber Key configuration.
EmailAddress	mParticle will map to the “email” user identity type.
EventType	Custom Event Attribute named “Extract Type”

Configuration Settings

Setting Name	Data Type	Default Value	Description
Subscriber Key	string		The Primary Key in the Data Extension used to store subscriber information which indicates the Subscriber Key