Fonctions de transformation prises en charge dans Destination SDK
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.
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 connaître la structure d’un profil dans Experience Platform avant de pouvoir utiliser des modèles de Pebble pour transformer 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 :
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 noms identityMap, où vous pouvez parcourir des éléments tels que
identityMap.gaid,identityMap.emailou 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 de Pebble sont utilisées dans Destination SDK, consultez ci-dessous la manière dont la fonction de date (lien dans la documentation Pebble) transforme le format d’une date et heure.
Cas d’utilisation date-use-case
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 date-example
Entrée date-input
{
"lastQualificationTime": "2022-02-08T18:34:24.000+0000"
}
Format date-format
{{ lastQualificationTime | date(existingFormat="yyyy-MM-dd'T'HH:mm:sss.SSSX", format="yyyy-MM-dd'T'HH:mm:ssX") }}
Sortie date-output
{
"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 segments-use-case
Ces fonctions peuvent être utilisées pour obtenir la liste des audiences qui ont été ajoutées ou supprimées d’un profil.
Exemple segments-example
Entrée 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"
}
}
}
}
Format segments-format
added: {% for s in addedSegments(segmentMembership.ups) %}<{{s.key}}>{% endfor %}; removed: {% for s in removedSegments(segmentMembership.ups) %}<{{s.key}}>{% endfor %}
Sortie segments-output
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 :