In questa pagina: Scopri come utilizzare identificatori supplementari, identificatori secondari come un ID ordine o prenotazione, per eseguire un’istanza di percorso separata per identificatore e personalizzare i messaggi con i relativi attributi.
Per impostazione predefinita, i percorsi vengono eseguiti nel contesto di un ID profilo. Questo significa che, se il profilo è attivo in un dato percorso, non potrà rientrare in un altro percorso. Per evitare questo problema, Journey Optimizer consente di acquisire un identificatore supplementare, ad esempio un ID ordine, un ID abbonamento, un ID prescrizione, oltre all'ID profilo.
In questo esempio, è stato aggiunto un ID prenotazione come identificatore supplementare.
In questo modo, i percorsi vengono eseguiti nel contesto dell’ID profilo associato all’identificatore supplementare (in questo caso, l’ID prenotazione). Viene eseguita un’istanza del percorso per ogni iterazione dell’identificatore supplementare. Questo consente più ingressi dello stesso ID profilo nei percorsi se sono state effettuate prenotazioni diverse.
Inoltre, Journey Optimizer consente di sfruttare gli attributi dell’identificatore supplementare (ad esempio, numero di prenotazione, data di rinnovo della prescrizione, tipo di prodotto) per la personalizzazione dei messaggi, garantendo comunicazioni altamente pertinenti.
➡️ Scopri questa funzione nel video
Guardrail e limitazioni guardrails
-
percorsi supportati: sono supportati identificatori supplementari per percorsi attivati da eventi e di pubblico di lettura. Sono non supportati per i percorsi di qualificazione del pubblico (ovvero, percorsi che iniziano con un’attività di qualificazione del pubblico).
-
Azioni in entrata: gli identificatori supplementari non sono attualmente supportati per le azioni in entrata, ad esempio in-app e web.
-
Limiti di istanze simultanee: i profili non possono avere più di 10 istanze di percorso simultanee.
-
Tipo di dati e struttura dello schema: l’identificatore supplementare deve essere di tipo
string. Può essere un attributo di stringa indipendente oppure un attributo di stringa all’interno di una matrice di oggetti. L’attributo di stringa indipendente darà luogo a una singola istanza di percorso, mentre l’attributo di stringa all’interno di una matrice di oggetti darà luogo a un’istanza di percorso univoca per iterazione della matrice di oggetti. Gli array di stringhe e le mappe non sono supportati. -
Rientro Percorso
Il comportamento di rientro percorso con identificatori supplementari segue la politica di rientro esistente:
- Se il percorso non è un rientro, la stessa combinazione di ID profilo + ID supplementare non può rientrare nel percorso.
- Se il percorso è rientro con una finestra temporale, la stessa combinazione di ID profilo + ID supplementare può essere reinserita dopo la finestra temporale definita.
-
Etichettatura e applicazione uso dati (DULE) - Nessun controllo di convalida DULE eseguito sull’ID supplementare. Questo significa che questo attributo non verrà considerato quando il percorso cerca violazioni dei criteri di governance dei dati.
-
Configurazione eventi downstream
Se utilizzi un altro evento a valle nel percorso, questo deve utilizzare lo stesso ID supplementare e avere lo stesso ID spazio dei nomi.
-
Leggi percorsi di pubblico
- Eventi di business: l’ID supplementare è disabilitato se si utilizza un evento di business.
- Campi evento e contesto: l’identificatore supplementare non deve provenire da un campo contesto evento o percorso.
- Selezione attributo: qualsiasi attributo non di identità (o identità non di persona) può essere utilizzato come ID supplementare, per tutti i tipi di pubblico (Servizio profilo unificato, importazione CSV e Composizione pubblico federato). Gli attributi di identità basati su persona non sono consentiti. Per i tipi di pubblico esterni, vedi Identificatori supplementari con tipi di pubblico esterni per i modelli di dati supportati e i requisiti di configurazione.
- Frequenza di lettura: per percorsi di pubblico di lettura che utilizzano un campo ID supplementare di tipo array, la frequenza di lettura dell’attività Read audience è limitata a un massimo di 500 profili al secondo.
Comportamento dei criteri di uscita con ID supplementari exit-criteria
Precondizione: Percorso abilitato per l’ID supplementare (tramite attività evento unitario o attività di lettura del pubblico)
La tabella seguente spiega il comportamento dei profili in un percorso supplementare abilitato per gli ID quando è configurato il criterio di uscita:
Nota: lo spazio dei nomi ID supplementare deve corrispondere a quello del nodo iniziale.
Aggiungere un identificatore supplementare e sfruttarlo in un percorso add
Per utilizzare un identificatore supplementare in un percorso attivato da un evento, effettua le seguenti operazioni:
-
Aggiungi l’ID supplementare all’evento
-
Crea o modifica l’evento desiderato. Scopri come configurare un evento unitario
-
Nella schermata di configurazione dell’evento, selezionare l’opzione Usa identificatore supplementare.
-
Utilizza l’editor espressioni per selezionare il campo da utilizzare come ID supplementare (ad esempio, ID prenotazione, ID abbonamento).
note NOTE Assicurarsi di utilizzare l'editor espressioni in modalità avanzata per selezionare l'attributo.
-
-
Aggiungi l’evento al percorso
Trascina l’evento configurato nell’area di lavoro del percorso. Attiva la voce percorso in base sia all’ID profilo che all’ID supplementare.
Per utilizzare un identificatore supplementare in un percorso Read audience, effettua le seguenti operazioni:
-
Aggiungi e configura un’attività Read audience nel percorso
-
Trascina nel percorso un’attività Read audience.
-
Nel riquadro delle proprietà dell’attività attivare l’opzione Usa identificatore supplementare.
-
Nel campo Identificatore supplementare, utilizzare l’editor espressioni per selezionare l’attributo dell’identificatore supplementare.
Per i tipi di pubblico importati da un file CSV, se il pubblico CSV contiene più righe per ID profilo, assicurati che Attivazione rapida sia prima abilitata. Consulta Identificatori supplementari con tipi di pubblico esterni.
note Assicurati di utilizzare l'editor espressioni in Modalità avanzata per selezionare l'attributo. -
Utilizzo degli attributi ID supplementari
Utilizza l’editor di espressioni e l’editor di personalizzazione per fare riferimento agli attributi dell’identificatore supplementare per la personalizzazione o la logica condizionale. Gli attributi sono accessibili dal menu Attributi contestuali.
Per i percorsi attivati da eventi se si utilizzano array (ad esempio, più prescrizioni o criteri), utilizzare una formula per estrarre elementi specifici.
In un array di oggetti con ID supplementare come bookingNum e un attributo allo stesso livello denominato bookingCountry, il percorso eseguirà un’iterazione nell’oggetto array in base al bookingNum e creerà un’istanza di percorso per ogni oggetto.
-
L’espressione seguente nell’attività condizione eseguirà un’iterazione nella matrice di oggetti e verificherà se il valore di
bookingCountryè uguale a “FR”:code language-none @event{<event_name>.<object_path>.<object_array_name>.all(currentEventField.<attribute_path>.bookingNum==${supplementalId}).at(0).<attribute_path>.bookingCountry}=="FR" -
L’espressione seguente nell’editor di personalizzazione e-mail eseguirà un’iterazione nell’array di oggetti, estrae
bookingCountryapplicabile all’istanza di percorso corrente e lo visualizza nel contenuto:code language-none {{#each context.journey.events.<event_ID>.<object_path>.<object_array_name> as |l|}} {%#if l.<attribute_path>.bookingNum = context.journey.technicalProperties.supplementalId%} {{l.<attribute_path>.bookingCountry}} {%/if%} {{/each}} -
Esempio dell’evento utilizzato per attivare il percorso:
code language-none "bookingList": [ { "bookingInfo": { "bookingNum": "x1", "bookingCountry": "US" } }, { "bookingInfo": { "bookingNum": "x2", "bookingCountry": "FR" } } ]
ID supplementare e arbitrato di percorso arbitration
L’arbitrato di percorso (inclusi i limiti di concorrenza e il conteggio delle voci all’interno dei set di regole) funziona a livello di ID profilo, non a livello di coppia (ID profilo, ID supplementare). Ciò significa che un limite di concorrenza pari a 1 può bloccare una seconda istanza di percorso per lo stesso profilo anche quando presenta un diverso valore ID supplementare.
Contatta il tuo rappresentante Adobe per indicazioni sul comportamento di arbitrato prima di affidarti a specifiche impostazioni di arbitrato in produzione.
Documentazione correlata:
Identificatori supplementari con pubblico esterno external-audiences
L’ID supplementare è supportato per i tipi di pubblico esterni, inclusi i tipi di pubblico importati da un file CSV e quelli creati con Federated Audience Composition. Quando configuri un percorso che legge da un pubblico di tipo CSV o Federated Audience Composition, puoi designare qualsiasi attributo non di identità in tale pubblico come ID supplementare. Journey Optimizer crea quindi un’istanza di percorso separata per ogni combinazione di profilo univoco + ID supplementare.
-
Caso d’uso 1: una riga per profilo univoco + coppia di ID supplementare
Questo è il caso d’uso principale per i tipi di pubblico CSV e Federated Audience Composition. Il pubblico contiene più righe in cui ogni riga rappresenta una combinazione univoca di un profilo (ad esempio, un cliente) e un ID supplementare (ad esempio, un account o un ID ordine). Ogni riga viene considerata come record di attivazione indipendente.
table 0-row-3 1-row-3 2-row-3 3-row-3 profile_id account_id (ID supplementare) other_attributes customer_001 ACC-1001 … customer_001 ACC-1002 … customer_002 ACC-2001 … In questo esempio,
customer_001ha due account. Journey Optimizer crea un’istanza di percorso separata per ogni coppia univoca di profilo +account_id. -
Caso d’uso 2: una riga per profilo con un array di ID supplementari
Questo caso d’uso è disponibile per i tipi di pubblico che supportano gli array. Una singola riga del pubblico contiene un profilo con un attributo array contenente più valori ID supplementari. Journey Optimizer crea un’istanza di percorso per valore nell’array.
table 0-row-3 1-row-3 2-row-3 profile_id account_ids (array, ID supplementare) other_attributes customer_001 [ACC-1001, ACC-1002] … customer_002 [ACC-2001] … In questo esempio, Journey Optimizer genera due istanze di percorso per
customer_001(una per ID account) e una percustomer_002. Questo si comporta in modo coerente con il funzionamento dell’ID supplementare per i tipi di pubblico del servizio Unified Profile.
Come configurare external-configuration
Per i tipi di pubblico CSV che utilizzano il caso d’uso 1 (in cui il pubblico contiene intenzionalmente più righe per lo stesso ID profilo) è necessario abilitare la funzione Attivazione rapida prima di configurare il percorso. Consulta i prerequisiti di seguito. Per tutti gli altri casi, configura direttamente il percorso.
| note important |
|---|
| IMPORTANT |
Questo prerequisito si applica solo ai tipi di pubblico CSV in cui il pubblico contiene intenzionalmente più righe per lo stesso ID profilo (Caso d’uso 1). I tipi di pubblico con Composizione del pubblico federato hanno l’attivazione rapida abilitata per impostazione predefinita e non richiedono questo passaggio. L'interfaccia utente di Audience Portal non supporta l'impostazione di expressActivation. È necessario utilizzare l'API del pubblico esterno. |
Abilitare expressActivation sul pubblico al momento della creazione. Questo comunica a Journey Optimizer di attivare ogni record in modo indipendente, senza deduplicazione per ID profilo. Questo flag non può essere modificato dopo la creazione del pubblico.
Utilizza la seguente chiamata API durante la creazione del pubblico:
Endpoint:
| code language-http |
|---|
|
Intestazioni richieste:
| code language-http |
|---|
|
Corpo della richiesta (set expressActivation: true):
| code language-json |
|---|
|
| note |
|---|
| NOTE |
expressActivation utilizza false per impostazione predefinita. Deve essere impostato al momento della creazione del pubblico e non può essere modificato dopo la creazione. Per impostazione predefinita, per tutti i tipi di pubblico di Federated Audience Composition è abilitata l’attivazione rapida e non è necessario questo flag. |
Consulta la documentazione di creazione API per pubblico esterno per il riferimento completo.
Per configurare il percorso:
- Aprire o creare un percorso con un nodo Read audience.
- Nelle impostazioni del nodo Read audience, seleziona il pubblico CSV o Federated Audience Composition.
- Attiva l’opzione Usa identificatore supplementare, quindi nel campo Identificatore supplementare utilizza l’editor espressioni in Modalità avanzata per scegliere l’attributo da utilizzare come identificatore secondario (ad esempio,
account_id,order_number). - L’attributo selezionato viene trattato come ID supplementare per il percorso; non è richiesta alcuna registrazione di identità.
Comportamento di deduplicazione external-dedup
Quando per un pubblico è abilitata l’attivazione rapida (sempre true per Federated Audience Composition, deve essere impostata in modo esplicito per CSV), Journey Optimizer gestisce la deduplicazione in base alla configurazione del percorso:
Casi d’uso di esempio
Questi esempi mostrano come gli identificatori supplementari supportano più record correlati.
Notifiche di rinnovo dei criteri
-
Scenario: un provider di assicurazioni invia promemoria di rinnovo per ogni polizza attiva detenuta da un cliente.
-
Esecuzione:
- Voce principale: John.
- ID supplementari:
"AutoPolicy123", "HomePolicy456". - Il percorso viene eseguito separatamente per ogni criterio, con date di rinnovo personalizzate, dettagli sulla copertura e informazioni sui premi.
Gestione abbonamenti
-
Scenario: un servizio di sottoscrizione invia messaggi personalizzati per ogni sottoscrizione quando viene attivato un evento per tale sottoscrizione.
-
Esecuzione:
- Voce principale: Jane.
- ID supplementari:
"Luma Yoga Program ", "Luma Fitness Program". - Ogni evento include un ID abbonamento e i dettagli relativi a tale abbonamento. Il percorso viene eseguito separatamente per ogni evento/abbonamento, consentendo offerte di rinnovo personalizzate per abbonamento.
Consigli di prodotto
-
Scenario: una piattaforma di e-commerce invia consigli basati su prodotti specifici acquistati da un cliente.
-
Esecuzione:
- Voce principale: Alex.
- ID supplementari:
"productID1234", "productID5678". - Il percorso viene eseguito separatamente per ciascun prodotto, con opportunità di upselling personalizzate.
Video introduttivo video
Scopri come abilitare e applicare un identificatore supplementare in Adobe Journey Optimizer.