Segments

Overview

Segments are groups of consumers that share common characteristics, such as demographics or patterns in interaction history. In the Engagement Data Platform, Segments are used for targeting promotions, offers, and communications, as well as to manage eligibility to be contacted. Segments may be used in rule conditions as well.

The Segmentation Engine can query consumer data based on any information in the consumer interaction profile, then create an "Audience" consisting of the desired group of individuals. The Segmentation Engine is completely dynamic: consumers may enter or exit Segments in real-time based on their profile changes or most recent interactions.

The Cheetah Learning portal provides access to a wide range of training videos on how to use Cheetah Digital's products. Click here to view a training video on how to use Segments. Please note that you must have a free Cheetah Learning user account in order to access this video.

Segment Computation

EDP uses two broad categories of Segment computation:

For One Customer: All Segments are computed for a customer on demand whenever the customer's eligibility needs to be determined. This process ensures that a customer's Segment definition is dynamic and up-to-date. As soon as a customer performs an activity, they may enter or exit Segments.
For All Members: While the previous computation keeps a single active customer's Segments up-to-date, certain batch scenarios (such as sending emails) require the refresh of Segment membership for all customers. A Segment may be manually computed by using the "Refresh Members" action within the Results tab of the Segment Details screen.

In addition to the two computation modes, the platform also supports the concepts of Dynamic and Static Segments.

A Dynamic Segment will immediately add or remove individuals in real-time, whenever their attributes or activity history changes. Every API call will cause the platform to re-evaluate the individual referenced in the API, and determine their inclusion in Dynamic Segments.

A Static Segment is evaluated only when the marketer manually refreshes the Segment, or when the system performs batch processing, such as a message deployment or a Batch Job.

Execution Types

When you're creating a new Segment, you'll be prompted to select an Execution Type. The options available are as follows.

EDP (Engagement Data Platform): This Execution Type uses aggregated data, and does not support dynamically-calculated Segments. The EDP Execution Type is primarily intended for use cases where you need to calculate all the individuals that belong in a particular Segment. A common use case for EDP Segments would be email sends, where you're using a Segment to identify the audience of email recipients. EDP is the default Execution Type when you create a new Segment.
Golden Record: This Execution Type uses a "wide row" design, meaning that everything about an individual is available within a single row. This method is primarily intended for use cases where you need to calculate to which Segments a single individual belongs. The Golden Record Execution Type supports dynamic Segments that are computed as needed, such as for website personalization. The Golden Record Execution Type also supports the use of custom Groovy code if you need to define more sophisticated logic.

Access

To access the Segments screen, select Audiences from the Main Navigation Menu, then select Segments from the Sub-Category menu.

Additional Resources

Audiences Quick Start Guide

Features

Working with Segments

The Segments screen provides the following features related to managing your Segments:

Searching and Sorting

Click hereClick here

Search

The search feature allows you to search for a specified text string anywhere within the following Segment fields: Display Name, Internal Name, Status, Tag, Category label, or Category name.

Optionally, in the search field near the top of the Segments screen, enter the desired text string.
Optionally, to filter the Segments by Status, from the "Status" drop-down menu, select a Segment status (or "Any status").
Optionally, to filter the Segments by effectivity, from the "Effectivity" drop-down menu, select a Segment effectivity (or "Any effectivity").
Optionally, to filter the Segments by Tag, click a Segment Tag from the pane on the right-hand side of the screen.
Press Enter, or click the search button (magnifying glass icon).
The Segments screen is refreshed to show only the Segments that meet your search criteria. Please note that if you enter multiple search criteria, the platform displays only the Segments that meet ALL criteria.
To remove all search criteria, click the remove button ("X" icon).

Sort

The "Sort" drop-down menu allows you to sort the Segments on a variety of different fields. To sort the list of Segments, select the desired sort option from this menu.

Segment ID (default)
Name
Created Date
Updated Date

Navigation

Once you've found the desired Segment, you can navigate to the following other screens:

Click the name of the Segment to navigate to the Segment Details screen.

Create a New Segment

Click hereClick here

To create a new Segment with an Execution Type of "EDP:"

In the "Enter Display Name" field, enter the Display Name value for the new Segment.
Click create. The Segment Details screen is displayed, with the Rules tab selected.

Note: By default, a new Segment will have an Execution Type of EDP. If you want to make a Golden Record type Segment, you'll need to create a new Segment, then edit the Segment properties to switch it to Golden Record. See Segment Details for more information.

View or Edit a Segment

Click hereClick here

To view or edit the details of a Segment:

Search, sort, or filter the Segment screen as described above.
Click on the desired Segment record.
The Segment Details screen is displayed and populated with all of the information about this Segment. See Segment Details for more information.

Deploy Segment Metadata

Click hereClick here

After you've created a Segment and defined its rules for selecting customers, you must deploy the Segment metadata.

If you have changed Segments in your account that haven't yet been deployed, a warning message is displayed at the top of the Segments screen. When you deploy the segment metadata to the server, the process automatically deploys the metadata for ALL modified Segments.

From the "Actions" menu in the top-right corner, select "Validate Segments Metadata."

Note: You can deploy metadata immediately, but the best practice is to validate the Segment logic before deploying metadata to ensure no incorrect expression code gets deployed to the server that could cause issues.

If the validation step passes, you'll see a message that says, "Segments metadata is valid." If the validation step fails, you'll receive an error message; review and correct your Segment expressions, then retry the validation step.
Click deploy segments metadata.
A confirmation dialog box is displayed; click confirm.
If the deployment was successful, you'll see a message that says, "Segments metadata has been deployed."

View Deployed Segment Metadata

Click hereClick here

To see the details of what Segment metadata has been deployed:

From the "Actions" menu in the top-right corner of the screen, select "View Deployed Segments." The "View Snapshot" pop-up window is displayed.
Click the plus-sign to expand the message to view additional details, such as the total number of deployed Segments. You can also drill in deeper, to see details of each deployed Segment (Segment name, logic, included customers, etc.).
When finished, click the "X" icon to close the pop-up window.

Exporting Segment Data

The Segments screen provides the following features related to exporting Segments.

Create Export Definition

Click hereClick here

Export definitions can optionally be saved and reused, when you need to download Segments from EDP.

From the "Actions" drop-down menu in the top-right corner of the screen, select "Export Segments." The "Create New Export - Segments" pop-up window is displayed.

Info

In the "Label" field, enter a name for the export file.
The "Internal Name" is automatically populated based on the "Label" value. This field is uneditable by default. To edit the Internal Name, check the "Edit Internal Name" check box. A confirmation dialog box is displayed; click ok. Edit the Internal Name value.
In the "Description" field, optionally enter a description of the export file.
Select a column separator -- comma or semicolon.

Timing

Select when you want to execute the export:

Asynchronous -- check this option if you want to execute the export manually on an ad hoc basis.
Execute now -- check this option if you want to execute the export immediately.
Create schedule -- check this option if you want to define a schedule (either a one-off execution, or a recurring schedule).

If you checked "Create schedule" above, the schedule options are displayed.

Define Export ScheduleDefine Export Schedule

To define the export schedule:

From the "Recurrence" drop-down menu, select an option:

Repeat -- Execute the export based on the defined schedule; see below for more details.
Once -- Execute the export once. In the "Execute once on" field, enter the date and time. Select the time zone from the "Time Zone" drop-down menu.
On demand -- Execute the export when specified by a user. In the "Execute once on" field, enter the date and time. From the "Time Zone" drop-down menu, select the time zone to use.

Define a Repeating Schedule

From the "Schedule Composer" drop-down menu, select a unit of time -- every minute, hour, day, week, month, or year.
Optionally, check "Advanced" to enable the "CRON expression" text field, and enter a custom CRON expression.
In the "From" and "To" field, enter the start date and time, and the end date and time, for the repeating schedule.
From the "Time Zone" drop-down menu, select the time zone to use.

Notification and Transport

If you checked "Asynchronous" above, this section is displayed.

To send email notifications when the import process is successful, enter one or more email addresses in the "Success Email Recipients" text field.
To send email notifications if the import encounters an error, enter one or more email addresses in the "Error Email Recipients" text field.

Fields

This section allows you to optionally include (or exclude) specific columns in the export file.

From the "Inclusion" drop-down menu, select an option:

All -- include all columns in the export file.
Only Included -- in the "Fields" field, select one or more columns you want to include in the export file.
Except selected -- in the "Fields" field, select one or more columns you want to exclude from the export file.

Rules

This section allows you to create custom business rules to define which Segments are included in the export file.

Click the Add icon, then select Add Rule. The platform adds a new blank row for defining the Rule Condition.
From the first drop-down menu, select the desired Attributes. This menu is populated with all of the different Attributes for building a condition.
Select a mathematical operator. The available operators will vary based on the data type of the selected Attribute.
Enter or select a value.
Some attribute types allow you to define additional criteria, such as a date range, or a channel type, for example. Select or enter the additional criteria.
Repeat the above steps as needed to define more Rule Conditions. If you need to delete a Rule Condition, click the Delete icon to it.
Once you define more than one Rule Condition, select the logical operator. From the "Include customers that meet" drop-down menu, select either:

All of the following: The conditions are processed with a logical 'AND' operator such that all conditions must be true for an individual to be selected by this Segment.
Some of the following: The conditions are processed with a logical 'OR' operator such that at least one of the conditions must be true for an individual to be selected by this Segment.

You can also group rules by selecting Add Rule Group from the Add icon. Rule Groups have their own internal logical operator.

Children

To export child records joined to the Segments:

Click add. A new row is displayed.
Check "Enabled."
From the "Child" drop-down menu, select a child record type.
From the "Inclusion" drop-down menu, select an option:

All -- include all columns in the export file.
Only Included -- in the "Fields" field, select one or more columns you want to include in the export file.
Except selected -- in the "Fields" field, select one or more columns you want to exclude from the export file.

Repeat the above steps needed to include more associated records. To remove an association, click the delete icon next to it.

Finish

When finished creating the Export Definition, click save.

View or Edit an Export Definition

Click hereClick here

To view or edit a Segment Export Definition:

From the "Actions" drop-down menu in the top-right corner of the screen, select "Segments Exports." The "Segment Export Definitions" pop-up window is displayed and populated with a list of all Segment Export Definitions.
From the "Action" column of the desired Export Definition, click the Edit icon. The "Edit Export" pop-up window is displayed.
Make any necessary changes to the Export Definition properties.
When finished, click save.

Manually Execute an Export Definition

Click hereClick here

To manually execute a Segment Export Definition:

From the "Actions" drop-down menu in the top-right corner of the screen, select "Segments Exports." The "Segment Export Definitions" pop-up window is displayed and populated with a list of all Segment Export Definitions.
From the "Action" column of the desired Export Definition, click the Enqueue this Export icon. A confirmation dialog box is displayed.
Click confirm.

Download an Export Definition

Click hereClick here

To download the last execution of an Export Definition:

From the "Actions" drop-down menu in the top-right corner of the screen, select "Segments Exports." The "Segment Export Definitions" pop-up window is displayed and populated with a list of all Segment Export Definitions.
In the "Action" column of the desired Export Definition, click the Download File icon. The platform downloads the file to your PC.

Delete an Export Definition

Click hereClick here

To delete a Segment Export Definition:

From the "Actions" drop-down menu in the top-right corner of the screen, select "Segments Exports." The "Segment Export Definitions" pop-up window is displayed and populated with a list of all Segment Export Definitions.
From the "Action" column of the desired Export Definition, click the Delete icon. A confirmation dialog box is displayed.
Click confirm.

Back to Audiences Overview

Last Updated: April 2022