“IMG”和“A”标记 HTTP 请求参数

在消息连接器收到请求时（无论是因为最终用户打开了包含以消息连接器编码的 IMG 标记的电子邮件，还是因为最终用户单击了 A 标记），消息连接器都会解析请求中包含的参数以返回相应的商品数据。此节提供了可以包含在请求 URL 中包含的参数列表（IMG 标记（当电子邮件打开时显示带有标记的图像时自动装入）或 A 标记（在查看电子邮件的用户单击指向指定站点的消息时装入））。

参数

消息连接器收到请求时，将解析请求中包含的参数。这些参数包括以下部分或所有内容：

参数名称	描述	是否必需？	缺省值
msgId	电子邮件实例或 Web 页面的唯一标识。	是	无。这由创建电子邮件唯一实例的系统或者包含标记的 Web 页面来提供。
linkId	此电子邮件或 Web 页面中链接的唯一标识。	是	无。这由创建电子邮件唯一实例的系统或者包含标记的 Web 页面来提供。
audienceLevel	此通信的接收方所属于的受众级别。	否	audienceLevel 在位于 MessageConnectorConfig.xml 文件中的 audienceLevels 元素中被指定为缺省值。
ic	目标交互式渠道 (IC) 的名称	否	interactiveChannel 元素（位于 MessageConnectorConfig.xml 文件的 defaultParameterValues 部分中）的值，缺省情况下为“interactiveChannel”。
ip	应用交互点 (IP) 的名称	否	interactionPoint 元素（位于 MessageConnectorConfig.xml 文件的 defaultParameterValues 部分中）的值，缺省情况下为“headBanner”。
offerImageUrl	消息中 IMG URL 的目标商品图像的 URL。	否	无。
offerImageUrlAttr	具有目标商品图像 URL 的商品属性的名称	否	imageUrlAttribute 元素（位于 MessageConnectorConfig.xml 文件的 defaultParameterValues 部分中）的值。
offerLandingPageUrl	对应于目标商品的登录页面的 URL。	否	无。
offerLandingPageUrlAttr	商品属性的名称，此商品属性具有登录页面（对应于目标商品）的 URL。	否	landingPageUrlAttribute 元素（位于 MessageConnectorConfig.xml 文件的 defaultParameterValues 部分中）的值。
contactEvent	联系事件的名称。	否	contactEventName 元素（位于 MessageConnectorConfig.xml 文件的 defaultParameterValues 部分中）的值，缺省情况下为“contact”。
responseEvent	接受事件的名称。	否	acceptEventName 元素（位于 MessageConnectorConfig.xml 文件的 defaultParameterValues 部分中）的值，缺省情况下为“accept”。
debug	调试标志。仅当进行故障诊断以及在由 IBM® 技术支持进行指导的情况下，才能将此参数设置为“true”。	否	debugFlag 元素（位于 MessageConnectorConfig.xml 文件的 defaultParameterValues 部分中）的值，缺省情况下为“false”。
<audience id>	此用户的受众标识。此参数的名称是在配置文件中定义。	是	无。

当消息连接器收到无法识别的参数时（即，并非以上列表中显示的参数），将通过以下两种可能方式中的一种来处理此参数：

如果提供了无法识别的参数（例如，attribute="attrValue" 中的“attribute”）并且具有相同名称外加单词“Type”的匹配参数（例如，attributeType="string" 中的“attributeType”），那么这将导致消息连接器创建一个匹配的 Interact 参数并将其传递给 Interact 运行时。

对于“datetime”类型的参数，消息连接器还将查找其值为有效日期/时间格式并且名称相同外加单词“Pattern”的参数（例如，“attributePattern”）。例如，您可能提供参数 attributePattern="MM/dd/yyyy"。

请注意，如果您指定了“datetime”类型的参数，但是未提供匹配的日期模式，那么将使用 Interact 服务器上消息连接器配置文件（位于 <installation_directory>/msgconnector/config/MessageConnectorConfig.xml 中）中指定的值。

如果提供了无法识别的参数并且没有匹配的 Type 值，那么消息连接器会将该参数传递到目标重定向 URL。

对于所有无法识别的参数，消息连接器会将其传递到 Interact 运行时服务器，而不会进行处理或保存。

消息连接器代码示例

以下 A 标记包含可能显示在电子邮件中的一组消息连接器链接的示例：

<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 标记将自动装入。通过从指定页面中检索图像，消息将传递唯一消息标识 (msgID)、唯一链接标识 (linkID) 和唯一用户标识 (userid) 的参数，还将传递要传递到 Interact 运行时的另外两个参数（incomeCode 和 incomeType）。

A 标记提供了 HREF（超文本引用）属性，此属性可将商品图像转换为电子邮件中的可单击链接。如果消息的查看者在看到图像后单击以转向登录页面，那么唯一消息标识 (msgId)、链接标识 (linkId) 和用户标识 (userid) 将传递到服务器，另外一个传递到目标重定向 URL 的参数 (referral) 也将传递到服务器。