DokumentationExperience PlatformZielhandbuch

Unterstützte Umwandlungsfunktionen in Destination SDK

Last update: Tue Oct 31 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Admin
  • User

Das Destination SDK von Experience Platform verwendet Pebble -Vorlagen, womit Sie die aus Experience Platform exportierten Daten in das für Ihr Ziel erforderliche Format umwandeln können.

Die Pebble -Implementierung in Experience Platform hat einige Änderungen gegenüber der nativen Version, die von Pebble bereitgestellt wird. Zusätzlich zu den vordefinierten Funktionen von Pebble hat Adobe einige zusätzliche Funktionen erstellt, die Sie mit Destination SDK verwenden können.

IMPORTANT
Bei allen von Destination SDK unterstützten Parameternamen und Werten wird nach Groß-/Kleinschreibung unterschieden. Um Fehler bei der Groß-/Kleinschreibung zu vermeiden, verwenden Sie bitte die Parameternamen und -werte genau wie in der Dokumentation dargestellt.

Verwendungsbereiche where-to-use

Verwenden Sie die unten aufgeführten unterstützten Funktionen auf dieser Seite, wenn Sie für die Daten, die aus Experience Platform an Ihr Ziel exportiert wurden, eine Nachrichtenumwandlungsvorlage erstellen.

Die Nachrichtenumwandlungsvorlage wird in der Ziel-Server-Konfiguration für Streaming-Ziele verwendet.

Voraussetzungen prerequisites

Um die Konzepte und Funktionen auf dieser Referenzseite zu verstehen, lesen Sie zunächst das Dokument zum Nachrichtenformat. Sie müssen die Profilstruktur in Experience Platform verstehen, bevor Sie Pebble-Vorlagen zur Transformation der exportierten Daten verwenden können.

Bevor Sie zu den unten dokumentierten Funktionen übergehen, sehen Sie sich die Beispielvorlagen im Abschnitt Verwenden einer Vorlagensprache für die Transformationen von Identitäten, Attributen und Zielgruppenzugehörigkeiten an. Die Beispiele dort beginnen sehr einfach und werden immer komplexer.

Unterstützte Pebble-Funktionen supported-functions

Aus dem Pebble-Tags-Abschnitt unterstützt Destination SDK nur:

TIP
Die Verwendung von for unterscheidet sich bei der Iteration durch Array- oder Zuordnungs-Elemente in einer Vorlage. Wenn Sie durch ein Array navigieren, können Sie das Element direkt abrufen. Wenn Sie durch eine Zuordnung (Map) navigieren, erhalten Sie jeden Map-Eintrag, der über ein Schlüssel-Wert-Paar verfügt.
  • Betrachten Sie zum Beispiel für ein Array-Element die Identitäten in einem identityMap-Namespace, in dem Sie durch Elemente wie identityMap.gaid, identityMap.email oder Ähnliches iterieren können.
  • Nehmen Sie als Beispiel für ein Zuordnungselement segmentMembership.

Aus dem Abschnitt der Pebble-Filter unterstützt Destination SDK alle Funktionen. Ein Beispiel weiter unten zeigt, wie die Funktion date in Destination SDK verwendet werden kann.

Aus dem Pebble-Funktionsabschnitt unterstützt Adobe nicht die Funktion range.

Beispiel für die Verwendung der Funktion date date-function

Um zu veranschaulichen, wie die Pebble-Funktionen in Destination SDK verwendet werden, sehen Sie unten, wie die Datumsfunktion (Link in der Pebble-Dokumentation) verwendet wird, um das Format eines Zeitstempels zu transformieren.

Anwendungsfall

Sie möchten den lastQualificationTime Zeitstempel vom Standard-ISO 8601-Wert, den Experience Platform exportiert, in einen anderen von Ihrem Ziel bevorzugten Wert ändern.

Beispiel

Eingabe

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

Format

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

Ausgabe

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

Von Adobe hinzugefügte Funktionen functions-added-by-adobe

Zusätzlich zu den vordefinierten Funktionen von Pebble sehen Sie unten die zusätzlichen Funktionen, die von Adobe erstellt wurden und die Sie für Ihre Datenexporte verwenden können.

Funktionen addedSegments und removedSegments addedsegments-removedsegments-functions

Anwendungsfall

Diese Funktionen können verwendet werden, um eine Liste von Zielgruppen zu erhalten, die einem Profil hinzugefügt oder daraus entfernt wurden.

Beispiel

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

Nächste Schritte next-steps

Sie wissen jetzt, welche Pebble -Funktionen in Destination SDK unterstützt werden und wie Sie sie verwenden können, um das Format der exportierten Daten an Ihre Anforderungen anzupassen. Als Nächstes sollten Sie die folgenden Seiten lesen:

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