Skip to end of metadata
Go to start of metadata

 

An updated version of the Verve Publisher Analytics API is now available.  The new version will impact URLs, JSON payload and API returns.  Please find the new API request URL and required changes below. The existing Analytics API (version 1) will be deprecated on October 31, 2019. 

Please contact your Account Manager with any questions.

 

Publisher Revenue Daily

https://analytics-api.vervemobile.com/api/v2/51-publisher-revenue-daily-api.format?parameters 

Publisher Revenue Monthly

https://analytics-api.vervemobile.com/api/v2/64-publisher-revenue-monthly-api.format?parameters

 

Required Changes

 V1V2Impact
URL

URL: https://analytics-api.vervemobile.com/api/v1/{API_NAME}/data.format?parameters

Example: 

https://analytics-api.vervemobile.com/api/v1/64-publisher-revenue-monthly-api.format?parameters

URL: https://analytics-api.vervemobile.com/api/v2/{API_NAME}/data.format?parameters

Example: 

https://analytics-api.vervemobile.com/api/v2/64-publisher-revenue-monthly-api.format?parameters

v1 will be deprecated on October 31, 2019.
JSON{
  "entries": [
   
  ]
}
{
  "current_page": 1,
  "total_count": 0,
  "total_pages": 1,
  "entries": [
   
  ]
}
This extra information should not have any impact on the current user, but it provides helpful information for users when using limit and pagination.
&select=Optional. When omitted, api returns all the metrics available as default.v2: Required. The expected metric(s) must be specified. Otherwise, the error message will be returned.Any api call which is missing select= parameter will get the error message ""Missing required parameter(s)  (&by= ,  &select= , &where[])."
&by=Optional. When omitted, api returns all the dimensions available as default.v2: Required. The expected dimension(s) must be specified. Otherwise, the error message will be returned.Any api call which is missing by= parameter will get the error message ""Missing required parameter(s)  (&by= ,  &select= , &where[])."
&where=Optional. When omitted, api returns all recordsv2: Required. The constraints must be specifiedAny api call which is missing where= parameter will get the error message ""Missing required parameter(s)  (&by= ,  &select= ,&where=)."

Optional Changes

  V1V2Impact
&limit=Optional. When omitted, api returns 100 rows as default. No constraint on maximum value

v2: Optional. When omitted, api returns 100 rows as default.

When &limit is used, allowed maximum value = 2000. For faster performance, We suggest to use any number less than 500. If the data set expected to be returned >2000 rows, using pagination

Any api call with the value in limit greater than 2000, will get the error message ""The value in &limit= is out of range. The maximum for &limit =2000".

 

 

 

 

  • No labels