Sjabloonspecificaties voor bestemmingen die met Destination SDK zijn gemaakt

Gebruik het malplaatjespecifieke deel van de configuratie van de bestemmingsserver om te vormen hoe te om de HTTP- verzoeken te formatteren die naar uw bestemming worden verzonden.

In een sjabloonspecificatie kunt u definiƫren hoe u profielkenmerkvelden transformeert tussen het XDM-schema en de indeling die uw platform ondersteunt.

Sjabloonspecificaties maken deel uit van de configuratie van de doelserver voor realtime (streaming) doelen.

Om te begrijpen waar deze component in een integratie past die met Destination SDK wordt gecreeerd, zie het diagram in de configuratieoptiesdocumentatie of zie de gids op hoe te gebruiken Destination SDK om een het stromen bestemmingte vormen.

U kunt de malplaatjespecs voor uw bestemming via het /authoring/destination-servers eindpunt vormen. Zie de volgende API verwijzingspagina's voor gedetailleerde API vraagvoorbeelden waar u de componenten kunt vormen die in deze pagina worden getoond.

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

Ondersteunde integratietypen supported-integration-types

Raadpleeg de onderstaande tabel voor meer informatie over de integratietypen die de op deze pagina beschreven functionaliteit ondersteunen.

Type integratie
Ondersteunt functionaliteit
Integraties in realtime (streaming)
Ja
Op bestanden gebaseerde (batch) integratie
Nee

Een sjabloonspecificatie configureren configure-template-spec

De Adobe gebruikt een sjabloontaal gelijkend op Jinjaom de gebieden van het schema XDM in een formaat om te zetten dat door uw bestemming wordt gesteund.

benadrukte configuratie van het Malplaatje

Ga voor meer informatie over de transformatie naar de onderstaande koppelingen:

TIP
De Adobe biedt het hulpmiddel van de a ontwikkelaaraan dat u helpt een malplaatje van de berichttransformatie creƫren en testen.

Zie onder een voorbeeld van een HTTP-aanvraagsjabloon, samen met beschrijvingen van elke individuele parameter.

{
   "httpTemplate":{
      "httpMethod":"POST",
      "requestBody":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{ \"attributes\": [ {% for ns in [\"external_id\", \"yourdestination_id\"] %} {% if input.profile.identityMap[ns] is not empty and first_namespace_encountered %} , {% endif %} {% set first_namespace_encountered = true %} {% for identity in input.profile.identityMap[ns]%} { \"{{ ns }}\": \"{{ identity.id }}\" {% if input.profile.segmentMembership.ups is not empty %} , \"AEPSegments\": { \"add\": [ {% for segment in input.profile.segmentMembership.ups %} {% if segment.value.status == \"realized\" or segment.value.status == \"existing\" %} {% if added_segment_found %} , {% endif %} {% set added_segment_found = true %} \"{{ destination.segmentAliases[segment.key] }}\" {% endif %} {% endfor %} ], \"remove\": [ {% for segment in input.profile.segmentMembership.ups %} {% if segment.value.status == \"exited\" %} {% if removed_segment_found %} , {% endif %} {% set removed_segment_found = true %} \"{{ destination.segmentAliases[segment.key] }}\" {% endif %} {% endfor %} ] } {% set removed_segment_found = false %} {% set added_segment_found = false %} {% endif %} {% if input.profile.attributes is not empty %} , {% endif %} {% for attribute in input.profile.attributes %} \"{{ attribute.key }}\": {% if attribute.value is empty %} null {% else %} \"{{ attribute.value.value }}\" {% endif %} {% if not loop.last%} , {% endif %} {% endfor %} } {% if not loop.last %} , {% endif %} {% endfor %} {% endfor %} ] }"
      },
      "contentType":"application/json"
   }
}
Parameter
Type
Beschrijving
httpMethod
String
Vereist. De methode die de Adobe in vraag aan uw server zal gebruiken. Ondersteunde methoden: GET, PUT, POST, DELETE, PATCH .
templatingStrategy
String
Vereist. Gebruik PEBBLE_V1 .
value
String
Vereist. Deze tekenreeks is de op tekens gebaseerde versie van de sjabloon die de HTTP-aanvragen opmaakt die door Platform worden verzonden naar de indeling die door uw bestemming wordt verwacht.
voor informatie over hoe te om het malplaatje te schrijven, lees de sectie op gebruikend het templating.
voor meer informatie over karakter het ontsnappen, verwijs naar de norm RFC JSON, sectie zeven.
Voor een voorbeeld van een eenvoudige transformatie, verwijs naar de profielattributentransformatie.
contentType
String
Vereist. Het inhoudstype dat uw server accepteert. Afhankelijk van welk type van output uw transformatiemalplaatje produceert, kan dit om het even welke gesteunde types van de toepassingsinhoud van HTTPzijn. In de meeste gevallen moet deze waarde worden ingesteld op application/json .

Volgende stappen next-steps

Na het lezen van dit artikel, zou u een beter inzicht in moeten hebben wat een malplaatjespecificatie is, en hoe u het kunt vormen.

Raadpleeg de volgende artikelen voor meer informatie over de andere componenten van de doelserver:

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