Skip to content

Updated Linked Audiences Dynamic Reference/Entity Conditions #7135

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Oct 10, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 16 additions & 10 deletions src/engage/audiences/linked-audiences.md
Original file line number Diff line number Diff line change
Expand Up @@ -96,7 +96,7 @@ at most: supports 0 or greater.

*When filtering by 0, you can’t filter on by entity properties or on additional nested entities.

#### Operator Selection
#### Operator selection

You can create audience definitions using either `AND` or `OR` operators across all condition levels. You can switch between these operators when filtering on multiple entity or event properties, between conditions within a condition group, and between condition groups.

Expand All @@ -112,18 +112,24 @@ This information appears when you click the user profile generated from the audi

![A screenshot of the Entity Explorer.](/docs/engage/images/entity_explorer.png)

#### Dynamic References
#### Dynamic references

**Event Conditions**
**Event conditions**

When filtering on event properties, you can dynamically reference the value of another profile trait, or enter a constant value. These operators support dynamic references: equals, not equals, less than, greater than, less than or equal, greater than or equal, contains, does not contain, starts with, ends with.

**Entity Conditions**
**Entity conditions**

When filtering on entity properties, you can dynamically reference the value of another entity column (from the same entity branch at the same level or above it), profile trait, or enter a constant value. You can only dynamically reference properties of the same data type. Dynamic references are supported for specific operators depending on the data type, as in the following table:

| Data Type | Supported Operators |
| --------- | -------------------------------------------------------------------------------------- |
| NUMBER | equals, not equals, less than, greater than, less than or equal, greater than or equal |
| STRING | equals, not equals, contains, does not contain, starts with, ends with |
| DATE | equals, not equals, less than, greater than, less than or equal, greater than or equal |
| TIME | equals, not equals, less than, greater than, less than or equal, greater than or equal |
| TIMESTAMP | equals, not equals, less than, greater than, less than or equal, greater than or equal |

When filtering on entity properties, you can dynamically reference the value of another entity column (from the same entity branch at the same level or above it), profile trait, or enter a constant value.You can only dynamically reference properties of the same data type. Dynamic references are only supported for certain operators depending on the data type:
NUMBER data type: equals, not equals, less than, greater than, less than or equal, greater than or equal
STRING data type: equals, not equals, contains, does not contain, starts with, ends with
TIMESTAMP data type: equals, not equals, less than, greater than, less than or equal, greater than or equal

## Step 2: Activate your Linked Audience

Expand Down Expand Up @@ -179,7 +185,7 @@ After you select an action, Segment attempts to automatically configure the data

Select additional traits and properties to include when the event is sent.

#### Show/Hide preview
#### Show/hide preview

As you're enriching your events in Linked Audiences, you should view a preview of the event payload schema based on the properties you select. It might look like the following:

Expand Down Expand Up @@ -238,4 +244,4 @@ Delivery Overview shows you four steps in your data activation pipeline:
- **Events from Audience**: Events that Segment created for your activation. The number of events for each compute depends on the changes detected in your audience membership.
- **Filtered at Destination**: The activation pipeline is rich with features that let you control which events make it to the destination. If any events aren't eligible to be sent (for example, due to destination filters, insert function logic, and so on), Segment will show them in Filtered at Destination.
- **Failed Delivery**: Events that Segment attempted but failed to deliver to your destination. Failed Delivery indicates an issue with the destination, like invalid credentials, rate limits, or other error statuses received during delivery.
- **Successful Delivery**: Events that Segment successfully delivered to your destination. You'll see these events in your downstream integration.
- **Successful Delivery**: Events that Segment successfully delivered to your destination. You'll see these events in your downstream integration.
Loading