Exclusion Lists

Messaging supports two different types of Exclusion Lists -- Standard and Virtual. A Standard Exclusion List is populated with recipients that are provided by the user. Conversely, a Virtual Exclusion List is populated with recipients based on parameters that the user defines.

To create a new Standard Exclusion List:

1. Above the list of existing Exclusion Lists, click + New button.

2. A "New Exclusion List" pop-up window is displayed. In the "Name" field, enter a name for the new Exclusion List.

3. From the "Type" drop-down menu, select "Standard (Default)."

4. Click Create. The Workspace is refreshed to show the Exclusion List details screen.

5. In the "Data Options" section, select the appropriate data type (Email Address, Mobile Phone, or Push Registration ID) from the "Data Type" drop-down menu.

6. In the "Exclusion File" section, click browse. An "Open File" dialog box is displayed. Navigate to the appropriate file and click open.

7. If the import file has a header row, make sure the "Header Row" check box is checked (this box is checked by default). If your file does not have a header row, uncheck this check box.

8. The toggle buttons at the bottom of the "Exclusion File" section allow you to indicate whether you're adding new records to the Exclusion List, or deleting records from the Exclusion List. When defining a brand new Exclusion File, you will be adding new records, so make sure that the append records in file to list button is selected (this button is selected by default).

9. In the Tool Ribbon, click Save.

10. The system begins the file import process. To check the status of the import, click "Imported Files" in the Function Menu. This screen displays a log of all file import activities, with the most recent activity listed at the top. If needed, click the refresh button (double-arrow icon) to get a refreshed view of the import process. When the import is complete, the system displays the final information about the import, including the number of records added, and the date / time.

11. Optionally, you can assign one or more tags to your Exclusion List. To assign a tag, click on the "Add tag" field in the Edit section of the Tool Ribbon. The system displays a pop-up menu of all the existing tags. You can select one of these tags, or type in a new one and press Enter. You can repeat this process to add more tags. To remove a tag, click the "X" icon next to the tag label.  

12. When finished, click Edit > Save in the Tool Ribbon.

Messaging supports two different types of Exclusion Lists -- Standard and Virtual. A Standard Exclusion List is populated with recipients that are provided by the user. Conversely, a Virtual Exclusion List is populated with recipients based on parameters that the user defines.

To create a new Virtual Exclusion List:

1. Above the list of existing Exclusion Lists, click + New button.

2. A "New Exclusion List" pop-up window is displayed. In the "Name" field, enter a name for the new Exclusion List.

3. From the "Type" drop-down menu, select "Virtual."

4. Click Create. The Workspace is refreshed to show the Exclusion List details screen.

5. In the "Data Options" section, select "Email Address" from the "Data Type" drop-down menu.

6. In the "Entity" section, select the primary Campaign source table used by your relational database Campaigns.

7. Based on the table you selected above in step 6, the field drop-down menu in the "Map to Profile" section is populated with all of the fields in this table that have a Data Type of "Email," and that have been associated with at least one Sender Profile. From this menu, selected the desired field that will be used to synchronize opt-out information from the primary Campaign source table.

8. Based on the "Email" field you selected above in step 7, the Sender Profile drop-down menu is populated with all of the Sender Profiles associated with this "Email" field. From this menu, selected the desired Sender Profile.

9. Click the add button (plus-sign icon). The combination of table / field / Sender Profile is displayed in the "Map to Profile" section. If you want to remove this combination, click the remove button ("X" icon).

10. Repeat steps 6 through 9 as needed to add more table / field / Sender Profiles to the Virtual Exclusion List.

11. Optionally, you can assign one or more tags to your Exclusion List. To assign a tag, click on the "Add tag" field in the Edit section of the Tool Ribbon. The system displays a pop-up menu of all the existing tags. You can select one of these tags, or type in a new one and press Enter. You can repeat this process to add more tags. To remove a tag, click the "X" icon next to the tag label.  

12. When finished, click Edit > Save in the Tool Ribbon.

To copy an existing item to use as the basis for a new item:

1. Search for the desired item (see Search for an Item for more details).

2. Click on the item name. The main item screen is displayed and populated with the details of the selected item.

3. In the Tool Ribbon, click Edit > Save As. A "Save as" dialog box is displayed.

4. Enter a name for the new item.

5. By default, the new item will be saved in the same folder location as the base item. Optionally, click the magnifying glass icon to browse to and select a different folder location.

6. Click save a copy. The system creates a copy of the selected item.

To view or edit an existing Standard Exclusion List:

1. When the screen is displayed, a list of all the current Exclusion Lists is displayed in the left-hand side of the Workspace. Optionally, you can filter this list by typing in all or part of an Exclusion List name in the "Search by Name" field.

2. Click on the Standard Exclusion List that you want to view. The Workspace is refreshed to show the details of the selected Exclusion List.

3. Optionally, to view detailed information about the Exclusion List, click the Exclusion List tab in the Tool Ribbon. The Item Details screen is displayed, showing who created the item, who modified it last, and what the last actions taken on the item were. On this screen, click "Related Items" in the Function Menu to see other items in the system that reference or utilize this Exclusion List. When finished, click the Edit tab in the Tool Ribbon to return to the main edit screen.

4. Optionally, to view a log of all the file imports that have occurred for this Exclusion List, click "Imported Files" in the Function Menu. This screen shows the total number of records currently in this Exclusion List, along with a detailed history of every file import. Please note that changes made to the Exclusion List contents via the Exclusion List API are not considered a file import, and therefore aren't displayed within the file import history.

Note: The Messaging application doesn't provide a way to view the contents of the Exclusion List through the user interface. However, you can retrieve a list of the recipients in an Exclusion List by means of the Exclusion List API.

5. The system allows you to either add new records to this Exclusion List, or to indicate records that need to be deleted from the Exclusion List. In either case, your changes must be stored within an external text file (.txt) that you import into the system. This text file must contain ONLY the properly-formatted relevant contact information (either email addresses, mobile phone numbers, or Push IDs).

Modify the contents of the Exclusion List

6. Optionally, to rename the Exclusion List, click Edit > Rename. A "Rename Item" dialog box is displayed. Enter a new name for the Exclusion List, then click save new name.

7. Optionally, you can assign one or more tags to your Exclusion List. To assign a tag, click on the "Add tag" field in the Edit section of the Tool Ribbon. The system displays a pop-up menu of all the existing tags. You can select one of these tags, or type in a new one and press Enter. You can repeat this process to add more tags. To remove a tag, click the "X" icon next to the tag label.  

8. To save your changes, click Edit > Save in the Tool Ribbon.

To view or edit an existing Virtual Exclusion List:

1. When the screen is displayed, a list of all the current Exclusion Lists is displayed in the left-hand side of the Workspace. Optionally, you can filter this list by typing in all or part of an Exclusion List name in the "Search by Name" field.

2. Click on the Virtual Exclusion List that you want to view. The Workspace is refreshed to show the details of the selected Exclusion List.

3. Optionally, to view detailed information about the Exclusion List, click the Exclusion List tab in the Tool Ribbon. The Item Details screen is displayed, showing who created the item, who modified it last, and what the last actions taken on the item were. On this screen, click "Related Items" in the Function Menu to see other items in the system that reference or utilize this Exclusion List. When finished, click the Edit tab in the Tool Ribbon to return to the main edit screen.

4. Optionally, make any necessary changes to the table / field / Sender Profile combinations defined for this Exclusion List.

   • To add a new combination, select the source table from the "Entity" drop-down menu, then select the email field from the Field drop-down menu, then select the Sender Profile from the Sender Profile drop-down menu. Click the add button (plus-sign icon).

   • To remove a combination, click the remove button ("X" icon) next to the combination.

5. Optionally, to rename the Exclusion List, click Edit > Rename. A "Rename Item" dialog box is displayed. Enter a new name for the Exclusion List, then click save new name.

6. Optionally, you can assign one or more tags to your Exclusion List. To assign a tag, click on the "Add tag" field in the Edit section of the Tool Ribbon. The system displays a pop-up menu of all the existing tags. You can select one of these tags, or type in a new one and press Enter. You can repeat this process to add more tags. To remove a tag, click the "X" icon next to the tag label.  

7. To save your changes, click Edit > Save in the Tool Ribbon.

To delete an item:

1. Search for the desired item (see Search for an Item for more details).

2. Click on the item name. The main item screen is displayed and populated with the details of the selected item.

3. In the Tool Ribbon, click Edit > Delete. A confirmation dialog box is displayed.

4. Click delete item to confirm the deletion.

Foldered items are moved to the Recycle Bin. Non-foldered items are permanently deleted.

Campaigns in the Email, Push Notification, and SMS Text channels can optionally be assigned one or more Exclusion Lists. The data type associated with the Exclusion List must match the Campaign channel (for example, you can't use an Exclusion List containing Push IDs in an email Campaign).

Note: For Load and Send Campaigns, you're required to assign a Virtual Exclusion List to the Campaign, if you select a "promotional" Sender Profile (that is, a Sender Profile intended to be used for promotional marketing messages, rather than for operational messages like shipping notifications). When you launch the Load and Send Campaign, the system will verify that you've assigned at least one Virtual Exclusion List; if not, an error message is displayed.

To assign an Exclusion List to a Campaign:

1. Navigate to the desired Campaign (see Campaigns for more details).

2. In the Tool Ribbon, click Options > Audience > Add Exclusion List. A "Browse Exclusion Lists" dialog box is displayed.

3. Click on the desired Exclusion List.

4. Within the "Audience" section of the Campaign screen, the system adds a new "Exclusion List" field. To view or edit the Exclusion List, click on the List's name. To remove this Exclusion List from the Campaign, click the "X" icon to the right of the List name.  

5. Repeat steps 2-4 as needed to add more Exclusion Lists to this Campaign.

6. In the Tool Ribbon, click Edit > Save.