Parámetros de solicitud HTTP de etiqueta "IMG" y "A"

Cuando Message Connector recibe una solicitud, ya sea porque un usuario final ha abierto un correo electrónico que contiene una etiqueta IMG codificada por Message Connector o porque el usuario final ha pulsado una etiqueta A, analiza los parámetros incluidos con la solicitud para devolver los datos de oferta adecuados. Esta sección proporciona una lista de los parámetros que se pueden incluir en el URL solicitante (la etiqueta IMG (cargada automáticamente cuando se visualiza una imagen etiquetada al abrir un correo electrónico) o la etiqueta A (cargada cuando la persona que visualiza el correo electrónico pulsa el mensaje y va al sitio especificado).

Parámetros

Cuando Message Connector recibe una solicitud, analiza los parámetros incluidos con la solicitud. Estos parámetros incluyen algunos de los siguientes, o todos ellos:

Nombre de parámetro	Descripción	¿Necesario?	Valor predeterminado
IDmsj	Identificador exclusivo de la instancia de correo electrónico o página web.	Sí	Ninguno. Lo proporciona el sistema que crea la instancia exclusiva del mensaje de correo electrónico o página web que contiene la etiqueta.
IDEnlace	Identificador exclusivo del enlace de este correo electrónico o página web.	Sí	Ninguno. Lo proporciona el sistema que crea la instancia exclusiva del mensaje de correo electrónico o página web que contiene la etiqueta.
nivelAudiencia	Nivel de audiencia al que pertenece el destinatario de esta comunicación.	No	audienceLevel especificado como valor predeterminado en el elemento audienceLevels que se encuentra en el archivo MessageConnectorConfig.xml.
ic	Nombre del canal interactivo de destino (IC)	No	Valor del elemento interactiveChannel que se encuentra en la sección defaultParameterValues del archivo MessageConnectorConfig.xml, que es "interactiveChannel" de forma predeterminada.
ip	Nombre del punto de interacción (IP) que se aplica	No	Valor del elemento interactionPoint que se encuentra en la sección defaultParameterValues del archivo MessageConnectorConfig.xml, que es "headBanner" de forma predeterminada.
URLImagenoferta	URL de la imagen de oferta de destino para el URL IMG en el mensaje.	No	Ninguno.
AtrURLImagenOferta	Nombre del atributo de oferta que tiene el URL de la imagen de oferta de destino	No	Valor del elemento imageUrlAttribute que se encuentra en la sección defaultParameterValues del archivo MessageConnectorConfig.xml.
URLPáginaDestinoOferta	URL de la página de destino correspondiente a la oferta de destino.	No	Ninguno.
AtribPáginaDestinoOferta	Nombre del atributo de oferta que tiene el URL de la página de destino correspondiente a la oferta de destino.	No	Valor del elemento landingPageUrlAttribute que se encuentra en la sección defaultParameterValues del archivo MessageConnectorConfig.xml.
eventoContacto	Nombre del evento de contacto.	No	Valor del elemento contactEventName que se encuentra en la sección defaultParameterValues del archivo MessageConnectorConfig.xml, que es "contact" de forma predeterminada.
eventoRespuesta	Nombre del evento de aceptación.	No	Valor del elemento acceptEventName que se encuentra en la sección defaultParameterValues del archivo MessageConnectorConfig.xml, que es "accept" de forma predeterminada.
depuración	Indicador de depuración. Establezca este parámetro en "true" solo para la resolución de problemas y si se lo indica el personal de soporte técnico de IBM® .	No	Valor del elemento debugFlag que se encuentra en la sección defaultParameterValues del archivo MessageConnectorConfig.xml, que es "false" de forma predeterminada.
<ID de audiencia>	ID de audiencia de este usuario. El nombre de este parámetro se define en el archivo de configuración.	Sí	Ninguno.

Cuando Message Connector recibe un parámetro que no se reconoce (es decir, no aparece en la lista anterior, se maneja de dos posibles maneras:

Si se proporciona un parámetro no reconocido (por ejemplo, "attribute", como en attribute="attrValue") y hay un parámetro coincidente del mismo nombre más la palabra "Type" (por ejemplo, "attributeType", como en attributeType="string"), esto hace que Message Connector cree un parámetro de Interact coincidente y lo pase al tiempo de ejecución de Interact.

Los valores del parámetro Type pueden ser los siguientes:

string

numeric

datetime

Para un parámetro de tipo "datetime," Message Connector busca también un parámetro con el mismo nombre más la palabra "Pattern" (por ejemplo, "atributoPattern") cuyo valor es un formato válido de fecha/hora. Por ejemplo, podría proporciona el parámetro attributePattern="MM/dd/aaaa".

Tenga en cuenta que si especifica un tipo de parámetro de "datetime" pero no proporciona un patrón de fecha coincidente, se utilizará el valor especificado en el archivo de configuración de Message Connector (que se encuentra en <directorio_instalación>/msgconnector/config/MessageConnectorConfig.xml) en el servidor Interact.

Si se proporciona un parámetro no reconocido y no hay ningún valor Type coincidente, Message Connector pasa ese parámetro al URL de redireccionamiento de destino.

Para todos los parámetros no reconocidos, Message Connector los pasa al servidor de ejecución de Interact sin procesarlos o guardarlos.

Código de Message Connector de ejemplo

La siguiente etiqueta A contiene un ejemplo de un conjunto de enlaces de Message Connector que podría aparecer en un mensaje de correo electrónico:

<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>

En este ejemplo, la etiqueta IMG se carga automáticamente cuando se abre el mensaje de correo electrónico. Recuperando la imagen de la página especificada, el mensaje pasa los parámetros para el identificador de mensaje exclusivo (IDmsj), identificador de enlace exclusivo (IDEnlace) e identificador de usuario exclusivo (ID_usuario), junto con dos parámetros adicionales (códigoIngresos y tipoIngresos) para que se pasen al tiempo de ejecución de Interact.

La etiqueta A proporciona el atributo HREF (Hypertext Reference) que convierte la imagen de oferta en un enlace del mensaje de correo electrónico que se puede pulsar. Si el visor del mensaje, al ver la imagen, pulsa y va a la página de destino, el identificador de mensaje exclusivo (IDmsj), identificador de enlace (IDEnlace) e identificador de usuario (ID_usuario) se pasan al servidor, así como un parámetro adicional (recomendación) que se pasa al URL de redireccionamiento de destino.