Skip to content

LA advanced conditions #6827

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 15 commits into from
Jul 30, 2024
Merged
Show file tree
Hide file tree
Changes from 4 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
92 changes: 84 additions & 8 deletions src/engage/audiences/linked-audiences.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,9 +69,86 @@ As you're building your Linked Audience, you can choose from the following profi
| part of an [audience](/docs/glossary/#audience) | Creates a condition that filters profiles that are part of an existing audience. |
| not part of an [audience](/docs/glossary/#audience) | Creates a condition that filters profiles that are not part of an existing |
| that performed [event](/docs/glossary/#event) | Creates a condition that filters profiles that have a specific event in their event history. You can also filter on event property values.|
| that did not performed [event](/docs/glossary/#event) | Creates a condition that filters profiles that do not have a specific event in their event history. You can also filter on event property values.|
| that did not performed [event](/docs/glossary/#event) | Creates a condition that filters profiles that do not have a specific event in the event history. You can also filter on event property values.|

**Note:** you can only create nested entity conditions up to four levels in depth. For example, an entity condition that queries for relationships between Profiles, Accounts, Credit Cards, and Transactions has four levels of depth.
**Note:** you can only create nested entity conditions up to four levels in depth. For example, an entity condition that queries for relationships between Profiles, Accounts, Credit Cards, and Transactions has four levels of depth.

### Linked Audience advanced profiles conditions

The Audience builder returns the portion of values from the data warehouse or incoming data stream that are the most commonly used, including some entity and event properties. However, if you don’t see the value you’re looking for, you can manually enter it.

Segment sources profile trait and event keys surfaced in the linked audience builder from the data warehouse and not from the Segment profile. This means that the data you want to reference has to be synced to the data warehouse through Profiles Sync before you can reference it in the linked audience builder, even if it already exists on the Segment profile.

#### Overview

You can view relevant audience information on the Overview page (Profiles in Audience, Run Schedule, Latest run, Next compute).

#### Edit/Delete Audience

You can delete your Linked Audience from the Overview page.
You can edit and save your previously created rETL audience on the Builder tab of the Overview page.

If you edit an audience with configured activation events, you may need to disable or delete impacted events for your audience to successfully compute. Events are impacted if they reference entities that are edited and removed from the audience definition.

#### 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.

**Example:**

![An example of the operator selection filled out.](/docs/engage/images/operator_selection.png)

#### Event Conditions

- *at least*: supports 1 or greater.
- *exactly*: supports 0 or greater.
- *at most*: supports 0 or greater.
- does not support funnel audiences, unlike classic audiences.
- can’t select enrich event payloads with event properties.

#### Entity Conditions

- *at least*: only supports 1 or greater.
- *exactly*: supports 0 or greater.
- *at most*: supports 0 or greater.
- When filtering by 0, you can’t filter by entity properties or by additional nested entities.

#### Negative Audiences

Negation of an entire entity group condition will not support activation and enrichment on the entities within that condition group. When a condition such as “Select all users associated with an entity with exactly 0 instances” is used:

- Segment won't allow any entity property filters to be applied to this condition group.
- Segment won't allow any more nested entities to be specified in this condition group.

#### Entity Explorer

If you have defined entity conditions in your audience definition, then you see a “Matched Entities” tab in the audience preview that helps define what entities qualified that user to be a part of the audience.

This information appears when you click the user profile generated from the audience preview. The information encompasses entity relationships as well as entity column values that were used as filtering criteria in the audience definition. The data being returned is truncated - 10 entities at each level, 6 levels of depth. By default, you are opted-in to see entity preview values.

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

#### Dynamic References

**Event Conditions**

For event property values, you can either enter a Constant or dynamically reference a profile trait from the Segment profile.
When filtering on event properties, you can dynamically reference the value of another profile trait, or enter a constant value.

**Entity Conditions**

When filtering on entity properties, you can dynamically reference the value of another entity column (from the same branch at the same level or above it) or profile trait, or enter a constant value.

#### Limits

**Auto-populate Dropdown Entity Property Values**

You can select property values from a drop-down. By default, you are opted-in to see entity preview values.

#### Duplicate Conditions & Clone Audiences

You can duplicate your conditions in the audience builder in the same condition group.
You can clone a rETL audience to the same Space from the List and Overview pages. Cloning a linked audience will create a new linked audience in the builder create flow with the same conditions as the linked audience that was cloned.

## Step 2: Activate your Linked Audience

Expand Down Expand Up @@ -155,22 +232,21 @@ After building your Linked Audience, choose **Save and Enable**. You'll be redir
To enable your audience:
Select the **Enabled** toggle, then select **Enable audience**.

### Compute Now
### Run Now

You can trigger a compute for your audience if you want to send events to your destination without waiting for the next scheduled compute run. To do so, select **Compute Now**. This triggers a compute for the audience and sends events downstream.
You can trigger a run for your audience if you want to send events to your destination without waiting for the next scheduled run. To do so, select **Run Now**. This triggers a run for the audience and sends events downstream.

### Set a run schedule

Use the Audience Overview page to view the audience profile count, current run schedule, run status, and upcoming run time.

Determine when an audience should run and send data to enabled destinations with a run schedule:

- **Manual**: Trigger audience runs manually by clicking **Run Now** on the Audience Overview page.
- **Interval**: Trigger audience runs based on a predefined set of time intervals. Supported intervals are: 15 minutes, 30 minutes, 1 hour, 2 hours, 4 hours, 6 hours, 8 hours, 12 hours, or 1 day. If you select this option, Segment runs your audience after you enable the audience.
- **Day and time**: Trigger audience runs at specific times on selected days of the week. If you select this option, Segment runs your audience at the first selected date and time.
- **Interval**: Trigger audience runs based on a predefined set of time intervals. Supported intervals are: 15 minutes, 30 minutes, 1 hour, 2 hours, 4 hours, 6 hours, 8 hours, 12 hours, 1 day. If you select this option, Segment will run your audience after you enable the audience.
- **Day and time**: Trigger audience runs at specific times on selected days of the week. If you select this option, Segment will run your audience at the first selected date and time.

You can maintain your run schedule at any time from the audience's **Settings** tab.

You can also click **Run Now** on the Audience Overview page at any time (even if the run schedule is **Interval** Overview **Day and time**) to manually trigger a run on your warehouse and send data to enabled destinations.

There may be up to a 5 minute delay from the configured start time for audiences that are configured with the **Interval** and **Day and time** run schedules. For example, if you configured an audience with the **Day and time** compute schedule to run on Mondays at 8:00 AM, it can compute as late as Monday at 8:05 AM. This is to help Segment better manage system load.
There may be up to a 5 minute delay from the configured start time for audiences that are configured with the **Interval** and **Day and time** run schedules. For example, if you configured an audience with the **Day and time** compute schedule to run on Mondays at 8am, it can compute as late as Monday at 8:05am. This is to help us better manage our system load.
Binary file added src/engage/images/entity_explorer.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/engage/images/operator_selection.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.