Funzioni di trasformazione supportate in Destination SDK
Experience Platform Destination SDK utilizza Pebble modelli, che consentono di trasformare i dati esportati da Experience Platform nel formato richiesto dalla destinazione.
L'implementazione di Experience Platform Pebble presenta alcune modifiche rispetto alla versione standard fornita da Pebble. Inoltre, oltre alle funzioni predefinite fornite da Pebble, Adobe ha creato alcune funzioni aggiuntive utilizzabili con Destination SDK.
Dove utilizzare where-to-use
Utilizza le funzioni supportate elencate di seguito in questa pagina quando crei un modello di trasformazione dei messaggi per i dati esportati da Experience Platform nella tua destinazione.
Il modello di trasformazione dei messaggi viene utilizzato nella configurazione del server di destinazione per le destinazioni di streaming.
Prerequisiti prerequisites
Per comprendere i concetti e le funzioni di questa pagina di riferimento, leggere prima il documento message format. È necessario conoscere la struttura di un profilo in Experience Platform prima di poter utilizzare i modelli Pebble per trasformare i dati esportati.
Prima di passare alle funzioni descritte di seguito, esaminare gli esempi di modelli nella sezione Utilizzo di un linguaggio di modelli per le trasformazioni di identità, attributi e appartenenza a un pubblico. Gli esempi qui presenti iniziano con una struttura molto semplice e aumentano di complessità.
Funzioni Pebble supportate supported-functions
Dalla sezione dei tag Pebble, Destination SDK supporta solo:
for è diverso quando si esegue l'iterazione tra gli elementi array o map in un modello. Quando esegui l’iterazione attraverso un array, puoi ottenere direttamente l’elemento. Quando si esegue l'iterazione di una mappa, si ottiene ogni voce della mappa che ha una coppia chiave-valore.- Per un esempio di elemento array, considera le identità in uno spazio dei nomi identityMap, dove è possibile eseguire iterazioni tra elementi come
identityMap.gaid,identityMap.emailo simili. - Per un esempio di elemento mappa, pensa a segmentMembership.
Dalla sezione del filtro Pebble, Destination SDK supporta tutte le funzioni. Un esempio più avanti mostra come la funzione date può essere utilizzata all'interno di Destination SDK.
Dalla sezione delle funzioni Pebble, Adobe non supporta not la funzione range.
Esempio di utilizzo della funzione date date-function
Per illustrare il modo in cui le funzioni Pebble vengono utilizzate in Destination SDK, vedere di seguito come la funzione data (link nella documentazione di Pebble) trasforma il formato di una marca temporale.
Caso d’uso date-use-case
Si desidera modificare il timestamp lastQualificationTime dal valore predefinito ISO 8601 esportato da Experience Platform a un altro valore preferito dalla destinazione.
Esempio date-example
Input date-input
{
"lastQualificationTime": "2022-02-08T18:34:24.000+0000"
}
Formato date-format
{{ lastQualificationTime | date(existingFormat="yyyy-MM-dd'T'HH:mm:sss.SSSX", format="yyyy-MM-dd'T'HH:mm:ssX") }}
Output date-output
{
"lastQualificationTime": "2022-02-21T18:34:24Z"
}
Funzioni aggiunte da Adobe functions-added-by-adobe
Oltre alle funzioni predefinite fornite da Pebble, vedere di seguito le funzioni aggiuntive create da Adobe che è possibile utilizzare per le esportazioni di dati.
addedSegments e removedSegments funzioni addedsegments-removedsegments-functions
Caso d’uso segments-use-case
Queste funzioni possono essere utilizzate per ottenere un elenco dei tipi di pubblico che sono stati aggiunti o rimossi da un profilo.
Esempio segments-example
Input segments-input
{
"identityMap": {
"myIdNamespace": [
{
"id": "external_id1"
},
{
"id": "external_id2"
}
]
},
"segmentMembership": {
"ups": {
"111111": {
"lastQualificationTime": "2019-11-20T13:15:49Z",
"status": "realized"
},
"222222": {
"lastQualificationTime": "2019-11-20T13:15:49Z",
"status": "exited"
},
"333333": {
"lastQualificationTime": "2019-11-20T13:15:49Z",
"status": "realized"
}
}
}
}
Formato segments-format
added: {% for s in addedSegments(segmentMembership.ups) %}<{{s.key}}>{% endfor %}; removed: {% for s in removedSegments(segmentMembership.ups) %}<{{s.key}}>{% endfor %}
Output segments-output
added: <111111><333333>; removed: <222222>
Passaggi successivi next-steps
È ora possibile sapere quali funzioni di Pebble sono supportate in Destination SDK e come utilizzarle per adattare il formato dei dati esportati alle proprie esigenze. Quindi, controlla le pagine seguenti: