DokumentationExperience PlatformDestinationshandbok

Omformningsfunktioner som stöds i Destinationen SDK

Last update: Tue Oct 31 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Administratör
  • Användare

Experience Platform Destination SDK använder Pebble mallarså att du kan omforma de data som exporteras från Experience Platform till det format som krävs för destinationen.

Experience Platform Pebble implementeringen har vissa ändringar jämfört med den färdiga versionen som tillhandahålls av Pebble. Förutom funktionerna som finns i Pebblehar 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änslig. 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 funktionerna som stöds längre ned på den här sidan när skapa en meddelandeomformningsmall för data som exporteras från Experience Platform till destinationen.

Meddelandetransformeringsmallen används i målserverkonfiguration för direktuppspelningsmål.

Förutsättningar prerequisites

Om du vill veta mer om begreppen och funktionerna på den här referenssidan läser du meddelandeformat dokument först. Du måste förstå profilstruktur i Experience Platform innan du kan använda Pebble -mallar för att omforma och exportera data.

Granska mallexemplen i avsnittet innan du går vidare till funktionerna som beskrivs nedan Använda ett mallspråk för omvandlingar av identitet, attribut och målgruppsmedlemskap. Exemplen där börjar mycket enkelt och blir mer komplicerade.

Stöds Pebble funktioner supported-functions

Från Pebble taggsektion, Destinationen SDK stöder endast:

TIP
Använda for är annorlunda när du itererar igenom array eller map -element 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 är 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 att tänka på segmentMembership.

Från Pebble filtersektion, Destination SDK stöder alla funktioner. Ett exempel nedan visar hur date -funktionen kan användas i Destinationen SDK.

Från Pebble funktionsavsnittet, Adobe gör not stöder omfång funktion.

Exempel på hur date funktionen används date-function

Så här visar du hur Pebble funktioner som används i Destination SDK, se nedan hur datumfunktionen (link in Pebble documentation) används för att omforma formatet för en tidsstämpel.

Användningsfall

Du vill ändra lastQualificationTime tidsstämpel från standard ISO 8601 det värde som Experience Platform exporterar till ett annat värde som du föredrar.

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 funktionerna som finns i Pebblefinns nedan de ytterligare funktioner som skapas av Adobe som du kan använda för dataexport.

addedSegments och removedSegments funktioner 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 Pebble -funktioner 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:

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