Paramètres de demande HTTP "IMG" et"A"

Lorsque Message Connector reçoit une demande, soit parce qu'un utilisateur final a ouvert un courrier électronique contenant une balise IMG encodée par Message Connector, soit parce que utilisateur final a cliqué jusqu'à atteindre une balise A, il analyse les paramètres fournis avec la demande afin de renvoyer les données d'offre appropriées. Cette section fournit la liste des paramètres pouvant être inclus dans l'adresse URL de demande (soit la balise IMG (chargée automatiquement lorsqu'une image balisée est affichée lors de l'ouverture du courrier électronique), soit la balise A (chargée lorsque la personne affichant le courrier électronique clique sur le message jusqu'à atteindre le site spécifié).

Paramètres

Lorsque Message Connector reçoit une demande, il analyse les paramètres fournis avec la demande. Ces paramètres contiennent tout ou une partie de ce qui suit :

Nom du paramètre	Description	Obligatoire ?	Valeur par défaut
msgId	Identificateur unique de l'instance de courrier électronique ou d'une page Web.	Oui	Aucun. Fourni par le système créant l'instance unique du message électronique ou la page Web contenant la balise.
linkId	Identificateur unique du lien dans ce courrier électronique ou la page Web.	Oui	Aucun. Fourni par le système créant l'instance unique du message électronique ou la page Web contenant la balise.
audienceLevel	Niveau de référentiel auquel le destinataire du cette communication appartient.	Non	L'audienceLevel indiqué par défaut dans l'élément audienceLevels trouvé dans le fichier MessageConnectorConfig.xml.
ic	Nom du canal interactif cible (IC)	Non	Valeur de l'élément interactiveChannel trouvé dans la section defaultParameterValues du fichier MessageConnectorConfig.xml, qui est "interactiveChannel" par défaut.
ip	Nom du point d'interaction (IP).	Non	Valeur de l'élément interactionPoint trouvé dans la section defaultParameterValues du fichier MessageConnectorConfig.xml, qui est par défaut "headBanner".
offerImageUrl	Adresse URL de l'image offre cible correspondant à l'adresse URL IMG dans le message.	Non	Aucun.
offerImageUrlAttr	Nom de l'attribut de l'offre contenant l'URL de l'image cible offre.	Non	Valeur de l'élément imageUrlAttribute trouvé dans la section defaultParameterValues du fichier MessageConnectorConfig.xml.
offerLandingPageUrl	URL de la page d'accueil correspondant à l'offre cible.	Non	Aucun.
offerLandingPageUrlAttr	Nom de l'attribut de l'offre contenant l'URL de la page d'accueil correspondant à l'offre cible.	Non	Valeur de l'élément landingPageUrlAttribute trouvé dans la section defaultParameterValues du fichier MessageConnectorConfig.xml.
contactEvent	Nom de l'événement du contact.	Non	Valeur de l'élément contactEventName trouvé dans la section defaultParameterValues du fichier MessageConnectorConfig.xml, qui est "contact" par défaut.
responseEvent	Nom de l'événement d'acceptation.	Non	Valeur de l'élément acceptEventName trouvé dans la section defaultParameterValues du fichier MessageConnectorConfig.xml, qui est par défaut "accept".
débogage	Indicateur de débogage. Définissez ce paramètre sur "true" uniquement pour l'identification des incidents et si vous le support technique IBM® Unica® vous l'a demandé.	Non	Valeur de l'élément debugFlag trouvé dans la section defaultParameterValues du fichier MessageConnectorConfig.xml, qui est "false" par défaut.
<id de référentiel>	ID de référentiel de cet utilisateur. Le nom de ce paramètre est défini dans le fichier de configuration.	Oui	Aucun.

Lorsque Message Connector reçoit un paramètre non reconnu (c'est-à-dire, n'apparaît pas dans la liste ci-dessus), il est traité dans l'une des deux façons possibles :

Si un paramètre non reconnu est fourni (par exemple, "attribute", comme dans attribute="attrValue") et s'il existe un paramètre correspondant ayant le même nom plus le mot "Type" (par exemple "attributeType", comme dans attributeType="string"), Message Connector crée un paramètre correspondant Interact et le passe à l'exécution Interact.

Les valeurs du paramètre Type peuvent être les suivantes :

string

numeric

datetime

Pour un paramètre de type "datetime," Message Connector recherche également des messages pour un paramètre du même nom plus le mot "Pattern" (par exemple, "attributePattern") dont la valeur est un format de date/heure valide. Par exemple, vous pouvez fournir le paramètre attributePattern="MM/jj/aaaa".

Notez que si vous spécifiez un paramètre de type "datetime" mais ne fournissez pas de modèle de date correspondante, la valeur indiquée dans le fichier de configuration de Message Connector (qui se trouve dans <installation_directory>/msgconnector/config/MessageConnectorConfig.xml) sur le serveur Interact est utilisée.

Si un paramètre non reconnu est fourni et s'il n'existe aucune valeur Type correspondante, Message Connector transmet ce paramètre à l'URL cible de redirection.

Message Connector passe tous les paramètres non reconnus au serveur d'exécution Interact sans les traiter ni les sauvegarder.

Exemple de code de Message Connector

La balise A contient un exemple d'ensemble de liens de Message Connector qui peut apparaître dans un message électronique :

Dans cet exemple, la balise IMG charge automatiquement lorsque le message électronique est ouvert. En extrayant l'image à partir de la page spécifiée, le message transmet les paramètres de l'identificateur de message unique (msgID), l'identificateur de lien unique (linkID), et l'identificateur d'utilisateur unique (userid) avec deux paramètres supplémentaires (incomeCode et incomeType) qui doivent être transmis à l'exécution Interact.

La balise A fournit l'attribut HREF (Hypertext Reference) qui transforme l'image de l'offre en un lien cliquable dans le message électronique. Si le destinataire du message, lorsqu'il voit l'image, clique jusqu'à atteindre la page d'accueil, l'identificateur de message unique (msgId), l'identificateur de lien (linkId) et et l'identificateur de l'utilisateur (userid) sont transmis au serveur, ainsi qu'un paramètre supplémentaire (referral) qui est transmise à l'adresse URL cible de a redirection.