Integrations
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.
To enable this feed, you will need to create SFTP credentials and perform separate configuration in mParticle and Salesforce.
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.
customer_<org_id>
.Create a password and encrypt credentials:
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:
A
–Z
) a
–z
) 0
through 9
) ~!@#$%^&*_-+=`|\(){}[]:;"'<>,.?/
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.
From the Admin dashboard of your Salesforce account, select Data Management > File Locations. And create a new location. Set the following parameters:
External SFTP
sftp.mparticle.com/<path>
- using the Path
you copied from the mParticle dashboard.Hostname
you copied from the mParticle.Password
Follow Salesforce’s instructions to create a Data Extract. As you create the activity set the following parameters:
%%Year%%
, %%Month%%
, %%Day%%
.Tracking Extract
for the Extract TypeUTF-8
for Character Encoding[Comma]
for Column DelimiterCSV
for FormatUTC
for TimezoneMake 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.
The following Extract Types can be configured to be forwarded to mParticle. Events will be mapped as follows:
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 |
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” |
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 |
Was this page helpful?