HTTP-Anforderungsparameter für die Tags "IMG" und "A"

Wenn der Message Connector eine Anfrage empfängt, weil ein Endbenutzer auf ein A-Tag geklickt oder eine E-Mail geöffnet hat, die einen Message Connector-codierten IMG-Tag enthält, werden die in der Anfrage enthaltenen Parameter geparst, um die entsprechenden Angebotsdaten zurückzugeben. Dieser Abschnitt enthält eine Liste der Parameter, die in der anfordernden URL enthalten sein können (entweder im IMG-Tag, das automatisch geladen wird, wenn ein in Tags eingeschlosses Bild aufgerufen oder die E-Mail geöffnet wird, oder im A-Tag, das geladen wird, wenn sich der Benutzer durch die E-Mail-Nachricht zur angegebenen Website klickt).

Parameter

Wenn der Message Connector eine Anfrage empfängt, werden die in der Anfrage enthaltenen Parameter geparst. Diese Parameter können vollständig oder teilweise Folgendes enthalten:

Parametername	Beschreibung	Erforderlich?	Standardwert
msgId	Die eindeutige ID der E-Mail-Instanz oder Webseite.	Ja	Ohne. Dies wird von dem System bereitgestellt, das die eindeutige Instanz der E-Mail-Nachricht oder der Webseite erstellt, die den Tag enthält.
linkId	Die eindeutige ID des Links in dieser E-Mail oder Webseite.	Ja	Ohne. Dies wird von dem System bereitgestellt, das die eindeutige Instanz der E-Mail-Nachricht oder der Webseite erstellt, die den Tag enthält.
audienceLevel	Die Zielgruppenebene, zu der der Empfänger dieser Kommunikation gehört.	Nein	Der audienceLevel-Standardwert, der im audienceLevels-Element der Datei MessageConnectorConfig.xml angegeben ist.
ic	Der Name des interaktiven Zielkanals (IC)	Nein	Der Wert des interactiveChannel-Elements im Abschnitt defaultParameterValues der Datei MessageConnectorConfig.xml. Der Standardwert lautet "interactiveChannel".
ip	Der Name des Interaktionspunkts (IP)	Nein	Der Wert des interactionPoint-Elements im Abschnitt defaultParameterValues der Datei MessageConnectorConfig.xml. Der Standardwert lautet "headBanner".
offerImageUrl	Die URL der Zielangebotsgrafik für die IMG-URL in der Nachricht.	Nein	Ohne.
offerImageUrlAttr	Der Name des Angebotsattributs mit der URL der Zielangebotsgrafik	Nein	Der Wert des imageUrlAttribute-Elements im Abschnitt defaultParameterValues der Datei MessageConnectorConfig.xml.
offerLandingPageUrl	Die URL der Landing-Page für das Zielangebot.	Nein	Ohne.
offerLandingPageUrlAttr	Der Name des Zielattributs mit der URL der Landing-Page für das Zielangebot.	Nein	Der Wert des landingPageUrlAttribute-Elements im Abschnitt defaultParameterValues der Datei MessageConnectorConfig.xml.
contactEvent	Der Name des Kontaktereignisses.	Nein	Der Wert des contactEventName-Elements im Abschnitt defaultParameterValues der Datei MessageConnectorConfig.xml. Der Standardwert lautet "contact".
responseEvent	Der Name des Akzeptanzereignisses.	Nein	Der Wert des acceptEventName-Elements im Abschnitt defaultParameterValues der Datei MessageConnectorConfig.xml. Der Standardwert lautet "accept".
debug	Das Debugflag. Setzen Sie diesen Parameter nur zur Fehlerbehebung und auf Anweisung durch den IBM® technischen Support auf "true".	Nein	Der Wert des debugFlag-Elements im Abschnitt defaultParameterValues der Datei MessageConnectorConfig.xml. Der Standardwert lautet "false".
<audience id>	Die Zielgruppen-ID dieses Benutzers. Der Name dieses Parameters ist in der Konfigurationsdatei definiert.	Ja	Ohne.

Wenn der Message Connector einen unbekannten Parameter empfängt (das heißt einen Parameter, der nicht in obiger Liste enthalten ist), gibt es zwei Möglichkeiten:

Wenn ein unbekannter Parameter angegeben ist (z. B. "attribute", wie in attribute="attrValue") und ein übereinstimmender Parameter mit dem gleichen Namen und dem Wortzusatz "Type" vorhanden ist (z. B. "attributeType", wie in attributeType="string"), erstellt der Message Connector einen übereinstimmenden Interact Parameter und übergibt diesen der Interact Laufzeit.

Für den Typparameter sind folgende Werte zulässig:

Zeichenfolge

Zahl

Datum/Uhrzeit

Für einen Typparameter "datetime" sucht der Message Connector auch nach einem Parameter mit dem gleichen Namen und dem Wortzusatz "Pattern" (z. B. "attributePattern"), falls ein gültiger Wert im Format für Datum/Uhrzeit vorhanden ist. Sie können zum Beispiel den Parameter attributePattern="MM/dd/yyyy" angeben.

Hinweis: Wenn Sie den Parametertyp "datetime" angeben, ohne ein übereinstimmendes Datumsmuster anzugeben, wird der Wert verwendet, der in der Message Connector-Konfigurationsdatei (in <installation_directory>/msgconnector/config/MessageConnectorConfig.xml) auf dem Interact Server angegeben ist.

Wenn ein unbekannter Parameter angegeben wird und kein übereinstimmender Typwert vorhanden ist, übergibt der Message Connector diesen Parameter an die URL für die Zielweiterleitung.

Der Message Connector übergibt alle unbekannten Parameter an den Interact Laufzeitserver, ohne die Parameter zu verarbeiten oder zu speichern.

Beispielcode für den Message Connector

Der folgende A-Tag enthält ein Beispiel mit einem Satz von Message Connector-Links, die in einer E-Mail-Nachricht enthalten sein können:

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

In diesem Beispiel wird der IMG-Tag beim Öffnen der E-Mail-Nachricht automatisch geladen. Indem die Grafik aus der angegebenen Seite abgerufen wird, übergibt die Nachricht die Parameter für die eindeutige Nachrichten-ID (msgID), die eindeutige Link-ID (linkID) und die eindeutige Benutzer-ID (userid) zusammen mit den beiden zusätzlichen Parametern (incomeCode und incomeType) an die Interact Laufzeit.

Der A-Tag stellt das HREF-Attribut (Hypertext Reference) bereit, das die Angebotsgrafik in einen Link zum Anklicken in der E-Mail-Nachricht umwandelt. Wenn der Endbenutzer die Grafik in der Nachricht anzeigt und sich dann zur Landing-Page durchklickt, werden die eindeutige Nachrichten-ID (msgId), die eindeutige Link-ID (linkId) und die eindeutige Benutzer-ID (userid) jeweils zusammen mit allen zusätzlichen Parametern (referral) der URL für die Zielweiterleitung an den Server übergeben.