Relevant to: Demand Acceleration Platform | Content Syndication | Event Lead Management | Social Integrations | Webinar Integrations
General lists can be used to ensure incoming lead data uses standardized values (eg. states, countries, job titles) and also for some advanced value mapping purposes. A general list is added to an list type field.
In this article:
Creating a general list
| When you create a new general list, it will be available to assign to any Campaign/Source fields in your Demand Acceleration Platform account. |
Creating a general list from the Lists page
1. Navigate to Campaigns > Lists. This will display all the lists associated with your account.
2. Click Create List and choose General List.
3. The General List modal will appear.
Complete the following:
| Field | Required? | Description |
| List Name | Required | It's recommended to give the list a unique name as you'll be able to use it in any Campaigns/Sources. |
| Enforce Case Sensitivity | Toggle on/off |
Switch on to ensure leads match the capitalization of the characters in the list value. eg. Canada not canada or CANADA. This is switched off by default and can only be turned on when creating a list. |
| Show Duplicates Only | Toggle on/off |
Switch on to view and resolve any duplicates in the uploaded values. This is switched off by default and can only be turned on when creating a list. It's recommended to switch the toggle off once you have used the function to resolve any duplicates, before saving. |
4. Add the list values.
You can add values manually by typing them into the text box. Or paste an entire list of values to automatically add them in bulk.
| It's advisable to remove special characters from list values by first pasting them into a plain text editor (eg. Notepad) and then pasting into the modal. |
Press the enter key and the term will appear in the Value column.
Alternatively, click on Upload List Values to upload values from a .csv or .txt file.
Formatting your general list file
|
Drop the file into the blue box or click browse to select it from your computer.
Once uploaded, you can manually add and/or remove values as needed.
5. Click Create List to finish building the list.
6. Once complete, you will return to the Lists page. Click the list's Options menu to edit the settings or configure list mapping.
Creating a general list when adding or editing Campaign/Source fields
1. When building a new Campaign/Source or editing an existing one, go to the Fields tab to create and assign a new general list.
More information on the Fields tab and available Field Types & Validations here.
2. Click on the field that requires a list (eg. state/province, country). This will open the Field Settings side menu.
- Fields that require a list to be assigned, are highlighted red in the Source Fields.
3. Scroll to the Lists section and click Create List to build a new general list.
4. This will open the General Lists modal where you can proceed with the steps outlined above (name the list, define the settings and add values).
Adding a general list to fields
| A note on Media Partner CPL Source: list values that are assigned to Source fields will be visible to the associated Media Partner. |
1. In the Campaign/Source > Fields tab, click on the field that requires a list.
More information on the Fields tab and available Field Types & Validations here.
2. Scroll to the Lists section and click Assign List to add a list to the field.
3. Select the desired list from the modal and click Assign List.
- The modal displays all the lists in the account - use the search functionality to find a specific one.
4. Set your allowed and disallowed list values.
By default, all of the values on the list will be set to allowed - ie. a lead will be accepted if it uses a value on the list. If you want to exclude any of the values from the list, so that the lead cannot use a specific value, select it in the allowed column and click the bi-directional arrows to move it into the disallowed column.
- Highlight multiple values in grey to move them from allowed to disallowed.
- Use select all box to highlight all values
5. Decide how new values should be treated ie. if a lead contains a value that is not on the existing list, you can either allow the new value to be accepted or disallow it. By default, this is set to disallow.
6. Click Save.
The list is now visible in the field settings (and the field itself is no longer red).
