Omformningsfunktioner som stöds i Destinationen SDK
I Experience Platform Destination SDK används Pebble mallar, vilket gör att du kan omforma de data som exporteras från Experience Platform till det format som krävs för ditt mål.
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 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örhandskrav 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 och exportera 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 har Destinationen SDK bara stöd för:
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.email
eller liknande. - Ett exempel på ett kartelement kan vara segmentMembership.
Från filteravsnittet Pebble stöder Destinationen SDK alla funktioner. Ett exempel nedan visar hur funktionen date
kan användas i Destinationen SDK.
I Pebble-funktionsavsnittet stöder inte range -funktionen i Adobe.
Exempel på hur funktionen date
används date-function
Om du vill se exempel på hur Pebble-funktioner används i Destinationen SDK kan du läsa nedan om hur datumfunktionen (link in Pebble documentation) används för att omforma formatet för en tidsstämpel.
Användningsfall
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 som mål.
Exempel
Indata
{
"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") }}
Utdata
{
"lastQualificationTime": "2022-02-21T18:34:24Z"
}
Funktioner som lagts till av Adobe functions-added-by-adobe
Förutom de användningsklara funktioner som tillhandahålls av Pebble, se nedan vilka ytterligare funktioner som skapas av Adobe som du kan använda för dataexporter.
Funktionerna addedSegments
och removedSegments
addedsegments-removedsegments-functions
Användningsfall
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
Indata
{
"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 %}
Utdata
added: <111111><333333>; removed: <222222>
Nästa steg next-steps
Du vet nu vilka Pebble-funktioner som stöds i Destinationen 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: