Using MessageGears Hosted or External Data with Movable Ink

Overview

MessageGears Hosted and External data APIs (formerly called Real-time Context Data and Context API) are a turnkey solution to power open-time personalization for images sent through Movable Ink. Below is a high-level walkthrough of how to enable Movable Ink to select data from hosted or external data.

Table of Contents

Creating an API data source

Entering API information

Authorization

Process

Creating an API data source

The first step to creating data-driven content within Movable Ink is setting up MessageGears as an API data source for your creative. To do this, click the drop-down at the top right of your screen and select Data Sources.

Once at the data source page, create an API integration by selecting the appropriate box.

Entering API information

Once there, fill out the API page with your MessageGears data source details. The base endpoint for hosted data is:

https://api.messagegears.net/v5/engage/context?data=<your datasource>-[<your key>]

Ensure that you put your contextual data variable in square brackets, as that is how Movable Ink recognizes variable parameters.

Authorization

MessageGears' External data API makes use of JSON Web Tokens, an open, industry standard RFC 7519 method for representing claims securely between two parties. To enable authorization in the Movable Ink console, click on ‘Show Advanced Settings’, and click ‘add header’ at the bottom. Your header name should be the word Authorization and the value should be your API token sent to you from MessageGears Support.

At this point, your endpoint should be returning sample data and you are now ready to enhance your messages with data-activated creative.