Magnolia 5.7 reached extended end of life on May 31, 2022. Support for this branch is limited, see End-of-life policy. Please note that to cover the extra maintenance effort, this EEoL period is a paid extension in the life of the branch. Customers who opt for the extended maintenance will need a new license key to run future versions of Magnolia 5.7. If you have any questions or to subscribe to the extended maintenance, please get in touch with your local contact at Magnolia.
This module is deprecated. See Deprecations.
The Magnolia Silverpop module is a connector for IBM Watson Marketing Cloud. It is a cloud-based digital marketing provider that offers email marketing, lead-to-revenue management and mobile engagement solutions. The connector allows you to personalize content based on powerful scoring models aggregated by the visitor's behavior.
Installing
<version/>
in the dependency.<dependency> <groupId>info.magnolia.silverpop</groupId> <artifactId>magnolia-silverpop</artifactId> </dependency>
Configuration
- Please follow XML API Developer guide (link requires you to log in with your IBM Watson Marketing Cloud account):
- Authentication with the APIs
- Authentication Method: OAuth 2.0 Granted Access
- Getting Started with OAuth in Engage
- Authentication Method: OAuth 2.0 Granted Access
- Authentication with the APIs
Edit the configuration of the node
/modules/silverpop/config
with the Configuration app:
https://api[x].silverpop.com/XMLAPI
Web tracking
IBM Watson Marketing Cloud connector uses the Marketing Tags module to insert tracking javascript into pages. Go to http://localhost:8080/magnoliaPublic/.magnolia/admincentral#app:marketing-tags:detail;/Silverpop:edit to adjust the scripts for your instance (https://engage[x].silverpop.com/viewOrganization.do, section
Web Tracking Settings
).
Personalization
The module contains two traits for Personalization module. Those are able to retrieve information from the IBM Watson Marketing Cloud
Recipient column value
: you can set a regular expression to match a certain column of the recipient.
- You can also use a regular expression for
Contact scores
trait.
You need to set the ID of the database from which you want to retrieve information. To enable detecting traits edit node /server/filters/SilverpopTraitsDetectorFilter
with the Configuration app accordingly:
true info.magnolia.silverpop.personalization.SilverpopTraitsDetectorFilter 4014446Node name Value
External forms
If you want to create forms directly in IBM Marketing Cloud, you can skip this chapter and install External Forms module - IBM Web Forms implementation instead.
IBM Watson Marketing Cloud connector uses the External Forms module to show forms created from Silverpop's databases. To check your configuration:
- Create a database in your https://engage[x].silverpop.com if you don't have any.
- Go to the sample page http://localhost:8080/magnoliaAuthor/.magnolia/admincentral#app:pages:detail;/travel/subscribe:edit.
- Edit the external form component.
- Choose
Silverpop
as external form. - Choose a database from Silverpop.
- The form should be rendered from all columns of the chosen database.
- Add a field to the database from the Silverpop admin central.
- Go to http://localhost:8080/ magnoliaAuthor/travel/subscribe.html. Your new field should be displayed.
- You probably don't want to show all the field of the database such as system ones and want to change the order of field on the page:
- Create a selection field called
LAYOUT
in the database. - Add the desired field names as values for selection.
- Create a selection field called
- Activate the page to the public instance.
- Go to the activated page, fill in some fields (http://localhost:8080/magnoliaPublic/travel/subscribe.html) and submit.
- Information will be stored in Silverpop.
- User identification:
- If the web tracking javascript is enabled and your browser allows to store cookies. Your submitted information should be pre-filled if you revisit the subscription page. You can change values and resubmit.
- Alternatively, you can allow login with email/password if you want to allow users to be logged in from another computers, mobiles...
- Add a field called
PASSWORD
to the Silverpop database. Set the databaseId against which you want to run authentication. This should be the same database as the one defined for the
SilverpopTraitsDetectorFilter
.SilverpopAuthenticationFilterenabledtrue
classinfo.magnolia.silverpop.login.SilverpopAuthenticationFilter
databaseId4014446
- Go to the subscription page.
Password
andPassword confirmation
fields should be there. - Fill the password and submit the form.
- You should now be able to log in with email/password: http://localhost:8080/magnoliaPublic/travel/subscribe/login.html.
- The password login has precedence to cookie identification.
- Add a field called
Mailing
You can publish pages from Magnolia to IBM Watson Marketing Cloud as mailing template:
- Go to the pages app.
- Choose a page to be send (e.g. a newsletter). This page has to be already published to a public instance.
- Click the
Preview page
action. - Click the
Publish to Silverpop
action. - Fill the information. Links source is the domain or subscriber url from which should be the page requested.
- Click
Confirm
.
- You can send the published page to a Silverpop contact list:
- Click the Send from Silverpop action.
- Optionally choose a schedule date. If not specified, the mail will be send immediately.
- Confirm.
Read more
- XML API Developer’s Guide ENGAGE, Copyright Silverpop Systems Inc. All rights reserved.
(You should have access to this via your IBM Marketing Cloud account.) - IBM Marketing Cloud (Silverpop) Support portal
- Personalization module
- Marketing Tags module