In questa pagina: Scopri come utilizzare gli eventi generali per attivare i percorsi in modo unitario in tempo reale e configurare i timeout degli eventi e i percorsi di timeout per l’ascolto di un evento solo durante un periodo definito.
Gli eventi consentono di attivare i percorsi in modo unitario per inviare messaggi in tempo reale all’utente che entra nel percorso.
Per questo tipo di evento, puoi aggiungere solo un’etichetta e una descrizione. Impossibile modificare il resto della configurazione. È stata eseguita dall’utente tecnico. Consulta questa pagina.
Ulteriori informazioni sulla velocità effettiva degli eventi e sulle velocità di elaborazione percorsi in questa sezione.
Quando rilasci un evento di business, aggiunge automaticamente un’attività Read Audience. Per ulteriori informazioni sugli eventi di business, consulta questa sezione
Ascolto degli eventi durante un periodo di tempo specifico events-specific-time
Un’attività evento posizionata nel percorso ascolta gli eventi a tempo indefinito. Per ascoltare un evento solo durante un determinato periodo di tempo, è necessario configurare un timeout per l’evento.
Il percorso ascolterà quindi l’evento durante il tempo specificato nel timeout. Se un evento viene ricevuto durante tale periodo, la persona scorrerà nel percorso dell’evento. In caso contrario, il cliente passa al percorso di timeout, se definito, oppure continua quel percorso.
Se non è definito alcun percorso di timeout, l’impostazione di timeout fungerà da attività di attesa, facendo aspettare il profilo per un periodo di tempo che potrebbe essere interrotto se un evento si verifica prima della fine di tale attesa. Se desideri escludere i profili da tale percorso dopo il timeout, devi impostare un percorso di timeout.
Per configurare un timeout per un evento, effettua le seguenti operazioni:
-
Attiva l’opzione Definisci il timeout evento dalle proprietà dell’evento.
-
Specifica il tempo di attesa dell’evento da parte del percorso. La durata massima è di 90 giorni.
-
Quando non viene ricevuto alcun evento entro il timeout specificato, è consigliabile inviare i singoli utenti a un percorso di timeout. Abilitare l’opzione Imposta un percorso di timeout. In tal caso, il percorso continua per l’individuo una volta raggiunto il timeout. È consigliabile abilitare sempre l’opzione Imposta un percorso di timeout.
In questo esempio, il percorso invia un’e-mail di benvenuto a un cliente dopo che è entrato nell’atrio. Invia un’e-mail con uno sconto sui pasti solo se il cliente entra nel ristorante entro il giorno successivo. Abbiamo quindi configurato l’evento del ristorante con un timeout di 1 giorno:
- Se l’evento del ristorante viene ricevuto meno di 1 giorno dopo l’e-mail di benvenuto, viene inviata l’e-mail con lo sconto sui pasti.
- Se non viene ricevuto alcun evento del ristorante nel giorno successivo, la persona scorre attraverso il percorso di timeout.
Se vuoi configurare un timeout per più eventi posizionati dopo un’attività Wait, devi configurare il timeout solo per uno di questi eventi.
Il timeout definito si applica a tutti gli eventi posizionati dopo l’attività Wait:
- Se un evento viene ricevuto entro la durata di timeout, il singolo passa nel percorso dell’evento ricevuto.
- Se non viene ricevuto alcun evento entro la durata di timeout, il singolo fluisce nel ramo di timeout dell’evento in cui è stato definito il timeout.
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 use general (unitary and business) events in journeys to trigger real-time, individual-level message delivery, including how to configure event timeouts and timeout paths.
Intents:
- Add a general event activity to a journey canvas to trigger real-time profile entry
- Configure an event timeout to limit how long a journey listens for an event
- Set up a timeout path to handle profiles that do not trigger the expected event in time
- Distinguish between unitary events and business events and understand when each is added automatically
- Combine event timeouts with Wait activities to control multi-event timeout behaviour
Glossary:
- Unitary event: An event that triggers the journey for one individual at a time, in real-time (product-specific)
- Business event: A non-profile-related event that triggers a journey for an audience of profiles, automatically adding a Read Audience activity (product-specific)
- Event timeout: A configurable duration (up to 90 days) after which the journey stops waiting for a specific event and routes the profile to a timeout path (product-specific)
- Timeout path: An optional journey branch that profiles follow when the expected event is not received within the timeout window (product-specific)
Guardrails:
- Event label and description are the only editable fields for a general event on the canvas; all other configuration is performed by a technical user and cannot be changed from the journey
- Maximum event timeout duration is 90 days
- When multiple events follow a Wait activity, the timeout must be configured on only one of those events; the defined timeout then applies to all events after the Wait
- If no timeout path is defined, the timeout acts as a Wait activity; profiles that do not receive the event remain in the journey until the timeout elapses
Terminology:
- Canonical name: General event — Acronym: none — variants: unitary event, custom event
- Synonyms: “general event” = “unitary event” (in the context of the canvas activity)
- Do not confuse: “business event” ≠ “unitary event” — a business event targets an audience of profiles, while a unitary event targets a single individual
FAQ:
- Q: Can I change the event configuration from the journey canvas? — No; only the label and description can be edited on the canvas. The full event configuration is set by a technical user and cannot be modified from the journey.
- Q: What happens if no event is received before the timeout expires? — If a timeout path is defined, the profile flows into that path. If no timeout path is set, the timeout behaves like a Wait activity and the profile continues the journey after the timeout period.
- Q: What is the maximum event timeout duration? — 90 days.
- Q: When should I enable the timeout path option? — Always enable it if you want profiles to exit that branch after the timeout; without a timeout path, profiles remain in the journey waiting for the event.
- Q: How does a business event differ from a unitary event in the journey canvas? — Dropping a business event automatically adds a Read Audience activity, because business events target multiple profiles simultaneously rather than a single individual.