In questa pagina: Scopri come configurare l’attività Attendi per sospendere un percorso per una durata relativa o fino a una data calcolata personalizzata prima dell’esecuzione dell’attività successiva.
Puoi utilizzare un’attività Wait per definire una durata prima di eseguire l’attività successiva. La durata massima di attesa è di 90 giorni.
È possibile impostare due tipi di attività Attendi:
- Un’attesa basata su una durata relativa. Ulteriori informazioni
- Una data personalizzata, utilizzando le funzioni per calcolarla. Ulteriori informazioni
Consigli wait-recommendations
Utilizza queste raccomandazioni per mantenere le attese prevedibili e sicure.
Attività di attesa multiple multiple-wait-activities
Quando utilizzi più attività Wait in un percorso, tieni presente che il timeout globale per i percorsi è di 91 giorni, il che significa che i profili vengono sempre eliminati dal massimo percorso 91 giorni dopo l’immissione. Ulteriori informazioni sono disponibili in questa pagina.
Una persona può accedere a un’attività Wait solo se nel percorso è rimasto abbastanza tempo per completare la durata dell’attesa prima del timeout di 91 percorsi.
Attendere e rientrare wait-reentrance
È consigliabile non utilizzare le attività Wait per bloccare il rientro. Utilizza invece l’opzione Consenti rientro a livello di proprietà del percorso. Ulteriori informazioni sono disponibili in questa pagina.
Modalità di attesa e test wait-test-mode
In modalità di test, il parametro Wait time in test (Tempo di attesa nel test) consente di definire la durata di ogni attività Wait. Il tempo predefinito è di 10 secondi. In questo modo potrai ottenere rapidamente i risultati del test. Ulteriori informazioni sono disponibili in questa pagina.
Canali attendi e mobili wait-mobile-channels
Se desideri visualizzare un messaggio in-app poco dopo aver inviato una notifica push, utilizza un’attività Attendi per consentire la propagazione del tempo di payload del messaggio in-app. In genere si consiglia un’attesa di 5-15 minuti, ma i tempi esatti possono variare a seconda della complessità del payload e delle esigenze di personalizzazione.
Configurazione wait-configuration
Configura qui la durata e il tempo di attesa.
Attesa durata duration
Selezionare il tipo Durata per impostare la durata relativa dell’attesa prima dell’esecuzione dell’attività successiva. La durata massima è di 90 giorni.
Attesa personalizzata custom
Seleziona il tipo Personalizzato per definire una data personalizzata, utilizzando un’espressione avanzata basata su un campo proveniente da un evento o una risposta a un’azione personalizzata. Non è possibile definire direttamente una durata relativa, ad esempio 7 giorni, ma è possibile utilizzare le funzioni per calcolarla se necessario (ad esempio, 2 giorni dopo l’acquisto).
L’espressione nell’editor deve fornire un formato dateTimeOnly. Consulta questa pagina. Per ulteriori informazioni sul formato dateTimeOnly, vedere questa pagina.
Si consiglia di utilizzare date personalizzate specifiche per i profili ed evitare di utilizzare la stessa data per tutti. Ad esempio, non definire toDateTimeOnly('2024-01-01T01:11:00Z'), ma toDateTimeOnly(@event{Event.productDeliveryDate}) specifico per ciascun profilo. Tieni presente che l’utilizzo di date fisse può causare problemi nell’esecuzione del percorso. Ulteriori informazioni sull’impatto delle attività Attendi sulla velocità di elaborazione del percorso in questa sezione.
dateTimeOnly, tenere presente quanto segue:- È possibile utilizzare direttamente un'espressione
dateTimeOnlyo convertirla utilizzando una funzione, ad esempio:toDateTimeOnly(@event{Event.offerOpened.activity.endTime})dove il valore del campo è nel formato2023-08-12T09:46:06Z. - Il fuso orario è definito nelle proprietà del percorso. Di conseguenza, non è possibile dall’interfaccia utente puntare a un timestamp ISO-8601 completo che combina l’offset di ora e fuso orario, ad esempio
2023-08-12T09:46:06.982-05. Ulteriori informazioni - Durante la creazione di un'espressione di attesa personalizzata con
toDateTimeOnly(), not aggiungereZo un offset del fuso orario (ad esempio,-05:00). L’espressione deve fare riferimento al fuso orario configurato nel percorso senza indicatori di fuso orario espliciti, altrimenti i profili potrebbero bloccarsi nell’attività Attendi.
| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Esempio | |
| Corretto | toDateTimeOnly(concat(toString(toDateOnly(nowWithDelta(2, "days"))),"T10:00:00")) |
| Errato | toDateTimeOnly(concat(toString(toDateOnly(nowWithDelta(2, "days"))),"T10:00:00Z")) ❌ (contiene Z) |
Per verificare che l’attività Attendi funzioni come previsto, puoi utilizzare gli eventi dei passaggi. Ulteriori informazioni.
Aggiornamento profilo dopo l’attesa profile-refresh
Quando un profilo viene parcheggiato in un’attività Wait in un percorso che inizia con un’attività Read Audience, il percorso aggiorna automaticamente gli attributi del profilo da Servizio profili unificato (UPS) per recuperare i dati disponibili più recenti.
- Alla voce percorso: i profili utilizzano i valori degli attributi dello snapshot del pubblico valutato all’avvio del percorso.
- Dopo un nodo di attesa: il percorso esegue una ricerca per recuperare i dati di profilo più recenti da UPS, non i dati snapshot precedenti. Ciò significa che gli attributi del profilo possono essere cambiati dall’inizio del percorso.
Questo comportamento assicura che le attività a valle utilizzino le informazioni correnti del profilo dopo un periodo di attesa. Tuttavia, potrebbero verificarsi risultati imprevisti se si prevede che il percorso utilizzi solo i dati snapshot originali durante l’esecuzione.
Esempio: se un profilo è idoneo per un pubblico “cliente silver” all’inizio del percorso, ma viene aggiornato a “cliente gold” durante un’attesa di 3 giorni, le attività successive all’attesa visualizzeranno lo stato “cliente gold” aggiornato.
Nodo di attesa automatico auto-wait-node
Ogni attività esperienza in entrata (messaggio in-app, esperienza basata su codice o scheda) viene fornita con un’attività Wait di 3 giorni. Poiché i messaggi in entrata terminano automaticamente quando un profilo raggiunge la fine del percorso, si presume che gli utenti debbano visualizzarlo almeno per 3 giorni. Puoi rimuovere questa attività Attendi o modificarne la configurazione, se necessario.
Questa sezione contiene informazioni strutturate che supportano l’interpretazione, il recupero e la risposta alle domande relative a questo argomento.
Per una comprensione completa, queste informazioni devono essere unite alla documentazione su questa pagina. Nessuna delle due origini è progettata per essere indipendente; la pagina descrive la funzione, mentre questa sezione fornisce un contesto aggiuntivo che aiuta a non ambiguare la terminologia, le finalità, l’applicabilità e i vincoli.
- TL;DR: In questa pagina viene illustrato come configurare l’attività Attendi in un percorso per sospendere la progressione del profilo per una durata relativa o fino a una data calcolata personalizzata prima di eseguire il passaggio successivo.
Intenti:
- Aggiungi un’attività Attendi per sospendere un percorso per una durata relativa fissa (fino a 90 giorni)
- Configura un’attesa personalizzata utilizzando un’espressione avanzata per posticipare la data calcolata specifica per il profilo
- Comprendere come le attività di attesa interagiscono con il timeout globale del percorso (91 giorni)
- Utilizza il parametro Wait time in test (Tempo di attesa nel test) per velocizzare la convalida della modalità di test
- Scopri come gli attributi del profilo vengono aggiornati dopo un nodo Wait in Read Audience percorsi
Glossario:
- Attività di attesa: un’attività di orchestrazione del percorso che mette in pausa la progressione del profilo per una durata specificata o fino a una data calcolata prima dell’esecuzione dell’attività successiva (specifico per prodotto)
- Attesa durata: tipo di attesa che imposta un periodo di tempo relativo da sospendere, con un massimo di 90 giorni (specifico per prodotto)
- Attesa personalizzata: tipo di attesa che utilizza un’espressione
dateTimeOnlyderivata dai dati del profilo o dell’evento per definire una data/ora futura specifica per la ripresa (specifica per prodotto) - Nodo di attesa automatico: un’attività di attesa di 3 giorni inserita automaticamente dopo le attività esperienza in entrata (in-app, basate su codice, scheda) per mantenere il profilo nel percorso abbastanza a lungo da visualizzare il contenuto (specifico per prodotto)
- Tempo di attesa nel test: un parametro della modalità di test del percorso che ignora le durate di attesa effettive (impostazione predefinita: 10 secondi), in modo che i risultati del test vengano restituiti rapidamente (specifico per prodotto)
Guardrail:
- La durata massima di attesa è di 90 giorni.
- I profili vengono eliminati da un percorso dopo 91 giorni (timeout globale), indipendentemente dalle attività di attesa in sospeso.
- Un profilo può entrare in un’attività Attendi solo se nel percorso rimane tempo sufficiente per completare l’attesa prima del timeout di 91 giorni.
- Non utilizzare le attività Attendi per bloccare il rientro; utilizza invece l’opzione Consenti rientro nelle proprietà del percorso.
- Le espressioni di attesa personalizzate devono utilizzare il formato
dateTimeOnlye non devono includere un suffissoZo uno scostamento fuso orario esplicito. - L’utilizzo di una data statica fissa (ad esempio,
toDateTimeOnly('2024-01-01T01:11:00Z')) in un’attesa personalizzata può causare problemi; utilizzare invece date dinamiche specifiche per il profilo. - Gli attributi del profilo vengono aggiornati da Unified Profile Service dopo un nodo di attesa in Read Audience percorsi, che può produrre risultati imprevisti se si prevede la coerenza delle istantanee.
Terminologia:
- Nome canonico: Wait activity — Acronimo: none — varianti: Wait node, wait step
- Sinonimi: “Attesa durata” = “Attesa relativa”; “Attesa personalizzata” = “Attesa basata su espressione”
- Non confondere: “Attesa durata” (relativa, ad esempio 3 giorni da ora) ≠ “Attesa personalizzata” (data calcolata assoluta dai dati del profilo)
Domande frequenti:
- Q: Qual è la durata massima di un’attività Attendi? — La durata massima di attesa è di 90 giorni; anche i profili sono soggetti al timeout di percorso globale di 91 giorni.
- Q: in che modo la modalità di test gestisce le attività di attesa? — In modalità di test, il parametro “Wait time in test” (Tempo di attesa nel test) ignora la durata di attesa effettiva; il valore predefinito è 10 secondi, pertanto i test vengono completati rapidamente.
- Q: perché evitare di aggiungere Z a un’espressione di attesa personalizzata? — L’aggiunta di una Z o di uno scostamento di fuso orario a un’espressione
toDateTimeOnly()può bloccare i profili nell’attività di attesa. L’espressione deve basarsi sul fuso orario configurato del percorso. - Q: gli attributi del profilo vengono aggiornati dopo un nodo Wait? — Sì, nei percorsi che iniziano con Read Audience, il percorso aggiorna gli attributi del profilo da Unified Profile Service dopo l’attesa, in modo che le attività a valle possano visualizzare valori aggiornati anziché i dati dell’istantanea del pubblico originale.
- D: Cos’è il nodo di attesa automatico? — Un’attività Attendi di 3 giorni inserita automaticamente dopo le attività esperienza in entrata (in-app, basate su codice, scheda) per garantire che i profili rimangano nel percorso abbastanza a lungo per visualizzare il messaggio; può essere rimossa o riconfigurata in base alle esigenze.