Mallspecifikationer för mål som skapats med Destination SDK
Använd mallens specifika del av målserverkonfigurationen för att konfigurera hur HTTP-begäranden som skickas till målet ska formateras.
I en mallspecifikation kan du definiera hur profilattributfält ska omformas mellan XDM-schemat och det format som stöds på plattformen.
Mallspecifikationer är en del av målserverkonfigurationen för mål för realtidsströmning.
Mer information om var den här komponenten passar in i en integrering som skapas med Destination SDK finns i diagrammet i konfigurationsalternativ eller se guiden om hur du använd Destination SDK för att konfigurera ett mål för direktuppspelning.
Du kan konfigurera mallspecifikationerna för ditt mål via /authoring/destination-servers slutpunkt. På följande API-referenssidor finns detaljerade API-anropsexempel där du kan konfigurera komponenterna som visas på den här sidan.
Integrationstyper som stöds supported-integration-types
Se tabellen nedan för mer ingående information om vilka typer av integreringar som stöder de funktioner som beskrivs på den här sidan.
Konfigurera en mallspecifikation configure-template-spec
Adobe använder ett mallspråk som liknar Jinja för att omvandla fälten från XDM-schemat till ett format som stöds av ditt mål.
Mer information om omvandlingen finns på länkarna nedan:
Nedan finns ett exempel på en mall för en HTTP-begäran, tillsammans med beskrivningar av varje enskild 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"
}
}
httpMethodGET, PUT, POST, DELETE, PATCH.templatingStrategyPEBBLE_V1.valueMer information om hur du skriver mallen finns i avsnittet om använda mall.
Mer information om teckenigenkänning finns i RFC JSON-standard, avsnitt sju.
Ett exempel på en enkel omformning finns i profilattribut omformning.
contentTypeapplication/json.Nästa steg next-steps
När du har läst den här artikeln bör du få en bättre förståelse för vad en mallspecifikation är och hur du kan konfigurera den.
Mer information om andra målserverkomponenter finns i följande artiklar: