"IMG" 및 "A" 태그 HTTP 요청 매개변수

최종 사용자가 Message Connector 인코딩된 IMG 태그가 포함된 이메일을 열었거나 최종 사용자가 A 태그를 클릭했기 때문에 Message Connector가 요청을 수신하면, Message Connector는 요청에 포함된 매개변수를 구문 분석하여 해당 오퍼 데이터를 리턴합니다. 이 절에서는 요청 URL(IMG 태그(이메일이 열릴 때 태그 지정된 이미지가 표시되면 자동으로 로드됨) 또는 A 태그(이메일을 보는 사람이 지정된 사이트로 연결하는 메시지를 클릭하면 로드됨))에 포함될 수 있는 매개변수 목록을 제공합니다.

매개변수

Message Connector는 요청을 수신하면 요청에 포함된 매개변수를 구문 분석합니다. 이러한 매개변수는 다음 중 일부 또는 모두를 포함합니다.

매개변수 이름	설명	필수 여부	기본값
msgId	이메일 인스턴스 또는 웹 페이지의 고유 ID입니다.	예	없음 태그가 포함된 이메일 메시지 또는 웹 페이지의 고유 인스턴스를 작성하는 시스템이 제공합니다.
linkId	이 이메일 또는 웹 페이지에 있는 링크의 고유 ID입니다.	예	없음 태그가 포함된 이메일 메시지 또는 웹 페이지의 고유 인스턴스를 작성하는 시스템이 제공합니다.
audienceLevel	이 커뮤니케이션 수신인이 속한 대상 레벨입니다.	아니오	MessageConnectorConfig.xml 파일에 있는 audienceLevels 요소에 기본값으로 지정된 audienceLevel.
ic	대상 대화식 채널(IC) 이름입니다.	아니오	MessageConnectorConfig.xml 파일의 defaultParameterValues 섹션에 있는 interactiveChannel 요소 값(기본적으로 "interactiveChannel"임).
ip	적용 중인 상호작용 지점(IC) 이름입니다.	아니오	MessageConnectorConfig.xml 파일의 defaultParameterValues 섹션에 있는 interactionPoint 요소 값(기본적으로 "headBanner"임).
offerImageUrl	메시지의 IMG URL에 대한 대상 오퍼 이미지 URL입니다.	아니오	없음
offerImageUrlAttr	대상 오퍼 이미지 URL을 갖는 오퍼 속성 이름입니다.	아니오	MessageConnectorConfig.xml 파일의 defaultParameterValues 섹션에 있는 imageUrlAttribute 요소 값.
offerLandingPageUrl	대상 오퍼에 대응하는 랜딩 페이지 URL입니다.	아니오	없음
offerLandingPageUrlAttr	대상 오퍼에 대응하는 랜딩 페이지 URL을 갖는 오퍼 속성 이름입니다.	아니오	MessageConnectorConfig.xml 파일의 defaultParameterValues 섹션에 있는 landingPageUrlAttribute 요소 값.
contactEvent	컨택 이벤트 이름입니다.	아니오	MessageConnectorConfig.xml 파일의 defaultParameterValues 섹션에 있는 contactEventName 요소 값(기본적으로 "contact"임).
responseEvent	수락 이벤트 이름입니다.	아니오	MessageConnectorConfig.xml 파일의 defaultParameterValues 섹션에 있는 acceptEventName 요소 값(기본적으로 "accept"임).
debug	디버그 플래그입니다. 문제점 해결 및 IBM 기술 지원의 지시가 있는 경우에만 이 매개변수를 "true"로 설정하십시오.	아니오	MessageConnectorConfig.xml 파일의 defaultParameterValues 섹션에 있는 debugFlag 요소 값(기본적으로 "false"임).
<audience id>	이 사용자의 대상 ID입니다. 이 매개변수 이름은 구성 파일에 정의됩니다.	예	없음

Message Connector가 알 수 없는(즉, 위 목록에 나타나지 않은) 매개변수를 수신하는 경우, 매개변수는 다음 두 가지 방법 중 하나로 처리됩니다.

알 수 없는 매개변수가 제공되고(예: attribute="attrValue"에서의 "attribute")되고 동일한 이름과 "Type" 단어가 있는 일치하는 매개변수가 있으면(예: attributeType="string"에서의 "attributeType"), Message Connector는 일치하는 Interact 매개변수를 작성하여 Interact 런타임에 전달합니다.

Type 매개변수 값은 다음 중 하나입니다.

string

numeric

datetime

"datetime" 유형의 매개변수의 경우, Message Connector는 값이 유효한 날짜/시간 형식인 동일한 이름과 "Pattern" 단어(예: "attributePattern")가 있는 매개변수도 검색합니다. 예를 들어, attributePattern="MM/dd/yyyy" 매개변수를 제공할 수 있습니다.

"datetime" 유형의 매개변수를 지정하지만 일치하는 날짜 패턴을 제공하지 않으면, Interact 서버의 Message Connector 구성 파일(<installation_directory>/msgconnector/config/MessageConnectorConfig.xml에 있음)에 지정된 값이 사용됩니다.

알 수 없는 매개변수가 제공되고 일치하는 Type 값이 없으면, Message Connector가 해당 매개변수를 대상 경로 재지정 URL로 전달합니다.

알 수 없는 모든 매개변수의 경우, Message Connector는 매개변수를 처리하거나 저장하지 않고 Interact 런타임 서버로 전달합니다.

Message Connector 코드 예

다음 A 태그는 이메일 메시지에 나타날 수 있는 Message Connector 링크 집합 예를 포함합니다.

<a href="http://www.example.com/MessageConnector/offerClickthru.jsp?msgId=234
   &linkId=1&userid=1&referral=xyz">
	<img src="http://www.example.com/MessageConnector/offerImage.jsp?msgId=234&linkId=1
      &userid=1&incomeCode=3&incomeType=numeric"/>
</a>

이 예에서 IMG 태그는 이메일 메시지가 열릴 때 자동으로 로드됩니다. 지정된 페이지에서 이미지를 검색하여 메시지는 전달될 두 개의 추가 매개변수(incomeCode 및 incomeType)와 함께 고유 메시지 ID(msgID), 고유 링크 ID(linkID), 고유 사용자 ID(userid)에 대한 매개변수를 Interact 런타임으로 전달합니다.

A 태그는 오퍼 이미지를 이메일 메시지에서 클릭 가능한 링크가 되게 하는 HREF(Hypertext Reference) 속성을 제공합니다. 메시지 뷰어가 이미지를 보는 즉시 랜딩 페이지로 연결하면, 대상 경로 재지정 URL로 전달되는 하나의 추가 매개변수(referral)는 물론 고유 메시지 ID(msgId), 링크 ID(linkId), 사용자 ID(userid)가 서버로 전달됩니다.