Xponent Graph API

The Xponent Graph API makes integrating Xponent business logic into other systems easy. This is achieved by providing a listener adaptor that can be added to any graph to make it publicly accessible. The graph is given a unique permanent URL that can be called immediately. 

The Xponent Graph API has three modes of operation: 

• Standard API Listener - in this mode, the graph exposes a web service endpoint that will respond to a web service POST request 
• Web Tracking with the Xponent Journey Hub Web Tag - in this mode, the graph provides some JavaScript that can be included on any web page to track activity and implement returned recommendations into the website.
• Pixel Tracking - in this mode, the graph returns a 1x1 transparent image, implemented as an HTML page on a page. This can be used for email pixel tracking and simple web page tracking. 
  • Pixel with Cookie - this tag will handle and return a cookie to identify the user and the parameters specified on the pixel tag.
  • Pixel No Cookie - this tag will only return parameters and headers; no cookie is set. This can be used to track email open activity.
• Dynamic Content and Redirection - this mode can be used to return any valid HTTP response, including a redirect to an image or another web page 

Adding a Graph API Listener

A graph API listener can be added by clicking on the Add Listener button in the top right of a graph editor screen. Then select listener type "API"  from the dropdown.

The Xponent Graph API Listener can be edited at any time by clicking on the Edit Listener button  or by double-clicking on the Listener icon in the top left-hand corner of the graph.

Xponent Journey Hub Graph API Header

All of the Xponent API requests return a standard "_kw" object, as shown below, and other information depending on the Graph API listener type. This object contains standard HTTP header fields. Descriptions courtesy of Wikipedia. 

{
	"_kw": {
		"headers": {
			"accept": "application/json, text/javascript, */*; q=0.01",
			"accept-encoding": "gzip, deflate, br",
			"accept-language": "en-US,en;q=0.8",
			"cache-control": "max-age=0",
			"content-length": "815",
			"content-type": "application/json; charset=UTF-8"
			"host": "api-demo.Xponent.com",
			"origin": "http://eudemo.Xponent.co.uk",
			"referer": "http://eudemo.Xponent.co.uk/retail/index.html",
			"user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36",
			"x-forwarded-for": "213.86.100.4, 213.86.100.4",
			"x-forwarded-port": "443",
			"x-forwarded-proto": "https",
			"x-real-ip": "213.86.100.4"
		}
	}
}