DocumentatieExperience PlatformHandleiding voor bestemmingen

Ondersteunde transformatiefuncties in Destination SDK

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

Gemaakt voor:

  • Beheerder
  • Gebruiker

Experience Platform-Destination SDK gebruikt Pebble sjablonen, zodat u de uit Experience Platform geëxporteerde gegevens kunt omzetten in de indeling die voor uw bestemming vereist is.

Het Experience Platform Pebble de implementatie is gewijzigd, in vergelijking met de versie van de box buiten de verpakking die wordt geleverd door Pebble. Naast de functies die buiten de box worden geleverd door Pebble, heeft de Adobe enkele extra functies gemaakt die u kunt gebruiken met Destination SDK.

IMPORTANT
Alle parameternamen en -waarden die door Destination SDK worden ondersteund, zijn hoofdlettergevoelig. Om fouten in hoofdlettergevoeligheid te voorkomen, gebruikt u de namen en waarden van parameters exact zoals in de documentatie wordt getoond.

Waar wordt het gebruikt? where-to-use

Gebruik de ondersteunde functies die verderop op op deze pagina worden vermeld wanneer een sjabloon voor berichttransformatie maken voor de gegevens die uit Experience Platform naar uw bestemming worden uitgevoerd.

De sjabloon voor berichttransformatie wordt gebruikt in het dialoogvenster doelserverconfiguratie voor streamingdoelen.

Vereisten prerequisites

Als u de concepten en functies in deze referentiepagina wilt begrijpen, leest u de berichtindeling document eerst. U moet de structuur van een profiel in Experience Platform voordat u kunt gebruiken Pebble sjablonen voor transformatie en de geëxporteerde gegevens.

Lees de sjabloonvoorbeelden in de sectie voordat u doorgaat naar de functies die hieronder worden beschreven Een sjabloontaal gebruiken voor de transformaties voor identiteit, kenmerken en publieksleiding. De voorbeelden in dat verband beginnen zeer eenvoudig en nemen toe in complexiteit.

Ondersteund Pebble functies supported-functions

Van de Pebble tagsectie, alleen Destination SDK ondersteunt:

TIP
Gebruiken for is anders wanneer u doorloopt array of map elementen in een sjabloon. Wanneer u een array doorloopt, kunt u het element rechtstreeks ophalen. Wanneer u door een kaart herhaalt, krijgt u elke kaartingang, die een zeer belangrijk-waardepaar heeft.
  • Denk bij een voorbeeld van een arrayelement aan de identiteiten in een identityMap naamruimte, waar u elementen zoals identityMap.gaid, identityMap.email, of een soortgelijke situatie.
  • Denk aan een voorbeeld van een structuurelement segmentLidmaatschap.

Van de Pebble filtersectie, Destination SDK ondersteunt alle functies. In het onderstaande voorbeeld wordt getoond hoe de date functie kan binnen Destination SDK worden gebruikt.

Van de Pebble functies, sectie, Adobe doet dit niet de bereik functie.

Voorbeeld van hoe het date function wordt gebruikt date-function

Uitlijnen hoe Pebble functies worden gebruikt in Destination SDK, zie hieronder hoe de datumfunctie (link in Pebble documentatie) wordt gebruikt om de indeling van een tijdstempel te transformeren.

Gebruiksscenario

U wilt het dialoogvenster lastQualificationTime tijdstempel van de standaard ISO 8601 waarde die Experience Platform naar een andere waarde uitvoert die door uw bestemming wordt voorkeur.

Voorbeeld

Invoer

{
"lastQualificationTime": "2022-02-08T18:34:24.000+0000"
}

Indeling

{{ lastQualificationTime | date(existingFormat="yyyy-MM-dd'T'HH:mm:sss.SSSX", format="yyyy-MM-dd'T'HH:mm:ssX") }}

Uitvoer

{
"lastQualificationTime": "2022-02-21T18:34:24Z"
}

Door Adobe toegevoegde functies functions-added-by-adobe

Naast de functies die buiten de box worden geleverd door Pebble, zie onder de extra functies die door Adobe worden gecreeerd die u voor uw gegevensuitvoer kunt gebruiken.

addedSegments en removedSegments functies addedsegments-removedsegments-functions

Gebruiksscenario

Deze functies kunnen worden gebruikt om een lijst met soorten publiek te verkrijgen die aan een profiel zijn toegevoegd of uit een profiel zijn verwijderd.

Voorbeeld

Invoer
{
  "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"
      }
    }
  }
}
Indeling
added: {% for s in addedSegments(segmentMembership.ups) %}<{{s.key}}>{% endfor %}; removed: {% for s in removedSegments(segmentMembership.ups) %}<{{s.key}}>{% endfor %}
Uitvoer
added: <111111><333333>; removed: <222222>

Volgende stappen next-steps

U weet nu welke Pebble functies worden ondersteund in Destination SDK en hoe u deze kunt gebruiken om de indeling van de geëxporteerde gegevens aan uw wensen aan te passen. Hierna volgt een overzicht van de volgende pagina's:

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