In questa pagina: scopri come utilizzare e configurare gli eventi di qualificazione del pubblico per attivare l’ingresso o la progressione del percorso quando i profili si qualificano per un pubblico Adobe Experience Platform o ne escono.
Informazioni sugli eventi di qualificazione del pubblico about-segment-qualification
Questa attività ascolta le entrate e le uscite dei profili nei tipi di pubblico Adobe Experience Platform. Può far entrare individui in un percorso o andare avanti. Per ulteriori informazioni sulla creazione di tipi di pubblico, consulta questa sezione.
Supponiamo che tu abbia un pubblico di tipo “cliente silver”. Con questa attività, puoi fare in modo che tutti i nuovi clienti silver entrino in un percorso e inviino loro una serie di messaggi personalizzati.
Questo tipo di evento può essere posizionato come primo passaggio o successivamente nel percorso.
➡️ Scopri questa funzione nel video
Configurare l’attività configure-segment-qualification
Per configurare l’attività Qualificazione del pubblico, eseguire la procedura seguente:
-
Espandi la categoria Eventi e rilascia un’attività Qualifica pubblico nell’area di lavoro.
-
Aggiungi un’etichetta Label all’attività. Questo passaggio è facoltativo.
-
Fai clic nel campo Pubblico e seleziona i tipi di pubblico che desideri sfruttare.
note NOTE Puoi personalizzare e ordinare le colonne visualizzate nell’elenco.
Una volta aggiunto il pubblico, il pulsante Copia ti consente di copiarne il nome e l’ID:
{"name":"Loyalty membership","id":"8597c5dc-70e3-4b05-8fb9-7e938f5c07a3"}
note tip TIP Per identificare il metodo di valutazione di un pubblico prima di utilizzarlo, apri il menu Tipi di pubblico, seleziona il pubblico e controlla il campo Metodo di valutazione: Streaming, Batch o Edge. Puoi anche aggiungere la colonna Metodo di valutazione all'elenco del pubblico in questa attività. Il metodo di valutazione influisce sui tempi di immissione e sulle best practice applicabili. Vedere Tipi di pubblico in batch e Tipi di pubblico in streaming. -
Nel campo Comportamento, scegli se desideri ascoltare le entrate del pubblico, le uscite o entrambe.
note NOTE Invio e Uscita corrispondono agli stati di partecipazione al pubblico Realizzato e Uscito da Adobe Experience Platform.
Consulta la documentazione del servizio di segmentazione. -
Seleziona uno spazio dei nomi. Questa opzione è necessaria solo se l’evento è posizionato come primo passaggio del percorso. Per impostazione predefinita, il campo è precompilato con l’ultimo spazio dei nomi utilizzato.
note NOTE È possibile selezionare solo uno spazio dei nomi delle identità basato su persone.
Gli spazi dei nomi della tabella di ricerca (ad esempio, ProductID per una ricerca di prodotto) non sono disponibili nell'elenco a discesa Namespace.
Il payload contiene le seguenti informazioni contestuali, che è possibile utilizzare in condizioni e azioni:
- il comportamento (entrata, uscita)
- il timestamp della qualifica
- l’id del pubblico
Quando utilizzi l’editor espressioni in una condizione o in un’azione che segue un’attività AudienceQualification, puoi accedere al nodo AudienceQualification. Puoi scegliere tra Ora ultima qualifica e stato (entrata o uscita).
Vedi Condizioni.
Un nuovo percorso che include un evento Qualificazione del pubblico diventa operativo dieci minuti dopo la pubblicazione. Questo intervallo corrisponde all’intervallo di aggiornamento della cache del servizio dedicato. Attendere dieci minuti prima di usare questo percorso.
Best practice best-practices-segments
L’attività Qualificazione del pubblico consente l’ingresso immediato nei percorsi per i singoli utenti che si qualificano o che non si qualificano a un pubblico Adobe Experience Platform.
La velocità di ricezione di queste informazioni è elevata. Le misurazioni mostrano 10.000 eventi ricevuti al secondo. Pianifica i picchi di ingresso, evitali quando possibile e prepara il percorso a gestirli. Scopri di più sui tassi di elaborazione dei percorsi e sui limiti della velocità effettiva in questa sezione.
Pubblico in batch batch-speed-segment-qualification
Quando utilizzi la qualificazione del pubblico per un pubblico batch, tieni presente che un picco di ingresso si verifica al momento del calcolo giornaliero. La dimensione del picco dipende dal numero di individui che entrano o escono dal pubblico ogni giorno.
Inoltre, se il pubblico batch è stato appena creato e immediatamente utilizzato in un percorso, il primo batch di calcolo può determinare molte voci. Pianificate questo picco.
Tempistica degli aggiornamenti dell’iscrizione al segmento timing-segment-membership
Quando si utilizzano gli snapshot in batch in un percorso, qualsiasi nuova appartenenza a un segmento può essere riflessa solo negli snapshot successivi. Se sono essenziali aggiunte immediate o dello stesso giorno, considera la segmentazione in streaming o verifica che gli aggiornamenti dei segmenti vengano acquisiti dallo snapshot successivo.
Tipi di pubblico in streaming streamed-speed-segment-qualification
Quando si utilizza la qualificazione del pubblico per i tipi di pubblico in streaming, vi è meno rischio di picchi di ingresso e uscita di grandi dimensioni perché la valutazione è continua. Se la definizione del pubblico soddisfa più clienti contemporaneamente, può comunque verificarsi un picco.
Evita di utilizzare eventi di apertura e invio con segmentazione in streaming. Utilizza invece segnali reali di attività dell’utente come clic, acquisti o dati beacon. Per la logica di frequenza o eliminazione, utilizza le regole business anziché gli eventi di invio. Ulteriori informazioni
Consulta la Adobe Experience Platform documentazione sulla segmentazione in streaming.
Perché non tutti i profili qualificati possono entrare nel percorso streaming-entry-caveats
Quando si utilizzano tipi di pubblico in streaming con l’attività Qualifica pubblico, non tutti i profili idonei per il pubblico entreranno necessariamente nel percorso. Questo comportamento può verificarsi per i seguenti motivi:
-
Profili già presenti nel pubblico: solo i profili appena qualificati per il pubblico dopo la pubblicazione del percorso attiveranno l’ingresso. I profili già presenti nel pubblico prima della pubblicazione non verranno inseriti. Analogamente, quando un segmento di streaming utilizza una condizione basata sul tempo (ad esempio, “evento nelle prossime 8 ore”), i profili che hanno già soddisfatto tale condizione prima della creazione del segmento non sono valutati retroattivamente — solo i profili i cui dati cambiano dopo l’attivazione del segmento vengono valutati in base alla condizione.
-
Tempo di attivazione Percorso: quando pubblichi un percorso, l’attività Qualificazione del pubblico impiega fino a 10 minuti per diventare attiva e iniziare ad ascoltare le entrate e le uscite del profilo. Ulteriori informazioni sull’attivazione del percorso.
-
Uscite rapide dal pubblico: se un profilo è idoneo per il pubblico ma viene chiuso prima che venga attivata la voce percorso, è possibile che tale profilo non entri nel percorso.
-
Intervallo tra la qualifica e l’elaborazione del percorso: a causa della natura distribuita di Adobe Experience Platform, potrebbero esserci intervalli di tempo. Un profilo può qualificarsi prima che il percorso elabori l’evento di qualifica.
Consigli:
-
Dopo aver pubblicato un percorso, attendi almeno 10 minuti prima di inviare eventi o dati che attiveranno la qualifica del profilo. In questo modo il percorso sarà completamente attivato e pronto per elaborare le voci.
-
Per i casi d’uso critici in cui devi assicurarti che tutti i profili qualificati entrino, puoi utilizzare un’attività Read Audience. Elabora tutti i profili di un pubblico in un momento specifico.
-
Monitora la velocità di ingresso e il throughput del tuo percorso per comprendere i modelli di flusso del profilo.
-
Se i profili non vengono immessi come previsto, fare riferimento alla guida alla risoluzione dei problemi per ulteriori passaggi diagnostici.
Come evitare gli overload overloads-speed-segment-qualification
Di seguito sono riportate alcune best practice per evitare il sovraccarico dei sistemi utilizzati nei percorsi (origini dati, azioni personalizzate, attività di azione del canale):
-
Non utilizzare un pubblico batch immediatamente dopo la sua creazione in un’attività Qualificazione del pubblico. Questo evita il picco del primo calcolo. Se stai per utilizzare un pubblico che non è mai stato calcolato, nell’area di lavoro del percorso viene visualizzato un avviso giallo.
-
Inserisci una regola di limite per le origini dati e le azioni utilizzate nei percorsi per evitare di sovraccaricarle. Ulteriori informazioni sono disponibili nella documentazione di Journey Orchestration. La regola di limite non ha alcun nuovo tentativo. Se devi riprovare, usa un percorso alternativo nel percorso selezionando la casella Aggiungi un percorso alternativo in caso di timeout o errore in condizioni o azioni.
-
Prima di utilizzare il pubblico in un percorso di produzione, valuta il volume di persone qualificate per questo pubblico ogni giorno. Per farlo, controlla il menu Pubblico, apri il pubblico e osserva il grafico Profili nel tempo.
Ulteriori informazioni sui limiti di velocità di ingresso e la velocità effettiva in questa sezione.
Guardrail e limitazioni audience-qualification-guardrails
Segui le protezioni e le raccomandazioni riportate di seguito per creare percorsi di qualificazione del pubblico. Consulta anche Best practice per la qualificazione del pubblico.
-
I percorsi di qualificazione del pubblico sono progettati principalmente per funzionare con i tipi di pubblico in streaming. Questa combinazione garantisce una migliore esperienza in tempo reale. Si consiglia vivamente di utilizzare tipi di pubblico in streaming nell’attività Qualificazione del pubblico.
Tuttavia, se desideri utilizzare gli attributi basati sull’acquisizione in batch nel pubblico in streaming o in un pubblico in batch per un percorso di qualificazione del pubblico, considera l’intervallo di tempo per la valutazione/attivazione del pubblico. Un pubblico batch o un pubblico in streaming che utilizza attributi acquisiti in batch diventa pronto per l’uso nell’attività Qualificazione del pubblico circa 2 ore dopo il completamento del processo di segmentazione. Questo processo viene eseguito una volta al giorno all’ora definita dall’amministratore dell’organizzazione Adobe.
-
Adobe Experience Platform tipi di pubblico vengono calcolati una volta al giorno (batch tipi di pubblico) o in tempo reale (per flussi tipi di pubblico, utilizzando l’opzione Tipi di pubblico ad alta frequenza di Adobe Experience Platform).
- Se il pubblico selezionato viene inviato in streaming, gli utenti appartenenti a questo pubblico potrebbero entrare nel percorso in tempo reale.
- Se il pubblico è in batch, le persone appena qualificate per questo pubblico entreranno potenzialmente nel percorso in cui viene eseguito il calcolo del pubblico il Adobe Experience Platform.
Come best practice, utilizza i tipi di pubblico in streaming in un’attività Qualificazione del pubblico. Per i casi di utilizzo in batch, utilizza un’attività Read audience.
note NOTE A causa della natura batch dei tipi di pubblico creati utilizzando flussi di lavoro di composizione e caricamenti personalizzati, non è possibile indirizzare questi tipi di pubblico in un’attività "Qualificazione del pubblico". Solo i tipi di pubblico creati utilizzando le definizioni dei segmenti possono essere utilizzati in questa attività. -
I gruppi di campi evento esperienza non possono essere utilizzati in percorsi che iniziano con un’attività Read Audience, Audience Qualification o Business Event.
-
Quando si utilizza un’attività Qualificazione del pubblico in un percorso, l’attività può richiedere fino a 10 minuti per essere attiva e ascoltare i profili che entrano o escono dal pubblico.
Video introduttivo video
Scopri i casi d’uso applicabili ai percorsi di qualificazione del pubblico in questo video. Scopri come creare un percorso con qualificazione del pubblico e quali best practice applicare.
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 explains how to configure and use the Audience Qualification event activity in Journey Optimizer to trigger or advance profiles in a journey when they enter or exit an Adobe Experience Platform audience.
Intents:
- Configure an Audience Qualification event activity to trigger journey entry on audience membership changes
- Select the correct behavior (entrance, exit, or both) for an Audience Qualification activity
- Apply best practices to avoid overloading systems when using batch or streaming audiences
- Understand why some qualified profiles may not enter the journey and how to mitigate this
- Use the AudienceQualification node payload in downstream conditions and actions
Glossary:
- Audience Qualification event: A journey event activity that listens for profile entrances into or exits from an Adobe Experience Platform audience and triggers journey progression (product-specific)
- Behaviour (Enter/Exit): The setting that controls whether the journey reacts to profiles joining (“Realized”), leaving (“Exited”), or both states of an audience (product-specific)
- Streaming audience: An audience evaluated continuously in real time using the High Frequency Audiences option; recommended for Audience Qualification activities (product-specific)
- Batch audience: An audience recalculated once per day; introduces a daily peak of profile entries and requires a 2-hour readiness window after segmentation job completion (product-specific)
- AudienceQualification node: The context node available in the expression editor after an Audience Qualification activity, exposing last qualification time and status (product-specific)
- Edge-to-Hub propagation: The process by which a streaming segment membership evaluated at the Edge is synced to Hub before the journey can act on it; typically takes 15–30 minutes (product-specific)
Guardrails:
- A new Audience Qualification journey takes up to 10 minutes to become active after publishing
- Batch or streaming audiences using batch-ingested attributes become ready approximately 2 hours after the segmentation job completes
- Only audiences created using segment definitions can be used; composition workflow or custom upload audiences are not supported
- Experience event field groups cannot be used in journeys starting with Audience Qualification
- Only people-based identity namespaces are available for the namespace field; lookup table namespaces are not supported
- Profiles already in the audience before journey publication will not retroactively enter the journey
- Edge-to-Hub propagation for streaming segments typically takes 15–30 minutes
Terminology:
- Canonical name: Audience Qualification event — Acronym: none — variants: segment qualification, audience qualification activity
- Synonyms: “Enter” = “Realized” ; “Exit” = “Exited”
- Do not confuse: “Audience Qualification” ≠ “Read Audience” (Audience Qualification reacts to real-time membership changes; Read Audience processes all members at a scheduled time)
FAQ:
- Q: When does a newly published Audience Qualification journey start processing entries? — It takes up to 10 minutes after publication for the activity to become active and start listening for profile entries and exits.
- Q: Why are profiles not entering my Audience Qualification journey? — Common causes include: profiles were already in the audience before publishing, the 10-minute activation window has not elapsed, or the Edge-to-Hub propagation (15–30 min) for streaming segments has not completed yet.
- Q: Can I use a batch audience in an Audience Qualification activity? — Yes, but it is not recommended. Batch audiences generate a daily entry peak and are not suited for real-time use cases; use a Read Audience activity instead for batch scenarios.
- Q: What data is available in the AudienceQualification payload? — The payload includes the behavior (entrance or exit), the timestamp of qualification, and the audience ID.
- Q: Can I use audiences created from composition workflows in an Audience Qualification activity? — No, only audiences created using segment definitions are supported in this activity.