Documentazione Journey Optimizer Guida di Journey Optimizer

Funzione inAudience inAudience

Ultimo aggiornamento: 5 settembre 2026

Si applica a:
Journey Orchestration

Creato per:

Experienced
Sviluppatore

La funzione inAudience è una funzione di Adobe Experience Platform che consente di verificare se un individuo del percorso appartiene a un pubblico specifico. Questa potente funzione ti consente di creare percorsi di percorso personalizzati in base all’iscrizione al pubblico, abilitando segmentazione e targeting sofisticati all’interno delle esperienze dei clienti.

Utilizzare la funzione inAudience quando è necessario:

Percorsi del percorso di rami basati sull’iscrizione al pubblico. Ulteriori informazioni
Applicare una logica condizionale che dipende dall’appartenenza di un profilo a un segmento specifico
Eseguire il targeting di gruppi specifici di clienti con esperienze personalizzate
Valutazione della partecipazione del pubblico in tempo reale in condizioni di percorso
Combinare più controlli di pubblico per creare regole di targeting complesse

La funzione valuta l’appartenenza al pubblico in tempo reale e restituisce un valore booleano, rendendolo ideale per i nodi decisionali e le espressioni condizionali. I tipi di pubblico vengono definiti e gestiti in Adobe Experience Platform (ulteriori informazioni su utilizzo dei tipi di pubblico in Journey Optimizer) e l’editor espressioni fornisce suggerimenti di completamento automatico per aiutarti a farvi riferimento in modo accurato.

Stato pubblico:

I tipi di pubblico possono avere due stati di partecipazione:

Realizzato: l’individuo è idoneo per la definizione del pubblico ed è un membro attivo
Uscito: l’utente ha lasciato il pubblico e non è più idoneo

Solo i singoli utenti con lo stato Realizzato verranno considerati membri del pubblico attivi. Quando la funzione restituisce true, conferma che l’individuo ha realizzato lo stato; quando restituisce false, indica lo stato di uscita. Per ulteriori informazioni sulla valutazione del pubblico, consulta la documentazione del servizio di segmentazione.

Sintassi

inAudience(<parameter>)

Parametri

table 0-row-3 1-row-3
Parametro	Descrizione	Tipo
Pubblico	Il nome del pubblico	`<string>`

Vincoli importanti:

Il nome del pubblico deve essere una costante stringa
Non può essere un riferimento di campo o un’espressione
Puoi recuperare fino a 100 tipi di pubblico in un singolo percorso

Firma e tipo restituito

inAudience(<string>)

Restituisce un valore booleano:

true: l’individuo è membro del pubblico (stato realizzato)
false: l’individuo non è un membro del pubblico (stato di uscita)

Esempi

inAudience("men over 50")

Restituisce true se l’individuo all’interno dell’istanza del percorso fa parte del pubblico Adobe Experience Platform denominato “uomini sopra i 50”, false in caso contrario.

Casi d’uso pratici:

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

Guardrail e limitazioni guardrails

Quando utilizzi la funzione inAudience nei tuoi percorsi, tieni presente le seguenti protezioni e limitazioni:

Limite di recupero pubblico:

Puoi recuperare fino a 100 tipi di pubblico in un singolo percorso
L’editor di espressioni fornisce un elenco completato automaticamente dei tipi di pubblico disponibili, per aiutarti a farvi riferimento correttamente

Vincoli dei parametri:

Il nome del pubblico deve essere una costante stringa
I riferimenti e le espressioni di campo non sono supportati come parametri

Modifiche nome pubblico:

La modifica del nome di un pubblico esistente in Adobe Experience Platform non aggiorna automaticamente i riferimenti a tale pubblico nelle espressioni di percorso
Se il nodo della condizione utilizza inAudience('oldAudienceName'), è necessario modificare manualmente l’espressione per utilizzare il nuovo nome
Se non si aggiorna il nome del pubblico, la condizione di percorso si interromperà e si potrebbe verificare un comportamento di percorso errato

Considerazioni sui criteri di unione:

Quando si utilizzano più tipi di pubblico con la funzione inAudience, le incoerenze con i criteri di unione possono causare errori o avvisi
Per ulteriori informazioni sul comportamento dei criteri di unione, vedere Proprietà Percorso

Tempistica di propagazione:

Quando si utilizza inAudience() in un nodo condizione, i tempi di valutazione dell’appartenenza ai segmenti variano a seconda della posizione in cui la condizione viene visualizzata nel percorso:

In un percorso Read Audience, prima di un’attività Wait: Journey Optimizer legge dalla proiezione batch del profilo. I dati in questa proiezione vengono aggiornati entro 2 ore dopo l’acquisizione. I tipi di pubblico che si basano su condizioni giornaliere o basate su un intervallo di tempo possono subire un ulteriore ritardo. Aggiungi una breve Attività di attesa all’inizio del percorso oppure consenti un tempo di buffer per garantire che venga riflessa l’ultima appartenenza al segmento.
In un percorso di eventi unitario o dopo un’attività Attendi: l’appartenenza al segmento viene letta dalla proiezione streaming (unitaria). I dati sono generalmente disponibili entro 15 minuti. Per ulteriori dettagli, consulta la documentazione sull’acquisizione streaming di Adobe Experience Platform.

Argomenti correlati

Scopri come utilizzare i tipi di pubblico in Adobe Journey Optimizer:

Informazioni sui tipi di pubblico - Comprendi come funzionano i tipi di pubblico in Adobe Experience Platform e Journey Optimizer, incluso come crearli e gestirli
Attività Read Audience - Utilizza i tipi di pubblico per attivare l’ingresso nel percorso e fare in modo che tutti i membri del pubblico entrino in un percorso
Eventi di qualificazione del pubblico - Ascolta le entrate e le uscite del profilo dai tipi di pubblico per attivare le azioni di percorso in tempo reale
Utilizzo di tipi di pubblico nelle condizioni - Creazione di percorsi di percorso condizionali in base all’appartenenza al pubblico tramite l’attività Ottimizza
Proprietà Percorso - Criteri di unione - Comprendere il funzionamento dei criteri di unione quando si utilizzano più tipi di pubblico con la funzione inAudience

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