Campaigns

get/api/v2/campaigns/{id}/stats

Request

  • Base URL: https://api.richads.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.richads.com/api/v2/campaigns/{id}/stats
  • Auth: HTTP bearer

Path parameters

idinteger required

Campaign ID

Query parameters

dateFromstring date required
Example:2024-01-01
dateTostring date required
Example:2024-02-29

Max 2 months range

groupBy'date' | 'hour' | 'country' | 'site-id' | 'publisher-id' | 'ssp-id' | 'subscription-list' | 'isp' | 'carrier' | 'os' | 'browser' | 'region' | 'city' | 'device' | 'connection-type' | 'browser-language'
Example:date

Response

Returns campaign statistics for the given date range, optionally grouped.

datestring

Date or grouping key

impressionsinteger

Total impressions

clicksinteger

Total clicks

conversionsinteger

Total conversions

conversions1integer

Approved conversions

conversions2integer

Conversions 2

conversions3integer

Conversions 3

spendnumber float

Total spend in USD

ctrnumber float

Click-through rate percentage

conversionRatenumber float

Conversion rate percentage

cpcnumber float

Cost per click in USD

cpanumber float

Cost per acquisition in USD

Example response

[
  {
    "date": "2024-01-01",
    "impressions": 15000,
    "clicks": 350,
    "conversions": 25,
    "conversions1": 20,
    "conversions2": 15,
    "conversions3": 10,
    "spend": 175.5,
    "ctr": 2.33,
    "conversionRate": 7.14,
    "cpc": 0.5,
    "cpa": 7.02
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.