Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
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
}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
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Campaign ID
Was this page helpful?