Omformningsfunktioner som stöds i Destination SDK
Experience Platform Destination SDK använder Pebble mallar, vilket gör att du kan omvandla data som exporteras från Experience Platform till det format som krävs för målplatsen.
Implementeringen av Experience Platform Pebble har vissa ändringar jämfört med den körklara versionen som tillhandahålls av Pebble. Utöver de färdiga funktionerna som tillhandahålls av Pebble har Adobe även skapat ytterligare funktioner som du kan använda med Destination SDK.
Används where-to-use
Använd de funktioner som stöds nedan på den här sidan när du skapar en meddelandeomformningsmall för data som exporteras från Experience Platform till ditt mål.
Meddelandetransformeringsmallen används i målserverkonfigurationen för direktuppspelningsmål.
Förutsättningar prerequisites
Om du vill förstå begreppen och funktionerna på den här referenssidan läser du först dokumentet meddelandeformat. Du måste förstå strukturen för en profil i Experience Platform innan du kan använda Pebble-mallar för att omforma exporterade data.
Innan du går vidare till de funktioner som beskrivs nedan bör du granska mallexemplen i avsnittet Använda ett mallspråk för identitet, attribut och konverteringar av målgruppsmedlemskap. Exemplen där börjar mycket enkelt och blir mer komplicerade.
Pebble funktioner som stöds supported-functions
I taggavsnittet Pebble stöder Destination SDK endast:
for skiljer sig åt när du itererar genom elementen array eller map i en mall. När du itererar genom en array kan du hämta elementet direkt. När du itererar genom en karta får du varje mappningspost, som har ett nyckelvärdepar.- Ett exempel på ett arrayelement kan vara om du tänker på identiteterna i ett identityMap -namnutrymme, där du kan iterera genom element som
identityMap.gaid,identityMap.emaileller liknande. - Ett exempel på ett kartelement kan vara segmentMembership.
I filteravsnittet Pebble stöder Destination SDK alla funktioner. Ett exempel nedan visar hur funktionen date kan användas i Destination SDK.
I avsnittet Pebble-funktioner har Adobe inte stöd för funktionen range .
Exempel på hur funktionen date används date-function
Om du vill se exempel på hur Pebble-funktioner används i Destination SDK kan du läsa nedan hur datumfunktionen (link in Pebble documentation) omformar formatet för en tidsstämpel.
Användningsfall date-use-case
Du vill ändra tidsstämpeln lastQualificationTime från standardvärdet för ISO 8601 som Experience Platform exporterar till ett annat värde som du föredrar.
Exempel date-example
Indata 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") }}
Utdata date-output
{
"lastQualificationTime": "2022-02-21T18:34:24Z"
}
Funktioner som lagts till av Adobe functions-added-by-adobe
Förutom de användningsklara funktionerna från Pebble, se nedan de extrafunktioner som skapas av Adobe och som du kan använda för dataexporter.
Funktionerna addedSegments och removedSegments addedsegments-removedsegments-functions
Användningsfall segments-use-case
Dessa funktioner kan användas för att få en lista över målgrupper som har lagts till eller tagits bort från en profil.
Exempel segments-example
Indata 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 %}
Utdata segments-output
added: <111111><333333>; removed: <222222>
Nästa steg next-steps
Du vet nu vilka Pebble-funktioner som stöds i Destination SDK och hur du använder dem för att justera formatet för exporterade data efter dina behov. Därefter ska du granska följande sidor: