Deprecation Warning

DSP API v1 will continue to receive critical bug and security fixes, but no new functionality will be added going forward. Next version of DSP API is under development and when ready DSP API v1 will be deprecated.

Statistics

Statistics can be requested by day or in total. The delta total can be used to get e.g. per hour statistics.

Contact your Delta Projects representative to get your mediaAgencyId!

Activity Statistics

Description: Retrieve activity statistics
Verb: GET
Path: /api/v1/media_agency/<mediaAgencyId>/client/<clientId>/campaign/<campaignId>/activity/<activityId>/statistics

Request Parameters

Parameter Type Required Description Example
mediaAgencyId Path Yes Id of media agency 86b35325-794c-11e4-8425-daf437376f87
clientId Path Yes Id of client 86b35326-794c-11e4-8425-daf437376f87
campaignId Path Yes Id of campaign. Must be "default" in v1. default
activityId Path Yes Id of activity 86b35327-794c-11e4-8425-daf437376f87
interval Query No Statistics date interval (default: activity flight) 2014-01-01/2014-01-10
group_by Query No Grouping (default: "bidding_plan") "format"
granularity Query No Granularity (default: "none") "day"
sort_order Query No The sorting order of Entries - ASC(default) or DESC DESC
limit Query No Number of Entries to limit the response to 10
apikey Query Yes API key for authentication and authorization secretkey123

Available groupings:

  • "bidding_plan" -- Bidding Plan
  • "bidding_platform" -- Inventory Channel
  • "format" -- Creative dimensions
  • "site" -- Site

Available granularities:

  • "none" -- Total during period
  • "day" -- Per day, during period

Response JSON body

Parameter Parameter Type Description Example
top level Array of Group Group See below

Group Object

Parameter Parameter Type Description Example
name String Name of group "Example Inventory Channel 1"
id String Id of group (only applicable for bidding_plan "86b35328-794c-11e4-8425-daf437376f87"
entries Array of Entry Entries within group See below

id is only included when group_by is bidding_plan.

Entry object [entry-object]

Parameter Parameter Type Description Example
bids Integer Bids 1000
impressions Integer Impressions 1000
viewable_impressions Double Viewable Impressions factor 0.6652360515021459
clicks Integer Clicks 50
vt_orders Integer VT Orders 4
ct_orders Integer CT Orders 1
cost Double Cost in account currency 2.5
range_begin ISO8601 Timestamp Statistics date start "2014-01-01T00:00:00.000Z"
range_end ISO8601 Timestamp Statistics date end "2014-01-01T23:59:59.999Z"

viewable_impressions is only included if sufficient data is available.

range_end set to 2014-01-01 will be read as 2014-01-01T00:00:00.000Z.

Example Request

GET /api/v1/media_agency/86b35325-794c-11e4-8425-daf437376f87/client/86b35326-794c-11e4-8425-daf437376f87/campaign/default/activity/86b35327-794c-11e4-8425-daf437376f87/statistics?apikey=secret123&interval=2014-01-01/2014-01-03&granularity=day&group_by=bidding_platform

Example Response

[
  {
    "entries": [
      {
        "bids": 1000,
        "clicks": 50,
        "cost": 2.5,
        "ct_orders": 1,
        "impressions": 1000,
        "range_begin": "2014-01-01T00:00:00.000Z",
        "range_end": "2014-01-01T23:59:59.999Z",
        "viewable_impressions": 0.6652360515021459,
        "vt_orders": 4
      },
      {
        "bids": 1000,
        "clicks": 50,
        "cost": 2.5,
        "ct_orders": 1,
        "impressions": 1000,
        "range_begin": "2014-01-02T00:00:00.000Z",
        "range_end": "2014-01-02T23:59:59.999Z",
        "viewable_impressions": 0.6652360515021459,
        "vt_orders": 4
      },
      {
        "bids": 1000,
        "clicks": 50,
        "cost": 2.5,
        "ct_orders": 1,
        "impressions": 1000,
        "range_begin": "2014-01-03T00:00:00.000Z",
        "range_end": "2014-01-03T23:59:59.999Z",
        "viewable_impressions": 0.6652360515021459,
        "vt_orders": 4
      }
    ],
    "name": "Example Inventory Channel 1",
    "id": "86b35328-794c-11e4-8425-daf437376f87"
  },
  {
    "entries": [
      {
        "bids": 1000,
        "clicks": 50,
        "cost": 2.5,
        "ct_orders": 1,
        "impressions": 1000,
        "range_begin": "2014-01-01T00:00:00.000Z",
        "range_end": "2014-01-01T23:59:59.999Z",
        "viewable_impressions": 0.6652360515021459,
        "vt_orders": 4
      },
      {
        "bids": 1000,
        "clicks": 50,
        "cost": 2.5,
        "ct_orders": 1,
        "impressions": 1000,
        "range_begin": "2014-01-02T00:00:00.000Z",
        "range_end": "2014-01-02T23:59:59.999Z",
        "viewable_impressions": 0.6652360515021459,
        "vt_orders": 4
      },
      {
        "bids": 1000,
        "clicks": 50,
        "cost": 2.5,
        "ct_orders": 1,
        "impressions": 1000,
        "range_begin": "2014-01-03T00:00:00.000Z",
        "range_end": "2014-01-03T23:59:59.999Z",
        "viewable_impressions": 0.6652360515021459,
        "vt_orders": 4
      }
    ],
    "name": "Example Inventory Channel 2",
    "id": "86b35328-794c-11e4-8425-daf437376f88"
  }
]

Live Activity Statistics Summary

Description: Retrieve live activity statistics summary
Verb: GET
Path: /api/v1/media_agency/<mediaAgencyId>/client/<clientId>/campaign/<campaignId>/activity/<activityId>/live_statistics_summary

Request Parameters

Parameter Type Required Description Example
mediaAgencyId Path Yes Id of media agency 86b35325-794c-11e4-8425-daf437376f87
clientId Path Yes Id of client 86b35326-794c-11e4-8425-daf437376f87
campaignId Path Yes Id of campaign. Must be "default" in v1 default
activityId Path Yes Id of activity 86b35327-794c-11e4-8425-daf437376f87
apikey Query Yes API key for authentication and authorization secretkey123

Response JSON body

Parameter Parameter Type Description Example
name String Name of activity "Example Campaign"
id String Id of activity "86b35328-794c-11e4-8425-daf437376f87"
bids Integer Bids 78954
impressions Integer Impressions 42007
clicks Integer Clicks 124
reach Integer Reach 32811
cost Double Cost 59.51
currency ISO4217 Currency Cost currency code "EUR"
activity_begin ISO8601 Timestamp Statistics date start "2017-02-01T00:00:00.000Z"
activity_end ISO8601 Timestamp Statistics date end "2017-05-01T23:59:59.999Z"
generated_at ISO8601 Timestamp Report creation time "2017-03-25T14:01:31.056Z"

Example Request

GET /api/v1/media_agency/86b35325-794c-11e4-8425-daf437376f87/client/86b35326-794c-11e4-8425-daf437376f87/campaign/default/activity/86b35327-794c-11e4-8425-daf437376f87/live_statistics_summary?apikey=secret123

Example Response

{
  "name": "Example Campaign",
  "id": "86b35328-794c-11e4-8425-daf437376f87",
  "bids": 78954,
  "impressions": 42007,
  "clicks": 124,
  "reach": 32811,
  "cost": 594.17251,
  "currency": "SEK",
  "activity_begin": "2017-02-01T00:00:00.000Z",
  "activity_end": "2017-05-01T23:59:59.999Z",
  "generated_at": "2017-03-25T14:01:31.056Z"
}

Live Activity Statistics

Description: Retrieve live activity statistics
Verb: GET
Path: /api/v1/media_agency/<mediaAgencyId>/client/<clientId>/campaign/<campaignId>/activity/<activityId>/live_statistics

Request Parameters

Parameter Type Required Description Example
mediaAgencyId Path Yes Id of media agency 86b35325-794c-11e4-8425-daf437376f87
clientId Path Yes Id of client 86b35326-794c-11e4-8425-daf437376f87
campaignId Path Yes Id of campaign. Must be "default" in v1 default
activityId Path Yes Id of activity 86b35327-794c-11e4-8425-daf437376f87
apikey Query Yes API key for authentication and authorization secretkey123

Response JSON body

Parameter Parameter Type Description Example
top level Array of BiddingPlan Bidding Plans See below

BiddingPlan Object

Parameter Parameter Type Description Example
bidding_plan_id String Id of bidding plan "86b35328-794c-11e4-8425-daf437376f87"
bidding_plan String Name of bidding plan "Example Bidding Plan"
bidding_platforms Array of BiddingPlatform Bidding Platforms See below

BiddingPlatform Object

Parameter Parameter Type Description Example
name String Name of bidding platform "Example Bidding Platform"
entry Entry Entry See below

Example Request

GET /api/v1/media_agency/86b35325-794c-11e4-8425-daf437376f87/client/86b35326-794c-11e4-8425-daf437376f87/campaign/default/activity/86b35327-794c-11e4-8425-daf437376f87/live_statistics?apikey=secret123

Example Response

[
  {
    "bidding_plan_id": "86b35328-794c-11e4-8425-daf437376f87",
    "bidding_plan": "Example Bidding Plan 1",
    "bidding_platforms": [
      {
        "name": "Example Bidding Platform 1",
        "entry": {
          "bids": 1000,
          "impressions": 1000,
          "clicks": 50,
          "vt_orders": 4,
          "ct_orders": 1,
          "cost": 2.5,
          "range_begin": "2014-01-01T00:00:00.000Z",
          "range_end": "2014-01-01T23:59:59.999Z"
        }
      },
      {
        "name": "Example Bidding Platform 2",
        "entry": {
          "bids": 1000,
          "impressions": 1000,
          "clicks": 50,
          "vt_orders": 4,
          "ct_orders": 1,
          "cost": 2.5,
          "range_begin": "2014-01-01T00:00:00.000Z",
          "range_end": "2014-01-01T23:59:59.999Z"
        }
      }
    ]
  },
  {
    "bidding_plan_id": "86b35329-794c-11e4-8425-daf437376f87",
    "bidding_plan": "Example Bidding Plan 2",
    "bidding_platforms": [
      {
        "name": "Example Bidding Platform 1",
        "entry": {
          "bids": 1000,
          "impressions": 1000,
          "clicks": 50,
          "vt_orders": 4,
          "ct_orders": 1,
          "cost": 2.5,
          "range_begin": "2014-01-01T00:00:00.000Z",
          "range_end": "2014-01-01T23:59:59.999Z"
        }
      },
      {
        "name": "Example Bidding Platform 2",
        "entry": {
          "bids": 1000,
          "impressions": 1000,
          "clicks": 50,
          "vt_orders": 4,
          "ct_orders": 1,
          "cost": 2.5,
          "range_begin": "2014-01-01T00:00:00.000Z",
          "range_end": "2014-01-01T23:59:59.999Z"
        }
      }
    ]
  }
]

Last modified: Tue Feb 21 2017 09:44:04 GMT+0100 (CET)