Back to top

Glispa Connect Publishers Reporting API v1.1

Overview

Requirements

In order to start using the API you will need the following:

  • Your unique id as a Publisher, from now on referred as publisher_id.

  • A client_id and client_secret for your Client implementation.

You can go to https://ssp.glispaconnect.com/apis/clients and click the new client to get your Cient Id and Client Secret.

Retrieve an Access Token

In order to access the Reporting API you will need to provide an access_token. You will see this request parameter referenced in all example calls.

To get your access_token you will need to issue a POST to https://auth.glispaconnect.com/token with the following parameters:

  • Parameters
    • client_id: YOUR_CLIENT (string) - Client ID provided by Glispa Connect
    • client_secret: YOUR_CLIENT_SECRET (string) - Equivalant Client Secret provided by Glispa Connect
    • grant_type: password (string) - Fixed value password as Grant type
    • username: YOUR_USERNAME (string)- Username used by Publisher to login in glispaconnect.com
    • password: YOUR_PASSWORD (string) - Password used by Publisher to login in glispaconnect.com

ATTENTION

  • client_id, client_secret are sensitive infromation and should not be used in front facing applications (eg. browser apps)

  • Do not provide your Publisher’s username & password in domains different than app.glispaconnect.com

Request

$ curl https://auth.glispaconnect.com/token \
  -X POST \
  -d "client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&grant_type=password&username=YOUR_USERNAME&password=YOUR_PASSWORD" \
  -H 'Content-Type: application/x-www-form-urlencoded; charset=utf-8'

Response

{
  "access_token": "<your-access-token>", 
  "refresh_token": "<your-refresh-token>"
}

Note: access_token will expire an hour after retrieval. You need to use the refresh_token from previous response to request a new access_token. See Refresh token below.

Refresh token

After access_token has expired, the refresh token could be used to acquire a new access token following the step below.

Request

$ curl https://auth.glispaconnect.com/token \
  -X POST \
  -d "client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&grant_type=refresh_token&refresh_token=YOUR_REFRESH_TOKEN_ACQUIRED_PREVIOUSLY" \
  -H 'Content-Type: application/x-www-form-urlencoded; charset=utf-8'

Response

{
  "access_token": "<new-access-token>", 
  "refresh_token": "<new-refresh-token>"
}

Get test_glispaconnect_authentication.sh script to start testing.

Reporting API

The Host url for the reporting API is https://reporting.glispaconnect.com

Any request is prefixed with the current version /v1.1 (for documentation of previous version v1 please contact Glispa Connect)

NOTE: Both http & https traffic is allowed but we highly encourage to use https.

Requests

All requests “MUST” use GET Method and provide the access_token as a query parameter.

For example, given a publisher_id==f0b55f5c-4c51-445f-b6fe-9157db6d11ec and an access_token==xxx it looks like:

GET https://reporting.glispaconnect.com/v1.1/publishers/f0b55f5c-4c51-445f-b6fe-9157db6d11ec?access_token=xxx

Response

First level

Currently, all requests result in a JSON response and Content-Type: application/json; charset-8 response header. First level properties of the response are:

  • meta, an object with metadata information regarding response (like currency used)

  • query, the actual query executed, helpful for debugging 😃

  • data, an array with objects containing datapoints of result.

Data points

More specific datapoints in data array have the following properties:

  • timestamp the timestamp of the datapoint in UTC timezone and ISO-8601 format

  • result the actual values of the response containing:

    • earnings (float)
    • impressions (int)
    • ecpm (float)
    • ad_requests (int)
    • clicks (int)
    • ctr (float)
    • fill_rate (float)
    • render_rate (float)
  • dimension the dimension that describe this particular datapoint containing:

    • publisher_id (string)
    • app_id (string)
    • app_version (string)
    • sdk_version (string)
    • adunit_id (string)
    • adunit_type (string)
    • country (string)
    • city (string)
    • carrier (string)
    • connection_type (string)
    • device_os (string)
    • device_os_version (string)
    • device_brand (string)
    • device_model (string)
    • device_orientation (string)
    • gender (string)
    • year_of_birth (string)
    • interest_category (string)
    • persona (string)

Date values

All date and time values in response are UTC and use ISO-8601 standard and the format is: YYYY-MM-DDTHH:mm:ss.sssZ.

Country values

All country values in response are in ISO 3166-1 alpha-2 standard, eg: US,GR,GB etc

Gender values

Gender values can be the following:

  • F: Female

  • M: Male

Interest category values

All interest category values in response are in IAB standard, eg: IAB9-30. A single user could belong to more than one interest categories.

Persona values

Personas describe the user’s behaviour. A single user could have more than one personas.

Plain request

Examples

By default the results returned without any params given except the required access_token would result in data points breakdown per hour for current day.

Following there in an examples for a request without an access_token and the error response. A request with a valid access_token will result in 200 OK and a response object shown later.

Unauthorized Request
GET/v1.1/publishers/{publisher_id}

Example URI

GET https://reporting.glispaconnect.com/v1.1/publishers/f0b55f5c-4c51-445f-b6fe-9157db6d11ec
URI Parameters
HideShow
publisher_id
string (required) Example: f0b55f5c-4c51-445f-b6fe-9157db6d11ec

Publisher id

Request  Empty Request
HideShow
Headers
Content-Type: application/json
Response  400
HideShow
Headers
Content-Type: application/json; charset=utf-8
Body
{
  "errors": [
    {
      "message": "Missing Authorization header from request"
    }
  ]
}

Authorized Request
GET/v1.1/publishers/{publisher_id}{?access_token}

Example URI

GET https://reporting.glispaconnect.com/v1.1/publishers/f0b55f5c-4c51-445f-b6fe-9157db6d11ec?access_token=30767175-3872-4cda-80b0-5d79c926970a
URI Parameters
HideShow
publisher_id
string (required) Example: f0b55f5c-4c51-445f-b6fe-9157db6d11ec

Publisher id

access_token
string (required) Example: 30767175-3872-4cda-80b0-5d79c926970a

Access Token

Request  Authorized Request
HideShow
Headers
Content-Type: application/json
Response  200
HideShow
Headers
Content-Type: application/json; charset=utf-8
Body
{
  "meta": {
    "currency": "USD"
  },
  "query": {
    "filters": {
      "publisher_id": [
        "Hello, world!",
        "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      ],
      "app_id": [
        "Hello, world!"
      ],
      "adunit_id": [
        "Hello, world!"
      ],
      "country": [
        "Hello, world!"
      ]
    },
    "granularity": "hour",
    "timestamp": {
      "from": "2016-04-01T00:00:00.000Z",
      "to": "2016-04-01T01:00:00.000Z"
    },
    "group": [
      "Hello, world!",
      "Members:",
      "publisher_id"
    ]
  },
  "data": [
    {
      "timestamp": "2016-04-01T00:00:00.000Z",
      "dimensions": {
        "app_id": "Hello, world!",
        "app_version": "Hello, world!",
        "adunit_id": "Hello, world!",
        "adunit_type": "Hello, world!",
        "country": "Hello, world!",
        "city": "Hello, world!",
        "publisher_id": "f0b55f5c-4c51-445f-b6fe-9157db6d11ec",
        "sdk_version": "Hello, world!",
        "carrier": "Hello, world!",
        "connection_type": "Hello, world!",
        "device_os": "Hello, world!",
        "device_os_version": "Hello, world!",
        "device_brand": "Hello, world!",
        "device_model": "Hello, world!",
        "device_orientation": "Hello, world!",
        "gender": "Hello, world!",
        "year_of_birth": "Hello, world!",
        "interest_category": "Hello, world!",
        "persona": "Hello, world!"
      },
      "result": {
        "earnings": 58.271349526959966,
        "impressions": 304783,
        "ecpm": 0.19118963172801623,
        "ad_requests": 6812332,
        "clicks": 927,
        "render_rate": 0.3041508220602855,
        "fill_rate": 0.3041508220602855,
        "ctr": 0.003041508220602855
      }
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        }
      },
      "required": [
        "currency"
      ]
    },
    "query": {
      "type": "object",
      "properties": {
        "filters": {
          "type": "object",
          "properties": {
            "publisher_id": {
              "type": "array"
            },
            "app_id": {
              "type": "array"
            },
            "adunit_id": {
              "type": "array"
            },
            "country": {
              "type": "array"
            }
          },
          "required": [
            "publisher_id",
            "app_id",
            "adunit_id",
            "country"
          ]
        },
        "granularity": {
          "type": "string",
          "enum": [
            "hour",
            "day",
            "all"
          ]
        },
        "timestamp": {
          "type": "object",
          "properties": {
            "from": {
              "type": "string"
            },
            "to": {
              "type": "string"
            }
          },
          "required": [
            "from",
            "to"
          ]
        },
        "group": {
          "type": "array"
        }
      },
      "required": [
        "filters",
        "granularity",
        "timestamp",
        "group"
      ]
    },
    "data": {
      "type": "array"
    }
  },
  "required": [
    "meta",
    "query",
    "data"
  ]
}

Filters

There are 14 filters that could be used to filter our data set:

  • app_id The id of the application

  • app_version The version of the application

  • adunit_id The key of the ad unit

  • adunit_type The type of the placement.

  • sdk_version The version of the SDK.

  • country A country in ISO 3166-1 alpha-2 format.

  • city The city of the user.

  • carrier The carrier of the user.

  • connection_type The connection type of the user.

  • device_os The OS running on the user’s phone.

  • device_os_version The version of the OS.

  • device_brand The brand of the user’s phone.

  • device_model The model of the user’s phone.

  • device_orientation The orientation of the screen.

  • gender The gender of the user.

  • year_of_birth The year of birth of the user.

  • interest_category The interest category of the user

  • persona The persona of the user

By default everything is filtered under the publisher_id used in request path. You can filter with more than 1 values for any filter using , as delimeter in values.

In case of more than 1 value for a filter an OR operation will be performed and for multiple filters an AND operation will be performed.

NOTE: Filters do not alter the number of datasets returned in { "data": { ... } } but the values contained.

Application

Single Application
GET/v1.1/publishers/{publisher_id}{?access_token}

Example URI

GET https://reporting.glispaconnect.com/v1.1/publishers/f0b55f5c-4c51-445f-b6fe-9157db6d11ec?access_token=30767175-3872-4cda-80b0-5d79c926970a
URI Parameters
HideShow
publisher_id
string (required) Example: f0b55f5c-4c51-445f-b6fe-9157db6d11ec

Publisher id

access_token
string (required) Example: 30767175-3872-4cda-80b0-5d79c926970a

Access token

filters[app_id]
string (required) Example: 5975a308-fab4-dbf2-afa1-992a577b15bb

Application id

Request  Filter with single Application
HideShow
Headers
Content-Type: application/json
Response  200
HideShow
Headers
Content-Type: application/json; charset=utf-8
Body
{
  "meta": {
    "currency": "USD"
  },
  "query": {
    "filters": {
      "publisher_id": [
        "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      ],
      "app_id": [
        "5975a308-fab4-dbf2-afa1-992a577b15bb"
      ],
      "adunit_id": [
        "Hello, world!"
      ],
      "country": [
        "Hello, world!"
      ]
    },
    "granularity": "hour",
    "timestamp": {
      "from": "2016-04-01T00:00:00.000Z",
      "to": "2016-04-01T01:00:00.000Z"
    },
    "group": [
      "publisher_id"
    ]
  },
  "data": [
    {
      "timestamp": "2016-04-01T00:00:00.000Z",
      "dimensions": {
        "app_id": "Hello, world!",
        "app_version": "Hello, world!",
        "adunit_id": "Hello, world!",
        "adunit_type": "Hello, world!",
        "country": "Hello, world!",
        "city": "Hello, world!",
        "publisher_id": "f0b55f5c-4c51-445f-b6fe-9157db6d11ec",
        "sdk_version": "Hello, world!",
        "carrier": "Hello, world!",
        "connection_type": "Hello, world!",
        "device_os": "Hello, world!",
        "device_os_version": "Hello, world!",
        "device_brand": "Hello, world!",
        "device_model": "Hello, world!",
        "device_orientation": "Hello, world!",
        "gender": "Hello, world!",
        "year_of_birth": "Hello, world!",
        "interest_category": "Hello, world!",
        "persona": "Hello, world!"
      },
      "result": {
        "earnings": 58.271349526959966,
        "impressions": 304783,
        "ecpm": 0.19118963172801623,
        "ad_requests": 6812332,
        "clicks": 927,
        "render_rate": 0.3041508220602855,
        "fill_rate": 0.3041508220602855,
        "ctr": 0.003041508220602855
      }
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        }
      },
      "required": [
        "currency"
      ]
    },
    "query": {
      "type": "object",
      "properties": {
        "filters": {
          "type": "object",
          "properties": {
            "publisher_id": {
              "type": "array"
            },
            "app_id": {
              "type": "array"
            },
            "adunit_id": {
              "type": "array"
            },
            "country": {
              "type": "array"
            }
          },
          "required": [
            "publisher_id",
            "app_id",
            "adunit_id",
            "country"
          ]
        },
        "granularity": {
          "type": "string",
          "enum": [
            "hour"
          ]
        },
        "timestamp": {
          "type": "object",
          "properties": {
            "from": {
              "type": "string"
            },
            "to": {
              "type": "string"
            }
          },
          "required": [
            "from",
            "to"
          ]
        },
        "group": {
          "type": "array"
        }
      },
      "required": [
        "filters",
        "granularity",
        "timestamp",
        "group"
      ]
    },
    "data": {
      "type": "array"
    }
  },
  "required": [
    "meta",
    "query",
    "data"
  ]
}

Multiple Applications
GET/v1.1/publishers/{?access_token}

Example URI

GET https://reporting.glispaconnect.com/v1.1/publishers/?access_token=30767175-3872-4cda-80b0-5d79c926970a
URI Parameters
HideShow
access_token
string (required) Example: 30767175-3872-4cda-80b0-5d79c926970a

Access token

filters[app_id]
string (required) Example: 5975a308-fab4-dbf2-afa1-992a577b15bb,6875a308-fab4-dbf2-afa1-992a577b15bb

Application id

Request  Filter with multiple Applications
HideShow
Headers
Content-Type: application/json
Response  200
HideShow
Headers
Content-Type: application/json; charset=utf-8
Body
{
  "meta": {
    "currency": "USD"
  },
  "query": {
    "filters": {
      "publisher_id": [
        "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      ],
      "app_id": [
        "5975a308-fab4-dbf2-afa1-992a577b15bb",
        "2C6875a308-fab4-dbf2-afa1-992a577b15bb"
      ],
      "adunit_id": [
        "Hello, world!"
      ],
      "country": [
        "Hello, world!"
      ]
    },
    "granularity": "hour",
    "timestamp": {
      "from": "2016-04-01T00:00:00.000Z",
      "to": "2016-04-01T01:00:00.000Z"
    },
    "group": [
      "publisher_id"
    ]
  },
  "data": [
    {
      "timestamp": "2016-04-01T00:00:00.000Z",
      "dimensions": {
        "app_id": "Hello, world!",
        "app_version": "Hello, world!",
        "adunit_id": "Hello, world!",
        "adunit_type": "Hello, world!",
        "country": "Hello, world!",
        "city": "Hello, world!",
        "publisher_id": "f0b55f5c-4c51-445f-b6fe-9157db6d11ec",
        "sdk_version": "Hello, world!",
        "carrier": "Hello, world!",
        "connection_type": "Hello, world!",
        "device_os": "Hello, world!",
        "device_os_version": "Hello, world!",
        "device_brand": "Hello, world!",
        "device_model": "Hello, world!",
        "device_orientation": "Hello, world!",
        "gender": "Hello, world!",
        "year_of_birth": "Hello, world!",
        "interest_category": "Hello, world!",
        "persona": "Hello, world!"
      },
      "result": {
        "earnings": 58.271349526959966,
        "impressions": 304783,
        "ecpm": 0.19118963172801623,
        "ad_requests": 6812332,
        "clicks": 927,
        "render_rate": 0.3041508220602855,
        "fill_rate": 0.3041508220602855,
        "ctr": 0.003041508220602855
      }
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        }
      },
      "required": [
        "currency"
      ]
    },
    "query": {
      "type": "object",
      "properties": {
        "filters": {
          "type": "object",
          "properties": {
            "publisher_id": {
              "type": "array"
            },
            "app_id": {
              "type": "array"
            },
            "adunit_id": {
              "type": "array"
            },
            "country": {
              "type": "array"
            }
          },
          "required": [
            "publisher_id",
            "app_id",
            "adunit_id",
            "country"
          ]
        },
        "granularity": {
          "type": "string",
          "enum": [
            "hour"
          ]
        },
        "timestamp": {
          "type": "object",
          "properties": {
            "from": {
              "type": "string"
            },
            "to": {
              "type": "string"
            }
          },
          "required": [
            "from",
            "to"
          ]
        },
        "group": {
          "type": "array"
        }
      },
      "required": [
        "filters",
        "granularity",
        "timestamp",
        "group"
      ]
    },
    "data": {
      "type": "array"
    }
  },
  "required": [
    "meta",
    "query",
    "data"
  ]
}

Country

Single Country
GET/v1.1/publishers/{publisher_id}{?access_token}

Example URI

GET https://reporting.glispaconnect.com/v1.1/publishers/f0b55f5c-4c51-445f-b6fe-9157db6d11ec?access_token=30767175-3872-4cda-80b0-5d79c926970a
URI Parameters
HideShow
publisher_id
string (required) Example: f0b55f5c-4c51-445f-b6fe-9157db6d11ec

Publisher id

access_token
string (required) Example: 30767175-3872-4cda-80b0-5d79c926970a

Access token

filters[country]
string (required) Example: US

Filter per country

Request  Filter with single Country
HideShow
Headers
Content-Type: application/json
Response  200
HideShow
Headers
Content-Type: application/json; charset=utf-8
Body
{
  "meta": {
    "currency": "USD"
  },
  "query": {
    "filters": {
      "publisher_id": [
        "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      ],
      "app_id": [
        "Hello, world!"
      ],
      "adunit_id": [
        "Hello, world!"
      ],
      "country": [
        "US"
      ]
    },
    "granularity": "hour",
    "timestamp": {
      "from": "2016-04-01T00:00:00.000Z",
      "to": "2016-04-01T01:00:00.000Z"
    },
    "group": [
      "publisher_id"
    ]
  },
  "data": [
    {
      "timestamp": "2016-04-01T00:00:00.000Z",
      "dimensions": {
        "app_id": "Hello, world!",
        "app_version": "Hello, world!",
        "adunit_id": "Hello, world!",
        "adunit_type": "Hello, world!",
        "country": "Hello, world!",
        "city": "Hello, world!",
        "publisher_id": "f0b55f5c-4c51-445f-b6fe-9157db6d11ec",
        "sdk_version": "Hello, world!",
        "carrier": "Hello, world!",
        "connection_type": "Hello, world!",
        "device_os": "Hello, world!",
        "device_os_version": "Hello, world!",
        "device_brand": "Hello, world!",
        "device_model": "Hello, world!",
        "device_orientation": "Hello, world!",
        "gender": "Hello, world!",
        "year_of_birth": "Hello, world!",
        "interest_category": "Hello, world!",
        "persona": "Hello, world!"
      },
      "result": {
        "earnings": 58.271349526959966,
        "impressions": 304783,
        "ecpm": 0.19118963172801623,
        "ad_requests": 6812332,
        "clicks": 927,
        "render_rate": 0.3041508220602855,
        "fill_rate": 0.3041508220602855,
        "ctr": 0.003041508220602855
      }
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        }
      },
      "required": [
        "currency"
      ]
    },
    "query": {
      "type": "object",
      "properties": {
        "filters": {
          "type": "object",
          "properties": {
            "publisher_id": {
              "type": "array"
            },
            "app_id": {
              "type": "array"
            },
            "adunit_id": {
              "type": "array"
            },
            "country": {
              "type": "array"
            }
          },
          "required": [
            "publisher_id",
            "app_id",
            "adunit_id",
            "country"
          ]
        },
        "granularity": {
          "type": "string",
          "enum": [
            "hour"
          ]
        },
        "timestamp": {
          "type": "object",
          "properties": {
            "from": {
              "type": "string"
            },
            "to": {
              "type": "string"
            }
          },
          "required": [
            "from",
            "to"
          ]
        },
        "group": {
          "type": "array"
        }
      },
      "required": [
        "filters",
        "granularity",
        "timestamp",
        "group"
      ]
    },
    "data": {
      "type": "array"
    }
  },
  "required": [
    "meta",
    "query",
    "data"
  ]
}

Multiple Countries
GET/v1.1/publishers/{publisher_id}{?access_token}

Example URI

GET https://reporting.glispaconnect.com/v1.1/publishers/f0b55f5c-4c51-445f-b6fe-9157db6d11ec?access_token=30767175-3872-4cda-80b0-5d79c926970a
URI Parameters
HideShow
publisher_id
string (required) Example: f0b55f5c-4c51-445f-b6fe-9157db6d11ec

Publisher id

access_token
string (required) Example: 30767175-3872-4cda-80b0-5d79c926970a

Access token

filters[country]
string (required) Example: US,gb

Filter per country

Request  Filter with multiple Countries
HideShow
Headers
Content-Type: application/json
Response  200
HideShow
Headers
Content-Type: application/json; charset=utf-8
Body
{
  "meta": {
    "currency": "USD"
  },
  "query": {
    "filters": {
      "publisher_id": [
        "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      ],
      "app_id": [
        "Hello, world!"
      ],
      "adunit_id": [
        "Hello, world!"
      ],
      "country": [
        "US",
        "GB"
      ]
    },
    "granularity": "hour",
    "timestamp": {
      "from": "2016-04-01T00:00:00.000Z",
      "to": "2016-04-01T01:00:00.000Z"
    },
    "group": [
      "publisher_id"
    ]
  },
  "data": [
    {
      "timestamp": "2016-04-01T00:00:00.000Z",
      "dimensions": {
        "app_id": "Hello, world!",
        "app_version": "Hello, world!",
        "adunit_id": "Hello, world!",
        "adunit_type": "Hello, world!",
        "country": "Hello, world!",
        "city": "Hello, world!",
        "publisher_id": "f0b55f5c-4c51-445f-b6fe-9157db6d11ec",
        "sdk_version": "Hello, world!",
        "carrier": "Hello, world!",
        "connection_type": "Hello, world!",
        "device_os": "Hello, world!",
        "device_os_version": "Hello, world!",
        "device_brand": "Hello, world!",
        "device_model": "Hello, world!",
        "device_orientation": "Hello, world!",
        "gender": "Hello, world!",
        "year_of_birth": "Hello, world!",
        "interest_category": "Hello, world!",
        "persona": "Hello, world!"
      },
      "result": {
        "earnings": 58.271349526959966,
        "impressions": 304783,
        "ecpm": 0.19118963172801623,
        "ad_requests": 6812332,
        "clicks": 927,
        "render_rate": 0.3041508220602855,
        "fill_rate": 0.3041508220602855,
        "ctr": 0.003041508220602855
      }
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        }
      },
      "required": [
        "currency"
      ]
    },
    "query": {
      "type": "object",
      "properties": {
        "filters": {
          "type": "object",
          "properties": {
            "publisher_id": {
              "type": "array"
            },
            "app_id": {
              "type": "array"
            },
            "adunit_id": {
              "type": "array"
            },
            "country": {
              "type": "array"
            }
          },
          "required": [
            "publisher_id",
            "app_id",
            "adunit_id",
            "country"
          ]
        },
        "granularity": {
          "type": "string",
          "enum": [
            "hour"
          ]
        },
        "timestamp": {
          "type": "object",
          "properties": {
            "from": {
              "type": "string"
            },
            "to": {
              "type": "string"
            }
          },
          "required": [
            "from",
            "to"
          ]
        },
        "group": {
          "type": "array"
        }
      },
      "required": [
        "filters",
        "granularity",
        "timestamp",
        "group"
      ]
    },
    "data": {
      "type": "array"
    }
  },
  "required": [
    "meta",
    "query",
    "data"
  ]
}

Adunit id

Single Adunit
GET/v1.1/publishers/{publisher_id}{?access_token}

Example URI

GET https://reporting.glispaconnect.com/v1.1/publishers/f0b55f5c-4c51-445f-b6fe-9157db6d11ec?access_token=30767175-3872-4cda-80b0-5d79c926970a
URI Parameters
HideShow
publisher_id
string (required) Example: f0b55f5c-4c51-445f-b6fe-9157db6d11ec

Publisher id

access_token
string (required) Example: 30767175-3872-4cda-80b0-5d79c926970a

Access token

filters[adunit_id]
string (required) Example: d282a399-a12a-27af-5ec8-3d08a56f12c1

Adunit id

Request  Filter with single Adunit id
HideShow
Headers
Content-Type: application/json
Response  200
HideShow
Headers
Content-Type: application/json; charset=utf-8
Body
{
  "meta": {
    "currency": "USD"
  },
  "query": {
    "filters": {
      "publisher_id": [
        "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      ],
      "app_id": [
        "Hello, world!"
      ],
      "adunit_id": [
        "d282a399-a12a-27af-5ec8-3d08a56f12c1"
      ],
      "country": [
        "Hello, world!"
      ]
    },
    "granularity": "hour",
    "timestamp": {
      "from": "2016-04-01T00:00:00.000Z",
      "to": "2016-04-01T01:00:00.000Z"
    },
    "group": [
      "publisher_id"
    ]
  },
  "data": [
    {
      "timestamp": "2016-04-01T00:00:00.000Z",
      "dimensions": {
        "app_id": "Hello, world!",
        "app_version": "Hello, world!",
        "adunit_id": "Hello, world!",
        "adunit_type": "Hello, world!",
        "country": "Hello, world!",
        "city": "Hello, world!",
        "publisher_id": "f0b55f5c-4c51-445f-b6fe-9157db6d11ec",
        "sdk_version": "Hello, world!",
        "carrier": "Hello, world!",
        "connection_type": "Hello, world!",
        "device_os": "Hello, world!",
        "device_os_version": "Hello, world!",
        "device_brand": "Hello, world!",
        "device_model": "Hello, world!",
        "device_orientation": "Hello, world!",
        "gender": "Hello, world!",
        "year_of_birth": "Hello, world!",
        "interest_category": "Hello, world!",
        "persona": "Hello, world!"
      },
      "result": {
        "earnings": 58.271349526959966,
        "impressions": 304783,
        "ecpm": 0.19118963172801623,
        "ad_requests": 6812332,
        "clicks": 927,
        "render_rate": 0.3041508220602855,
        "fill_rate": 0.3041508220602855,
        "ctr": 0.003041508220602855
      }
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        }
      },
      "required": [
        "currency"
      ]
    },
    "query": {
      "type": "object",
      "properties": {
        "filters": {
          "type": "object",
          "properties": {
            "publisher_id": {
              "type": "array"
            },
            "app_id": {
              "type": "array"
            },
            "adunit_id": {
              "type": "array"
            },
            "country": {
              "type": "array"
            }
          },
          "required": [
            "publisher_id",
            "app_id",
            "adunit_id",
            "country"
          ]
        },
        "granularity": {
          "type": "string",
          "enum": [
            "hour"
          ]
        },
        "timestamp": {
          "type": "object",
          "properties": {
            "from": {
              "type": "string"
            },
            "to": {
              "type": "string"
            }
          },
          "required": [
            "from",
            "to"
          ]
        },
        "group": {
          "type": "array"
        }
      },
      "required": [
        "filters",
        "granularity",
        "timestamp",
        "group"
      ]
    },
    "data": {
      "type": "array"
    }
  },
  "required": [
    "meta",
    "query",
    "data"
  ]
}

Multiple Adunits
GET/v1.1/publishers/{publisher_id}{?access_token}

Example URI

GET https://reporting.glispaconnect.com/v1.1/publishers/f0b55f5c-4c51-445f-b6fe-9157db6d11ec?access_token=30767175-3872-4cda-80b0-5d79c926970a
URI Parameters
HideShow
publisher_id
string (required) Example: f0b55f5c-4c51-445f-b6fe-9157db6d11ec

Publisher id

access_token
string (required) Example: 30767175-3872-4cda-80b0-5d79c926970a

Access token

filters[adunit_id]
string (required) Example: 3d0822a399-a12a-27af-5ec8-3d08a56f12c1,d282a399-a12a-27af-5ec8-3d08a56f12c1

Adunit id

Request  Filter with multiple Adunit ids
HideShow
Headers
Content-Type: application/json
Response  200
HideShow
Headers
Content-Type: application/json; charset=utf-8
Body
{
  "meta": {
    "currency": "USD"
  },
  "query": {
    "filters": {
      "publisher_id": [
        "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      ],
      "app_id": [
        "Hello, world!"
      ],
      "adunit_id": [
        "d282a399-a12a-27af-5ec8-3d08a56f12c1",
        "3d0822a399-a12a-27af-5ec8-3d08a56f12c1"
      ],
      "country": [
        "Hello, world!"
      ]
    },
    "granularity": "hour",
    "timestamp": {
      "from": "2016-04-01T00:00:00.000Z",
      "to": "2016-04-01T01:00:00.000Z"
    },
    "group": [
      "publisher_id"
    ]
  },
  "data": [
    {
      "timestamp": "2016-04-01T00:00:00.000Z",
      "dimensions": {
        "app_id": "Hello, world!",
        "app_version": "Hello, world!",
        "adunit_id": "Hello, world!",
        "adunit_type": "Hello, world!",
        "country": "Hello, world!",
        "city": "Hello, world!",
        "publisher_id": "f0b55f5c-4c51-445f-b6fe-9157db6d11ec",
        "sdk_version": "Hello, world!",
        "carrier": "Hello, world!",
        "connection_type": "Hello, world!",
        "device_os": "Hello, world!",
        "device_os_version": "Hello, world!",
        "device_brand": "Hello, world!",
        "device_model": "Hello, world!",
        "device_orientation": "Hello, world!",
        "gender": "Hello, world!",
        "year_of_birth": "Hello, world!",
        "interest_category": "Hello, world!",
        "persona": "Hello, world!"
      },
      "result": {
        "earnings": 58.271349526959966,
        "impressions": 304783,
        "ecpm": 0.19118963172801623,
        "ad_requests": 6812332,
        "clicks": 927,
        "render_rate": 0.3041508220602855,
        "fill_rate": 0.3041508220602855,
        "ctr": 0.003041508220602855
      }
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        }
      },
      "required": [
        "currency"
      ]
    },
    "query": {
      "type": "object",
      "properties": {
        "filters": {
          "type": "object",
          "properties": {
            "publisher_id": {
              "type": "array"
            },
            "app_id": {
              "type": "array"
            },
            "adunit_id": {
              "type": "array"
            },
            "country": {
              "type": "array"
            }
          },
          "required": [
            "publisher_id",
            "app_id",
            "adunit_id",
            "country"
          ]
        },
        "granularity": {
          "type": "string",
          "enum": [
            "hour"
          ]
        },
        "timestamp": {
          "type": "object",
          "properties": {
            "from": {
              "type": "string"
            },
            "to": {
              "type": "string"
            }
          },
          "required": [
            "from",
            "to"
          ]
        },
        "group": {
          "type": "array"
        }
      },
      "required": [
        "filters",
        "granularity",
        "timestamp",
        "group"
      ]
    },
    "data": {
      "type": "array"
    }
  },
  "required": [
    "meta",
    "query",
    "data"
  ]
}

Connection type

Values

  • 0: Unknown

  • 1: Ethernet

  • 2: WIFI

  • 3: Unknown Generation

  • 4: 2G

  • 5: 3G

  • 6: 4G

Single Connection Type
GET/v1.1/publishers/{publisher_id}{?access_token}

Example URI

GET https://reporting.glispaconnect.com/v1.1/publishers/f0b55f5c-4c51-445f-b6fe-9157db6d11ec?access_token=30767175-3872-4cda-80b0-5d79c926970a
URI Parameters
HideShow
publisher_id
string (required) Example: f0b55f5c-4c51-445f-b6fe-9157db6d11ec

Publisher id

access_token
string (required) Example: 30767175-3872-4cda-80b0-5d79c926970a

Access token

filters[connection_type]
string (required) Example: d282a399-a12a-27af-5ec8-3d08a56f12c1

Connection type

Request  Filter with single connection type
HideShow
Headers
Content-Type: application/json
Response  200
HideShow
Headers
Content-Type: application/json; charset=utf-8
Body
{
  "meta": {
    "currency": "USD"
  },
  "query": {
    "filters": {
      "publisher_id": [
        "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      ],
      "app_id": [
        "Hello, world!"
      ],
      "connection_type": [
        "???"
      ]
    },
    "granularity": "hour",
    "timestamp": {
      "from": "2016-04-01T00:00:00.000Z",
      "to": "2016-04-01T01:00:00.000Z"
    },
    "group": [
      "publisher_id"
    ]
  },
  "data": [
    {
      "timestamp": "2016-04-01T00:00:00.000Z",
      "dimensions": {
        "app_id": "Hello, world!",
        "app_version": "Hello, world!",
        "adunit_id": "Hello, world!",
        "adunit_type": "Hello, world!",
        "country": "Hello, world!",
        "city": "Hello, world!",
        "publisher_id": "f0b55f5c-4c51-445f-b6fe-9157db6d11ec",
        "sdk_version": "Hello, world!",
        "carrier": "Hello, world!",
        "connection_type": "Hello, world!",
        "device_os": "Hello, world!",
        "device_os_version": "Hello, world!",
        "device_brand": "Hello, world!",
        "device_model": "Hello, world!",
        "device_orientation": "Hello, world!",
        "gender": "Hello, world!",
        "year_of_birth": "Hello, world!",
        "interest_category": "Hello, world!",
        "persona": "Hello, world!"
      },
      "result": {
        "earnings": 58.271349526959966,
        "impressions": 304783,
        "ecpm": 0.19118963172801623,
        "ad_requests": 6812332,
        "clicks": 927,
        "render_rate": 0.3041508220602855,
        "fill_rate": 0.3041508220602855,
        "ctr": 0.003041508220602855
      }
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        }
      },
      "required": [
        "currency"
      ]
    },
    "query": {
      "type": "object",
      "properties": {
        "filters": {
          "type": "object",
          "properties": {
            "publisher_id": {
              "type": "array"
            },
            "app_id": {
              "type": "array"
            },
            "connection_type": {
              "type": "array"
            }
          },
          "required": [
            "publisher_id",
            "app_id",
            "connection_type"
          ]
        },
        "granularity": {
          "type": "string",
          "enum": [
            "hour"
          ]
        },
        "timestamp": {
          "type": "object",
          "properties": {
            "from": {
              "type": "string"
            },
            "to": {
              "type": "string"
            }
          },
          "required": [
            "from",
            "to"
          ]
        },
        "group": {
          "type": "array"
        }
      },
      "required": [
        "filters",
        "granularity",
        "timestamp",
        "group"
      ]
    },
    "data": {
      "type": "array"
    }
  },
  "required": [
    "meta",
    "query",
    "data"
  ]
}

Multiple Connection Types
GET/v1.1/publishers/{publisher_id}{?access_token}

Example URI

GET https://reporting.glispaconnect.com/v1.1/publishers/f0b55f5c-4c51-445f-b6fe-9157db6d11ec?access_token=30767175-3872-4cda-80b0-5d79c926970a
URI Parameters
HideShow
publisher_id
string (required) Example: f0b55f5c-4c51-445f-b6fe-9157db6d11ec

Publisher id

access_token
string (required) Example: 30767175-3872-4cda-80b0-5d79c926970a

Access token

filters[connection_type]
string (required) Example: 3d0822a399-a12a-27af-5ec8-3d08a56f12c1,d282a399-a12a-27af-5ec8-3d08a56f12c1

Connection type

Request  Filter with multiple connection types
HideShow
Headers
Content-Type: application/json
Response  200
HideShow
Headers
Content-Type: application/json; charset=utf-8
Body
{
  "meta": {
    "currency": "USD"
  },
  "query": {
    "filters": {
      "publisher_id": [
        "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      ],
      "app_id": [
        "Hello, world!"
      ],
      "connection_type": [
        "???",
        "???"
      ]
    },
    "granularity": "hour",
    "timestamp": {
      "from": "2016-04-01T00:00:00.000Z",
      "to": "2016-04-01T01:00:00.000Z"
    },
    "group": [
      "publisher_id"
    ]
  },
  "data": [
    {
      "timestamp": "2016-04-01T00:00:00.000Z",
      "dimensions": {
        "app_id": "Hello, world!",
        "app_version": "Hello, world!",
        "adunit_id": "Hello, world!",
        "adunit_type": "Hello, world!",
        "country": "Hello, world!",
        "city": "Hello, world!",
        "publisher_id": "f0b55f5c-4c51-445f-b6fe-9157db6d11ec",
        "sdk_version": "Hello, world!",
        "carrier": "Hello, world!",
        "connection_type": "Hello, world!",
        "device_os": "Hello, world!",
        "device_os_version": "Hello, world!",
        "device_brand": "Hello, world!",
        "device_model": "Hello, world!",
        "device_orientation": "Hello, world!",
        "gender": "Hello, world!",
        "year_of_birth": "Hello, world!",
        "interest_category": "Hello, world!",
        "persona": "Hello, world!"
      },
      "result": {
        "earnings": 58.271349526959966,
        "impressions": 304783,
        "ecpm": 0.19118963172801623,
        "ad_requests": 6812332,
        "clicks": 927,
        "render_rate": 0.3041508220602855,
        "fill_rate": 0.3041508220602855,
        "ctr": 0.003041508220602855
      }
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        }
      },
      "required": [
        "currency"
      ]
    },
    "query": {
      "type": "object",
      "properties": {
        "filters": {
          "type": "object",
          "properties": {
            "publisher_id": {
              "type": "array"
            },
            "app_id": {
              "type": "array"
            },
            "connection_type": {
              "type": "array"
            }
          },
          "required": [
            "publisher_id",
            "app_id",
            "connection_type"
          ]
        },
        "granularity": {
          "type": "string",
          "enum": [
            "hour"
          ]
        },
        "timestamp": {
          "type": "object",
          "properties": {
            "from": {
              "type": "string"
            },
            "to": {
              "type": "string"
            }
          },
          "required": [
            "from",
            "to"
          ]
        },
        "group": {
          "type": "array"
        }
      },
      "required": [
        "filters",
        "granularity",
        "timestamp",
        "group"
      ]
    },
    "data": {
      "type": "array"
    }
  },
  "required": [
    "meta",
    "query",
    "data"
  ]
}

Extra fields

The rest of the filters can be used in the same manner as demonstrated below:

  • app_version

  • adunit_type

  • sdk_version

  • city

  • carrier

  • device_os

  • device_os_version

  • device_brand

  • device_model

  • device_orientation

  • gender

  • year_of_birth

  • interest_category

  • persona

Single Value
GET/v1.1/publishers/{publisher_id}{?access_token}

Example URI

GET https://reporting.glispaconnect.com/v1.1/publishers/f0b55f5c-4c51-445f-b6fe-9157db6d11ec?access_token=30767175-3872-4cda-80b0-5d79c926970a
URI Parameters
HideShow
publisher_id
string (required) Example: f0b55f5c-4c51-445f-b6fe-9157db6d11ec

Publisher id

access_token
string (required) Example: 30767175-3872-4cda-80b0-5d79c926970a

Access token

filters[app_version]
string (required) Example: 1.0.3

App version

filters[adunit_type]
string (required) Example: INTERSTITIAL

Adunit type

filters[sdk_version]
string (required) Example: 4.6.0

SDK Version

filters[city]
string (required) Example: Moscow

City

filters[carrier]
string (required) Example: 310-260

Carrier

filters[device_os]
string (required) Example: iOS

OS

filters[device_os_version]
string (required) Example: 10.3.3

OS Version

filters[device_brand]
string (required) Example: samsung

Device brand

filters[device_model]
string (required) Example: SM-G955U

Device model

filters[device_orientation]
string (required) Example: PORTRAIT

Orientation

filters[gender]
string (required) Example: F

Gender

filters[year_of_birth]
string (required) Example: 1996

Year of birth

filters[interest_category]
string (required) Example: IAB9-30

Interest category

filters[persona]
string (required) Example: vacationer

Persona

Request  Filter with single app version
HideShow
Headers
Content-Type: application/json
Response  200
HideShow
Headers
Content-Type: application/json; charset=utf-8
Body
{
  "meta": {
    "currency": "USD"
  },
  "query": {
    "filters": {
      "publisher_id": [
        "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      ],
      "app_version": [
        "1.0.3"
      ],
      "adunit_type": [
        "INTERSTITIAL"
      ],
      "city": [
        "Moscow"
      ],
      "sdk_version": [
        "4.6.0"
      ],
      "carrier": [
        "310-260"
      ],
      "device_os": [
        "iOS"
      ],
      "device_os_version": [
        "10.3.3"
      ],
      "device_brand": [
        "samsung"
      ],
      "device_model": [
        "SM-G955U"
      ],
      "device_orientation": [
        "PORTRAIT"
      ],
      "gender": [
        "F"
      ],
      "year_of_birth": [
        "1996"
      ],
      "interest_category": [
        "IAB9-30"
      ],
      "persona": [
        "vacationer"
      ]
    },
    "granularity": "hour",
    "timestamp": {
      "from": "2016-04-01T00:00:00.000Z",
      "to": "2016-04-01T01:00:00.000Z"
    },
    "group": [
      "publisher_id"
    ]
  },
  "data": [
    {
      "timestamp": "2016-04-01T00:00:00.000Z",
      "dimensions": {
        "app_id": "Hello, world!",
        "app_version": "Hello, world!",
        "adunit_id": "Hello, world!",
        "adunit_type": "Hello, world!",
        "country": "Hello, world!",
        "city": "Hello, world!",
        "publisher_id": "f0b55f5c-4c51-445f-b6fe-9157db6d11ec",
        "sdk_version": "Hello, world!",
        "carrier": "Hello, world!",
        "connection_type": "Hello, world!",
        "device_os": "Hello, world!",
        "device_os_version": "Hello, world!",
        "device_brand": "Hello, world!",
        "device_model": "Hello, world!",
        "device_orientation": "Hello, world!",
        "gender": "Hello, world!",
        "year_of_birth": "Hello, world!",
        "interest_category": "Hello, world!",
        "persona": "Hello, world!"
      },
      "result": {
        "earnings": 58.271349526959966,
        "impressions": 304783,
        "ecpm": 0.19118963172801623,
        "ad_requests": 6812332,
        "clicks": 927,
        "render_rate": 0.3041508220602855,
        "fill_rate": 0.3041508220602855,
        "ctr": 0.003041508220602855
      }
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        }
      },
      "required": [
        "currency"
      ]
    },
    "query": {
      "type": "object",
      "properties": {
        "filters": {
          "type": "object",
          "properties": {
            "publisher_id": {
              "type": "array"
            },
            "app_version": {
              "type": "array"
            },
            "adunit_type": {
              "type": "array"
            },
            "city": {
              "type": "array"
            },
            "sdk_version": {
              "type": "array"
            },
            "carrier": {
              "type": "array"
            },
            "device_os": {
              "type": "array"
            },
            "device_os_version": {
              "type": "array"
            },
            "device_brand": {
              "type": "array"
            },
            "device_model": {
              "type": "array"
            },
            "device_orientation": {
              "type": "array"
            },
            "gender": {
              "type": "array"
            },
            "year_of_birth": {
              "type": "array"
            },
            "interest_category": {
              "type": "array"
            },
            "persona": {
              "type": "array"
            }
          },
          "required": [
            "publisher_id",
            "app_version",
            "adunit_type",
            "city",
            "sdk_version",
            "carrier",
            "device_os",
            "device_os_version",
            "device_brand",
            "device_model",
            "device_orientation",
            "gender",
            "year_of_birth",
            "interest_category",
            "persona"
          ]
        },
        "granularity": {
          "type": "string",
          "enum": [
            "hour"
          ]
        },
        "timestamp": {
          "type": "object",
          "properties": {
            "from": {
              "type": "string"
            },
            "to": {
              "type": "string"
            }
          },
          "required": [
            "from",
            "to"
          ]
        },
        "group": {
          "type": "array"
        }
      },
      "required": [
        "filters",
        "granularity",
        "timestamp",
        "group"
      ]
    },
    "data": {
      "type": "array"
    }
  },
  "required": [
    "meta",
    "query",
    "data"
  ]
}

Multiple Values
GET/v1.1/publishers/{publisher_id}{?access_token}

Example URI

GET https://reporting.glispaconnect.com/v1.1/publishers/f0b55f5c-4c51-445f-b6fe-9157db6d11ec?access_token=30767175-3872-4cda-80b0-5d79c926970a
URI Parameters
HideShow
publisher_id
string (required) Example: f0b55f5c-4c51-445f-b6fe-9157db6d11ec

Publisher id

access_token
string (required) Example: 30767175-3872-4cda-80b0-5d79c926970a

Access token

filters[app_version]
string (required) Example: 1.0.3,1.0.2

App version

filters[adunit_type]
string (required) Example: INTERSTITIAL,CUSTOMgit

Adunit type

filters[sdk_version]
string (required) Example: 4.6.0,3.8.2

SDK Version

filters[city]
string (required) Example: Moscow,Bangkok

City

filters[carrier]
string (required) Example: 310-260,311-480

Carrier

filters[device_os]
string (required) Example: iOS,Android

OS

filters[device_os_version]
string (required) Example: 10.3.3,7.0

OS Version

filters[device_brand]
string (required) Example: samsung,motorola

Device brand

filters[device_model]
string (required) Example: SM-G955U,MotoG3

Device model

filters[device_orientation]
string (required) Example: PORTRAIT,LANDSCAPE

Orientation

filters[gender]
string (required) Example: F,M

Gender

filters[year_of_birth]
string (required) Example: 1996,1997

Year of birth

filters[interest_category]
string (required) Example: IAB9-30,IAB9-31

Interest category

filters[persona]
string (required) Example: vacationer,racing_gamers

Persona

Request  Filter with multiple app versions
HideShow
Headers
Content-Type: application/json
Response  200
HideShow
Headers
Content-Type: application/json; charset=utf-8
Body
{
  "meta": {
    "currency": "USD"
  },
  "query": {
    "filters": {
      "publisher_id": [
        "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      ],
      "app_version": [
        "1.0.3",
        "1.0.2"
      ],
      "adunit_type": [
        "INTERSTITIAL",
        "NATIVE_CUSTOM"
      ],
      "city": [
        "Moscow",
        "Bangkok"
      ],
      "sdk_version": [
        "4.6.0",
        "3.8.2"
      ],
      "carrier": [
        "310-260",
        "311-480"
      ],
      "device_os": [
        "iOS",
        "Android"
      ],
      "device_os_version": [
        "10.3.3",
        "7.0"
      ],
      "device_brand": [
        "samsung",
        "motorola"
      ],
      "device_model": [
        "SM-G955U",
        "MotoG3"
      ],
      "device_orientation": [
        "PORTRAIT",
        "LANDSCAPE"
      ],
      "gender": [
        "F",
        "M"
      ],
      "year_of_birth": [
        "1996",
        "1997"
      ],
      "interest_category": [
        "IAB9-30",
        "IAB9-31"
      ],
      "persona": [
        "vacationer",
        "racing_gamers"
      ]
    },
    "granularity": "hour",
    "timestamp": {
      "from": "2016-04-01T00:00:00.000Z",
      "to": "2016-04-01T01:00:00.000Z"
    },
    "group": [
      "publisher_id"
    ]
  },
  "data": [
    {
      "timestamp": "2016-04-01T00:00:00.000Z",
      "dimensions": {
        "app_id": "Hello, world!",
        "app_version": "Hello, world!",
        "adunit_id": "Hello, world!",
        "adunit_type": "Hello, world!",
        "country": "Hello, world!",
        "city": "Hello, world!",
        "publisher_id": "f0b55f5c-4c51-445f-b6fe-9157db6d11ec",
        "sdk_version": "Hello, world!",
        "carrier": "Hello, world!",
        "connection_type": "Hello, world!",
        "device_os": "Hello, world!",
        "device_os_version": "Hello, world!",
        "device_brand": "Hello, world!",
        "device_model": "Hello, world!",
        "device_orientation": "Hello, world!",
        "gender": "Hello, world!",
        "year_of_birth": "Hello, world!",
        "interest_category": "Hello, world!",
        "persona": "Hello, world!"
      },
      "result": {
        "earnings": 58.271349526959966,
        "impressions": 304783,
        "ecpm": 0.19118963172801623,
        "ad_requests": 6812332,
        "clicks": 927,
        "render_rate": 0.3041508220602855,
        "fill_rate": 0.3041508220602855,
        "ctr": 0.003041508220602855
      }
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        }
      },
      "required": [
        "currency"
      ]
    },
    "query": {
      "type": "object",
      "properties": {
        "filters": {
          "type": "object",
          "properties": {
            "publisher_id": {
              "type": "array"
            },
            "app_version": {
              "type": "array"
            },
            "adunit_type": {
              "type": "array"
            },
            "city": {
              "type": "array"
            },
            "sdk_version": {
              "type": "array"
            },
            "carrier": {
              "type": "array"
            },
            "device_os": {
              "type": "array"
            },
            "device_os_version": {
              "type": "array"
            },
            "device_brand": {
              "type": "array"
            },
            "device_model": {
              "type": "array"
            },
            "device_orientation": {
              "type": "array"
            },
            "gender": {
              "type": "array"
            },
            "year_of_birth": {
              "type": "array"
            },
            "interest_category": {
              "type": "array"
            },
            "persona": {
              "type": "array"
            }
          },
          "required": [
            "publisher_id",
            "app_version",
            "adunit_type",
            "city",
            "sdk_version",
            "carrier",
            "device_os",
            "device_os_version",
            "device_brand",
            "device_model",
            "device_orientation",
            "gender",
            "year_of_birth",
            "interest_category",
            "persona"
          ]
        },
        "granularity": {
          "type": "string",
          "enum": [
            "hour"
          ]
        },
        "timestamp": {
          "type": "object",
          "properties": {
            "from": {
              "type": "string"
            },
            "to": {
              "type": "string"
            }
          },
          "required": [
            "from",
            "to"
          ]
        },
        "group": {
          "type": "array"
        }
      },
      "required": [
        "filters",
        "granularity",
        "timestamp",
        "group"
      ]
    },
    "data": {
      "type": "array"
    }
  },
  "required": [
    "meta",
    "query",
    "data"
  ]
}

Grouping

In order to group datapoints based on dimensions, eg. group by application id, group by country, group param is used with one or more of the dimensions:

  • publisher_id

  • app_id

  • app_version

  • adunit_id

  • adunit_type

  • sdk_version

  • country

  • city

  • carrier

  • connection_type

  • device_os

  • device_os_version

  • device_brand

  • device_model

  • device_orientation

  • gender

  • year_of_birth

  • interest_category

  • persona

  • Comma seperated combination of the above like: app_id,country

By default everything is grouped with publisher_id.

Resulting groups can be seen in dimensions property in each datapoint.

Groups

Application
GET/v1.1/publishers/{publisher_id}{?group,access_token}

Example URI

GET https://reporting.glispaconnect.com/v1.1/publishers/f0b55f5c-4c51-445f-b6fe-9157db6d11ec?group=app_id&access_token=30767175-3872-4cda-80b0-5d79c926970a
URI Parameters
HideShow
publisher_id
string (required) Example: f0b55f5c-4c51-445f-b6fe-9157db6d11ec

Publisher id

access_token
string (required) Example: 30767175-3872-4cda-80b0-5d79c926970a

Access token

group
string (required) Example: app_id

Group name

Response  200
HideShow
Headers
Content-Type: application/json; charset=utf-8
Body
{
  "meta": {
    "currency": "USD"
  },
  "query": {
    "filters": {
      "publisher_id": [
        "Hello, world!",
        "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      ],
      "app_id": [
        "Hello, world!"
      ],
      "adunit_id": [
        "Hello, world!"
      ],
      "country": [
        "Hello, world!"
      ]
    },
    "granularity": "hour",
    "timestamp": {
      "from": "2016-04-01T00:00:00.000Z",
      "to": "2016-04-01T01:00:00.000Z"
    },
    "group": [
      "Hello, world!",
      "publisher_id",
      "app_id"
    ]
  },
  "data": [
    {
      "timestamp": "2016-04-01T00:00:00.000Z",
      "dimensions": {
        "app_id": "5975a308-fab4-dbf2-afa1-992a577b15bb",
        "adunit_id": "Hello, world!",
        "country": "Hello, world!",
        "publisher_id": "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      },
      "result": {
        "earnings": 58.271349526959966,
        "impressions": 304783,
        "ecpm": 0.19118963172801623,
        "ad_requests": 6812332,
        "clicks": 927,
        "render_rate": 0.3041508220602855,
        "fill_rate": 0.3041508220602855,
        "ctr": 0.003041508220602855
      }
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        }
      },
      "required": [
        "currency"
      ]
    },
    "query": {
      "type": "object",
      "properties": {
        "filters": {
          "type": "object",
          "properties": {
            "publisher_id": {
              "type": "array"
            },
            "app_id": {
              "type": "array"
            },
            "adunit_id": {
              "type": "array"
            },
            "country": {
              "type": "array"
            }
          },
          "required": [
            "publisher_id",
            "app_id",
            "adunit_id",
            "country"
          ]
        },
        "granularity": {
          "type": "string",
          "enum": [
            "hour",
            "day",
            "all"
          ]
        },
        "timestamp": {
          "type": "object",
          "properties": {
            "from": {
              "type": "string"
            },
            "to": {
              "type": "string"
            }
          },
          "required": [
            "from",
            "to"
          ]
        },
        "group": {
          "type": "array"
        }
      },
      "required": [
        "filters",
        "granularity",
        "timestamp",
        "group"
      ]
    },
    "data": {
      "type": "array"
    }
  },
  "required": [
    "meta",
    "query",
    "data"
  ]
}

Country
GET/v1.1/publishers/{publisher_id}{?group,access_token}

Example URI

GET https://reporting.glispaconnect.com/v1.1/publishers/f0b55f5c-4c51-445f-b6fe-9157db6d11ec?group=country&access_token=30767175-3872-4cda-80b0-5d79c926970a
URI Parameters
HideShow
publisher_id
string (required) Example: f0b55f5c-4c51-445f-b6fe-9157db6d11ec

Publisher id

access_token
string (required) Example: 30767175-3872-4cda-80b0-5d79c926970a

Access token

group
string (required) Example: country

Group name

Response  200
HideShow
Headers
Content-Type: application/json; charset=utf-8
Body
{
  "meta": {
    "currency": "USD"
  },
  "query": {
    "filters": {
      "publisher_id": [
        "Hello, world!",
        "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      ],
      "app_id": [
        "Hello, world!"
      ],
      "adunit_id": [
        "Hello, world!"
      ],
      "country": [
        "Hello, world!"
      ]
    },
    "granularity": "hour",
    "timestamp": {
      "from": "2016-04-01T00:00:00.000Z",
      "to": "2016-04-01T01:00:00.000Z"
    },
    "group": [
      "Hello, world!",
      "publisher_id",
      "country"
    ]
  },
  "data": [
    {
      "timestamp": "2016-04-01T00:00:00.000Z",
      "dimensions": {
        "app_id": "Hello, world!",
        "adunit_id": "Hello, world!",
        "country": "US",
        "publisher_id": "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      },
      "result": {
        "earnings": 58.271349526959966,
        "impressions": 304783,
        "ecpm": 0.19118963172801623,
        "ad_requests": 6812332,
        "clicks": 927,
        "render_rate": 0.3041508220602855,
        "fill_rate": 0.3041508220602855,
        "ctr": 0.003041508220602855
      }
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        }
      },
      "required": [
        "currency"
      ]
    },
    "query": {
      "type": "object",
      "properties": {
        "filters": {
          "type": "object",
          "properties": {
            "publisher_id": {
              "type": "array"
            },
            "app_id": {
              "type": "array"
            },
            "adunit_id": {
              "type": "array"
            },
            "country": {
              "type": "array"
            }
          },
          "required": [
            "publisher_id",
            "app_id",
            "adunit_id",
            "country"
          ]
        },
        "granularity": {
          "type": "string",
          "enum": [
            "hour",
            "day",
            "all"
          ]
        },
        "timestamp": {
          "type": "object",
          "properties": {
            "from": {
              "type": "string"
            },
            "to": {
              "type": "string"
            }
          },
          "required": [
            "from",
            "to"
          ]
        },
        "group": {
          "type": "array"
        }
      },
      "required": [
        "filters",
        "granularity",
        "timestamp",
        "group"
      ]
    },
    "data": {
      "type": "array"
    }
  },
  "required": [
    "meta",
    "query",
    "data"
  ]
}

Adunit
GET/v1.1/publishers/{publisher_id}{?group,access_token}

Example URI

GET https://reporting.glispaconnect.com/v1.1/publishers/f0b55f5c-4c51-445f-b6fe-9157db6d11ec?group=adunit_id&access_token=30767175-3872-4cda-80b0-5d79c926970a
URI Parameters
HideShow
publisher_id
string (required) Example: f0b55f5c-4c51-445f-b6fe-9157db6d11ec

Publisher id

access_token
string (required) Example: 30767175-3872-4cda-80b0-5d79c926970a

Access token

group
string (optional) Example: adunit_id

Group name

Response  200
HideShow
Headers
Content-Type: application/json; charset=utf-8
Body
{
  "meta": {
    "currency": "USD"
  },
  "query": {
    "filters": {
      "publisher_id": [
        "Hello, world!",
        "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      ],
      "app_id": [
        "Hello, world!"
      ],
      "adunit_id": [
        "Hello, world!"
      ],
      "country": [
        "Hello, world!"
      ]
    },
    "granularity": "hour",
    "timestamp": {
      "from": "2016-04-01T00:00:00.000Z",
      "to": "2016-04-01T01:00:00.000Z"
    },
    "group": [
      "Hello, world!",
      "publisher_id",
      "adunit_id"
    ]
  },
  "data": [
    {
      "timestamp": "2016-04-01T00:00:00.000Z",
      "dimensions": {
        "adunit_id": "5975a308-fab4-dbf2-afa1-992a577b15bb",
        "app_id": "Hello, world!",
        "country": "Hello, world!",
        "publisher_id": "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      },
      "result": {
        "earnings": 58.271349526959966,
        "impressions": 304783,
        "ecpm": 0.19118963172801623,
        "ad_requests": 6812332,
        "clicks": 927,
        "render_rate": 0.3041508220602855,
        "fill_rate": 0.3041508220602855,
        "ctr": 0.003041508220602855
      }
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        }
      },
      "required": [
        "currency"
      ]
    },
    "query": {
      "type": "object",
      "properties": {
        "filters": {
          "type": "object",
          "properties": {
            "publisher_id": {
              "type": "array"
            },
            "app_id": {
              "type": "array"
            },
            "adunit_id": {
              "type": "array"
            },
            "country": {
              "type": "array"
            }
          },
          "required": [
            "publisher_id",
            "app_id",
            "adunit_id",
            "country"
          ]
        },
        "granularity": {
          "type": "string",
          "enum": [
            "hour",
            "day",
            "all"
          ]
        },
        "timestamp": {
          "type": "object",
          "properties": {
            "from": {
              "type": "string"
            },
            "to": {
              "type": "string"
            }
          },
          "required": [
            "from",
            "to"
          ]
        },
        "group": {
          "type": "array"
        }
      },
      "required": [
        "filters",
        "granularity",
        "timestamp",
        "group"
      ]
    },
    "data": {
      "type": "array"
    }
  },
  "required": [
    "meta",
    "query",
    "data"
  ]
}

Timestamp

  • From by default is current UTC day and time at 00:00:00.000Z.

  • To by default is current UTC day and time at current hour HH:00:00.000Z.

In order to achieve a range filter use both timestamp[from] and timestamp[to].

From

From
GET/v1.1/publishers/{publisher_id}{?access_token}

Example URI

GET https://reporting.glispaconnect.com/v1.1/publishers/f0b55f5c-4c51-445f-b6fe-9157db6d11ec?access_token=30767175-3872-4cda-80b0-5d79c926970a
URI Parameters
HideShow
publisher_id
string (required) Example: f0b55f5c-4c51-445f-b6fe-9157db6d11ec

Publisher id

access_token
string (required) Example: 30767175-3872-4cda-80b0-5d79c926970a

Access token

timestamp[from]
string (required) Example: 2016-04-01T00:00:00.000Z

Lower limit for timestamp in UTC and YYYY-MM-DDTHH:mm:ss.sssZ format.

Response  200
HideShow
Headers
Content-Type: application/json; charset=utf-8
Body
{
  "meta": {
    "currency": "USD"
  },
  "query": {
    "filters": {
      "publisher_id": [
        "Hello, world!",
        "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      ],
      "app_id": [
        "Hello, world!"
      ],
      "adunit_id": [
        "Hello, world!"
      ],
      "country": [
        "Hello, world!"
      ]
    },
    "granularity": "hour",
    "timestamp": {
      "from": "2016-04-01T00:00:00.000Z",
      "to": "2016-04-01T01:00:00.000Z"
    },
    "group": [
      "Hello, world!",
      "Members:",
      "publisher_id"
    ]
  },
  "data": [
    {
      "timestamp": "2016-04-01T00:00:00.000Z",
      "dimensions": {
        "app_id": "Hello, world!",
        "app_version": "Hello, world!",
        "adunit_id": "Hello, world!",
        "adunit_type": "Hello, world!",
        "country": "Hello, world!",
        "city": "Hello, world!",
        "publisher_id": "f0b55f5c-4c51-445f-b6fe-9157db6d11ec",
        "sdk_version": "Hello, world!",
        "carrier": "Hello, world!",
        "connection_type": "Hello, world!",
        "device_os": "Hello, world!",
        "device_os_version": "Hello, world!",
        "device_brand": "Hello, world!",
        "device_model": "Hello, world!",
        "device_orientation": "Hello, world!",
        "gender": "Hello, world!",
        "year_of_birth": "Hello, world!",
        "interest_category": "Hello, world!",
        "persona": "Hello, world!"
      },
      "result": {
        "earnings": 58.271349526959966,
        "impressions": 304783,
        "ecpm": 0.19118963172801623,
        "ad_requests": 6812332,
        "clicks": 927,
        "render_rate": 0.3041508220602855,
        "fill_rate": 0.3041508220602855,
        "ctr": 0.003041508220602855
      }
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        }
      },
      "required": [
        "currency"
      ]
    },
    "query": {
      "type": "object",
      "properties": {
        "filters": {
          "type": "object",
          "properties": {
            "publisher_id": {
              "type": "array"
            },
            "app_id": {
              "type": "array"
            },
            "adunit_id": {
              "type": "array"
            },
            "country": {
              "type": "array"
            }
          },
          "required": [
            "publisher_id",
            "app_id",
            "adunit_id",
            "country"
          ]
        },
        "granularity": {
          "type": "string",
          "enum": [
            "hour",
            "day",
            "all"
          ]
        },
        "timestamp": {
          "type": "object",
          "properties": {
            "from": {
              "type": "string"
            },
            "to": {
              "type": "string"
            }
          },
          "required": [
            "from",
            "to"
          ]
        },
        "group": {
          "type": "array"
        }
      },
      "required": [
        "filters",
        "granularity",
        "timestamp",
        "group"
      ]
    },
    "data": {
      "type": "array"
    }
  },
  "required": [
    "meta",
    "query",
    "data"
  ]
}

To

To
GET/v1.1/publishers/{publisher_id}{?access_token}

Example URI

GET https://reporting.glispaconnect.com/v1.1/publishers/f0b55f5c-4c51-445f-b6fe-9157db6d11ec?access_token=30767175-3872-4cda-80b0-5d79c926970a
URI Parameters
HideShow
publisher_id
string (required) Example: f0b55f5c-4c51-445f-b6fe-9157db6d11ec

Publisher id

access_token
string (required) Example: 30767175-3872-4cda-80b0-5d79c926970a

Access token

timestamp[to]
string (required) Example: 2096-04-01T02:00:00.000Z

Upper limit for timestamp in UTC and YYYY-MM-DDTHH:mm:ss.sssZ format.

Response  200
HideShow
Headers
Content-Type: application/json; charset=utf-8
Body
{
  "meta": {
    "currency": "USD"
  },
  "query": {
    "filters": {
      "publisher_id": [
        "Hello, world!",
        "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      ],
      "app_id": [
        "Hello, world!"
      ],
      "adunit_id": [
        "Hello, world!"
      ],
      "country": [
        "Hello, world!"
      ]
    },
    "granularity": "hour",
    "timestamp": {
      "from": "2016-04-01T00:00:00.000Z",
      "to": "2016-04-01T01:00:00.000Z"
    },
    "group": [
      "Hello, world!",
      "Members:",
      "publisher_id"
    ]
  },
  "data": [
    {
      "timestamp": "2016-04-01T00:00:00.000Z",
      "dimensions": {
        "app_id": "Hello, world!",
        "app_version": "Hello, world!",
        "adunit_id": "Hello, world!",
        "adunit_type": "Hello, world!",
        "country": "Hello, world!",
        "city": "Hello, world!",
        "publisher_id": "f0b55f5c-4c51-445f-b6fe-9157db6d11ec",
        "sdk_version": "Hello, world!",
        "carrier": "Hello, world!",
        "connection_type": "Hello, world!",
        "device_os": "Hello, world!",
        "device_os_version": "Hello, world!",
        "device_brand": "Hello, world!",
        "device_model": "Hello, world!",
        "device_orientation": "Hello, world!",
        "gender": "Hello, world!",
        "year_of_birth": "Hello, world!",
        "interest_category": "Hello, world!",
        "persona": "Hello, world!"
      },
      "result": {
        "earnings": 58.271349526959966,
        "impressions": 304783,
        "ecpm": 0.19118963172801623,
        "ad_requests": 6812332,
        "clicks": 927,
        "render_rate": 0.3041508220602855,
        "fill_rate": 0.3041508220602855,
        "ctr": 0.003041508220602855
      }
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        }
      },
      "required": [
        "currency"
      ]
    },
    "query": {
      "type": "object",
      "properties": {
        "filters": {
          "type": "object",
          "properties": {
            "publisher_id": {
              "type": "array"
            },
            "app_id": {
              "type": "array"
            },
            "adunit_id": {
              "type": "array"
            },
            "country": {
              "type": "array"
            }
          },
          "required": [
            "publisher_id",
            "app_id",
            "adunit_id",
            "country"
          ]
        },
        "granularity": {
          "type": "string",
          "enum": [
            "hour",
            "day",
            "all"
          ]
        },
        "timestamp": {
          "type": "object",
          "properties": {
            "from": {
              "type": "string"
            },
            "to": {
              "type": "string"
            }
          },
          "required": [
            "from",
            "to"
          ]
        },
        "group": {
          "type": "array"
        }
      },
      "required": [
        "filters",
        "granularity",
        "timestamp",
        "group"
      ]
    },
    "data": {
      "type": "array"
    }
  },
  "required": [
    "meta",
    "query",
    "data"
  ]
}

Range

Range
GET/v1.1/publishers/{publisher_id}{?access_token}

Example URI

GET https://reporting.glispaconnect.com/v1.1/publishers/f0b55f5c-4c51-445f-b6fe-9157db6d11ec?access_token=30767175-3872-4cda-80b0-5d79c926970a
URI Parameters
HideShow
publisher_id
string (required) Example: f0b55f5c-4c51-445f-b6fe-9157db6d11ec

Publisher id

access_token
string (required) Example: 30767175-3872-4cda-80b0-5d79c926970a

Access token

timestamp[from]
string (required) Example: 2016-04-01T00:00:00.000Z

Lower limit for timestamp in UTC and YYYY-MM-DDTHH:mm:ss.sssZ format.

timestamp[to]
string (required) Example: 2096-04-01T02:00:00.000Z

Upper limit for timestamp in UTC and YYYY-MM-DDTHH:mm:ss.sssZ format.

Response  200
HideShow
Headers
Content-Type: application/json; charset=utf-8
Body
{
  "meta": {
    "currency": "USD"
  },
  "query": {
    "filters": {
      "publisher_id": [
        "Hello, world!",
        "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      ],
      "app_id": [
        "Hello, world!"
      ],
      "adunit_id": [
        "Hello, world!"
      ],
      "country": [
        "Hello, world!"
      ]
    },
    "granularity": "hour",
    "timestamp": {
      "from": "2016-04-01T00:00:00.000Z",
      "to": "2016-04-01T01:00:00.000Z"
    },
    "group": [
      "Hello, world!",
      "Members:",
      "publisher_id"
    ]
  },
  "data": [
    {
      "timestamp": "2016-04-01T00:00:00.000Z",
      "dimensions": {
        "app_id": "Hello, world!",
        "app_version": "Hello, world!",
        "adunit_id": "Hello, world!",
        "adunit_type": "Hello, world!",
        "country": "Hello, world!",
        "city": "Hello, world!",
        "publisher_id": "f0b55f5c-4c51-445f-b6fe-9157db6d11ec",
        "sdk_version": "Hello, world!",
        "carrier": "Hello, world!",
        "connection_type": "Hello, world!",
        "device_os": "Hello, world!",
        "device_os_version": "Hello, world!",
        "device_brand": "Hello, world!",
        "device_model": "Hello, world!",
        "device_orientation": "Hello, world!",
        "gender": "Hello, world!",
        "year_of_birth": "Hello, world!",
        "interest_category": "Hello, world!",
        "persona": "Hello, world!"
      },
      "result": {
        "earnings": 58.271349526959966,
        "impressions": 304783,
        "ecpm": 0.19118963172801623,
        "ad_requests": 6812332,
        "clicks": 927,
        "render_rate": 0.3041508220602855,
        "fill_rate": 0.3041508220602855,
        "ctr": 0.003041508220602855
      }
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        }
      },
      "required": [
        "currency"
      ]
    },
    "query": {
      "type": "object",
      "properties": {
        "filters": {
          "type": "object",
          "properties": {
            "publisher_id": {
              "type": "array"
            },
            "app_id": {
              "type": "array"
            },
            "adunit_id": {
              "type": "array"
            },
            "country": {
              "type": "array"
            }
          },
          "required": [
            "publisher_id",
            "app_id",
            "adunit_id",
            "country"
          ]
        },
        "granularity": {
          "type": "string",
          "enum": [
            "hour",
            "day",
            "all"
          ]
        },
        "timestamp": {
          "type": "object",
          "properties": {
            "from": {
              "type": "string"
            },
            "to": {
              "type": "string"
            }
          },
          "required": [
            "from",
            "to"
          ]
        },
        "group": {
          "type": "array"
        }
      },
      "required": [
        "filters",
        "granularity",
        "timestamp",
        "group"
      ]
    },
    "data": {
      "type": "array"
    }
  },
  "required": [
    "meta",
    "query",
    "data"
  ]
}

Granularity

Granularity describes the period of time the results will be broken down to. Possibles values are hour and day and all.

Using granularity: all you can get aggregated results for the period of time defined in timestamp[from] and timestamp[to].

NOTE: When using the day granularity value all filtering with timestamp[from]/timestamp[to] will be rounded to dates only.

Given the following from/to values:

  • from: 2016-04-01T04:00:00.000Z,

  • to: 2016-04-01T21:00:00.000Z

  • granularity: day

The result will be 1 datapoint and the query will be performed with:

  • from: 2016-04-01T00:00:00.000Z,

  • to: 2016-04-02T00:00:00.000Z

Granularity

All
GET/v1.1/publishers/{publisher_id}{?granularity,access_token}

Example URI

GET https://reporting.glispaconnect.com/v1.1/publishers/f0b55f5c-4c51-445f-b6fe-9157db6d11ec?granularity=all&access_token=30767175-3872-4cda-80b0-5d79c926970a
URI Parameters
HideShow
publisher_id
string (required) Example: f0b55f5c-4c51-445f-b6fe-9157db6d11ec

Publisher id

access_token
string (required) Example: 30767175-3872-4cda-80b0-5d79c926970a

Access token

granularity
string (required) Example: all

Filter name

Response  200
HideShow
Headers
Content-Type: application/json; charset=utf-8
Body
{
  "meta": {
    "currency": "USD"
  },
  "query": {
    "filters": {
      "publisher_id": [
        "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      ],
      "app_id": [],
      "adunit_id": [],
      "country": []
    },
    "granularity": "all",
    "group": [
      "publisher_id"
    ],
    "timestamp": {
      "from": "2016-04-01T01:00:00.000Z",
      "to": "2016-04-01T01:00:00.000Z"
    }
  },
  "data": [
    {
      "timestamp": "2016-04-01T00:00:00.000Z",
      "dimensions": {
        "app_id": null,
        "adunit_id": null,
        "country": null,
        "publisher_id": "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      },
      "result": {
        "earnings": 58.271349526959966,
        "impressions": 304783,
        "ecpm": 0.19118963172801623,
        "ad_requests": 6812332,
        "clicks": 927,
        "render_rate": 0.3041508220602855,
        "fill_rate": 0.3041508220602855,
        "ctr": 0.003041508220602855
      }
    }
  ]
}

Per Hour
GET/v1.1/publishers/{publisher_id}{?granularity,access_token}

Example URI

GET https://reporting.glispaconnect.com/v1.1/publishers/f0b55f5c-4c51-445f-b6fe-9157db6d11ec?granularity=hour&access_token=30767175-3872-4cda-80b0-5d79c926970a
URI Parameters
HideShow
publisher_id
string (required) Example: f0b55f5c-4c51-445f-b6fe-9157db6d11ec

Publisher id

access_token
string (required) Example: 30767175-3872-4cda-80b0-5d79c926970a

Access token

granularity
string (required) Example: hour

Filter name

Response  200
HideShow
Headers
Content-Type: application/json; charset=utf-8
Body
{
  "meta": {
    "currency": "USD"
  },
  "query": {
    "filters": {
      "publisher_id": [
        "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      ],
      "app_id": [],
      "adunit_id": [],
      "country": []
    },
    "granularity": "hour",
    "group": [
      "publisher_id"
    ],
    "timestamp": {
      "from": "2016-04-01T00:00:00.000Z",
      "to": "2016-04-01T01:00:00.000Z"
    }
  },
  "data": [
    {
      "timestamp": "2016-04-01T00:00:00.000Z",
      "dimensions": {
        "app_id": null,
        "adunit_id": null,
        "country": null,
        "publisher_id": "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      },
      "result": {
        "earnings": 58.271349526959966,
        "impressions": 304783,
        "ecpm": 0.19118963172801623,
        "ad_requests": 6812332,
        "clicks": 927,
        "render_rate": 0.3041508220602855,
        "fill_rate": 0.3041508220602855,
        "ctr": 0.003041508220602855
      }
    },
    {
      "timestamp": "2016-04-01T01:00:00.000Z",
      "dimensions": {
        "app_id": null,
        "adunit_id": null,
        "country": null,
        "publisher_id": "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      },
      "result": {
        "earnings": 58.271349526959966,
        "impressions": 304783,
        "ecpm": 0.19118963172801623,
        "ad_requests": 6812332,
        "clicks": 927,
        "render_rate": 0.3041508220602855,
        "fill_rate": 0.3041508220602855,
        "ctr": 0.003041508220602855
      }
    }
  ]
}

Per Day
GET/v1.1/publishers/{publisher_id}{?granularity,access_token}

Example URI

GET https://reporting.glispaconnect.com/v1.1/publishers/f0b55f5c-4c51-445f-b6fe-9157db6d11ec?granularity=day&access_token=30767175-3872-4cda-80b0-5d79c926970a
URI Parameters
HideShow
publisher_id
string (required) Example: f0b55f5c-4c51-445f-b6fe-9157db6d11ec

Publisher id

access_token
string (required) Example: 30767175-3872-4cda-80b0-5d79c926970a

Access token

granularity
string (optional) Example: day

Filter name

Response  200
HideShow
Headers
Content-Type: application/json; charset=utf-8
Body
{
  "meta": {
    "currency": "USD"
  },
  "query": {
    "filters": {
      "publisher_id": [
        "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      ],
      "app_id": [],
      "adunit_id": [],
      "country": []
    },
    "granularity": "day",
    "group": [
      "publisher_id"
    ],
    "timestamp": {
      "from": "2016-04-01T00:00:00.000Z",
      "to": "2016-04-02T00:00:00.000Z"
    }
  },
  "data": [
    {
      "timestamp": "2016-04-01T00:00:00.000Z",
      "dimensions": {
        "app_id": null,
        "adunit_id": null,
        "country": null,
        "publisher_id": "f0b55f5c-4c51-445f-b6fe-9157db6d11ec"
      },
      "result": {
        "earnings": 58.271349526959966,
        "impressions": 304783,
        "ecpm": 0.19118963172801623,
        "ad_requests": 6812332,
        "clicks": 927,
        "render_rate": 0.3041508220602855,
        "fill_rate": 0.3041508220602855,
        "ctr": 0.003041508220602855
      }
    }
  ]
}

Generated by aglio on 29 Aug 2018