DocumentationExperience PlatformGuide des destinations

Fonctions de transformation prises en charge dans Destination SDK

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

Créé pour :

  • Administration
  • Utilisateur ou utilisatrice

Experience Platform Destination SDK utilise des modèles Pebble, ce qui vous permet de transformer les données exportées d’Experience Platform au format demandé par la destination.

L’implémentation Pebble d’Experience Platform comporte quelques modifications par rapport à la version prête à l’emploi fournie par Pebble. En outre, en plus des fonctions prêtes à l’emploi fournies par Pebble, Adobe a créé des fonctions supplémentaires que vous pouvez utiliser avec Destination SDK.

IMPORTANT
Tous les noms et toutes les valeurs de paramètre pris en charge par Destination SDK sont sensibles à la casse. Pour éviter les erreurs de respect de la casse, utilisez les noms et valeurs des paramètres exactement comme indiqué dans la documentation.

Lieu d’utilisation where-to-use

Utilisez les fonctions prises en charge répertoriées ci-dessous sur cette page au moment de la création d’un modèle de transformation de message pour les données exportées depuis Experience Platform vers la destination.

Le modèle de transformation des messages est utilisé dans la configuration du serveur de destination pour les destinations de diffusion en streaming.

Conditions préalables prerequisites

Pour comprendre les concepts et les fonctions de cette page de référence, commencez par consulter le document relatif au format du message. Vous devez comprendre la structure d’un profil dans Experience Platform avant de pouvoir utiliser les modèles Pebble à transformer et les données exportées.

Avant d’accéder aux fonctions décrites ci-dessous, consultez les exemples de modèle dans la section Utiliser un langage de modèle pour les transformations d’identité, d’attributs et d’appartenance à une audience. Ces exemples commencent très simplement et se complexifient au fur et à mesure.

Fonction Pebble prise en charge supported-functions

Dans la section de balise Pebble, Destination SDK ne prend en charge que les éléments suivants :

TIP
L’utilisation de for est différente quand il s’agit de parcourir les éléments d’un tableau ou d’une map dans un modèle. Quand vous parcourez un tableau, vous pouvez obtenir l’élément directement. Quand vous parcourez une map, vous obtenez chaque entrée de map qui comporte une paire clé-valeur.
  • Pour obtenir un exemple d’élément de tableau, pensez aux identités d’un espace de nom identityMap, où vous pouvez parcourir des éléments tels que identityMap.gaid, identityMap.email ou similaires.
  • Pour obtenir un exemple d’élément map, pensez à segmentMembership.

Dans la section de filtre Pebble, Destination SDK prend en charge toutes les fonctions. Un exemple ci-dessous montre comment la fonction date peut être utilisée dans Destination SDK.

Dans la section de fonction Pebble, Adobe ne prend pas en charge la fonction de plage.

Exemple de la manière dont la fonction date est utilisée date-function

Pour illustrer comment les fonctions Pebble sont utilisées dans Destination SDK, consultez ci-dessous la manière dont la fonction de date (lien dans la documentation Pebble) est utilisée pour transformer le format d’une date et heure.

Cas d’utilisation

Vous souhaitez modifier la date et l’heure lastQualificationTime de la valeur ISO 8601 par défaut qu’Experience Platform exporte par une autre valeur préférée par la destination.

Exemple

Entrée

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

Sortie

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

Fonctions ajoutées par Adobe functions-added-by-adobe

Outre les fonctions prêtes à l’emploi fournies par Pebble, consultez ci-dessous les fonctions supplémentaires créées par Adobe que vous pouvez utiliser pour vos exportations de données.

Fonctions addedSegments et removedSegments addedsegments-removedsegments-functions

Cas d’utilisation

Ces fonctions peuvent être utilisées pour obtenir la liste des audiences qui ont été ajoutées ou supprimées d’un profil.

Exemple

Entrée
{
  "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 %}
Sortie
added: <111111><333333>; removed: <222222>

Étapes suivantes next-steps

Vous savez quelles fonctions Pebble sont prises en charge dans Destination SDK, ainsi que la manière de les utiliser pour ajuster le format des données exportées selon vos besoins. Vous devez à présent consulter les pages suivantes :

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