GIF Pixel API

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

The endpoint accepts data query parameter with base64 encoded event data JSON and returns an empty 1×1 GIF image.

Event data might be provided via data query parameter that is base64 encoded JSON or via query parameters where parameter name is a path to value in event.

Parameters

Request sample with data parameter

JSON for encoding:

{
  "token": "client_secret",
  "user": {
    "anonymous_id": "123"
  }
}

Request:

HTTP GET https://t.jitsu.com/api/v1/p.gif?data=ewogICJ0b2tlbiI6ICJjbGllbnRfc2VjcmV0IiwKICAidXNlciI6IHsKICAgICJhbm9ueW1vdXNfaWQiOiAiMTIzIgogIH0KfQ==

Request sample with data parameter and paths

JSON for encoding:

{
  "token": "client_secret",
  "user": {
    "anonymous_id": "123"
  }
}

Request:

HTTP GET https://t.jitsu.com/api/v1/p.gif?event_type=email_open&utm_campaign=cpa_10000&user.context.flag=true&data=ewogICJ0b2tlbiI6ICJjbGllbnRfc2VjcmV0IiwKICAidXNlciI6IHsKICAgICJhbm9ueW1vdXNfaWQiOiAiMTIzIgogIH0KfQ==

Result JSON:

{
  "token": "client_secret",
  "user": {
    "anonymous_id": "123",
    "context": {
      "flag": true
    }
  },
  "event_type": "email_open",
  "utm_campaign": "cpa_10000"
}

Response

Empty 1×1 GIF image with image/gif Content-Type.

The following data will be set into income events if an event doesn't have a field: