Installation & Configuration Guide - iContact · iContact for Salesforce Installation and Configuration Guide Version 2.3 7 Adjusting your Salesforce Security Controls Add Safe IP

Installation &

Configuration Guide Enterprise/Unlimited Edition

Version 2.3

Updated January 2014

08 Fall

iContact for Salesforce Installation and Configuration Guide Version 2.3 2

Table of Contents

Getting Started ....................................................................................................................................... 3 Introduction ........................................................................................................................................................ 3 Requirements ..................................................................................................................................................... 3 Support ................................................................................................................................................................. 4 Recommended Browsers ............................................................................................................................... 4 Other Supported Browsers ........................................................................................................................... 4

Installing iContact for Salesforce ..................................................................................................... 5 Installing iContact for Salesforce Package ............................................................................................... 5

Adjusting your Salesforce Security Controls ............................................................................... 7 Add Safe IP Ranges ........................................................................................................................................... 7 Field Level Security .......................................................................................................................................... 7

Adjusting your Salesforce Settings and Configuration........................................................... 11 Add Campaign Record Type ....................................................................................................................... 11 Customize Lead Settings .............................................................................................................................. 12 Map Lead Field ................................................................................................................................................ 12 Add Related Lists to Contact & Lead Page Layouts ............................................................................ 12 Configuring iContact for Salesforce (You’re almost done!) ............................................................ 20 Important Note for Internet Explorer users: ....................................................................................... 22

Sending a Test Email .......................................................................................................................... 23 Create an iContact Campaign ..................................................................................................................... 23 Add Recipients ................................................................................................................................................ 23 Send Test Message ......................................................................................................................................... 24

Additional Information: .................................................................................................................... 26 Choosing Appropriate Sharing Rules Setting....................................................................................... 26

Adding Permission to Additional Salesforce Profiles ............................................................ 26 Enhanced Profile User Interface .............................................................................................................. 27 Using Standard Profile Interface .............................................................................................................. 30

Installing the iContact MessageBuilder Tab - Optional ......................................................... 34


Getting Started

Introduction Welcome to iContact for Salesforce! This document serves as a guide to installing and configuring iContact for Salesforce CRM (hereafter referred to as “iContact”) within your Salesforce organization. Email marketing with iContact for Salesforce allows you to create, send and track relevant and targeted email marketing without the need to learn a new application. This document includes step by step instructions for full installation and configuration. NOTE: Apart from sections in the guide marked as ‘Optional,’ be sure to follow all directions step by step as they are required for the iContact for Salesforce integration to properly function.

Requirements To use iContact, your Salesforce organization must be Professional, Enterprise or Unlimited edition. This guide is for Enterprise or Unlimited editions only. For Professional editions, please use the specialized guide, located here. Not sure which edition of Salesforce you have? Check the title bar of your browser for the name of your Salesforce Edition.

Other Requirements:

Campaign functionality enabled

Ability to create new campaign record types

You must have System Administrator rights to your organization to perform the installation and configuration of iContact for Salesforce

You will need a System Administrator level user for authentication of your Salesforce organization with iContact. It’s recommended that you have a separate user (additional user license) set up just for this purpose with a custom profile, proper permissions and a password that never expires. If this is not possible, use a System Administrator user for authentication purposes. (more on page 21)

We recommend having unlimited data storage, though it is not required.

http://www.icontact.com/static/pdf/Pro_Installation_and_Configuration_Guide.pdf

http://blogs.salesforce.com/community/2012/01/appexchange-customer-choice-awards-announcing-the-best-apps-of-2011.html


Support For any technical or setup questions that are not answered in this guide, please contact iContact for Salesforce Support at: Toll free: 1-866-331-3208 International: +1-919-957-6070 [email protected]

Recommended Browsers

Firefox

Google Chrome

Other Supported Browsers

Safari Internet Explorer

More information about Salesforce Supported Browsers

mailto:[email protected]

http://na1.salesforce.com/help/doc/en/salesforce_supported_browsers_cheatsheet.pdf

http://www.mozilla.com/en-US/firefox/personal.html

http://www.google.com/chrome

http://www.apple.com/safari/

http://www.microsoft.com/windows/internet-explorer/?ocid=ie8_b_a95e1b02-dd15-4f23-a33b-052f021366c4


Installing iContact for Salesforce

Installing iContact for Salesforce Package

1. Click the following link or copy and paste it into your browser.

https://login.salesforce.com/?startURL=%2Fpackaging%2FinstallPackage.apexp%3Fp0%3D04tA0000000QxR5

2. Log in with your Salesforce System Administrator credentials. 3. Ensure that the package name listed is correct and is Version 2.3 4. Review the contents of the iContact for Salesforce package and click Continue 5. Approve Third-Party Access for app.icontact.com and click Continue.

6. Review Package API Access page and click Next 7. Define your security settings for your organization’s needs. We typically recommend choosing

Select security settings to specify permissions for certain profiles. Be sure to include the profile assigned to the “iContact User”. Please note: with the exception of System Administrator, the profile(s) to which you are granting access must be Custom Profiles, not Standard Profiles. You may add permissions to additional profiles at a later date by following the instructions near the end of this guide. Click Next when finished.

8. Now, click Install - This may take a few minutes, depending on your Internet connection speed and the size and density of your Salesforce org.

9. In most cases the installation should complete in a few moments, and you’ll see the following

message.

. 10. When the installation has completed, if you’re not automatically redirected, go to

Setup > App Setup > View Installed Packages




11. You should now see the iContact for Salesforce package listed

12. Verify in applications (dropdown in top right) that there is now iContact Email Marketing.


Adjusting your Salesforce Security Controls

Add Safe IP Ranges

1. Go to Setup > Administration Setup > Security Controls > Network Access

2. Click New to add the following trusted IP ranges:

66.192.165.133 - 66.192.165.133

69.166.132.241 - 69.166.132.254

69.166.134.129 - 69.166.134.158

Field Level Security

1. Go to Setup > Administration Setup > Security Controls > Field Accessibility


2. Select Contact

3. Check that the fields Fax and Email Opt Out are visible to the profiles. It’s recommended to

make “Email Opt Out” visible to the layout. Here’s one way to do this:

a. Click View by Profiles b. Select the profile System Administrator (or other appropriate Administrative profile)

from the drop down menu c. Locate the desired field (Email Opt Out or Fax) d. Click on the Field Access (Editable or Hidden link) for the profile(s) to which you have

granted access. e. Be sure that the Field-Level Security for each profile is marked as Visible.

For Email Opt Out in particular, be sure to mark as visible to layout as well.

f. Save and choose Field Fax. g. Repeat steps for Fax.


Note: These two fields, Fax and Email Opt Out, are specified here because they are not always visible to profiles by default. The following additional standard fields should be visible to profiles by default, but if you’ve made Field Accessibility changes, you may need to check that these fields are also visible to the appropriate profiles on Contact page layouts:

Salutation

First Name

Last Name

Account Name / Company

Email

Phone

Mailing Address / Address

4. Repeat all steps in this section for any other custom profiles to which you’ve granted access to iContact for Salesforce.

Repeat all steps in this section for Lead. This step is required, even if you do not currently use the Lead object. You will receive an error message and be unable to send through iContact for Salesforce if not all steps in this section are followed. 1. Go to Setup > Administration Setup > Security Controls > Field Accessibility

2. Select Lead

3. Check that the fields Fax and Email Opt Out are visible to the profiles. It’s recommended to

make “Email Opt Out” visible to the layout.


Here’s one way to do this:

a. Click View by Profiles b. Select the profile System Administrator (or other appropriate Administrative profile)

from the drop down menu c. Locate the desired field (Email Opt Out or Fax) d. Click on the Field Access (Editable or Hidden link) for the profile(s) to which you have

granted access. e. Be sure that the Field-Level Security for each profile is marked as Visible.

For Email Opt Out in particular, be sure to mark as visible to layout as well.

f. Save and choose Field Fax. g. Repeat steps for Fax.

Note: These two fields, Fax and Email Opt Out, are specified here because they are not always visible to profiles by default. The following additional standard fields should be visible to profiles by default, but if you’ve made Field Accessibility changes, you may need to check that these fields are also visible to the appropriate profiles Lead page layouts:

Salutation

First Name

Last Name

Account Name / Company

Email

Phone

Mailing Address / Address

4. Repeat all steps in this section for any other custom profiles to which you’ve granted access to iContact for Salesforce.


Adjusting your Salesforce Settings and Configuration

Add Campaign Record Type

1. Go to Setup > App Setup > Customize > Campaigns > Record Types

2. Do you have any campaign record types created? If yes, skip to step 3. If no, we suggest

these steps: a. Click New

i. Existing Record Type: --Master-- ii. Record Type Label: Standard Salesforce Campaign iii. Record Type Name: Standard_Salesforce_Campaign iv. Enable for at least System Administrator profile v. Click Next vi. Select Campaign Layout from dropdown vii. Save & New

3. Click New. a. Existing Record Type: --Master-- b. Record Type Label: iContact Email Campaign c. Record Type Name: iContact_Email_Campaign d. Mark as Active e. Enable for at least System Administrator profile f. Click Next g. Select iContact Campaign Layout from dropdown h. Save


Customize Lead Settings

Map Lead Field

1. Go to Setup > App Setup > Customize > Leads > Fields

2. Click Map Lead Fields 3. For iContact Contact Id select Contact.iContact Contact Id

4. Save

Add Related Lists to Contact & Lead Page Layouts

1. Go to Setup > App Setup > Customize > Leads > Page Layouts

5. Choose Edit for the Lead Page Layouts that will be used for your iContact Email Marketing

campaigns.


6. Drag and drop the following Related Lists into the page layout: a. iContact Message Statistics b. iContact Clicked Links

7. Edit the settings of each of these two related lists by clicking the wrench icon.


8. Add the following fields for the iContact Message Statistic related list: c. Recipient Name (should already be there) d. Campaign e. iContact Sent Message f. Total Opens g. Total Clicks h. Bounced Date i. Unsubscribed Date j. Created Date

9. Choose Sort By: Created Date and select Descending. This will put your newest message statistics at the top of your lists.

10. Click the + next to Buttons and uncheck the New option.

a. Click Ok.


11. Add the following fields for the iContact Clicked Links related list: a. Link (should already be there) b. Full Link c. Clicks d. Unique Clicks e. Created Date


a. Click the + next to Buttons and uncheck the New option.

b. Click Ok.

13. Click Save

14. Repeat for any other Lead Page Layouts you will be using with iContact for Salesforce


Repeat for Contacts:

1. Go to Setup > App Setup > Customize > Contacts > Page Layouts

2. Choose Edit for the Contact Page Layouts that will be used for your iContact Email Marketing

campaigns. 3. Drag and drop the following Related Lists into the page layout:

a. iContact Message Statistics b. iContact Clicked Links


4. Edit the settings of each of these two related lists by clicking the wrench icon.

5. Add the following fields for the iContact Message Statistic related list:

a. Recipient Name (should already be there) b. Campaign c. iContact Sent Message d. Total Opens e. Total Clicks f. Bounced Date g. Unsubscribed Date h. Created Date


c. Click the + next to Buttons and uncheck the New option.


d. Click Ok. 7. Add the following fields for the iContact Clicked Links related list:

a. Link (should already be there) b. Full Link c. Clicks d. Unique Clicks e. Created Date


c. Click the + next to Buttons and uncheck the New option.


d. Click Ok.

9. Click Save

10. Repeat for any other Lead Page Layouts you will be using with iContact for Salesforce


Configuring iContact for Salesforce (You’re almost done!)

1. Click All tabs (+ or > on far right tab)

2. Click on

3. Click Edit

4. Configure –

a. Enable Lite Version – Checking this box enables “Lite” version instead of “Normal” version.

Lite version does not store information on the campaign member level and may benefit users with storage capacity concerns. Leaving the box unchecked (recommended) enables Normal version.

Normal version stores statistics on the campaign member level and is recommended for most users. The version can be changed at any time on this page and may be altered for each individual send.

We recommend not checking this box for most users.

b. View Spam Score - Check this box if you prefer to view the spam score of your message before you send it. Note: iContact will not send messages with a spam score greater than 5.0.

We recommend checking this box.

c. Disable Sharing Rules – If your organization wide settings are set to Private, checking this box disables this within the iContact for Salesforce application. This would allow any user with Campaign permission the ability to send Email Messages to Contacts and Leads that your Salesforce Organization Wide Default permissions don’t allow them access to. Please see the full details of this feature on page 28.

We recommend not checking this box.


5. iContact API Connection – Enter the information that was provided to you by iContact for this section. All fields are required.

The information for these fields will not change unless changed at the iContact account level. This password should not be changed unless instructed to by an iContact support rep.

6. Salesforce API Connection – Enter the Salesforce Credentials (username and password to access Salesforce) of your chosen user and click Submit.

We recommend using a non-human user with a password that never expires for this role. This just means a separate user with a Salesforce license that is not the regular login for a staff member or any other person. This user must be a Salesforce System Administrator and must have “View all Data” permissions on the profile level.

The reason for this recommendation is that this username and password is used to authenticate iContact for Salesforce. If you use a human user and they leave the organization, or their password changes, you will then be required to re-authenticate the integration with a new set of credentials.

If using a non-human user is not possible, use a System Administrator’s credentials. Just keep in mind that most Salesforce password policies require a password reset after 90 days and the new password will need to be re-entered in this section once it is reset. When you see the success message below, your credentials have been accepted.


Important Note for Internet Explorer users:

If your Internet Explorer browser does not allow all cookies, you may see this page after entering iContact API Connection information:

1. In your Internet Explorer browser, go to Tools > Internet Options.

2. In the Privacy tab, move the Settings slider to Accept All Cookies and click OK. Refresh the window to set your Salesforce credentials. This privacy setting may be changed back after your credentials are successfully submitted.


Sending a Test Email

Create an iContact Campaign

1. Create a new campaign and, if prompted, select the “iContact Email Campaign” record type to create an email marketing campaign.

2. Click Continue 3. Specify a name for your iContact Email Campaign 4. Mark the campaign as active. 5. Click Save.

Add Recipients

1. Click Manage Members and choose Add Members – Search.

2. You can search your contacts and leads using filters to locate yourself and/or other internal users

to your campaign for testing. 3. Add with the status of your choice (Note that for the purposes of iContact for Salesforce, it does

not matter which status is selected).


4. To search again and add more campaign members, click the Add Members tab within the Add

Members – Search option. 5. When finished, click Back to Campaign.

Send Test Message

1. Click iContact Send 2. NOTE: The three major browsers (Chrome, Firefox and Internet Explorer) now contain a security

feature that needs to be disabled in order to complete your send. If this feature isn’t disabled, the ‘Send to Campaign Members’ button (see step 7) won’t function and the HTML preview of your template won’t load. Below are simple steps you can follow to do this in each browser. If you have any further questions, please contact Support:

Chrome:

a. In Chrome, click the icon that looks like a shield on the right side of the address bar. b. Click ‘Load unsafe script’ in order to load all content on the page.

Firefox:

a. In Firefox, click the icon that looks like a shield on the left side of the address bar. b. Click the drop-down arrow next to ‘Keep Blocking’ c. Select ‘Disable Protection On This Page’

Internet Explorer:


a. In Internet Explorer, a pop-up should appear at the bottom of the page. b. Click ‘Show all content’

3. Select the iContact Templates folder and the iContact Demo Template

4. Enter the name, email address, and physical address from which this message will be sent.

5. Enter your initials where indicated. 6. Choose Send Immediately as the Scheduling option.

7. Preview the message and click Send to Campaign Members. 8. Continue through Spam Check Score display.


9. From the iContact Sent Message page, watch the status to ensure that it changes from Scheduled to In Progress to Released. This change will occur automatically.

10. Confirm receipt of the message. 11. Click Update Statistics to view updated statistics

For more information on sending messages, application features, and tracking details, please refer to the iContact for Salesforce User Guide.

Additional Information:

Choosing Appropriate Sharing Rules Setting This setting is found under All Tabs > iContact Configuration > iContact Configuration Detail > Disable Sharing Rules (see page 20). Description of Default (unchecked) Setting: The “Disable Sharing Rules” default setting of unchecked keeps your Salesforce organization’s permission settings (org-wide, roles, and sharing rules) intact. Users that have been given permission to use iContact for Salesforce and also have read/write access to Contacts, Leads, and Campaigns will be able to send emails through iContact and update statistics. Description of checked Setting: When the “Disable Sharing Rules” setting is checked, sharing settings that prevent an iContact for Salesforce user from accessing an iContact campaign for sending or updating will be ignored. This only affects sending and updating. This can also be accomplished by manually sharing a record, or by writing new sharing rules for your org, though sharing rules should only be prepared by a trained Salesforce System Administrator.

When might I check the Disable Sharing Rules option?

If an iContact for Salesforce user needs to send or update an iContact Email Campaign, and they don’t have Full Read/Write access to the Campaign.

If an iContact for Salesforce user needs to send or update an iContact Email Campaign, and they don’t have Full Read/Write access to the Contacts or Leads in the campaign.

Other scenarios may apply We recommend examining your needs carefully and, if possible, write a sharing rule or share a record manually instead of using this feature.

Adding Permission to Additional Salesforce Profiles With the exception of System Administrator, the profile(s) to which you are granting access must be Custom Profiles. Below you will find detailed instructions for using Salesforce’s updated Enhanced Profile User Interface or the Standard Profile Interface This setting can be modified under Name > Setup > App Setup > Customize > User Interface > Enable

http://www.icontact.com/static/pdf/User_Guide.pdf


Enhanced Profile User Interface

Enhanced Profile User Interface

1. Go to Setup > Administration Setup > Manage Users > Profiles > Choose the profile you’d like to edit

2. Click Assigned Apps and then click Edit

a. Mark iContact Email Marketing as Visible b. Save

3. Click the and select Object Settings

a. Campaign

i. Assign iContact Email Campaign Record Type


b. Contacts i. Object Permissions: Assign Read, Create, Edit permissions at minimum. ii. Field Permissions: Assign minimum of Read permissions for the following fields

1. Account 2. Email 3. Email Opt Out 4. Fax 5. Mailing Address 6. Name 7. Phone

iii. Save

c. Leads i. Object Permissions: Assign Read, Create, Edit permissions at minimum. ii. Field Permissions: Assign minimum of Read permissions for the following fields

1. Address 2. Company 3. Email 4. Email Opt Out 5. Fax 6. Name 7. Phone

iii. Save

d. Continue with Custom Objects i. Assign at least the following permissions to each object listed here:

Object Minimum Permissions Needed

iContact Clicked Links Read, Create

iContact Configuration No access, hide tab

iContact Configurations No access, hide tab

iContact Global Statistics Read, Create

iContact Help Tab On / Off

iContact Message Statistics Read, Create

iContact Temp Recipients No access


4. Click the and select Visualforce Page Access a. Edit b. Move all Available Visualforce Pages that begin with the prefix iContactforSF to

Enabled

c. Save

5. Repeat all steps for other profiles that you wish to grant permission to iContact for Salesforce.

Notes: Don’t forget to give these permissions to your API or automatic user, if you have one – the user whose credentials you enter into the iContact Configuration tab. To be able to create a new campaign, a User must be marked as Marketing User on their User page, as well as have Create permissions for the Campaign object. If you have questions regarding any of these steps, please contact the iContact for Salesforce Support Team.

Toll free: 1-866-331-3208 International: +1-919-957-6070 [email protected]



Using Standard Profile Interface View the profile to which you want to grant permission for iContact for Salesforce. Go to Setup > Administration Setup > Manage Users > Profiles > select correct profile Setting Proper Permissions

While viewing the appropriate profile, click Edit

1. Custom App Settings a. Mark iContact Email Marketing Visible

2. Tab Settings

a. Make edits if desired. b. We recommend that only System Administrators are given access to the iContact

Configuration(s) tab.

3. Standard Object Permissions

a. For an end user, at minimum check Read and Create, and Edit for the following: i. Contacts ii. Leads

b. Check Edit on Campaigns to allow users with this profile to add or edit campaign members.


4. Custom Object Permissions

a. At minimum, check Read and Create for the following: i. iContact Clicked Links ii. iContact Global Statistics iii. iContact Message Statistics iv. iContact Sent Messages

b. Save

5. Field Level Security

a. Under Standard Field Level Security, click [View] next to Contact. b. Be sure at least the following fields are marked Visible:

i. Email Opt Out ii. Fax iii. Account Name iv. Email v. Mailing Address vi. Name vii. Phone


c. Save and repeat for Lead: i. Email Opt Out ii. Fax iii. Address iv. Company v. Email vi. Name vii. Phone

6. Record Type Settings

a. Under Standard Record Types, click Edit for Campaigns b. Move iContact Email Campaign to Selected and Save.


7. Enabled Visualforce Page Access

a. Click Edit b. Move all Available Visualforce Pages that begin with the prefix iContactforSF to

Enabled

c. Click Save


8. Repeat all steps for other profiles that you wish to add. Notes: Don’t forget to give these permissions to your API or automatic user, if you have one – the user whose credentials you enter into the iContact Configuration tab. To be able to create a new campaign, a User must be marked as Marketing User on their User page. If you have questions regarding any of these steps, please contact the iContact for Salesforce Support Team.

Toll free: 1-866-331-3208 International: +1-919-957-6070 [email protected]

Installing the iContact MessageBuilder Tab - Optional You may be interested in adding the iContact MessageBuilder Tab to allow easy one-click access to your iContact account. This will allow you to access iContact’s HTML editor and hundreds of templates, as well as billing and other account information. This step is optional and may be done at any time.

1. Go to Setup > App Setup > Create > Tabs 2. Under Web Tabs click New

a. Select the page layout of your choice. We like the “Full page width” b. Click Next

3. Enter the following properties: a. Tab Label: iContact MessageBuilder b. Tab Name: iContact_MessageBuilder c. Tab Style: Use the search function to choose any icon for your tab d. Content Frame Height: 800 e. Click Next

4. Button or Link URL: https://app.icontact.com/icp/core/create/message


https://app.icontact.com/icp/core/create/message


5. Click Next

6. Choose which profiles will have access to the iContact MessageBuilder tab. We suggest

starting with System Administrators only. 7. Click Next 8. Choose which customs apps should house the iContact MessageBuilder Tab. 9. Click Save

Now you may click your new iContact MessageBuilder tab to access iContact’s HTML editor and email templates. You should be logged in directly the first time, but in the future may need to log into the iContact account on this tab to access the features. Contact the iContact for Salesforce support team if you need assistance with this. Toll free: 1-866-331-3208 International: +1-919-957-6070 [email protected]


Documents

Installation & Configuration Guide - iContact · iContact for Salesforce Installation and Configuration Guide Version 2.3 7 Adjusting your Salesforce Security Controls Add Safe IP