Transactional messaging relies on a specific architecture, which is made up of several instances:
A control instance, on which the message templates are created.
One or more execution instances, which receive events and deliver messages.
|Control instance||Execution instance|
|Adobe Campaign users log on to the control instance to:
||Execution instances are here to:
There are several precautions to take when installing the Transactional message packages. Adobe recommends you to work in a test environment before putting into production. You also need to have a compatible Adobe Campaign license. For more information, please contact your Adobe account executive.
The control instance and the execution instance(s) must be installed on different machines. They cannot share the same Campaign instance.
If you need to use several channels, you must install and configure related packages before installing Transactional message packages. For more on this, see Add a delivery channel.
To install the control instance on your machine, select the Transactional message control package via the Tools > Advanced > Import package menu. For more on this, see Installing Campaign Classic standard packages.
The detailed steps to configure the control instance are presented in this section.
Sharing an execution cluster with several control instances is only supported for on-premise environments.
It is possible to share an execution cluster among several control instances. For example, if you manage several specialized stores, you can configure one control instance per brand and link them all to the same execution cluster.
For more on the necessary configuration, refer to Use several control instances.
To install an execution instance on your machine, select the Transactional message execution package via the Tools > Advanced > Import package menu. For more on this, see Installing Campaign Classic standard packages.
The detailed steps to configure an execution instance are presented in this section.
The email channel is available by default. To deliver your transactional messages on multiple channels, you can add other channels (mobile channel, Mobile App channel, etc.).
Adding a delivery channel (mobile channel, Mobile App channel, etc.) must be performed before installing the Transactional message package.
Adobe recommends you always add the delivery channel package before installing the Transactional message package.
However, if you have started a transactional messaging project on the email channel, then decide during the project to add a new channel, you can follow the steps below.
This procedure only applies to customers using a Windows NLServer installed on the same machine as they are working on.
Install the channel you need, for example the Mobile channel, using the package import wizard (Tools > Advanced > Import package… > Adobe Campaign Package).
Perform a file import (Tools > Advanced > Import package… > File), and select the datakitnms
[Your language]packagemessageCenter.xml file.
In the XML content of the data to import, keep only the delivery template that corresponds to the added channel. For example, if you have added the Mobile channel, keep only the entities element that corresponds to the Mobile transactional message (smsTriggerMessage). If you have added the Mobile App Channel, keep only the iOS transactional message (iosTriggerMessage) and the Android transactional message (androidTriggerMessage).
When combined with Mobile App channel module, transactional messaging enables you to push transactional messages through notifications on mobile devices.
The Mobile App channel is detailed in this section.
To use transactional message modules with Mobile App Channel, you need to apply the following configurations:
The event must contain the following elements:
Here is an example of an event that contains this information:
<SOAP-ENV:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"> <SOAP-ENV:Body> <urn:PushEvent> <urn:sessiontoken>mc/</urn:sessiontoken> <urn:domEvent> <rtEvent wishedChannel="41" type="DELIVERY" registrationToken="2cefnefzef758398493srefzefkzq483974"> <mobileApp _operation=”none” uuid="com.adobe.NeoMiles"/> <ctx> <deliveryTime>1:30 PM</deliveryTime> <url>http://www.adobe.com</url> </ctx> </rtEvent> </urn:domEvent> </urn:PushEvent> </SOAP-ENV:Body> </SOAP-ENV:Envelope>
The creation of message templates remains the same.
Combined with LINE Channel, transactional messages allow you to send real time messages on the LINE app installed in consumer mobile devices. This is used to send the Welcome message when a LINE user adds the brand’s page.
To use transactional message module with LINE, the following elements are needed for the configuration on your marketing instance and your execution instance:
Then, from the Explorer , in Platform > External account , you need to configure different external accounts on both instances:
Create an External database external account in your execution instance with the following configuration:
From the Connection category:
Type : select your database server e.g. PostgresSQL.
Server : enter your database server URL.
Account : enter your database account.
The database user needs to have read rights on the following tables for FDA connection: XtkOption, NmsVisitor, NmsVisitorSub, NmsService, NmsBroadLogRtEvent, NmsBroadLogBatchEvent, NmsTrackingLogRtEvent, NmsTrackingLogBatchEvent, NmsRtEvent, NmsBatchEvent, NmsBroadLogMsg, NmsTrackingUrl, NmsDelivery, NmsWebTrackingLogXtkFolder.
Password : enter the password for your database account.
Database : enter the database name of the execution instance.
Target of an HTTP relay to remote database’s account box must be checked.
Create an External Database account in your marketing instance with the following configuration.
From the Connection category:
Create an Execution instance external account in your marketing instance using the following configuration to create the data synchronization workflow:
From the Connection category:
From the Account connection method category:
You can now start creating transactional messages.