Skip to main content

Build a Segment

Note

This article covers segment building in Connect with Asset Management 2.0. For information on the differences between segment building in this version and Connect with Asset Management 1.0, see "What's Different in Connect With Asset Management 2.0".

You can use the Segment Builder to build a segment from the the following types of data assets in your account:

  • Segments (including all members of the segment)

  • Table attribute fields

  • Entire tables (including all members of the table)

You build the segment by constructing a series of filter rules, using individual filters rules and/or filter groups (groups of filter rules joined by the same "AND" or "OR" conjunction).

When building a new segment from your first-party data assets, you also view the overlaps between the new segment and your other data assets (for more information, see "Overlap Data Assets".). You can also choose to split the segment into multiple segments (for purposes such as test and control).

Once you've built a segment, that segment appears on the Segments page. You can then distribute that segment to your desired destinations (for more information, see "Distribute Data to a Destination").

Guidelines for Building Segments

When building segments with the Segment Builder, keep the following guidelines in mind:

  • If you plan on creating a complex segment statement, we recommend you plan out your segment in advance to make segment building easier.

  • When creating a rule group:

    • If the first rule uses a table attribute, all other rules in the group must use attributes from the same table

    • If the first rule uses a built segment, all other rules in the group must use built segments.

  • For information on the various elements of the Segment Builder and how to use them, see "Segment Builder Concepts".

Build a Segment with the Segment Builder

To build a segment with the Segment Builder:

  1. From the Quick Actions drop-down list in the navigation pane, click Build Segment to open the Segment Builder.

    CU-Build_Segment_quick_actions_button.png
    C2_0-Segment_Builder_overview.png

    Note

    You can also open the Segment Builder from the Segments page by clicking Build Segment or from the home page by clicking the "Build Segment" tile.

  2. From the "Include all of the following rules:" area, click one of the following options:

    LR1-Build_A_Segment-Rule_options_Level_1.png
    • To create an individual filter rule, click Add Rule. The Segment Builder displays a data asset dropdown with categories for datasets, built segments, and events.

    • To create a filter rule group out of multiple filter rules at the same level where all rules will be joined by the same conjunction, click Add Rule Group. The Segment Builder displays data asset selection fields for two filter rules joined with the conjunction "AND". If desired, you can change the conjunction to "OR".

  3. From the data asset dropdown, expand the list of datasets (to see the tables within each dataset, along with their table attributes) or built segments and select the desired data asset to use to build the segment from (table attribute example shown):

    Note

    • When you expand a table, you'll see options to select the individual table attribute columns, in addition to being able to select the entire table.

      CU-Build_Segment-select_table_attribute.png
    • When you hover over an individual data asset, a side panel appears with information about that asset (such as date created, date modified, owner, and more).

      CU-Build_Segment-advanced_select_side_panel.png
    • When you select a table attribute, fields for the operator and value are displayed.

      LR1-Build_A_Segment-attribute_additional_fields.png
    • When you select a table, all members of the table are included in the filter rule (no fields for operator or value are displayed).

    • When you select a segment, all segment members are included in the filter rule and the segment size in maintained RampIDs appears to the right of the segment name (no fields for operator or value are displayed).

      LR1-Build_A_Segment-segment_with_size.png
  4. If you've selected a table attribute, complete the filter rule:

    Note

    If you selected a segment, an event, or all members of a table in the previous step, skip this step.

    1. From the operator list, select the desired operator.

      LR1-Build_A_Segment-Operator_field.png

      Note

      The options available vary depending on the field type of the attribute you've selected. For more information, see "Available Filter Operators for the Segment Builder".

    2. In the value field, enter or select the values to filter on (entered values can contain spaces).

      LR1-Build_A_Segment-Value_field.png

      Note

      • For certain operators, such as "has a value", no value field will appear.

      • For string field types, when you select either the "is" or "is not" operator, the available attribute values appear as check boxes in the value field after a few seconds (a loader appears under the field while value loading is processing) and you can select multiple values.

      • For the field types "numeric" and "integer", the range and average values for the field are displayed below the value field in the Segment Builder to give you insights into the values that field contains (during the calculation process, you'll see a spinner and the text "Range being calculated").

        DCP-Build_a_Segment-range_calculation.png
  5. To see the number of RampIDs in the current version of the segment, click the "Calculate" text.

    C2_0-Build_a_Segment-Calculate_button.png

    Note

    • Any incomplete filter rules will be removed to perform the calculation.

    • Each time the filter rules are changed, you will have to click the "Calculate" text again to see the updated segment size.

  6. To view the overlap between the current segment and other data assets in your account, click Add Data to Overlap and select the desired asset to overlap (for more information, see "Overlap Data Assets").

    Note

    • You can only view overlaps when building a segment from your first-party data assets.

    • You can only select your first-party segments and tables that are not in an error or pending status. You cannot select a user-defined function or a segment or table that is an error or pending status to perform an overlap.

    • If you modify the current segment, you will need to click the "Calculate" text again to see the updated overlaps.

    C2_0-Build_a_Segment-Overlap_button.png
    C2_0-Build_a_Segment-Overlap_asset_selection.png
  7. To include additional filter rules or rule groups, perform one of the steps below (in either the are to include or the area to exclude) and then populate the appropriate fields:

    Note

    • To delete an individual filter rule, click the More Options menu (the three dots) that appears to the right of the rule when you hover over the rule and then click Remove Rule.

    • You can only select assets that are contained in the same dataset as your initial selection.

    • To delete an entire rule group, click the More Options menu (the three dots) that appears to the right of the rule when you hover over the rule and then click Remove Entire Group.

    • If you initially added an individual filter rule, you can create a filter rule group using that first filter rule by clicking the More Options menu (the three dots) that appears to the right of the rule when you hover over the rule and then clicking Turn Into a Rule Group.

    • If you initially added a filter rule group, populate the second filter rule.

    • To create an additional filter rule or rule group at the same level as the first filter rule, click either Add Rule or Add Rule Group outside of the first filter rule box.

    • To create a filter rule group nested within the first filter rule, click Add Rule Group inside of the first filter rule box.

    Note

    For more information on managing filters and filter rule groups, see "Managing Filters and Filter Rule Groups".

  8. If necessary, click the caret next to a conjunction (an "And" or an "Or") to adjust that conjunction to create the desired segment statement.

    Note

    The conjunction you set at a particular level will be the same for all of the conjunctions at that level.

  9. In the Segment Name field, enter a unique name for the segment.

    Note

    • Segment names must start with a letter and can contain letters, numbers, spaces, and underscores. Segment names cannot contain special characters, except for commas or >, <, -, _, %, and *.

    • By default, segment names for segments that contain Clean Room purchased data start with the clean room name, followed by "> Custom >".

    • The maximum length of a segment name is 90 characters.

  10. If desired, enter a description in the Segment Description field.

  11. If desired, you can randomly split the segment into multiple parts (for test and control, or other purposes), based on the number and percentages you specify, by sliding the Split Segment Into toggle to the right (for more information, see "Split a Segment Into Multiple Parts").

    C2_0-Build_a_Segment-split_segment_toggle.png
  12. When you're finished building the segment, click Build Segment.

    Note

    If there are any incomplete filter rules (filter rules that were added but haven't been completed), a dialog will appear to confirm that you want to remove the incomplete filter rules before saving.

A success message appears. You can view the segment on the Segments page. Once the segment's status is "Ready", you can activate it at your desired destinations (for more information, see "Distributing Data").

Note

Some segments might not immediately succeed at the segment creation step. Segment creation will be retried several times and show a status of "Processing" during that time. If the segment fails to create after the attempts to retry creating it, it will show a status of "failed" once the retries have completed. If the segment fails to create, contact your LiveRamp account representative.

If the segment consists entirely or your organization's first-party data, you can edit the segment rules once the segment has a status of "Ready" or "Creation Failed". For more information, see "Edit a Segment".