서버 및 템플릿 사양에 대한 구성 옵션

개요

일반적인 종단점 /authoring/destination-servers을 통해 Adobe Experience Platform 대상 SDK에서 서버 및 템플릿 사양을 구성할 수 있습니다. 엔드포인트에서 수행할 수 있는 작업의 전체 목록은 대상 API 엔드포인트 작업을 참조하십시오.

예제 구성

{
   "name":"Moviestar destination server",
   "destinationServerType":"URL_BASED",
   "urlBasedDestination":{
      "url":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"https://api.moviestar.com/data/{{customerData.region}}/items"
      }
   },
   "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"
   }
}

서버 사양

강조 표시된 서버 구성

고객은 HTTP 내보내기를 통해 Adobe Experience Platform에서 대상에 데이터를 활성화할 수 있습니다. 서버 구성에는 메시지를 받는 서버(사용자 측 서버)에 대한 정보가 포함되어 있습니다.

이 프로세스는 대상 플랫폼에 일련의 HTTP 메시지로 사용자 데이터를 전달합니다. 아래 매개 변수는 HTTP 서버 사양 템플릿에서 가져옵니다.

매개 변수 유형 설명
name 문자열 필수 여부. Adobe에만 표시되는 서버의 친숙한 이름을 나타냅니다. 파트너 또는 고객은 이 이름을 볼 수 없습니다. 예 Moviestar destination server.
destinationServerType 문자열 필수 여부. URL_BASED 은 현재 사용 가능한 유일한 옵션입니다.
templatingStrategy 문자열 필수 여부.
  • Adobe이 아래 value 필드에서 URL을 변환해야 하는 경우 PEBBLE_V1 을 사용합니다. 다음과 같은 종단점이 있는 경우 이 옵션을 사용합니다. https://api.moviestar.com/data/{{customerData.region}}/items
  • Adobe 측에 변환이 필요하지 않으면 NONE 을 사용하십시오. 예를 들어 다음과 같은 종단점이 있습니다. https://api.moviestar.com/data/items
value 문자열 필수 여부. Experience Platform이 연결해야 하는 API 엔드포인트의 주소를 입력합니다.

템플릿 사양

강조 표시된 템플릿 구성

템플릿 사양을 사용하면 내보낸 메시지의 형식을 대상에 지정하는 방법을 구성할 수 있습니다. Adobe은 Jinja와 유사한 템플릿 언어를 사용하여 XDM 스키마에서 해당 필드를 대상에서 지원하는 형식으로 변환합니다. 변형에 대한 자세한 내용은 아래 링크를 참조하십시오.

Adobe은 메시지 변환 템플릿을 만들고 테스트하는 데 도움이 되는 개발자 도구를 제공합니다.

매개 변수 유형 설명
httpMethod 문자열 필수 여부. Adobe이 서버 호출에 사용할 메서드입니다. 옵션은 GET, PUT, POST, DELETE, PATCH입니다.
templatingStrategy 문자열 필수 여부. PEBBLE_V1.
value 문자열 필수 여부. 이 문자열은 Platform 고객의 데이터를 서비스에 필요한 형식으로 변환하는 문자 이스케이프 처리 버전입니다.
템플릿을 작성하는 방법에 대한 자세한 내용은 템플릿 사용 섹션을 참조하십시오.
문자 이스케이프에 대한 자세한 내용은 RFC JSON 표준 섹션 7을 참조하십시오.
단순 변환의 예는 프로필 속성( Profile Attributestransformation) 을 참조하십시오.
contentType 문자열 필수 여부. 서버가 허용하는 컨텐츠 유형입니다. 이 값은 application/json일 가능성이 높습니다.

이 페이지에서는