/report/insight/demand-mix/dimension

GET

report

insight

demand-mix

dimension

/report/insight/demand-mix/dimension

curl --request GET \
  --url https://api.tagdeliver.com/v1/report/insight/demand-mix/dimension \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.tagdeliver.com/v1/report/insight/demand-mix/dimension"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.tagdeliver.com/v1/report/insight/demand-mix/dimension', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tagdeliver.com/v1/report/insight/demand-mix/dimension",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tagdeliver.com/v1/report/insight/demand-mix/dimension"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.tagdeliver.com/v1/report/insight/demand-mix/dimension")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "results": {
    "currency": "GBP",
    "dimensions": [
      "Ad Exchange",
      "Ad server",
      "Header Bidding",
      "Open Bidding"
    ],
    "data": {
      "ad_requests": {
        "total": [],
        "sum": 1227014
      },
      "revenue": {
        "total": [
          165.64493500000003,
          6108.845417000005,
          56.032088,
          9.199275
        ],
        "direct": [
          null,
          6090.406587000004,
          null,
          null
        ],
        "programmatic": [
          165.64493500000003,
          null,
          56.032088,
          9.199275
        ],
        "fallback": [
          null,
          0,
          null,
          null
        ],
        "untracked": [
          null,
          18.43883,
          null,
          null
        ],
        "ci_direct": [
          null,
          0,
          null,
          null
        ],
        "ci_programmatic": [
          5.090314,
          null,
          17.064781,
          null
        ],
        "ci_fallback": [
          null,
          null,
          null,
          null
        ],
        "ci_untracked": [
          null,
          null,
          null,
          null
        ],
        "publisher_direct": [
          null,
          6090.406587000004,
          null,
          null
        ],
        "publisher_programmatic": [
          160.554621,
          null,
          38.967307000000005,
          9.199275
        ],
        "publisher_fallback": [
          null,
          0,
          null,
          null
        ],
        "publisher_untracked": [
          null,
          18.43883,
          null,
          null
        ]
      },
      "impressions": {
        "total": [
          129389,
          486092,
          36450,
          5036
        ],
        "direct": [
          null,
          346071,
          null,
          null
        ],
        "programmatic": [
          129389,
          null,
          36450,
          5036
        ],
        "fallback": [
          null,
          131445,
          null,
          null
        ],
        "untracked": [
          null,
          8576,
          null,
          null
        ],
        "ci_direct": [
          null,
          8653,
          null,
          null
        ],
        "ci_programmatic": [
          19933,
          null,
          11677,
          null
        ],
        "ci_fallback": [
          null,
          null,
          null,
          null
        ],
        "ci_untracked": [
          null,
          null,
          null,
          null
        ],
        "publisher_direct": [
          null,
          337418,
          null,
          null
        ],
        "publisher_programmatic": [
          109456,
          null,
          24773,
          5036
        ],
        "publisher_fallback": [
          null,
          131445,
          null,
          null
        ],
        "publisher_untracked": [
          null,
          8576,
          null,
          null
        ]
      },
      "viewable_impressions": {
        "total": [
          90765,
          167510,
          8087,
          2559
        ],
        "direct": [
          null,
          119191,
          null,
          null
        ],
        "programmatic": [
          90765,
          null,
          8087,
          2559
        ],
        "fallback": [
          null,
          47494,
          null,
          null
        ],
        "untracked": [
          null,
          825,
          null,
          null
        ],
        "ci_direct": [
          null,
          5151,
          null,
          null
        ],
        "ci_programmatic": [
          12144,
          null,
          2487,
          null
        ],
        "ci_fallback": [
          null,
          null,
          null,
          null
        ],
        "ci_untracked": [
          null,
          null,
          null,
          null
        ],
        "publisher_direct": [
          null,
          114040,
          null,
          null
        ],
        "publisher_programmatic": [
          78621,
          null,
          5600,
          2559
        ],
        "publisher_fallback": [
          null,
          47494,
          null,
          null
        ],
        "publisher_untracked": [
          null,
          825,
          null,
          null
        ]
      }
    }
  },
  "success": true
}

Authorizations

Authorization

string

header

required

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

Query Parameters

uid

string

One or more publisher IDs, comma-separated. Defaults to all publishers in your organisation

range

enum<string>

Date range to report on. Preset ranges end yesterday. month_to_date is the current month so far and week_to_date is the current week so far. month_on_month and quarter_on_quarter return monthly or quarterly totals, with the latest period incomplete. custom requires start and end (YYYY-MM-DD). Other values return a 400 error

Available options:

custom,

all_time,

seven_days,

fourteen_days,

thirty_days,

three_months,

six_months,

week_to_date,

month_to_date,

quarter_to_date,

year_to_date,

last_week,

last_month,

last_quarter,

last_year,

month_on_month,

quarter_on_quarter,

yesterday

start

string<date>

Start date when range=custom

end

string<date>

End date when range=custom

date_group

enum<string>

default:day

Groups the series by day, month or quarter. month_on_month and quarter_on_quarter group automatically

Available options:

day,

month,

quarter

rev_type

enum<string>

default:gross

Revenue type

Available options:

gross,

net

rev_source

enum<string>

default:all

Revenue source, SaaS or Plug&Play (pap)

Available options:

all,

pap,

saas

tab

enum<string>

required

Dimension to report on

Available options:

partner,

channel,

advertiser,

platform

platform

string

Filter for when tab=platform. Comma-separated values. Only the one matching tab is used. 'Null' and '(empty)' match missing and blank values

channel

string

Filter for when tab=channel. Comma-separated values. Only the one matching tab is used. 'Null' and '(empty)' match missing and blank values

partner

string

Filter for when tab=partner. Comma-separated values. Only the one matching tab is used. 'Null' and '(empty)' match missing and blank values

advertiser

string

Filter for when tab=advertiser. Comma-separated values. Only the one matching tab is used. 'Null' and '(empty)' match missing and blank values

environment

enum<string>

default:all

Environment or platform to report from

Available options:

all,

app,

web

Response

200 - application/json

results

object

required

Show child attributes

success

boolean

required

⌘I

/report/insight/demand-mix/dimension

curl --request GET \
  --url https://api.tagdeliver.com/v1/report/insight/demand-mix/dimension \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.tagdeliver.com/v1/report/insight/demand-mix/dimension"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.tagdeliver.com/v1/report/insight/demand-mix/dimension', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tagdeliver.com/v1/report/insight/demand-mix/dimension",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tagdeliver.com/v1/report/insight/demand-mix/dimension"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.tagdeliver.com/v1/report/insight/demand-mix/dimension")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "results": {
    "currency": "GBP",
    "dimensions": [
      "Ad Exchange",
      "Ad server",
      "Header Bidding",
      "Open Bidding"
    ],
    "data": {
      "ad_requests": {
        "total": [],
        "sum": 1227014
      },
      "revenue": {
        "total": [
          165.64493500000003,
          6108.845417000005,
          56.032088,
          9.199275
        ],
        "direct": [
          null,
          6090.406587000004,
          null,
          null
        ],
        "programmatic": [
          165.64493500000003,
          null,
          56.032088,
          9.199275
        ],
        "fallback": [
          null,
          0,
          null,
          null
        ],
        "untracked": [
          null,
          18.43883,
          null,
          null
        ],
        "ci_direct": [
          null,
          0,
          null,
          null
        ],
        "ci_programmatic": [
          5.090314,
          null,
          17.064781,
          null
        ],
        "ci_fallback": [
          null,
          null,
          null,
          null
        ],
        "ci_untracked": [
          null,
          null,
          null,
          null
        ],
        "publisher_direct": [
          null,
          6090.406587000004,
          null,
          null
        ],
        "publisher_programmatic": [
          160.554621,
          null,
          38.967307000000005,
          9.199275
        ],
        "publisher_fallback": [
          null,
          0,
          null,
          null
        ],
        "publisher_untracked": [
          null,
          18.43883,
          null,
          null
        ]
      },
      "impressions": {
        "total": [
          129389,
          486092,
          36450,
          5036
        ],
        "direct": [
          null,
          346071,
          null,
          null
        ],
        "programmatic": [
          129389,
          null,
          36450,
          5036
        ],
        "fallback": [
          null,
          131445,
          null,
          null
        ],
        "untracked": [
          null,
          8576,
          null,
          null
        ],
        "ci_direct": [
          null,
          8653,
          null,
          null
        ],
        "ci_programmatic": [
          19933,
          null,
          11677,
          null
        ],
        "ci_fallback": [
          null,
          null,
          null,
          null
        ],
        "ci_untracked": [
          null,
          null,
          null,
          null
        ],
        "publisher_direct": [
          null,
          337418,
          null,
          null
        ],
        "publisher_programmatic": [
          109456,
          null,
          24773,
          5036
        ],
        "publisher_fallback": [
          null,
          131445,
          null,
          null
        ],
        "publisher_untracked": [
          null,
          8576,
          null,
          null
        ]
      },
      "viewable_impressions": {
        "total": [
          90765,
          167510,
          8087,
          2559
        ],
        "direct": [
          null,
          119191,
          null,
          null
        ],
        "programmatic": [
          90765,
          null,
          8087,
          2559
        ],
        "fallback": [
          null,
          47494,
          null,
          null
        ],
        "untracked": [
          null,
          825,
          null,
          null
        ],
        "ci_direct": [
          null,
          5151,
          null,
          null
        ],
        "ci_programmatic": [
          12144,
          null,
          2487,
          null
        ],
        "ci_fallback": [
          null,
          null,
          null,
          null
        ],
        "ci_untracked": [
          null,
          null,
          null,
          null
        ],
        "publisher_direct": [
          null,
          114040,
          null,
          null
        ],
        "publisher_programmatic": [
          78621,
          null,
          5600,
          2559
        ],
        "publisher_fallback": [
          null,
          47494,
          null,
          null
        ],
        "publisher_untracked": [
          null,
          825,
          null,
          null
        ]
      }
    }
  },
  "success": true
}

Reporting/Revenue Reports

Reporting/Experiment Reporting

Reporting/Campaign Reports

Reporting/Health Check

Reporting/Ads.txt

Reporting/Utility

Reporting/Insights Hub/SSP Insights

Reporting/Insights Hub/Core Web Vitals

Reporting/Insights Hub/Ads.txt Insights

Reporting/Insights Hub/Live Insights

Reporting/Insights Hub/Metrics

Reporting/Insights Hub/Diagnostics

Reporting/Insights Hub/Revenue Insights

Reporting/Insights Hub/Revenue Analytics

Reporting/Insights Hub/Demand Mix

Reporting/Insights Hub/Benchmarking

Reporting

Organisation/Organisation Meta

Organisation/Pricing

Organisation

Ad Stack/Integration

Ad Stack

Publisher/Publisher Stack

Publisher/Publisher Tag

Publisher/Publisher Meta

Publisher/Experiment

Publisher/Config (Ad unit)

Publisher/App Placement

Publisher

AI/Activity

AI

Billing/Invoice

Audit Log

[IN PROGRESS] Integration/Mapping

[IN PROGRESS] Integration

[IN PROGRESS] User/Account

/report/insight/demand-mix/dimension

Authorizations

Query Parameters

Response