Fonction inAudience inAudience

La fonction inAudience est une fonction Adobe Experience Platform qui vous permet de vérifier si un individu de votre parcours appartient à une audience spécifique. Cette fonction puissante vous permet de créer des chemins de parcours personnalisés en fonction de l’appartenance à une audience, ce qui permet une segmentation et un ciblage sophistiqués au sein de vos expériences client.

Utilisez la fonction inAudience lorsque vous devez :

  • diviser le parcours en fonction de l’appartenance à l’audience. En savoir plus
  • Appliquer une logique conditionnelle qui dépend du fait qu’un profil appartient ou non à un segment spécifique
  • Cibler des groupes spécifiques de clients et clientes avec des expériences personnalisées
  • Évaluer la participation de l’audience en temps réel dans des conditions de parcours
  • Combiner plusieurs vérifications d’audience pour créer des règles de ciblage complexes

La fonction évalue l’appartenance à l’audience en temps réel et renvoie une valeur booléenne, ce qui la rend idéale pour les nœuds de décision et les expressions conditionnelles. Les audiences sont définies et gérées dans Adobe Experience Platform (en savoir plus sur l’utilisation des audiences dans Journey Optimizer). L’éditeur d’expression fournit des suggestions de saisie semi-automatique pour vous aider à les référencer avec précision.

Statut de l’audience :

Les audiences peuvent posséder deux statuts de participation :

  • Réalisé : l’individu est éligible à la définition de l’audience et doit être un membre actif.
  • Sorti : l’individu a quitté l’audience et ne se qualifie plus.

Seuls les individus ayant le statut Réalisé seront considérés comme des membres actifs de l’audience. Lorsque la fonction renvoie true, elle confirme que l’individu a le statut Réalisé ; lorsqu’elle renvoie false, elle indique le statut de sortie. Pour plus d’informations sur l’évaluation d’audience, reportez-vous à la documentation de Segmentation Service.

Syntaxe
inAudience(<parameter>)
Paramètres
table 0-row-3 1-row-3
Paramètre Description Type
Audience Nom de l’audience <string>

Contraintes importantes :

  • Le nom de l’audience doit être une constante sous forme de chaîne.
  • Il ne peut pas s’agir d’une référence de champ ou d’une expression.
  • Vous pouvez récupérer jusqu’à 100 audiences dans un seul parcours.
Signature et type renvoyé

inAudience(<string>)

Renvoie une valeur booléenne :

  • true : l’individu est membre de l’audience (statut réalisé).

  • false : l’individu n’est pas membre de l’audience (statut sorti).

Exemples

inAudience("men over 50")

Renvoie true si l’individu concerné par l’instance de parcours figure dans l’audience Adobe Experience Platform « hommes de plus de 50 ans ». Sinon, elle renvoie false.

Cas d’utilisation pratiques :

code language-none
// Simple audience check in a condition
inAudience("Premium Customers") == true

// Multiple audience evaluation
inAudience("High Value Customers") == true AND inAudience("Active Last 30 Days") == true

// Negation check
inAudience("Unsubscribed") == false

Mécanismes de sécurisation et limitations guardrails

Lors de l’utilisation de la fonction inAudience dans vos parcours, tenez compte des mécanismes de sécurisation et limitations suivantes :

Limite de récupération de l’audience :

  • Vous pouvez récupérer jusqu’à 100 audiences dans un seul parcours.
  • L’éditeur d’expression fournit une liste d’audiences disponibles complétée automatiquement pour vous aider à les référencer correctement.

Contraintes de paramètre :

  • Le nom de l’audience doit être une constante sous forme de chaîne.
  • Les références et expressions de champ ne sont pas prises en charge en tant que paramètres.

Modifications du nom de l’audience :

  • La modification du nom d’une audience existante dans Adobe Experience Platform ne met pas automatiquement à jour les références à cette audience dans vos expressions de parcours.
  • Si votre nœud de condition utilise inAudience('oldAudienceName'), vous devez modifier manuellement l’expression pour utiliser le nouveau nom.
  • Si vous ne mettez pas à jour le nom de l’audience, la condition de parcours ne fonctionnera plus et le comportement du parcours pourra être incorrect.

Éléments à prendre en compte concernant la politique de fusion :

  • Lors de l’utilisation de plusieurs audiences avec la fonction inAudience, des incohérences avec les politiques de fusion peuvent entraîner des erreurs ou des alertes.
  • Pour plus d’informations sur le comportement des politiques de fusion, consultez la section Propriétés des parcours.

Délai de propagation :

Lors de l’utilisation de inAudience() dans un nœud de condition, le délai d’évaluation de l’appartenance au segment varie en fonction de l’emplacement de la condition dans le parcours :

  • Dans un parcours Lecture d’audience, avant une activité Attente : Journey Optimizer lit à partir de la projection par lots du profil. Les données de cette projection sont actualisées dans les 2 heures suivant l’ingestion. Les audiences qui reposent sur des conditions basées sur la journée ou sur l’heure peuvent subir un retard supplémentaire. Ajoutez une courte activité d’attente au début du parcours ou patientez le temps pour vous assurer que la dernière appartenance au segment est prise en compte.
  • Dans un parcours d’événement unitaire, ou après une activité Attente : l’appartenance à un segment est lue à partir de la projection en flux continu (unitaire). Les données sont généralement disponibles en 15 minutes. Pour plus d’informations, consultez la documentation sur l’ingestion par flux de 🔗.

Rubriques connexes

Pour en savoir plus sur l’utilisation des audiences dans Adobe Journey Optimizer :

AI Knowledge Reference

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 inAudience function, 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 inAudience checks 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 inAudience references 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 inAudience return when a profile has exited the audience? — It returns false; only profiles with “Realized” status are considered active members and return true.
  • 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 inAudience call 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.
recommendation-more-help
journey-optimizer-help