Retrieve aggregated offer stats like number of conversions and total costs (to be received by network).
|This calls action target
|This calls action method
|List of fields to returnShow Supported Values
|Array of field values to filter results byShow Filterable Fields
|Array of fields and directions to sort results byShow Sortable Fields
|Objects per page to return; defaults to returning all found
|Result page to return, based on limit value; defaults to 1
|Get totals on aggregate fields
|Default currency. Format ISO-4217. Examples: 'USD', 'EUR', 'CNY'.
|Start of date range for time zone shifting; use "YYYY-MM-DD" format
|End of date range for time zone shifting; use "YYYY-MM-DD" format
|Hour offset for time zone shifting
When to Use data_start / data_end
By default, datetime values returned are in the network's default time-zone. To retrieve data in a different time zone, use the data_start, data_end, and hour_offset parameters.
The values for data_start and data_end should contain the date range you would like to set for your results. These values should match the date range you set in your filter on Stat.date.
The hour_offset parameter instructs the API to shift these timestamps by a number of positive or negative hours from your network's default time zone.
For example, if your network is set to utilize Eastern Standard Time (UTC-0500), and you would like to fetch reporting data in Pacific Standard Time (UTC-0800), use an hour_offset value of "-3" as shown below.
&data_start=2020-01-13 &data_end=2020-01-13 &hour_offset=-3
The timestamps will shift by -3 hours while still maintaining a date range of January 1st 2016.
Important: data_start and data_end do not filter results by date! Use Stat.date in the filter parameter to filter results by date.
Filtering for Multiple Values on the Same Field
You can enter multiple values for the same field when filtering, to create an OR filter on that field. For example, if you want results for three different offers collected together, form that section of the call as:
&filters[Stat.offer_id][conditional]=EQUAL_TO &filters[Stat.offer_id][values]=123 &filters[Stat.offer_id][values]=456 &filters[Stat.offer_id][values]=789
This returns all entries relating to offer IDs 123, 456, and 789. For more on filtering, see Filtering, Paging & Sorting.
GET Response Notes
Returns an array of matching StatReport model objects