스트리밍 대상 서버 및 템플릿 사양을 위한 구성 옵션

개요

서버 및 템플릿 사양은 일반적인 종단점을 통해 Adobe Experience Platform Destination SDK에서 구성할 수 있습니다 /authoring/destination-servers. 읽기 대상 API 끝점 작업 전체 작업 목록을 보려면 종단점에서 수행할 수 있습니다.

서버 사양

강조 표시된 서버 구성

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

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

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

템플릿 사양

강조 표시된 템플릿 구성

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

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

스트리밍 대상 예제 구성

{
   "name":"Moviestar destination server",
   "destinationServerType":"URL_BASED",
   "urlBasedDestination":{
      "url":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"https://api.moviestar.com/data/{{customerData.endpointRegion}}/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"
   }
}
매개 변수 유형 설명
httpMethod 문자열 필수 여부. Adobe이 서버 호출에 사용할 메서드입니다. 옵션은 다음과 같습니다 GET, PUT, POST, DELETE, PATCH.
templatingStrategy 문자열 필수 여부. PEBBLE_V1.
value 문자열 필수 여부. 이 문자열은 Platform 고객의 데이터를 서비스에 필요한 형식으로 변환하는 문자 이스케이프 처리 버전입니다.
템플릿을 작성하는 방법에 대한 자세한 내용은 템플릿 섹션 사용.
문자 이스케이프에 대한 자세한 내용은 RFC JSON 표준, 섹션 7.
단순 변환의 예는 프로필 속성 변환.
contentType 문자열 필수 여부. 서버가 허용하는 컨텐츠 유형입니다. 이 값은 application/json.

이 페이지에서는