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.

IMPORTANT
Alla parameternamn och värden som stöds av Destinationen SDK är skiftlägeskänsliga. Undvik skiftlägeskänslighetsfel genom att använda parameternamn och värden exakt som de visas i dokumentationen.

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:

TIP
Användningen av 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:

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