Utilizzare i dati Adobe Experience Platform nei percorsi datalookup

Filtro basato su categorie di prodotti

Scenario:Send un coupon per gli utenti che spendono più di $ 40 per i prodotti per la casa.

Flusso Percorso:

1. Evento di acquisto: acquisisci SKU dal carrello dell’utente.

2. Attività di ricerca set di dati:

   • Set di dati: products-dataset (SKU come chiave primaria).
   • Chiavi di ricerca: list(@event{purchase_event.products.sku}).
   • Campi da restituire: ["SKU", "category", "price"].

3. Attività condizione:

   • Filtra gli SKU in cui la categoria è “famiglia”.

     code language-none
     @event{purchase_event.products.all( in(currentEventField.sku, @datasetlookup{MyDatasetLookupActivity1.entities.all(currentDatasetLookupField.category == 'household').sku} ) )}

   O

   • Aggrega la spesa totale per i prodotti per la casa e confrontala con la soglia di 40 $.

     code language-none
     sum(@event{purchase_event.products.all( in(currentEventField.sku, @datasetlookup{MyDatasetLookUpActivity1.entities.all(currentDatasetLookupField.category == 'household').sku} ) )}.price}, ',', true ) > 40

4. Editor Personalization:

   Utilizza i dati arricchiti per personalizzare il contenuto dell’e-mail:

   code language-none
   {% let householdTotal = 0 %} {{#each journey.datasetlookup.3709000.entities as |product|}} {%#if get(product, "category") = "household"%} {% let householdTotal = householdTotal + product.price %}{%/if%} {{/each}} "Hi, thanks for spending " + {%= householdTotal %} + " on household products. Here is your reward!"

Personalization che utilizza dati fedeltà esterni

Scenario: identifica l’account e-mail per un profilo con stato di fedeltà Platinum. In questo scenario, l’account fedeltà è associato a un ID e-mail e i dati fedeltà non sono disponibili nell’archivio di ricerca profilo standard.

Flusso Percorso:

1. Attivatore evento profilo: acquisisce gli ID e-mail dal profilo o dal contesto dell’evento.

2. Attività di ricerca set di dati:

   • Set di dati: loyalty-member-dataset (e-mail come chiave primaria).
   • Chiavi di ricerca: @profile.email.
   • Campi da restituire: ["email", "loyaltyTier"].

3. Attività condizione:

   Dividi il percorso in base al livello di fedeltà:

   code language-none
   @datasetLookup{MyDatasetLookUpActivity1.entity.loyaltyMember.loyaltyTier} == 'Platinum'

4. Editor Personalization:

   Utilizza i dati del livello fedeltà arricchito per personalizzare la comunicazione in uscita:

   code language-none
   {{context.journey.datasetLookup.1482319411.entity.loyaltyMember.loyaltyTier}}

Guida di riferimento della Knowledge Base di AI

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à di ricerca del set di dati per recuperare in modo dinamico i dati del set di dati del record di AEP in fase di esecuzione del percorso per la personalizzazione in tempo reale e la logica condizionale.

Intenti:

• Aggiungere un’attività di ricerca del set di dati a un percorso per recuperare i dati dei record AEP esterni in fase di esecuzione
• Seleziona campi di set di dati specifici (nodi foglia/valori primitivi) da recuperare durante la ricerca
• Definisci una chiave di ricerca in modalità avanzata per unire il contesto del percorso con i record dei set di dati
• Utilizzare dati di set di dati arricchiti nell’editor di espressioni di percorso o nell’editor di personalizzazione
• Risolvere i problemi relativi a “Ricerca set di dati non trovata” errori causati dall’utilizzo della modalità semplice per la chiave di ricerca

Glossario:

• Attività di ricerca set di dati: un’attività di orchestrazione del percorso che recupera dati dai set di dati dei record di AEP in fase di esecuzione utilizzando una chiave di join (specifica per prodotto)
• Nodo foglia: campo al livello più basso di una gerarchia di schemi che contiene un valore primitivo (stringa, numero, booleano, data) (specifico per prodotto)
• Chiave di ricerca: l’espressione di unione (stringa o elenco di stringhe) utilizzata per associare i dati contestuali del percorso ai record nel set di dati selezionato (specifico per prodotto)
• Dati arricchiti: dati recuperati da un’attività di ricerca del set di dati e memorizzati temporaneamente nel contesto del percorso per l’utilizzo in attività a valle (specifiche per prodotto)

Guardrail:

• Massimo 10 attività di ricerca del set di dati al percorso.
• Massimo 20 campi selezionati per attività di ricerca.
• Massimo 50 chiavi nell’array delle chiavi di ricerca.
• La dimensione dei dati arricchiti è limitata a 10 KB.
• Il set di dati deve essere abilitato per la ricerca in Adobe Experience Platform prima che venga visualizzato nella configurazione dell’attività.
• È possibile selezionare solo nodi foglia (valori primitivi); non è possibile selezionare matrici e mappe.
• Come chiavi di ricerca sono supportati solo stringhe o elenchi di stringhe.
• La chiave di ricerca deve essere definita in modalità avanzata; l’utilizzo della modalità semplice fa sì che l’output dell’attività non sia disponibile come attributo di contesto a valle.
• I dati arricchiti sono transitori e disponibili solo durante il runtime del percorso e nella personalizzazione delle attività in uscita.
• Per prestazioni ottimali, limita a 5 attività di ricerca al percorso (scelta consigliata); il limite massimo imposto dal sistema è di 10 attività al percorso. Si consigliano inoltre fino a 20 attributi per ricerca.

Terminologia:

• Nome canonico: attività di ricerca del set di dati — Acronimo: n/d — varianti: ricerca dati di AEP, attività di arricchimento dati
• Sinonimi: “chiave di ricerca” = “chiave di unione”
• Non confondere: “Attività di ricerca set di dati” ≠ “Ricerca eventi esperienza” — la ricerca set di dati recupera i dati del set di dati record, non gli eventi esperienza della serie temporale

Domande frequenti:

• Q: perché il set di dati non viene visualizzato nel menu a discesa del campo Set di dati? — Il set di dati deve essere abilitato per la ricerca in Adobe Experience Platform. Segui le istruzioni riportate nella sezione Da leggere per abilitarla.
• Q: perché @datasetLookup{} restituisce un errore “Ricerca set di dati non trovata” in una condizione? — La chiave di ricerca è stata definita utilizzando la modalità semplice anziché la modalità avanzata. Ridefiniscilo in modalità avanzata e ripubblica il percorso.
• Q: è possibile recuperare matrici o mappare campi dal set di dati? — No, è possibile selezionare solo i campi primitivi dei nodi foglia (stringa, numero, booleano, data).
• D: come posso accedere ai dati arricchiti in un messaggio e-mail? — Utilizzare l’editor di personalizzazione con la sintassi {{context.journey.datasetLookup.<activityId>.entities}}.
• Q: i dati arricchiti vengono mantenuti dopo la fine del percorso? — No, i dati arricchiti sono transitori e disponibili solo durante la sessione di runtime del percorso.