This article provides information about the Higher Logic Thrive Marketing Professional (Thrive Marketing Professional) integration with iMIS.
IMPORTANT: The information in this article is specific to iMIS version 20.3 and later. If your Thrive Marketing Professional account is integrated with an earlier version, visit the iMIS section of our knowledge base for relevant documentation.
Contact synchronization (sync)
Your Target Groups can synchronize in three ways.
- Navigate to Contacts > Groups and select Info from a Target Group's hover menu to trigger a manual sync.
- At the time of publish, the Target Group will refresh before the message sends.
- If a Target Group is used as part of a campaign, it will resync hourly.
List sync
Thrive Marketing Professional syncs lists from IQAs in the Higher Logic > MailingLists folder ("$/HigherLogic/MailingLists"). For an IQA to be available to the integration, it must:
- Return at least one active record,
- Have security settings set to Share Everyone (Full Control),
- Have its Display tab return PartyID (or a different field that contains the iMIS ID) with an alias of ID, and
- Have all prompts set to No.
Higher Logic will provide an installable package with the business objects and IQAs used by the integration. This package includes the templates for common marketing lists and to target panel fields for custom personalizations.
Personalizations
Default Personalizations - every Contact that is added to your Thrive Marketing Professional account via a sync with your iMIS database will default to the following fields.
$/HigherLogic/Contacts/Contacts
| Higher Logic Contact Field | IQA Field Name |
|---|---|
| AlternativeContactId | AlternativeContactId |
| Birthday | Birthday |
| ContactType | ContactType |
| Designation | Designation |
| DoNotEmail | DoNotEmail |
| ExcludeFromDirectory | ExcludeFromDirectory |
| FirstName | FirstName |
| Gender | Gender |
| InformalName | InformalName |
| IsMember | IsMember |
| IsOrganization | IsOrganization |
| LastName | LastName |
| MemberExpiresOn | MemberExpiresOn |
| MemberSince | MemberSince |
| MiddleName | MiddleName |
| OrganizationName | OrganizationName |
| ParentContactId | ParentContactId |
| PrefixCode | Prefix |
| PrimaryEmailAddress | PrimaryEmailAddress |
| SuffixCode | Suffix |
| Title | Title |
| WebsiteURL | WebsiteURL |
Custom personalization/demographic sync
You can also personalize on additional fields in iMIS. Higher Logic syncs Panel fields by calling an IQA.
- Higher Logic will define a template for the IQA as part of the package it provides.
- You can modify the template in order to make available for personalization the custom fields for your contacts.
Higher Logic syncs Panel fields nightly by calling the IQA.
Preference management & unsubscribes
Preference management
Higher Logic allows mail recipients to manage their communication preferences in iMIS.
- A preference token link will be pulled from iMIS.
- Users can access their preferences with that token.
The iMIS preference Token is synced as a personalization field named iMISv2 - Token. This can then be used to create Preference management page links to be shared with users. This way, mail recipients will not have to log in to provide their preferences.
A Communication Preferences page may have to be set up in iMIS first, if one is not already available. The settings on the widget may also have to be changed to 'everyone read' to make it visible.
The URL to build in the mailing templates for the IPM page will look like:
https://[imis_site_domain]/CommunicationPreferences?CPToken=%%WSI||INT|iMISv2|token%%
Unsubscribes
If you plan to use only the iMIS preference link in your emails, then iMIS becomes the system of
record for opt‑outs, and Higher Logic does not automatically process those clicks as global
unsubscribes. Instead, you must exclude people from mailings based on iMIS data (e.g., IQAs
or “do not contact” preferences) that sync to Higher Logic.
How unsubscribes are handled in this setup
- The footer link in the email is an iMIS communication preference URL using the token. For
example: https://[imis_domain]/CommunicationPreferences?CPToken=%%WSI||iMISv2|token%%
(or a similar tokenized link) - When a recipient clicks that link, they are taken to the iMIS communication preference page
to manage or opt out of communications. No Higher Logic global unsubscribe is triggered
by that click, because the link is not an HL/Informz unsubscribe URL. - iMIS stores the userʼs preferences and/or “unsubscribe from all” choice. iMIS is then the
source of truth for who is unsubscribed or opted out.
To enforce those preferences in Thrive Marketing Professional
- You create IQAs in iMIS that represent each preference category (and optionally a “do not
contact” style preference). - Those IQAs sync to Thrive Marketing Professional as target groups.
- When sending a mailing, you add the relevant IQA-based groups to the Exclude column so those contacts are not emailed (e.g., exclude the “no events” IQA from all event mailings, or always exclude a “do not contact me” group if used).
What does not happen automatically
Clicking the iMIS preference link does not:
- Set the contact to globally unsubscribed in Higher Logic.
- Trigger an Informz unsubscribe writeback event; instead, unsubscribe logic is handled in iMIS, and activity tracking/writeback depends on how the integration is configured.
Because of that, you can:
- Still email them from Higher Logic if they remain in your send group and are not in an
excluded IQA, even if they “unsubscribed from all” inside iMIS. Preventing sends relies on
your IQA design and exclusion logic, not on HLʼs global unsubscribe mechanism.
Only use the iMIS preference link in the footer if you want all preference management and
“unsubscribe from all” handled in iMIS.
Ensure:
- The iMIS preference page includes an “unsubscribe from everything” option if they need a full
opt‑out choice. - Appropriate IQAs are created for all opt‑out conditions and always used as exclude groups on sends
Activities written to the iMIS Activity table
Higher Logic writes the following Thrive Marketing Professional activities to the iMIS Activity table (Activity Type "HLOGIC").
IMPORTANT: Higher Logic must have the Read, Update, and Add permissions in Security tab > Authenticated Users, as shown below. Without these, writebacks will not work.
- Bad Email - when a subscriber with a "bad" email address is added to the system; for example, two @ symbols, a double .com
- Landing Page Submit - when a user has submitted a landing page form
- Unsubscribe - a global unsubscribe from all messages
- Resubscribe - when a user resubscribes after having unsubscribed (this must be in the same system as the unsubscribe)
NOTE: The following activities are written to the Activity table only if you have not created panel fields for these activities.
- Web Tracking Page Visit - when a page visit is tracked by web tracking
- Mail Sent - when a message is sent
- Mail Open - when a message is opened
- Link Click - when a link is clicked
Activities written to panel fields
Instead of the iMIS Activity table, you can have some Higher Logic activities written to panel fields in your iMIS database.
IMPORTANT: Higher Logic must have the Read, Update, and Add permissions in Security tab > Authenticated Users, as shown below. Without these, writebacks will not work.
Overview of the set-up steps
Below are the few steps that you have to complete in order to write to panel fields.
1 - Create the panels in your iMIS instance
- If you are not familiar with how to create panels in iMIS, see Creating panels.
- The panels that you create must be set to allow multiple entries, which is described in Multiple entries.
TIP: The fields and metadata that you need for each panel are referenced in the sections that follow.
2 - Notify Higher Logic Support
When your panel fields are ready, create a case and inform Higher Logic Support that you're ready to start using panel fields.
3 - Verify the configuration
Check the configuration of the Informz mailing-activity writeback tables.
For information, see Configure an automatic writeback in iMIS Writebacks - Mailing Activity.
Post-change writeback cadence
After your integration has been configured to write Thrive Marketing Professional activities to panels in iMIS, the cadence of the activity writebacks will change from:
- being written to iMIS as they happen to
- being written to iMIS once for all subscribers three to seven days after a mailing has been sent.
Mailing activities
This section provides the panel set-up information for mailing activities writebacks.
Set the following properties for this panel field.
- Source name: INFORMZ_MAILING_ACTIVITY
- Parent type: Contact
- Panel type: Multi-instance (checkbox or radio button)
| Informz Field/Data | Field Name | Datatype |
|---|---|---|
| Contact ID | IMIS_ID | Auto-created; do not create. Note that the IMIS_ID is a string, not an integer. |
| Mailing Instance ID | MAILING_ID | INTEGER |
| Message Name | MAILING_NAME | TEXT (255-character max) |
| Date Sent | PUBLISH_DATE | DATETIME |
| Was it delivered | DELIVERED | Yes/No |
| Did they open | OPENED | Yes/No |
| Was there a click | CLICKED | Yes/No |
| Link Clicked | LINK | TEXT (1000-character max) |
| Campaign ID | CAMPAIGN_ID | INTEGER |
| Campaign Name | CAMPAIGN_NAME | TEXT (1000-character max) |
Campaign step details
This section provides the panel set-up information for campaign step activities writebacks.
Set the following properties for this panel field.
- Source name: INFORMZ_CAMPAIGN_STEP
- Parent type: Contact
- Panel type: Multi-instance (checkbox or radio button)
| Informz Field/Data | Field Name | Datatype |
|---|---|---|
| Contact ID | IMIS_ID |
Auto-created; do not create. Note that the IMIS_ID is a string, not an integer. |
| Campaign ID | CAMPAIGN_ID | INTEGER |
| Campaign Name | CAMPAIGN_NAME | TEXT (255-character max) |
| Campaign Step ID | CAMPAIGN_STEP_ID | INTEGER |
| Campaign Step Name | CAMPAIGN_STEP_NAME | TEXT (255-character max) |
| Campaign Step Type | CAMPAIGN_STEP_TYPE | TEXT (255-character max) |
| Campaign Subscriber Id | CAMPAIGN_SUBSCRIBER | INTEGER |
| Step Start Date | STEP_START_DATE | DATETIME |
| Campaign Start Date | CAMPAIGN_START_DATE | DATETIME |
| Campaign Goal Date | CAMPAIGN_GOAL_DATE | DATETIME |
Web tracking
This section provides the panel set-up information for web-tracking activities writebacks.
Set the following properties for this panel field.
- Source name: INFORMZ_WEB_TRACKING
- Parent type: Contact
- Panel type: Multi-instance (checkbox or radio button)
| Informz Field/Data | Field Name | Datatype |
|---|---|---|
| Contact ID | IMIS_ID |
Auto-created; do not create. Note that the IMIS_ID is a string, not an integer. |
| Page URL | PAGE_URL | TEXT (1000-character max) |
| Page TITLE | PAGE_TITLE | TEXT (1000-character max) |
| Http User Agent | HTTP_USER_AGENT | TEXT (1000-character max) |
| Ip ADDRESS | IP_ADDRESS | TEXT (45-character max) |
| Country NAME | COUNTRY_NAME | TEXT (255-character max) |
| Orderid ORDERID | ORDERID | TEXT (255-character max) |