Utilizzare i dati di Adobe Experience Platform per la personalizzazione aep-data

Apri l’editor di personalizzazione, disponibile in ogni contesto in cui puoi definire la personalizzazione, ad esempio i messaggi. Scopri come utilizzare l'editor di personalizzazione

Passare all'elenco delle funzioni di supporto e aggiungere la funzione di supporto datasetLookup al riquadro del codice.

Questa funzione fornisce una sintassi predefinita per consentire di chiamare campi dai set di dati di Adobe Experience Platform. La sintassi è la seguente:

{{datasetLookup datasetId="datasetId" id="key" result="store" required=false}}

• datasetId è l'ID del set di dati con cui stai lavorando.

• id è l'ID della colonna di origine che deve essere unita all'identità primaria del set di dati di ricerca.

  note note
  NOTE
  Il valore immesso per questo campo può essere un ID campo (profile.packages.packageSKU), un campo passato in un evento di percorso (context.percorsi.events.event_ID.productSKU) o un valore statico (sku007653). In ogni caso, il sistema utilizzerà il valore e la ricerca nel set di dati per verificare se corrisponde a una chiave.
  Se utilizzi un valore stringa letterale per la chiave, tieni il testo tra virgolette. Esempio: {{datasetLookup datasetId="datasetId" id="SKU1234" result="store" required=false}}. Se si utilizza un valore di attributo come chiave dinamica, rimuovere le virgolette. Esempio: {{datasetLookup datasetId="datasetId" id=category.product.SKU result="SKU" required=false}}

• result è un nome arbitrario che devi fornire per fare riferimento a tutti i valori di campo che stai per recuperare dal set di dati. Questo valore verrà utilizzato nel codice per chiamare ogni campo.

• required=false: se required è impostato su TRUE, il messaggio verrà recapitato solo se viene trovata una chiave corrispondente. Se è impostato su false, non è necessaria una chiave corrispondente e il messaggio può ancora essere recapitato. Se impostato su false, è consigliabile tenere conto dei valori di fallback o predefiniti nel contenuto del messaggio.

Adatta la sintassi in base alle tue esigenze. In questo esempio, vogliamo recuperare i dati relativi ai voli dei passeggeri. La sintassi è la seguente:

{{datasetLookup datasetId="1234567890abcdtId" id=profile.upcomingFlightId result="flight"}}

• Stiamo lavorando nel set di dati il cui ID è "1234567890abcdtId",
• Il campo che si desidera utilizzare per effettuare un'unione con il set di dati di ricerca è profile.upcomingFlightId,
• Vogliamo includere tutti i valori dei campi nel riferimento "volo".

Una volta configurata la sintassi da chiamare nel set di dati di Adobe Experience Platform, puoi specificare quali campi recuperare. La sintassi è la seguente:

{{result.fieldId}}

• result è il valore assegnato al parametro result nella funzione helper MultiEntity. In questo esempio "flight".

• fieldID è l'ID del campo che si desidera recuperare. Questo ID è visibile nell'interfaccia utente di Adobe Experience Platform durante la navigazione nello schema di record relativo al set di dati:

  accordion
  Dove recuperare un ID campo?
  Gli ID dei campi possono essere recuperati durante l’anteprima di un set di dati nell’interfaccia utente di Adobe Experience Platform. Scopri come visualizzare in anteprima i set di dati nella documentazione di Adobe Experience Platform.

In questo esempio, vogliamo utilizzare le informazioni relative all'orario di imbarco e al gate dei passeggeri. Pertanto, aggiungiamo queste due righe:

• {{flight._myorg.booking.boardingTime}}
• {{flight._myorg.booking.gate}}

Ora che il codice è pronto, puoi completare il contenuto come di consueto e testarlo utilizzando il pulsante Simula contenuto per controllare la personalizzazione. Scopri come visualizzare in anteprima e testare il contenuto