The Real Magnet Higher Logic integration uses the Higher Logic API in conjunction with Real Magnet’s Universal Webservice. It is compatible across all browsers, and can be used in conjunction with the Real Magnet platform.

Watch the Video

Who should read this guide?

This guide is for Real Magnet users responsible for determining messaging and contact management guidelines. It assumes that you are familiar with:

• Using the Real Magnet system
• Managing Users in Higher Logic
• Managing Data within Higher Logic

Failure Notifications

Whenever there is a failure for the integration, an individual can opt-in to receive a daily notification.

To modify this setting:

1. Log in to Real Magnet.
2. Select Higher Logic Management.
3. Select Settings.
4. Under Failure Report, ensure that Enabled is set to YES.
5. Enter a Run Time.
6. Enter the email address(es) (comma separated format).
7. Click Save.

User-Access Requirements

A Real Magnet account administrator can designate what users in the account have permission to access the integration. Below you will find tables detailing what each permission level means and what a user can do with that permission.

To assign a permission:

1. Select Tools.
2. Select Account Management.
3. Select Integration Access Levels.

Real Magnet User Permissions

Scheduled Upload

Permission Level	View	Run	Create/Schedule	Edit	Delete
Full Access	Y	Y	Y	Y	Y
Read Only	Y	Y	N	N	N
No Access	N	N	N	N	N

Tracking

The Higher Logic integration does not push tracking; rather, if you're already integrated with one of Real Magnet’s products, the tracking will send back via that integration.

• Aptify
• AmNet
• iMIS
• MemberSuite
• MSCRM
• netFORUM Enterprise
• Personify
• Salesforce

Considerations before Uploading Higher Logic Communities

Uploading recipients from the Higher Logic interface to Real Magnet can be performed in a variety of ways. Below are the considerations that must be made before you upload your first Community from Higher Logic.

Unique Identifiers

Every database-driven system has a way to enforce uniqueness on records to avoid duplicates. Real Magnet offers two options for determining uniqueness: email address or the Higher Logic Contact Key. These choices assume that there is a Real Magnet integration installed (e.g., netFORUM or Aptify). On the other hand, if your main integration is Personify, there are some considerations to be made in regards to Custom ID.

Personify and Custom ID for Higher Logic

When using Personify and Higher Logic, it's recommended that the Custom ID for your Real Magnet account remain as email. The default setting for a Real Magnet account has the recipient’s email address as the unique ID.

Email as a Unique ID

When this default option is enabled, Real Magnet will only create one record for any single email address. For every record uploaded to Real Magnet that contains a custom ID and an email address, Real Magnet will create a unique record based on that email address.

NOTE: There can be NO duplicate email addresses with this method.

Implications

• Email addresses cannot be overwritten from Higher Logic

Custom Member ID as a Unique ID

When custom ID is selected as the unique identifier, this will be generated by the unique identifier supplied with your AMS or API process. in the case of Higher Logic, this is the Contact Key.

Implications

• Every record uploaded to Real Magnet must contain a Contact Key
• Duplicate email addresses can exist
• Email addresses can be overwritten from Higher Logic

Replacing Real Magnet Records

Real Magnet provides two options when uploading a Saved Search:

• Adding recipients - If add to existing list is selected, Real Magnet will only add the records to the group with the records from the upload. Individual records will not be updated or overwritten.
• Replacing recipients - If Replace existing list is selected, Real Magnet will replace the records in the group with the records from the upload. The records being removed are not deleted, only removed from the group (they remain in the database), and there is no impact on the historical data.

NOTE: The replace method can be made the default. To do so, submit a request to your Implementation Project Manager or to Support.

If Replace is selected (Real Magnet’s default setting to overwrite existing data), based on the unique identifier will overwrite the corresponding data that exists in Real Magnet. This can be particularly useful in instances where there is one database of record that is in the process of being constantly updated.

NOTE: Add to Group will not update individual records in Real Magnet.

Character Limitations

When uploading a list to Real Magnet, the maximum characters allowed per field are:

Field Type	Character Limit
E-mail, Address 1, Address 2, All Custom Fields	100 characters
First Name, Last Name, Phone, Fax, City, State, Zip	50 characters
Company	200 characters
Enhanced Personalization Field	250 characters

Upload a Higher Logic Community to Real Magnet

The integration works with the Data Sources (previously List Automation Rules). Data Sources will execute on demand at the time of run from the Real Magnet Upload Scheduler (RMUS). All other Communities will update according to the schedule you have set in the Admin section of Higher Logic once per day, or more often (such as hourly).

Create Data Sources in Higher Logic

To create a Data Source:

NOTE: You must have Super Admin permissions to create Data Sources.

1. Click admin (gear icon) in the Webmaster Links menu (this is usually on the right-hand side of the screen).
2. Click Admin in the resulting fly-out menu.
3. From the Tools menu, select Data Sources.
4. Click New Data Source.
5. Select List of Contacts from the Select Data Source Type menu.
6. Configure your Data Source as desired.

Transferring Communities from Higher Logic to Real Magnet

Data can be transferred from Higher Logic to Real Magnet via a scheduled upload or one-time transfer from within Real Magnet.

The Real Magnet Upload Scheduler (RMUS) is a feature of the integration that allows for automated uploads to the Real Magnet system; it is extremely useful in the event there are any Saved Searches that you send to on a regular basis.

It allows the following upload job types:

• Run Now - This upload job will run once. Once completed, edits or changes cannot be made to this upload job.
• On Demand - This upload job will only run when the green play icon is clicked or using the Sync on Send functionality. This will deploy the upload job when a message is scheduled to send to the group attached to the upload job.
• Scheduled - This upload job will run on a scheduled basis, either daily or weekly, and can be manually run by clicking the green play button. When selecting a group connected to an active Marketing Automation campaign, this option can also upload groups on an hourly basis.

The RMUS can be accessed by logging into Real Magnet and selecting Tools. The details below will cover all aspects of the RMUS.

Icon Legend

Icon	Description
	Delete the upload job.
	Edit the upload job. This applies to On Demand and Scheduled jobs only.
	Run the job. This applies to On Demand and Scheduled jobs only.
	View the rejected individual records. (Real Magnet validates all email addresses uploaded to Real Magnet.)

Upload Jobs Page Overview

This page contains a list of your existing upload jobs in the Real Magnet platform. The list will contain:

• Distribution List Name - The name of the list in Higher Logic.
• Date Created - The date the upload job was created.
• Job Type - Whether the job is Run Now, On Demand, or Scheduled.
• Frequency - The frequency of the scheduled job. For Run Now and On Demand, this will remain blank.
• Scheduled Time - One of the following times.
• Start Time (HH:MM) – The scheduled start time of the upload job.
• Last Run (MM/DD/YYYY HH:MM) – When the upload job was last executed and completed.
• Next Run (MM/DD/YYYY HH:MM) – When the upload job is next scheduled to run.
• Group Results - The group in Real Magnet the query was uploaded to and the results of the last upload, including the total number in the group and the number added. Any error that may occur on upload will surface here.
• Actions - The allowed actions a user can make to the upload job.

Create an Upload Job

To create an upload job in Real Magnet:

1. Select Tools.
2. Select Higher Logic Management.
3. Select Create Upload Job.
4. Select a Community.
5. Select Create Map.
6. Select View Entire Field List or One by One.
7. Select which columns you would like to bring over to Real Magnet. These are a one-to-one relationship when mapping fields. This means that you can only map the fields on the left side of the screen with one item on the Real Magnet side once.
8. Click Create Schedule.
9. Select Create New Group or Add to Existing Group.
10. Select either Add to existing group or Replace existing list.
11. Depending on account settings the third upload step may reveal the option whether or not to update. Select Do not Update Existing Records (Only Add Records To Group) or Update Existing Records.
12. Click Create.
13. Select your frequency: Run Now, On Demand, or Scheduled.
14. Click Submit.

Manually Upload Communities to Real Magnet

You may have users who want to upload .csv files into the system, independent of the integration. When uploading a list within Real Magnet, independent of the RMUS, a user must include the Contact Key and email address. Upon upload, the user must map the Contact Key column to the Custom Member ID field in Real Magnet. The character limits for the various field types are listed below.

Field Type	Character Limit
E-mail, Address 1, Address 2, All Custom Fields	100 characters
First Name, Last Name, Phone, Fax, City, State, Zip	50 characters
Company	200 characters
Enhanced Personalization Field	250 characters

Real Magnet Data in Higher Logic

The Real Magnet tracking data will send back overnight to your installed CRM integration. For Personify, Higher Logic recommends completing an upload job before tracking is pushed back, so that IDs are synced. Tracking will display in their respective areas based on your CRM.

Frequently Asked Questions

Why is this individual record missing tracking information? Ensure that individual is assigned a Contact Key. If the individual was uploaded outside of the Real Magnet Scheduler, you must ensure that it also has its Contact Key mapped to the Custom Member ID field in Real Magnet. This is how the Higher Logic platform identifies that individual in your CRM database. If an individual is missing this information, no tracking information will push back for that recipient to the CRM.