Email address books in Dotdigital for Salesforce

Learn about email address books in Salesforce and how they interact with your Dotdigital account.

Overview

The Email Address Books tab displays a list of your existing email address books and allows you to

• trigger a manual sync of an email address book.
• apply advanced settings.
• delete email an address book.
• link an email address book to a Salesforce campaign.

Email address books in Salesforce are groups of contacts and leads, roughly equivalent to your address books found under Email > Contacts > All contacts in Dotdigital.

Create an email address book

Email address books need to be created from the Campaigns tab to ensure that they are correctly linked to a Dotdigital account. To learn more, check out the section Link to an email address book.

Synchronise an email address book

To manually sync an email address book:

1. Select the Email Address Books tab.
2. Select the email address book name.
   

   If you can’t see the email address book you want, you might need to expand the Email Address Books drop-down menu and select a different list view.
   

3. Select Synchronise Address Book.
   

A message is displayed confirming the sync request has been queued.

To check the status of the sync:

1. Select the Configuration tab.
2. Expand the Settings drop-down menu and select Sync audit.
3. The Synchronisation audit window is displayed, and you can check if your email address book sync is complete by looking at the Status column.

Sync address books in bulk

To trigger a sync of all address books:

1. Go to Configuration.
2. Expand the Settings drop-down menu and select Sync Options.
3. On the Synchronisation Schedule tab, select the Sync Now checkbox for Address books.
4. Select Synchronise Now.

Address book contains no contacts after synchronisation

If an address book sync appears to have failed, this can be due to one or more contacts being rejected by the Dotdigital Data Watchdog. The Watchdog is used to identify problematic contact data and thereby help protect your sending reputation.

Newly created address books in Dotdigital initially appear as empty, then, once a sync has completed, contacts populate the address book. If you have completed a synchronisation and the address book remains empty of contacts, you can check the audit log for any failure messages. To do this:

1. Go to Configuration.
2. Expand the Settings drop-down menu and select Sync Audit.
3. Check the Status column for any failures. The Message column displays Rejected by Watchdog when this is the reason for the failure.

Contact your Dotdigital Customer Success representative for assistance with contact data being quarantined by the Watchdog. To learn more, check out the article About the Data Watchdog.

Edit an email address book's settings

To edit an email address book's settings:

1. Select the Email Address Books tab.
2. Select the email address book name.
3. Select Advanced.

The Advanced Settings window has two tabs: Settings and Campaign Members Status Filter.

Settings

Setting	Description
Manual sync	Prevents the email address book from being included in scheduled syncs. Address book sync can only be completed manually.
Join trigger	Ensures that Dotdigital address book join actions are triggered for new contacts added to the email address book. This means each addition to the address book will be an individual action. This method therefore consumes API calls at a much higher rate than the default bulk method. The option can be activated at any time and takes effect at the next synchronisation.
Source list	Prevents inactivity monitoring from applying the manual sync setting, and ensures that the email address book is always included in scheduled syncs.
Create Salesforce leads from new address book members	Syncs any additions to your linked address book in Dotdigital with Salesforce.

Manual sync

The connector automatically sets an email address book to Manual Sync after a specified inactivity timeout period - meaning the email address book was not sent to from either Salesforce or Dotdigital.

The inactivity period can be set between 1 and 180 days. By default the setting is 45 days. To learn more, check out the section Global Settings.

If the Manual Sync checkbox is cleared and a send is made from either Salesforce or Dotdigital before the next automated sync, the inactivity period timer is reset. If there are no further sends within the inactivity period, the Manual sync setting is re-applied.

Campaign Members Status Filter

Enable Filtering by Membership Status allows you to include or exclude members with the selected filter from the email address book at the next scheduled or manual sync. If more than one Salesforce campaign is linked to the email address book, the filter will apply to all linked campaigns.

This option allows the Salesforce campaign membership to stay the same, while applying the selected filter to the email address book.

The filter may result in there being no members in the email address book following synchronisation.

To apply the filter:

1. Select the checkbox for Enable Filtering by Membership Status.
2. Expand the Filter type drop-down menu and select Include or Exclude.
3. Select your filter criteria from the list.
4. Select Save.

Delete an email address book

To delete an address book:

1. Select the Email Address Books tab.
2. Select the email address book name.
3. Select Delete.
   
4. A window is displayed asking you to confirm the deletion. Select Delete to confirm.
   

Deleting an email address book is restricted by permission set and can't be done by all users. If you don't have the required permission in Salesforce, you can delete the address book directly in Dotdigital. To learn more, check out the article Delete and empty address books.

Link to a Salesforce campaign

To link an email address book to a Salesforce campaign:

1. Select the Email Address Books tab.
2. Select the email address book name.
3. Select Add Link to Campaign.
4. Select the campaign name you want to link to.
5. Select Link.