Skip to main content
GET
/
v1
/
report
/
campaign
/
{id}
/report/campaign/:id
curl --request GET \
  --url https://api.tagdeliver.com/v1/report/campaign/{id} \
  --header 'Authorization: Bearer <token>'
{
  "results": {
    "campaign_id": 32729473,
    "campaign_name": "example.com campaign",
    "start_date": "2024-07-31",
    "end_date": "2025-11-23",
    "currency": "GBP",
    "status": "live",
    "total_impressions": 220130979,
    "total_clicks": 110088,
    "total_ctr": 0.0005001022595733788,
    "total_spend": 0,
    "total_viewability": 0.6765965048472347,
    "filter_data": {
      "publishers": [
        {
          "uid": 18620,
          "domain": "example.com",
          "label": null
        }
      ],
      "configs": [
        {
          "config_id": 8391,
          "unit": "iab",
          "unit_label": "MPU 2 (OOV)"
        },
        {
          "config_id": 8389,
          "unit": "iab",
          "unit_label": "MPU 1 (OOV)"
        },
        {
          "config_id": 8390,
          "unit": "iab",
          "unit_label": "MPU 2"
        },
        {
          "config_id": 8395,
          "unit": "in-image",
          "unit_label": "In-Image"
        },
        {
          "config_id": 8393,
          "unit": "iab",
          "unit_label": "Leaderboard 1 (OOV)"
        },
        {
          "config_id": 8388,
          "unit": "iab",
          "unit_label": "MPU 1"
        },
        {
          "config_id": 8392,
          "unit": "iab",
          "unit_label": "Leaderboard 1"
        }
      ]
    },
    "range": {
      "clicks": [
        null
      ],
      "impressions": [
        null
      ],
      "dates": [
        "1970-01-01"
      ]
    },
    "data": {
      "byUid": [
        {
          "uid": 18620,
          "domain": "example.com",
          "impressions": 220130979,
          "clicks": 110088,
          "spend": 0,
          "viewable_impressions": 148939851,
          "ctr": 0.0005001022595733788,
          "viewability": 0.6765965048472347
        }
      ],
      "byLineItem": [
        {
          "line_item_id": 6727744249,
          "line_item_name": "Why not visit our shop? - Backfill - Network Tier",
          "impressions": 220130979,
          "clicks": 110088,
          "spend": 0,
          "viewable_impressions": 148939851,
          "ctr": 0.0005001022595733788,
          "viewability": 0.6765965048472347
        }
      ],
      "byConfig": [
        {
          "config_id": 8391,
          "unit": "iab",
          "unit_label": "MPU 2 (OOV)",
          "impressions": 2510050,
          "clicks": 977,
          "spend": 0,
          "viewable_impressions": 665193,
          "ctr": 0.00038923527419772516,
          "viewability": 0.2650118523535388
        },
        {
          "config_id": 8395,
          "unit": "in-image",
          "unit_label": "In-Image",
          "impressions": 196811066,
          "clicks": 84412,
          "spend": 0,
          "viewable_impressions": 135750476,
          "ctr": 0.0004288986473961784,
          "viewability": 0.6897502196344996
        },
        {
          "config_id": 8389,
          "unit": "iab",
          "unit_label": "MPU 1 (OOV)",
          "impressions": 11669747,
          "clicks": 10369,
          "spend": 0,
          "viewable_impressions": 6223654,
          "ctr": 0.0008885368294616841,
          "viewability": 0.5333152466801551
        },
        {
          "config_id": 8390,
          "unit": "iab",
          "unit_label": "MPU 2",
          "impressions": 1169364,
          "clicks": 1251,
          "spend": 0,
          "viewable_impressions": 618616,
          "ctr": 0.0010698123082290886,
          "viewability": 0.5290191933392853
        },
        {
          "config_id": 8393,
          "unit": "iab",
          "unit_label": "Leaderboard 1 (OOV)",
          "impressions": 146415,
          "clicks": 0,
          "spend": 0,
          "viewable_impressions": 36281,
          "ctr": 0,
          "viewability": 0.24779564935286685
        },
        {
          "config_id": 8392,
          "unit": "iab",
          "unit_label": "Leaderboard 1",
          "impressions": 278311,
          "clicks": 2,
          "spend": 0,
          "viewable_impressions": 227769,
          "ctr": 0.000007186205360190578,
          "viewability": 0.8183974043426239
        },
        {
          "config_id": 8388,
          "unit": "iab",
          "unit_label": "MPU 1",
          "impressions": 7546026,
          "clicks": 13077,
          "spend": 0,
          "viewable_impressions": 5417862,
          "ctr": 0.0017329651395317218,
          "viewability": 0.7179755277811128
        }
      ],
      "byCreativeSize": [
        {
          "creative_size": "300x250",
          "impressions": 22895187,
          "clicks": 25674,
          "spend": 0,
          "viewable_impressions": 12925325,
          "ctr": 0.001121371054973257,
          "viewability": 0.5645433251975622
        },
        {
          "creative_size": "730x90",
          "impressions": 21669683,
          "clicks": 13317,
          "spend": 0,
          "viewable_impressions": 15226541,
          "ctr": 0.000614545215082288,
          "viewability": 0.7026656089062309
        },
        {
          "creative_size": "320x50",
          "impressions": 175566109,
          "clicks": 71097,
          "spend": 0,
          "viewable_impressions": 120787985,
          "ctr": 0.0004049585674875326,
          "viewability": 0.6879914676470958
        }
      ],
      "byDevice": [
        {
          "device": "desktop",
          "impressions": 11468726,
          "clicks": 6584,
          "spend": 0,
          "viewable_impressions": 8026483,
          "ctr": 0.0005740829452198962,
          "viewability": 0.6998582928914685
        },
        {
          "device": "tablet",
          "impressions": 12479583,
          "clicks": 7582,
          "spend": 0,
          "viewable_impressions": 7835862,
          "ctr": 0.0006075523517091877,
          "viewability": 0.6278945378222974
        },
        {
          "device": "mobile",
          "impressions": 196133680,
          "clicks": 95921,
          "spend": 0,
          "viewable_impressions": 133055921,
          "ctr": 0.0004890592987395127,
          "viewability": 0.6783940473660618
        },
        {
          "device": "unknown",
          "impressions": 48990,
          "clicks": 1,
          "spend": 0,
          "viewable_impressions": 21585,
          "ctr": 0.000020412329046744232,
          "viewability": 0.4406001224739743
        }
      ],
      "all": [
        {
          "uid": 18620,
          "domain": "example.com",
          "line_item_id": 6727744249,
          "line_item_name": "Why not visit our shop? - Backfill - Network Tier",
          "config_id": 8391,
          "unit": "iab",
          "unit_label": "MPU 2 (OOV)",
          "date": "2024-07-31",
          "device": "desktop",
          "creative_size": "300x250",
          "impressions": 897,
          "viewable_impressions": 437,
          "clicks": 0,
          "spend": 0,
          "ctr": 0,
          "viewability": 0.48717948717948717
        },
        {
          "uid": 18620,
          "domain": "example.com",
          "line_item_id": 6727744249,
          "line_item_name": "Why not visit our shop? - Backfill - Network Tier",
          "config_id": 8395,
          "unit": "in-image",
          "unit_label": "In-Image",
          "date": "2024-07-31",
          "device": "tablet",
          "creative_size": "730x90",
          "impressions": 22172,
          "viewable_impressions": 14842,
          "clicks": 15,
          "spend": 0,
          "ctr": "6.765289554392928E-4",
          "viewability": 0.6694028504419989
        },
        {
          "uid": 18620,
          "domain": "example.com",
          "line_item_id": 6727744249,
          "line_item_name": "Why not visit our shop? - Backfill - Network Tier",
          "config_id": 8391,
          "unit": "iab",
          "unit_label": "MPU 2 (OOV)",
          "date": "2024-07-31",
          "device": "tablet",
          "creative_size": "300x250",
          "impressions": 417,
          "viewable_impressions": 91,
          "clicks": 0,
          "spend": 0,
          "ctr": 0,
          "viewability": 0.2182254196642686
        },
        {
          "uid": 18620,
          "domain": "example.com",
          "line_item_id": 6727744249,
          "line_item_name": "Why not visit our shop? - Backfill - Network Tier",
          "config_id": 8395,
          "unit": "in-image",
          "unit_label": "In-Image",
          "date": "2024-07-31",
          "device": "desktop",
          "creative_size": "730x90",
          "impressions": 20436,
          "viewable_impressions": 15144,
          "clicks": 14,
          "spend": 0,
          "ctr": "6.850655705617538E-4",
          "viewability": 0.741045214327657
        },
        {
          "uid": 18620,
          "domain": "example.com",
          "line_item_id": 6727744249,
          "line_item_name": "Why not visit our shop? - Backfill - Network Tier",
          "config_id": 8389,
          "unit": "iab",
          "unit_label": "MPU 1 (OOV)",
          "date": "2024-07-31",
          "device": "mobile",
          "creative_size": "300x250",
          "impressions": 15712,
          "viewable_impressions": 11442,
          "clicks": 19,
          "spend": 0,
          "ctr": 0.0012092668024439918,
          "viewability": 0.7282331975560081
        },
        {
          "uid": 18620,
          "domain": "example.com",
          "line_item_id": 6727744249,
          "line_item_name": "Why not visit our shop? - Backfill - Network Tier",
          "config_id": 8390,
          "unit": "iab",
          "unit_label": "MPU 2",
          "date": "2024-07-31",
          "device": "tablet",
          "creative_size": "300x250",
          "impressions": 219,
          "viewable_impressions": 116,
          "clicks": 1,
          "spend": 0,
          "ctr": 0.0045662100456621,
          "viewability": 0.5296803652968036
        },
        {
          "uid": 18620,
          "domain": "example.com",
          "line_item_id": 6727744249,
          "line_item_name": "Why not visit our shop? - Backfill - Network Tier",
          "config_id": 8393,
          "unit": "iab",
          "unit_label": "Leaderboard 1 (OOV)",
          "date": "2024-07-31",
          "device": "tablet",
          "creative_size": "730x90",
          "impressions": 8,
          "viewable_impressions": 3,
          "clicks": 0,
          "spend": 0,
          "ctr": 0,
          "viewability": 0.375
        },
        {
          "uid": 18620,
          "domain": "example.com",
          "line_item_id": 6727744249,
          "line_item_name": "Why not visit our shop? - Backfill - Network Tier",
          "config_id": 8395,
          "unit": "in-image",
          "unit_label": "In-Image",
          "date": "2024-07-31",
          "device": "unknown",
          "creative_size": "320x50",
          "impressions": 14,
          "viewable_impressions": 5,
          "clicks": 0,
          "spend": 0,
          "ctr": 0,
          "viewability": 0.35714285714285715
        }
      ]
    }
  },
  "success": true
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
integer
required

Campaign ID

Query Parameters

​
start
string<date>

Optional start date

​
end
string<date>

Optional end date

Response

200 - application/json
​
results
object
​
success
boolean