Funzioni di trasformazione supportate nella Destination SDK

Panoramica

Experience Platform Destination SDK utilizza Pebble modelli, che consente di trasformare i dati esportati da Experience Platform nel formato richiesto dalla destinazione.

L'Experience Platform Pebble l’implementazione 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

Utilizza le funzioni supportate elencate di seguito in questa pagina quando creazione di un modello di trasformazione dei messaggi per i dati esportati da Experience Platform alla destinazione. Il modello di trasformazione del messaggio viene utilizzato nel configurazione del server di destinazione per le destinazioni di streaming.

Prerequisiti

Per comprendere i concetti e le funzioni di questa pagina di riferimento, leggere il formato messaggio prima il documento. Devi capire il struttura di un profilo in Experience Platform prima di poter utilizzare Pebble modelli per trasformare e esportare i dati.

Prima di passare alle funzioni documentate di seguito, controlla gli esempi di modelli nella sezione Utilizzo di un linguaggio di template per le trasformazioni di identità, attributi e appartenenza ai segmenti. Gli esempi che ci sono iniziano molto semplici e aumentano la complessità.

Supportato Pebble Funzioni

Da Pebble sezione tag, Destination SDK supporta solo:

SUGGERIMENTO

Utilizzo for è diverso durante l’iterazione attraverso array o map elementi in un modello. Quando si esegue l'iterazione attraverso un array, è possibile ottenere l'elemento direttamente. Quando si esegue l'iterazione attraverso una mappa, si ottiene ogni voce mappa, che ha una coppia chiave-valore.

  • Per un esempio di un elemento array, considera le identità in un identityMap spazio dei nomi, in cui è possibile eseguire iterazioni attraverso elementi quali identityMap.gaid, identityMap.emailo simili.
  • Per un esempio di elemento mappa, pensa segmentMembership.

Da Pebble sezione filtro, Destination SDK supporta tutte le funzioni. Un esempio ulteriore qui di seguito mostra come date può essere utilizzata all'interno della Destination SDK.

Da Pebble sezione funzioni, Adobe sì not supportano gamma funzione .

Esempio di come date viene utilizzata la funzione

Per esemplificare come Pebble le funzioni sono utilizzate nella Destination SDK, vedi sotto come la funzione data (link nella documentazione di Pebble) viene utilizzato per trasformare il formato di una marca temporale.

Caso d’uso

Vuoi cambiare il lastQualificationTime timestamp dal valore predefinito ISO 8601 valore esportato da Experience Platform in un altro valore preferito dalla destinazione.

Esempio

Ingresso

{
"lastQualificationTime": "2022-02-08T18:34:24.000+0000"
}

Formato

{{ lastQualificationTime | date(existingFormat="yyyy-MM-dd'T'HH:mm:sss.SSSX", format="yyyy-MM-dd'T'HH:mm:ssX") }}

Output

{
"lastQualificationTime": "2022-02-21T18:34:24Z"
}

Funzioni aggiunte dall’Adobe

Oltre alle funzioni predefinite fornite da Pebble, vedi di seguito le funzioni aggiuntive create da Adobe che puoi utilizzare per le esportazioni di dati.

addedSegments e removedSegments Funzioni

Caso d’uso

Puoi utilizzare queste funzioni per ottenere un elenco di segmenti che sono stati aggiunti o rimossi da un profilo.

Esempio

Ingresso
{
  "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
added: {% for s in addedSegments(segmentMembership.ups) %}<{{s.key}}>{% endfor %}; removed: {% for s in removedSegments(segmentMembership.ups) %}<{{s.key}}>{% endfor %}
Uscita
added: <111111><333333>; removed: <222222>

Passaggi successivi

Ora sai quale Pebble Le funzioni sono supportate in Destination SDK e come utilizzarle per regolare il formato dei dati esportati in base alle tue esigenze. Quindi, devi rivedere le pagine seguenti:

In questa pagina