Pixel Tracking

Pixel tracking options allow you to use a graph with an API listener in situations where you can load an image (like emails and web pages) but cannot otherwise run code.

The Xponent API single-pixel image tag can be placed in emails, web pages, and anything else that supports HTML to track HTTP headers and any additional information (like campaign ID, customer ID, etc.) that is passed along in the query string.

Email Pixel Tracking

Pixel tracking passes data from the HTTP request, and anything appended on the query string to your graph.

For Example: An image tag like this: 

API Pixel Tag Example

<img src="https://api.kitewheel.com/api/v1/listener/ABCD/epixel.gif?name=Bob" />

Will send a packet of data into your graph that includes all HTTP headers and the query parameter "name"  with the value "Bob".

See below for a complete example. 

Website Pixel Tracking

In addition to data included with an email pixel, the website pixel tag will also get and set a cookie named "kwCookie."

A sample JSON packet for the website pixel tracking adaptor is shown below. Query parameters passed on the query string, such as 'param1=val1&param2=val2', will appear as top-level fields in the JSON structure. 

The IP address of the client is held in the x-real-ip field. See the section above on the standard Xponent API header. 

{
	"webPixel": {
		"param1": "val1",
		"param2": "val2",
		"paramn": "valn",
		"_kw": {
			"kwCookie": "927096b0-9560-11e6-b23f-f3c3713ff44b",
			"headers": {
				"accept-language": "en-US,en;q=0.8",
				"accept-encoding": "gzip, deflate, sdch, br",
				"x-forwarded-port": 443,
				"x-forwarded-for": "162.243.209.120, 162.243.209.120",
				"accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8",
				"upgrade-insecure-requests": 1,
				"host": "api.kitewheel.com",
				"x-forwarded-proto": "https",
				"cookie": "_ga=GA1.2.284056508.1476723130",
				"cache-control": "max-age=0",
				"x-real-ip": "162.243.209.120",
				"user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/53.0.2785.143 Safari/537.36"
			},
			"method": "GET"
		}
	}
}