Pixel API

Info

Available since Jitsu v2.8.2

Jitsu has a GIF Pixel API endpoint for tracking email opens, impressions of advertisements and other cases when:

  • JavaScript is restricted
  • only HTTP GET request is allowed
  • only embedding an image is allowed

Pixel Endpoint

This endpoint can be used as a src or <img> HTML tag to send events to Jitsu:

https://your-jitsu-domain.com/api/px/{event-type}

Query Parameters

Description
writekeyWrite Key of configured Jitsu Stream
database64 encoded event JSON payload
JSON path
path.to.node		path to node where write the value
process_headersBoolean. Enrich event with user and page data from HTTP headers: Referer and Cookies
cookie_domainWhen process_headers=true set Jitsu Anonymous Id cookie (__eventn_id) for provided domain

Examples

Pass base64 encoded JSON payload to image pixel:

<img 
  src="https://your-domain.com/api/px/t?writekey=WRITEKEY&data=eyJ0eXBlIjoidHJhY2siLCJldmVudCI6InRlc3RfZXZlbnQifQ=="
/>

Pass event properties to image pixel:

<img 
  src="https://your-domain.com/api/px/t?writekey=WRITEKEY&event=mail_open&properties.title=MyEmail"
/>