inAudience function inAudience
The inAudience function is an Adobe Experience Platform function that enables you to check whether an individual in your journey belongs to a specific audience. This powerful function allows you to create personalized journey paths based on audience membership, enabling sophisticated segmentation and targeting within your customer experiences.
Use the inAudience function when you need to:
- Branch journey paths based on audience membership. Learn more
- Apply conditional logic that depends on whether a profile belongs to a specific segment
- Target specific groups of customers with personalized experiences
- Evaluate real-time audience participation within journey conditions
- Combine multiple audience checks to create complex targeting rules
The function evaluates audience membership in real-time and returns a boolean value, making it ideal for decision nodes and conditional expressions. Audiences are defined and managed in Adobe Experience Platform (learn more about working with audiences in Journey Optimizer), and the expression editor provides autocomplete suggestions to help you reference them accurately.
Audience Status:
Audiences can have two participation statuses:
- Realized: The individual qualifies for the audience definition and is an active member
- Exited: The individual has left the audience and no longer qualifies
Only individuals with the Realized status will be considered as active audience members. When the function returns true, it confirms the individual has realized status; when it returns false, it indicates exited status. For more information on audience evaluation, refer to the Segmentation Service documentation.
inAudience(<parameter>)| table 0-row-3 1-row-3 | ||
|---|---|---|
| Parameter | Description | Type |
| Audience | The audience name | <string> |
Important constraints:
- The audience name must be a string constant
- It cannot be a field reference or an expression
- You can retrieve up to 100 audiences in a single journey
inAudience(<string>)
Returns a boolean:
-
true: The individual is a member of the audience (realized status) -
false: The individual is not a member of the audience (exited status)
inAudience("men over 50")
Returns true if the individual within the journey instance is part of the Adobe Experience Platform audience named “men over 50”, false otherwise.
Practical use cases:
| code language-none |
|---|
|
Guardrails and limitations guardrails
When using the inAudience function in your journeys, be aware of the following guardrails and limitations:
Audience retrieval limit:
- You can retrieve up to 100 audiences within a single journey
- The expression editor provides an autocompleted list of available audiences to help you reference them correctly
Parameter constraints:
- The audience name must be a string constant
- Field references and expressions are not supported as parameters
Audience name changes:
- Changing the name of an existing audience in Adobe Experience Platform does not automatically update any references to that audience in your journey expressions
- If your condition node uses
inAudience('oldAudienceName'), you must manually edit the expression to use the new name - Failure to update the audience name will cause the journey condition to break and may result in incorrect journey behavior
Merge policy considerations:
- When using multiple audiences with the
inAudiencefunction, inconsistencies with merge policies can cause errors or alerts - Refer to Journey properties for more information on merge policy behavior
Propagation timing:
When using inAudience() in a condition node, segment membership evaluation timing varies depending on where the condition appears in the journey:
- In a Read Audience journey, before a Wait activity: Journey Optimizer reads from the batch projection of the profile. Data in this projection is refreshed within 2 hours after ingestion. Audiences that rely on day-based or time-based conditions may experience additional delay. Add a short Wait activity at the start of the journey, or allow buffer time to ensure the latest segment membership is reflected.
- In a unitary event journey, or after a Wait activity: Segment membership is read from the streaming (unitary) projection. Data is typically available within 15 minutes. For more details, refer to the Adobe Experience Platform streaming ingestion documentation.
Related topics
Learn more about using audiences in Adobe Journey Optimizer:
- About audiences - Understand how audiences work in Adobe Experience Platform and Journey Optimizer, including how to create and manage them
- Read Audience activity - Use audiences to trigger journey entry and make all audience members enter a journey
- Audience Qualification events - Listen to profile entrances and exits from audiences to trigger journey actions in real-time
- Using audiences in conditions - Create conditional journey paths based on audience membership using the Optimize activity
- Journey properties - Merge policies - Understand how merge policies work when using multiple audiences with the inAudience function
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page documents the
inAudiencefunction, which checks in real-time whether a journey profile belongs to a named Adobe Experience Platform audience and returns a boolean used in journey conditions.
Intents:
- Branch a journey path based on whether a profile is a member of a specific audience using
inAudience - Combine multiple
inAudiencechecks with AND/OR logic to create complex targeting conditions - Verify that a profile has not entered a specific audience using a negation check (
inAudience("...") == false) - Understand the propagation timing differences between Read Audience journeys and unitary event journeys
- Identify and fix broken audience references caused by audience renames in Adobe Experience Platform
Glossary:
- Realized: Audience participation status indicating the individual currently qualifies for the audience definition and is an active member (product-specific)
- Exited: Audience participation status indicating the individual has left the audience and no longer qualifies (product-specific)
- Merge policy: A rule in Adobe Experience Platform that determines how profile data from multiple datasets is combined when evaluating audience membership (product-specific)
- Batch projection: The profile data store refreshed on a schedule (within 2 hours after ingestion) used by Read Audience journeys (product-specific)
- Streaming projection: The real-time profile data store (typically available within 15 minutes) used in unitary event journeys and after Wait activities (product-specific)
Guardrails:
- A single journey can retrieve up to 100 audiences
- The audience name parameter must be a string constant; field references and dynamic expressions are not supported
- Renaming an audience in Adobe Experience Platform does not automatically update
inAudiencereferences in journey expressions — manual updates are required - Inconsistent merge policies across multiple audiences used in the same journey can cause errors or alerts
Terminology:
- Canonical name: inAudience — Acronym: none — variants: inSegment (legacy name)
- Synonyms: “inAudience” = “audience membership check function”
- Do not confuse: “Realized” (active member) ≠ “Exited” (no longer a member)
- Do not confuse: “inAudience” (current function) ≠ “inSegment” (deprecated legacy function)
FAQ:
- Q: What does
inAudiencereturn when a profile has exited the audience? — It returnsfalse; only profiles with “Realized” status are considered active members and returntrue. - Q: How many audiences can I check in a single journey? — Up to 100 audiences can be retrieved within a single journey.
- Q: What happens if I rename an audience in Adobe Experience Platform after using it in a journey? — The journey expression is not updated automatically; you must manually edit the
inAudiencecall to use the new audience name, otherwise the condition will break. - Q: How quickly is audience membership available after a profile update in a Read Audience journey? — In a Read Audience journey before a Wait activity, data is read from the batch projection refreshed within 2 hours after ingestion.
- Q: Can I pass a profile attribute as the audience name parameter? — No, the audience name must be a string constant; field references and expressions are not supported.