DocumentazioneExperience PlatformGuida alle destinazioni

Funzioni di trasformazione supportate in Destination SDK

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Amministratore
  • Utente

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 preconfigurata fornita da Pebble. Inoltre, oltre alle funzioni predefinite fornite da Pebble, Adobe ha creato alcune funzioni aggiuntive che è possibile utilizzare con Destination SDK.

IMPORTANT
Tutti i nomi e i valori dei parametri supportati da Destination SDK sono con distinzione tra maiuscole e minuscole. Per evitare errori di distinzione tra maiuscole e minuscole, utilizza i nomi e i valori dei parametri esattamente come mostrato nella documentazione.

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 e 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:

TIP
L'utilizzo di 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.email o 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 esemplificare l'utilizzo di Pebble funzioni in Destination SDK, vedere di seguito come viene utilizzata la funzione data (link nella documentazione di Pebble) per trasformare il formato di una marca temporale.

Caso d’uso

Si desidera modificare il timestamp lastQualificationTime dal valore predefinito ISO 8601 che Experience Platform esporta in un altro valore preferito dalla destinazione.

Esempio

Input

{
"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 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

Queste funzioni possono essere utilizzate per ottenere un elenco dei tipi di pubblico che sono stati aggiunti o rimossi da un profilo.

Esempio

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

Passaggi successivi next-steps

Ora si sa 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:

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6