Data Tables

Data Tables provide storage and data usage from other systems, enabling our clients to easily access all of their custom data for segmentation and personalization. Data tables allow for the creation of multiple tables with varying structures which can be related together on a data field. This system works to establish a relational database. Each data table can house a completely separate data set, creating a complex configuration and granting you a detailed view of the data. Advanced Data Structures can be created allowing one-to-one, one-to-many, and many-to-one relationships in multiple data tables.

The data that is stored in Custom Data Tables can be used for audience segmentation, suppression, and personalization. This can be achieved by creating a logic-defined Dynamic Data Table or by using an SQL query. To personalize content based on data available in the customer data tables, you can use the normal iTL Merge Field or the iTL look up function.

There are four types of tables in iPost:

  • System Data Tables: These tables contain system data, such as tracking information, contact properties, and platform objects.
  • Custom Data Tables: These tables are created by the user for the use of sending, querying, and managing data.
  • Dynamic Data Tables: These tables are the results of filtering one or more Custom and System Tables.
  • Coupons Data Tables: These tables are created by the user for the storing and inserting coupon codes into emails.
System Data Tables

System Data Tables can be accessed via Dynamic Data Tables and SQL Queries.  

System Table
Definition
Sends Information associated with a send event.
Opens Information associated with an open event.
Clicks Information associated with a click event.
Bounces Information associated with a bounce event.
Optouts Information associated with an unsubscribe event.
Contact Latest
Contains the most recent occurrence of each of the main events.
Tickets Tracking data associated with mailing tickets.
List Membership Contacts and the lists they belong to.
Automations A list of automations and their status.
Custom Data Tables

Custom Data Tables (CDT) are tables that you create to store your data.  They are part of a relational MySQL database and allow for complex data manipulation.  Data can be added to data tables via the API, an import, or a SQL query.  Custom Data Tables are used within Dynamic Data Tables and SQL Queries; this allows you to manipulate the data and output a new set of contacts.

Creating a Custom Data Table

Follow the steps below to create a custom data table.

  1. On the Data Table Manger page, enter the name of the custom data table in the Create New Data Table field.  The name of the custom data table can only contain characters, numbers, and underscores.
  2. Select Custom Data Table as the content type.
  3. Click Create.

Once the data table has been created, you will be brought to the properties page to create the data fields.

Properties

The top portion of the properties page provides you with the standard information about the custom data table.

Object
Description
Name
The name of the custom data table.
Description A description given to the custom data table.  This field is optional.
Folder Location The location of the data table in the folder tree of the data table manager.
Available for Sending This indicates that the data table can be used for an email send.  When this is selected, you will be asked to select which data field in the tables should be used as the recipient key.  The field that should be selected is the field containing email addresses.

For clients using a field besides email address as the unique identifier UID) for the account, the UID field should be selected as the Recipient Key.   The data field with a Data Type of Email should be used when selecting the Email Column.
Email Testing This indicates that the data table can be used for testing an email.
GDPR This indicates that the data table contains contact information as outlined by the General Data Protection Regulation (GDPR).  This field will need to be enabled for all data tables that contain data that is outlined by GDPR in order for iPost to process any GDPR removal requests.
Records
The number of contacts contained within the data table.
Content Type The type of data table.
Created Date The date the data table was created.
Created By The user who created the data table.
Modified Date The date the data table was last modified.
Modified By The user who last modified the data table.
Distribute to Subclients Use this feature to easily recreate the custom data table in any subclient account. This is only available if your account is provisioned with subclients and this feature is enabled. Contact iPost Client Services if you would like this feature enabled.

Attributes

The bottom portion of the properties page allows you to define the data structure for the custom data table.  To create an attribute, follow the steps below.

  1. Click on the Edit Attributes button.
  2. Click on the Add New Attribute button on the Edit Attributes page.
  3. Enter the attribute information.
    • Name: This required field is the unique identifier for the table. It can contain only characters, numbers, and underscore.
    • Data Type: This field is required and sets the data type for the field.  See explanation of data types in the reference section at the end of the section.
    • Default Value: This is an optional field.  If no value is present during the import of data, the default value is applied to the contact.
    • Required: This indicates that the data field is required when new data is added to the table.  If there is an empty value for this column, the records will be rejected.
    • Primary Key: This indicates if the field is a unique identifier for the contact records in the table.  The field is used when adding and updating data in the table.
    • Post Code:  This is an optional field.  If checked, this column will denote that the field contains postal codes.  This field should be checked if the Custom Data Table is being used in a dynamic data table for postal code radius search.
    • Post Code Validation: This is an optional field.  If checked, the platform will perform a validation on the postal code field.
  4. Once all data fields are entered, click on the Save button.

Custom Data Table Relationship

Custom Data Table Relationships allow you to establish a relationship between your new custom data table and an existing custom data table.  The relationship can then be used in dynamic data tables.  To create a Custom Data Tables Relationship, please follow the steps below.

  1. Click on the Add Relationship button.
  2. Enter the name for the relationship in the Insert Relationship Name field.
  3. The name of the current custom data table will prepopulate the first data table field. 
  4. Select the field from the current data table that you will be using for the relationship.  Normally this is a field in the existing data table of the same type.
  5. Select the existing data table from the Select Table field.
  6. Select the field from the existing data table that you will be using for the relationship. Normally this is a field in the current data table of the same type.
  7. Click on Add Relationships.

Once all the information has been entered on the properties page, click on Continue to save your Custom Data Table and proceed to the Records page.

Records

The Records page is where you can access the contacts associated with the Custom Data Table.  When the Custom Data Table is created, the Records page will be blank and contacts will need to be added to the table.

There are several ways to add contacts to a Custom Data Table.  Contacts can be added via the API, a Process Automation that utilizes the Import Activity, or by manually importing via the UI.  To manually import a data file, follow the steps below:

  1. On the Records page, click on the Upload icon.
  2. Select how you would like to locate your data file.
    • Browser Upload will allow you to upload a file on your PC. The data file must be smaller than 50MB if this option is used.
    • FTP Upload will allow you to select a file that is located in the CDT_IN folder on your FTP site.
  3. Check the Expect Large Data box if the large text data field is in use.  This will default the delimiter to Tab and enforce the Respect double quotes as a text qualifier option.
  4. Select the delimiter of the data file.
  5. Select the Import option for the data import.
  6. Select the Record Operation.  The options available in the drop down will vary depending on the presence of one or more primary keys in data structure of the custom data table.
    • Overwrite Existing Records will replace data currently in the table with data from the data file.
    • Only Update Existing Records will only update any contacts associated with the data table and will reject any new contacts.
    • Add Only New Records will add new contacts from the data file but will not update any existing contacts.
    • Add New & Update Existing Contacts will add new contacts and update any contacts associated with the data table.
  7. Click Next.
  8. On the Map Records step, you will need to map the fields on the data file to the attributes for the data table.  Any fields that match the data table attributes will be mapped automatically.  If you do not want to map a field, select Ignore this column.
  9. Click Finish.

The import will run in session and you will be notified when it has completed with an import notification.  The notification will provide you with a total number of records added or updated, as well as a total of the records that were rejected.  You will also be able to download the rejected records.  The rejected record file does include a column with the reason as to why the contact was not imported.

Once the import has completed, the custom data table will be populated with contact information. You will be able to see the contacts and the various data fields associated with the contact for that custom data table.  You also have the option to Edit or Delete a contact within the Action column.

  • Edit will allow you to edit a contact and any data values related to that contact.  Once edited, these changes will be updated in the custom data table.  Edit is only enabled if a primary key is configured on the custom data table.
  • Delete allows you to delete a contact.  Once deleted, the contact will no longer exist in the custom data table.  Deleted contacts are unable to be recovered after the delete has been completed.

Once the custom data table is populated with contacts, other functionality will be enabled on the Records page.  These functions are icons located on the left hand side above the contact information.

Split

Split allows you to split the custom data table into multiple custom data tables.  To split a list, follow the steps below.

  1. Click on the Split icon.
  2. On the Split Table page, select the number of branches you would like to split the list into.  The default number of branches is two.
  3. Select how you would like to divide the contacts into the new branches.
    • Numbers allows you to split the list by a specific quantity per branch.
    • Percentage allows you to split the list by a percentage per branch.
  4. In order to distribute the contacts into the new branches, slide the blue circle for each branch until the correct quantity or percentage is reached.
  5. Click Split.
  6. The new custom data tables will be located in the same folder as the custom data table that was split.  The resulting data tables will have the split letter (A, B, C, etc) and date and time appended to the custom data table name.

Export

Export allows you to export the contacts out of the custom data table.  Exports from data table are pushed to the CDT_OUT folder on your FTP.  An email notification will be sent when the export is available.To export a custom data table, follow the steps below.

  1. Click on the Export icon.
  2. Your email address will be populated in the Send a Data Export Summary Report To box. 
  3. Click Done

Clean

Clean allows you to remove all contacts from the custom data table.  Please note that once a data table has been cleaned, the contacts cannot be recovered to repopulate the data table.  To clean a data table, follow the steps below.

  1. Click on the Clean icon.
  2. Click Yes to confirm that you want to clean the custom data table.

Search allows you to search for a contact in the data table. To search for a contact, follow the steps below.

  1. Click on the Search icon.
  2. On the Search Members page, select the field you want to search on from the Select Field to Search By drop down.
  3. Enter the information you are searching on in the Insert Text to Search By field.
  4. Click the Search button.

The search results will appear below the search criteria.  From here, you can click on the Edit Action Item or the Delete Action Item.

Editing a Custom Data Table

Once a Custom Data Table is created, you can edit the table structure as needed. If you are adding or removing a primary key in a populated data table, you will need to empty the data table prior to making this change.  Please follow the steps below to edit the data table.

  1. Locate the Custom Data Table in the Data Table Manager.
  2. Click on the Name of the Custom Data Table.
  3. Once on the properties page, changes can be made.
    • If editing the name of the table, click in the Name field and make the edits.
    • If editing the attributes, click on the Edit Attribute button to make the changes.
    • Once a Custom Data Table Relationship has been established, it cannot be edited.
  4. Click Continue to save your changes.

You are also able to go to the Records page and take action on an individual contact record by editing or deleting the contact. Furthermore, you can use the available functionality to perform additional functions such as importing or exporting the data and splitting the custom data table.

Dynamic Data Tables

Dynamic Data Tables provides you with the ability to filter data from one or more system tables or custom data tables in order to create a table with a subset of contacts.

Creating a Dynamic Data Table

To create a Dynamic Data Table, follow these steps.

  1. On the Data Table Manger page, enter the name of the custom data table in the Create New Data Table field.  The name of the custom data table can only contain characters, numbers, and underscores.
  2. Select Dynamic Data Table as the content type.
  3. Click on Create.

Once the data table has been created, you will be brought to the properties page to create the data fields.

Properties

The top portion of the properties page provides you with the standard information about the custom data table.

Object
Description
Name
The name of the custom data table.
Description A description given to the custom data table.  This field is optional.
Folder Location The location of the data table in the folder tree of the data table manager.
Refresh Table on Sending This enables a refresh of the filter criteria every time the table is used in an email send.  This ensures that the contacts for the table still meet the filter criteria.
Send Email Notifications to If populated, an email notification will be sent to the email address entered in the field.
Records The number of contacts contained within the data table.
Content Type The type of data table.
Created Date The date the data table was created.
Created By The user who created the data table.
Modified Date The date the data table was last modified.
Modified By The user who last modified the data table.

Click Continue to save the dynamic data table and move to the filter step.

Filter & Data Selection

The Filter & Data Selection page allows you create the criteria used to populate the dynamic data table.  The page is divided in two sections: Filters and Table Attributes.

Filters

Filters allow you to build out the rule set that will be used to populate the dynamic data table.  The left hand side consists of the source fields that will be used to create your dynamic data table.  They can either be fields within a System Table or a Custom Data table. You will build the filter on the right-hand side by dragging an element from the Attribute section into the Define Filter section.  From there, you are able to configure the operators and logic for your filter.

Attributes

The Attribute section of the filter area is where you would locate data fields to be used when building your filter.  The data fields available include a predefined set of system tables, as well as, any custom data table within your account.

System Data Tables

System Data Tables is a set of predefined system tables that can be used when defining your filter criteria.

  • Demographics is a system table that provides any data fields that are part of the All Contacts list.  The primary field used within demographics is Email Address.  If primarily using data tables, these fields may not apply.
  • Behaviors consist of several different System Tables that allow you to filter based on actions contacts have taken on an email send.
    • Sent allows you to filter based on emails that have been sent to a contact.
    • Opens allows you to filter based on if a contact has opened or not opened an email.
    • Clicks allows you to filter based on if a contact has clicked or not clicked on an email.
    • Bounces allows you to filter based on the bounce status of a contact.
    • Membership Status allows you to filter on the Global Optin/Out status or List Membership status for contacts.
    • Other allows you to filter on Domains, Categories, or Platforms used by contacts to view an email.
Select Saved Filters

Select Saved Filters allow you to select a filter that has already been created.  If a saved filter is selected, the filter criteria will populate on the Define Filter area.  You can then edit the filter criteria as needed.  To select a saved filter, follow the steps below.

  1. Click on the Select Saved Filters button.
  2. The Select Saved Filter page allows you to locate the filter you will be using.
    1. The most recently created filters are located in the top section.  If you using one of these, simply click the box next to the filter’s name.
    2. The search option will allow you to search through all saved filters.
    3. All saved filters will populate the bottom section, or if searching, your search results will appear here.  Click on the name of the filter in order to create it.
  3. Click Done.

Once the filter is selected, the filter name will populate in the Custom Data Table section and the filter criteria will be within the Defined Filter area.

Select Custom Data Tables

Select Custom Data Tables allows you to select one or more custom data tables to be used in the filter criteria.  To select a Custom Data Table, follow the steps below.

  1. Click the Select Custom Data Table button.
  2. On the Select Table page, either search for the custom data table(s) or use the folder tree to locate the custom data table(s).
  3. Click on the name of the table to be included in the filter criteria.
  4. Click Done.

Once the custom data table(s) is selected, it will appear under the Custom Data Table section.

Creating Filter Criteria

To create filter criteria, drag a data field from the Attribute options and drop it onto the Define Filter area. Once the data field is dropped, you can then select the operator and define the value for that field that you would like to filter. 

You can combine the different filter conditions together with AND/OR logic operators.  By default, the logic operator will be an OR.  The AND/OR logic operators are located in a button on the far-right side of the Define Filter Area. To change the logic operator, click on the button.

Filter conditions can also be combined in order to define a hierarchy of the conditions.  Follow the steps below to create a group filter condition.

  1. To group filter conditions, a minimum of three data fields must be present in the Define Filter Area.
  2. Place your mouse at the end of the grouping before the AND/OR logic operator button until a gray button appears.
  3. Click on the gray button to create a grouping. 
  4. Once a grouping is created, an additional AND/OR logic operator option will appear.  This can be changed as needed to meet the filter conditions.

You can review the query logic that will be used when running the dynamic data table within the Query Preview under the filter logic.  You are also able to save your filter to use again by checking the Save filter as option and providing a name for the filter.  The saved filters can be found in the Saved Filters option under Contacts.

Table Attributes

Within the Table Attributes section, you are able to define which fields you would like to include for the dynamic data table from the Source Tables option. This includes data fields from System Tables and the ability to select Custom Data Tables.

System Data Tables

The System Data Tables house all system tables and their data points.  In order to view the available system tables, click the System Data Table bar.  From here, you can click on the bar of any of the data tables to see the available fields for output.

Select Custom Data Table

If a Custom Data Table was used in the filter criteria, it will be available in the Source Tables.  Click on Custom Data Tables bar to view the data table.  Click on the name of the Custom Data Table to see any available data fields. 

If you would like include data fields from other custom data tables, they must first be added to the Source Tables options. To select Custom Data Tables, follow the steps below.

  1. Click the Select Custom Data Table button.
  2. On the Select Table page, either search for the custom data table(s) or use the folder tree to locate the custom data table(s).
  3. Click on the name of the table to be included in the filter criteria.
  4. Click Done.

Once the Custom Data Table(s) is selected, it will appear under the Custom Data Table bar.

Selecting Fields to Output

To select fields for output, follow the steps below.

  1. Select one or more data fields from the Source Table.  If selecting all of the data fields from a Custom Data Table, use the Select All option.
  2. Click on the Arrow button.
  3. One the Manage Column Name page, you can enter a new name of the field to be used in the dynamic data table and sent a primary key(s) on any of the fields.  Click Done once finished.
  4. Data Fields will then populate the New Dynamic Table box.

If you decide that you no longer want to output certain fields, they can be removed from the New Dynamic Table box by clicking on their name and then clicking on the left arrow.

Managing Columns will allow you to adjust names of the data fields and the primary key assignment.  To adjust these settings, click on the Managing Columns button and adjust any information as needed.  Once complete, click Done and the changes will be applied.

In order to ensure your Dynamic Data Table can be used in an email send, you will need to set the sending properties.  To do so, select one or more of the following options located at the bottom of the Table Attributes section.

  • Available for Email Sending will ensure that you can send to your dynamic data table.  Once checked, you will also need to define the recipient key for the table by clicking on the Edit option.
  • Email Testing will ensure that you can use your dynamic data table while testing your emails.
  • GDPR indicates that the data table contains contact information as outlined by the General Data Protection Regulation (GDPR).  This field will need to be enabled for all data tables that contain data that is outlined by GDPR in order for iPost to process any GDPR removal requests.

Once your filter criteria has been built and your table attributes set, you can click Continue to move onto the next step.

Relationships

Relationships allow you to relate disparate system or custom data tables together based on a common data field.  This step is required if using more than one system or custom data table.  Persistent relationships that have already been created for the tables selected in your filter will automatically be displayed if they are already created.  Otherwise, relationships will need to be created before your filter results can be compiled.  If filtering on sendable custom data tables only, a relationship will automatically be created using the sendable column for the custom data tables.  Remember that all the tables being used for the filter and for the resulting Dynamic Table will need to be linked together by a number of relationships that is equal to the number of tables involved minus one.

Creating a Relationship

To create a relationship, follow the steps below.

  1. Click on the Add Relationship button.
  2. Enter a name in the Insert Relationship Name field.
  3. Click the Persist relationship option if you would like to save the relationship.
  4. Select the First System or Custom Data Table from the Select Table dropdown.
  5. Select the Common Data field in the Select Attribute dropdown below it.
  6. Select the 2nd System or Custom Data Table from the second Select Table dropdown.
  7. Select the Common Data field in the second Select Attribute dropdown below it.
  8. Click on the Add Relationship button if another relationship is needed.
  9. Click Continue when done.

Records

The results of your filter criteria will appear on the Records Preview page.  It will include all contacts that meet the filter criteria and all output fields selected. Click on the Save button to apply any primary keys and to save the results to the dynamic data table.  If you leave the page before Save is applied, your data table will be empty.

Once the Record page is populated, additional icons will be available.

Refresh

Refresh allows you to refresh the filter in order to update the results.

Export

Export allows you to export the contacts in the custom data table.  If the custom data table contains more than 100K contacts, the export file will be pushed to the FTP to be retrieved; otherwise the export file will download in the browser.

Clean

Clean will empty the results from the dynamic data table.  The results can be populated again by refreshing the filter.

Coupon Data Tables

Coupon Data Tables allow you to store coupon codes that can be automatically added to email sends.

Creating a Coupons Data Table

Follow the steps below to create a Coupon Data Table.

  1. On the Data Table Manager page, enter the name of the Coupon Data Table in the Create New Data Table field. The name of the coupon data table can only contain characters, numbers, and underscores.
  2. Select Coupons Data Table as the Content Type
  3. Click on Create

Properties

The top portion of the properties page provides you with the standard information about the Coupons Data Table.

Object Description
Name The name of the Coupon Data Table
Description A description given to the Coupon Data Table. This field is optional
Folder Location The location of the Coupon Data Table in the folder tree of the Data Table Manager
Records The number of coupon codes contained  within the data table
Content Type The type of data table
Created Date The date the data table was created
Created By The user who created the data table
Modified Date The date the data table was last modified
Modified By The user who last modified the data table

Attributes

The attributes for a Coupons Data Table are created automatically. The only change that can be made to the default values of the Coupons Data Table is the name of the data field. All other values are fixed and default values cannot be used. Only the coupon code field is required in order to use Coupons and only one coupon code field can exist in the table. The standard field types are listed below.

Data Field Description
coupon_code The field that will hold the coupon codes to be inserted into the email. This field has a max length of 250 characters. As this is the Primary Key for the data table, all codes imported must be unique
contact_id The ID of the contact to which the coupon was sent. This field will be populated once the coupon code has been inserted and sent to a contact.
assigned_timestamp The time at which the coupon was sent to a contact. This field will be populated once the coupon code has been inserted and sent to a contact.
email The email ID in which the coupon was sent. This field will be populated once the coupon code has been inserted and sent to a contact.
mailing_id The mailing ID for the Email Ticket. This field will be populated once the coupon code has been inserted and sent to a contact.
redeemed The field can be used to mark the coupon as redeemed.

You can also add additional attributes to your Coupons Data table. To add additional attributes, follow the steps below:

  1. Click on the Edit Attributes button
  2. Click on the Add New Attribute button on the Edit Attributes page
  3. Enter the Attribute Information
    • Name: This is a required field and is the unique identifier for the table. It can contain only characters, numbers, and underscores.
    • Data Type: This field is required and sets the data type for the field. Please see the Reference section for available data types.
    • Default Value: This is an optional field. If no value is present during the import of data, the default value is applied to the contact.
    • Required: This indicates that the data field is required when new data is added to the table. If there is an empty value for this column, the records will be rejected.
    • Primary Key: This indicates that the field is a unique identifier for the contact records in the table. The field is used when adding and updating data in the table.
    • Post Code: This is optional field.  If checked, the column will denote that the field contains postal codes. This field should be checked if the Coupon Data Table is being used in a Dynamic Data Table for a postal code radius search.
    • Post Code Validation: This is an optional field. If checked, the platform will perform a validation on the postal code field.
    • Coupon Codes: This field is required and serves to indicate that the field contains the coupon codes. Only one coupon code field is allowed per Coupons Data Table.
  4. Once all data fields are entered, click on the Save button.

Custom Data Table Relationships

Custom Data Table Relationships allow you to establish a relationship between your new custom data table and an existing custom data table. The relationship can then be used in dynamic data tables. To create a Custom Data Tables Relationship, please follow the steps below.

  1. Click on the Add Relationship button.
  2. Enter the name for the relationship on the Insert Relationship Name field.
  3. The name of the current custom data table will prepopulate the first data table field.
  4. Select the field from the current data table that you will be using for the relationship.  Normally, this is a field in the existing data table of the same type.
  5. Select the existing data table from the Select Table field.
  6. Select the field from the existing data table that you will be using for the relationship. NOrmally this is a field in the current data table of the same type.
  7. Click on Add Relationships

Coupon Table Management

Coupon Table Management allows you to create rules for the behavior of Coupons when the number of available coupon codes is limited or non-existent. These rules can be used in conjunction with each other or separately depending on your use case. The available options are below.

  • Configure email notifications when available coupons are under specific threshold. To enable this feature, check the box next to the Send Email Notification option, enter the email address to receive the notification, and set the threshold for unclaimed coupon codes
  • Return empty values for coupon codes and allow sends to continue will continue to send the email but no codes will be inserted. This will result in blank values appearing in your emails where the coupon code would populate.
  • Autogenerate more coupon codes will autogenerate additional coupon codes based on the options you select and populate them into the Coupons Data Table. This will allow for the email to continue sending and coupon codes to be inserted. This option is selected by default. The coupon component definitions for the autogeneration of codes are listed below.
Coupon Component
Definition
Number of Partitions Defines the number of sections with the coupon code. All coupon codes have a minimum of 1 partition.
Partition Length Defines the number of characters allowed for each partition. If 1 partition is being used, the default length is 5 characters.
Separator Defines the character that will be used to separate the partition
Prefix Defines any value that will be prepended to the coupon code.
Characters Available Defines the types of characters that will be used when autogenerating the coupon code. By default, all options are enabled.

Once all the information has been entered on the properties page, click on Continue to save your Coupons Data Table and proceed to the Records page.

Records

The Records page is where you can access the coupon codes housed in the Coupons Data Table. When the Coupons Data Table is created, the Records page will be blank and the coupon codes will need to be added to the table.

There are several ways to add coupon codes to the table. They can be added via the API, imported from a data file, or be autogenerated via the UI.

Import

To manually import a data file, follow the steps below:

  1. On the Records page, click on the Upload icon
  2. Select how you would like to locate your data file.
    • Browser Upload will allow you to upload a file on your PC. The data file must be smaller than 19.5MB if this option is used.
    • FTP Upload will allow you to select a file that is located in the CDT_IN folder on your FTP site.
  3. Check the Expect large data box if the large text data field is in use. This will default the delimiter to Tab and enforce the Respect double quotes as a text qualifier option
  4. Select the delimiter of the data file
  5. Select the Import options for the data import
  6. Select the Record Operation. The options available in the drop down will vary depending on the data structure of the custom data table.
    • Overwrite Existing Records will replace data currently in the table with data from the data file
    • Only Update Existing Records will only update any coupons associated with the data table and will reject any new contacts
    • Add Only New Records will add new coupons from the data file but will not update any existing coupons
    • Add New & Update Existing Contacts will add new coupons and update any coupons associated with the data table.
  7. Click Next
  8. On the Map Records step, you will need to map the fields on the data file to the attributes for the data table. Any fields that match the data table attributes will be mapped automatically. If you do not want to map a field, select Ignore this column.
  9. Click Finish

The import will run in session and you will be notified when it has completed with an import notification. The notification will provide you with a total number of records added or updated, as well as a total of the records that were rejected. You will also be able to download the rejected records. The rejected record file includes a column with the reason as to why the contact was not imported.


Once the import has completed, the Coupons Data Table will be populated with the coupon codes. You will be able to see the coupons and data for any additional attributes created for the table. You also have the option to edit or delete a coupon within the Action column.

  • Edit will allow you to edit a coupon and any data values related to that coupon. Once edited, these changes will be updated in the coupons data table.
  • Delete allows you to delete a coupon and any data related to the coupon. Once deleted, the coupon will no longer exist in the custom data table. Deleted coupons are unable to be recovered after the delete has been completed.

Generate Coupons

Generate Coupons allows you to generate a large number of coupon codes within your table without the need of importing any data. You are able to configure the number of coupon codes that will be generated, as well as the format of those codes. To generate coupons, follow the steps below:

  • Click on the Generate Coupons icon
  • On the Generate Codes page, enter the number of coupons that will be generated
  • Enter the required information to define the format of the coupon codes
  • Click Generate

The coupon code generation will run in session and the table will be locked while the coupon codes are created.

Within the Coupons Data Table, other functionality is available using the icons located on the left-hand side above the contact information.

Split

Split allows you to separate the coupons data table into multiple tables. To split the table, follow the steps below:


  1. Click on the Split icon
  2. On the Split Table page, select the number of branches you would like the list split into. The default number of branches is 2.
  3. Select how you would like the table to appear by determining how to divide the contacts into the new branches
    • Numbers allows you to split the list by a specific quantity per branch
    • Percentage allows you to split the list by a specific percentage per branch
  4. In order to distribute the contacts to the new branches, slide the blue circle for each branch until the correct quantity or percentage is reached.
  5. Click Split
  6. The new custom data tables will be located in the same folder as the custom data table that was split. The resulting data tables will have a split letter (A, B, C, etc) and date and time appended to the custom data table name.

Export

Export allows you to export the data from the coupons data table. If the table contains more than 100K contacts, the export file will be pushed to the FTP to be retrieved; otherwise, the export file will download in the browser. To export a coupons data table, follow the steps below:

  1. Click on the Export icon
  2. If the table has more than 100K records, you will be able to enter you email address to receive a notification when the export has completed. Enter your email address into the Send a Data Export Summary Report To box. If no email address is entered, you will not be notified when the export is completed. All exported CDT files are located in the CDT_Out folder on the FTP site. If the table has less than 100K records, then the file will download in your browser.

Clean

Clean allows you to remove all data from the coupons data table. Please note that once a data table has been cleaned, the contacts cannot be recovered to repopulate the data table. To clean a data table, follow the steps below:

  1. Click on the Clean icon
  2. Click Yes to confirm that you want to clean the custom data table

Search

Search allows you to search for data in the coupons data table. To search the table, follow the steps below:

  1. Click on the Search icon
  2. On the Search Members page, select the field you want to search on from the Select Field to Search By drop down
  3. Enter the information you are searching on in the Insert Text to Search By field
  4. Click the Search button

The search results will appear below the search criteria. From here, you can click on the Edit action item or the Delete action item.

Editing a Coupons Data Table

Once a Coupon Data Table is created, you can edit the table structure as needed. If you are adding or removing a primary key in a populated data table, you will need to empty the data table prior to making this change. Please follow the steps below to edit the data table.

  1. Locate the Coupon Data Table in the Data Table Manager
  2. Click on the Name of the Coupon Data Table
  3. Once on the properties page, you can make changes
  4. If editing the name of the table, click the Name field and make the edits.
  5. If editing the attributes of the table, click on the Edit Attribute button to change the name of the attribute.
  6. Once a Custom Data Table Relationship has been established, it cannot be edited
  7. Click Continue to save your changes

You are also able to go to the Records page and take action on an individual coupon record by editing or deleting the record. The available functionality can be used as well in order to perform additional imports and exports of the data, along with splitting the coupons data table.

Reference

Data Types

Column Type
MySQL Type and Length
Notes
Date & Time Datetime Format: 'YYYY-MM-DD HH:MM:SS'
Decimal Decimal (16,4)
Email Varchar (255)
Integer Int (10) Value range: -2147483648 - 2147483647 (not bigint)
Long Text Text

"Long text" columns cannot part of a Primary Key

"Long text" columns cannot participate in relationships
Monetary Decimal (9,2)
Short Text Varchar(255
Boolean Tinyint(1) Values:1/0
Large Text
Used when importing large data sets such as HTML. The use of this data type will require that data files be tab delimited.

Operators

Below is a list of available operators for dynamic data tables.

Data Type
Operator
Text
Is / Is Not
Contains / Does Not Contain
Number Equal To / Not Equal To
Less Than
Greater Than
Between
Like / Not Like
Begins With
Ends With
Boolean Is 0
Is 1
Date Is Equal / Is Not Equal
Is After
Is On or After
Is Before
Is On or Before
Is Null / Is Not Null
Matches Day
Matches Month
Matches Day and Month
Matches Year
Radius Search Zip Code