Globale Statistiken API

Dieser Abschnitt beschreibt die Anfrageparameter und Ergebnisdaten der Global Statistics API.

Die Routen der Statistik-API wurden umbenannt:

• /statistics/advertiser/... -> /statistics/a/...
• /statistics/publisher/... -> /statistics/p/...

Die Global Statistics API zeigt übersprungene RTB-Abfragen nur für Datum, Sites, Zonen, Länder, Regionen und Sub-IDs an.

Parameter	Beschreibung	Hinweise	Typ
count	Nur die Gesamtsumme der Ergebnisse zurückgeben.	Ganzzahl	optional
detailliert	Falls möglich, mehr Details abrufen.	Ganzzahl	optional
Zeitzone	Zeitzoneneinstellung für den Filter 'hour' und 'group_by'	Zeichenfolge	optional
Gesamtsummen	Gibt an, ob Gesamtsummen zur Antwort hinzugefügt werden sollen oder nicht.	Ganzzahl	optional
Filter	Filter zur Einschränkung der zurückgegebenen Werte einer Statistikanfrage	Objekt	optional
group_by	Eine Liste von group_by-Werten, die in den Daten angewendet werden sollen. Maximal vier sind erlaubt.	Array	erforderlich
order_by	Sortierung der Ergebnisse nach einem bestimmten Feld bzw. bestimmten Feldern. Maximal zwei sind erlaubt.	Array	optional
Projektion	Einzelne Unterstrukturen, die ein Benutzer in der Antwort zurückerhalten möchte.	Array	optional
limit	Die Anzahl der Datensätze, die in dieser Antwort zurückgegeben werden sollen.	Ganzzahl	optional
offset	Die Position, ab der die Datensätze abgerufen werden sollen.	Ganzzahl	optional

Parameter „count“

Eigenschaft	count
Typ	optional
Variablentyp	Ganzzahl
Standardwert	0
Verfügbare Werte	[0, 1]
Beschreibung	Nur die Gesamtsumme der Ergebnisse zurückgeben.

Beispiel:

{
    "count": 1
}

Parameter „detailed“

Eigenschaft	detailliert
Typ	optional
Variablentyp	Ganzzahl
Standardwert	0
Verfügbare Werte	[0, 1]
Beschreibung	Ob detaillierte Informationen zurückgegeben werden sollen oder nicht.

Beispiel:

{
    "detailed": 1
}

Parameter „timezone“

Zeitzoneneinstellung für hour Filter und group_by.

Eigenschaft	Zeitzone
Typ	optional
Variablentyp	Zeichenfolge
Standardwert	America/New_york
Verfügbare Werte	Zeitzonenfeld von /collections/timezones festlegen
Beschreibung	HINWEIS: Zeitzonen sind nur relevant, wenn wir anhand stündlicher Daten abfragen; für nicht stündliche Daten ist dies ohne Wirkung.

Beispiel:

{
    "timezone": "Europe/Dublin"
}

Parameter „totals“

Eigenschaft	Gesamtsummen
Typ	optional
Variablentyp	Ganzzahl
Standardwert	0
Verfügbare Werte	[0,1]
Beschreibung	Gibt an, ob Gesamtsummen zur Antwort hinzugefügt werden sollen oder nicht.

Beispiel:

{
    "totals": 1
}

Parameter „filter“

Eigenschaft	Filter
Typ	optional
Variablentyp	Objekt
Verfügbare Option für Werbetreibende	[”adblock”, ”advertiser_ad_type_id”, “browser_id”, “carrier_id”, “category_id”, “country_iso”, “date_from”, “date_to”, “device_id”, “device_type_id”, hour”, “language_id”, “operating_system_id”, “region_id”, “site_hostname”, “site_id”, “size”, “sub”, “zone_id”, “campaign_group_id”, “campaign_id”, “exclude_deleted”, “offer_id”, “offer_landing_page_id”, “variation_id”]
Verfügbare Option für Publisher	[”adblock”, “browser_id”, “carrier_id”, “category_id”, “country_iso”, “date_from”, “date_to”, “device_id”, “device_type_id”, “hour”, “language_id”, “operating_system_id”, “region_id”, “site_hostname”, “site_id”, “zone_id”, “publisher_ad_type_id”, “size”, “sub”]
Beschreibung	Nach bestimmten Parametern filtern.

Filter: country_iso

Eigenschaft	country_iso
Typ	optional
Variablentyp	Zeichenfolge
Standardwert	-
Verfügbare Werte	Siehe die Eigenschaft iso3 des Endpunkts /collections/countries
Beschreibung	Liste der ISO-3-Codes

Beispiel:

{
    "filter": {
        "country_iso": ["ESP", "IRL"]
    }
}

Filter date_from, date_to

Die date_from und date_to Die Parameter steuern das Zeitfenster, über das Sie Statistikinformationen abrufen möchten.

• date_from: Datum ab Bereich für Statistiken, (Standard: Monatsanfang),
• date_to: Datum bis Bereich für Statistiken, (Standard: heute)

Eigenschaft	date_from, date_to
Typ	optional
Variablentyp	Zeichenfolge
Standardwert	Die Datumswerte sind standardmäßig der aktuelle Monat.
Verfügbare Werte	YYYY-mm-dd
Beschreibung	Datumsbereich von/bis für Statistiken. Format YYYY-mm-dd

Beispiel:

{
    "filter": {
        "date_from": "2019-02-25",
        "date_to": "2019-02-28"
    }
}

Zeitzonen sind nur relevant, wenn wir anhand stündlicher Daten abfragen; für nicht stündliche Daten ist dies ohne Wirkung.

Filter: advertiser_ad_type_id, campaign_group_id, campaign_id, browser_id, carrier_id, category_id, device_id, device_type_id, language_id, offer_id, offer_landing_page_id, operating_system_id, hour, region_id, site_id, sub, variation_id, zone_id, publisher_ad_type_id

Eigenschaft	advertiser_ad_type_id, campaign_group_id, campaign_id, browser_id, carrier_id, category_id, device_id, device_type_id, language_id, offer_id, offer_landing_page_id, operating_system_id, hour, region_id, site_id, sub, variation_id, zone_id, advertiser_ad_type_id, publisher_ad_type_id
Typ	optional
Variablentyp	Array
Elementtyp	Ganzzahl
Standardwert	-
Verfügbare Werte	Relative Eigenschaften ODER Sammlungen
Beschreibung	Liste der Entitäts-IDs

Beispiel:

{
    "filter": {
        "campaign_id": [123, 456],
        "browser_id": [789]
    }
}

Filter: exclude_deleted

Eigenschaft	exclude_deleted
Typ	optional
Variablentyp	Ganzzahl
Standardwert	0
Verfügbare Werte	[0, 1]
Beschreibung	Ob gelöschte Kampagnen ausgeschlossen werden sollen oder nicht.

Beispiel:

{
    "filter": {
        "exclude_deleted": 1
    }
}

Filter: adblock

Eigenschaft	adblock
Typ	optional
Variablentyp	Zeichenfolge
Standardwert	"all"
Verfügbare Werte	"adblock", "all", "standard"
Beschreibung	Ob Adblock-Zonen einbezogen werden sollen oder nicht.

Beispiel:

{
    "filter": {
        "adblock": "standard"
    }
}

Filter: site_hostname

Eigenschaft	site_hostname
Typ	optional
Variablentyp	Zeichenfolge
Standardwert	-
Verfügbare Werte	Gültige Zeichen für Hostnamen sind die Buchstaben a bis z, die Ziffern 0 bis 9, Bindestrich und Punkt.
Beschreibung	Nach dem Site-Hostname filtern.

Beispiel:

{
    "filter": {
        "site_hostname": ["www.example.com", "www.example-site.org"]
    }
}

Filter: size

Eigenschaft	size
Typ	optional
Variablentyp	Zeichenfolge
Standardwert	-
Verfügbare Werte	Gültige Zeichen für die Größe sind die Ziffern 0 bis 9 und das Zeichen x. Beispiel 300x100
Beschreibung	Nach Größe filtern

Beispiel:

{
    "filter": {
        "size": ["300x100"]
    }
}

Parameter „group_by“

Eigenschaft	group_by
Typ	erforderlich
Variablentyp	Array
Elementtyp	Zeichenfolge
Standardwert	-
Verfügbare Werte für Werbetreibende	[”adblock”, “advertiser_ad_type_id”, browser_id”, “idcampaign_group“, “campaign_id”, “carrier_id”, “category_id”, “country_iso”, “date”, “hour”, “device_id”, “device_type_id”, “language_id”, “operating_system_id”, “region_id”, “site_id”, “sub”, “zone_id”, “week”, “month”, “quarter”, “year”, “offer_id”, “offer_landing_page_id”, “site_hostname”, “size”, “variation_id”]
Verfügbare Werte für Publisher	[“adblock”, “browser_id”, “carrier_id”, “category_id”, “country_iso”, “date”, “device_id”, “device_type_id”, “hour”, “language_id”, “operating_system_id”, “publisher_ad_type_id” “region_id”, “site_id”, “size”, “sub”, “zone_id”, “week”, “month”, “quarter”, “year”]
Beschreibung	Eine Liste von Unteranfragen, um zusätzliche Daten in die Antwort aufzunehmen.

Beispiel:

{
  "group_by": [
    "browser",
    "date"
  ]
}

Parameter „order_by“

Eigenschaft	order_by
Typ	optional
Variablentyp	Array
Elementtyp	Zeichenfolge
Standardwert	-
Verfügbare Feldwerte für Metriken	[“cpc”, “cpc”, “cpm”, “cpv”, “ctr”, “clicks”, “impressions”, “video_impressions”, “video_views”, “vtr”, “rtb_win_ratio”, “rtb_avg_total_time”, “rtb_skipped”, “rtb_bid_response_ratio”, “rtb_avg_cpm”, “rtb_timeouts_ratio”, “rt_errors_ratio”, “rtb_no_bid_ratio”, “rtb_skipped_ratio”]
Verfügbare Feldwerte abhängig von `group_by` für Werbetreibende	[”adblock”, “browser_id”, “campaign_id”, “carrier_id”, “category_id”, “country_iso”, “device_id”, “date”, “device_type_id”, “hour”, “ecpa1”, “g1”,“language_id”, “month”, “offer_id”, “offer_landing_page_id”, “operating_system_id”, “quarter”, “region_id”, “site_hostname”, “site_id”, “sub”, “variation_id”, “week”, “year” ,“zone_id”]
Verfügbare Feldwerte abhängig von `group_by` für Publisher	[“adblock”, “browser_id”, “carrier_id”, “category_id”, “country_iso”, “device_id”, “date”, “device_type_id” , “hour”, “language_id”, “month”, “operating_system_id”, “quarter”, “region_id”, “site_id”, “sub”, “week”, “year”, “zone_id”]
Verfügbare Sortierwerte	[“asc”, “desc”]
Beschreibung	Eine Liste verfügbarer Order-by-Optionen

Hinweise:

• Die Metrikfelder sind jederzeit verfügbar, um als Order-by-Feld verwendet zu werden.
• Um nach einem bestimmten Wert zu sortieren (zum Beispiel nach “browser_id”), müssen Sie ihn im Parameter “group_by” einschließen.

Die Werte “g1” und “ecpa1” sind nur verfügbar, wenn der Benutzer Conversion Tracking (Goals) hat. Alle Ziele sind mit einer Seriennummer (g1, g2, …gx) verknüpft. Die eCPA-Werte sind entsprechend ecpa1, ecpa2, …ecpax.

Beispiel:

{
  "order_by": [
    {
      "field": "impressions",
      "order": "desc"
    }
  ]
}

Beispiel zur chronologischen Sortierung der Kampagnenergebnisse muss „date“ sowohl in „group_by“ als auch in „order_by“ enthalten sein:

{
  "group_by": [
    "campaign_id",
    "date"
  ],
  "order_by": [
    {
      "field": "date",
      "order": "asc"
    }
  ]
}

Parameter „projection“

Der Parameter projection gibt an, was in der resultierenden Nutzlast zurückgegeben wird. Wenn nicht angegeben, werden alle Unterstrukturen zurückgegeben.

Eigenschaft	Projektion
Typ	optional
Variablentyp	Objekt
Elementtyp	Array
Standardwert	alle Optionen, siehe unten
Verfügbare Feldwerte für Werbetreibende	[“base”, “rtb”, “video”, “goals*”]
Verfügbare Feldwerte für Publisher	[“base”, “rtb”, “video”, “wpn”]

Einige „goal“-Felder, wie „profit“ und „roi“, werden auf Basis der Kampagnenkosten berechnet. Daher müssen Sie auch das Feld „base“ verwenden, wenn Sie die korrekten „goals“-Metriken erhalten möchten.

Beispiele:

Um als Werbetreibender alle möglichen Metriken zu erhalten, verwenden Sie:

{
    "projection": {
      "base": ["*"],
      "video": ["*"],
      "goals": ["*"],
      "rtb": ["*"]
    }
}

Um als Publisher alle möglichen Metriken zu erhalten, verwenden Sie:

{
    "projection": {
      "base": ["*"],
      "video": ["*"],
      "wpn": ["*"],
      "rtb": ["*"]
    }
}

Sie können die Metriken auch innerhalb jedes Projection-Feldes angeben:

{
    "projection": {
      "base": ["impressions","clicks","cost","revenue","cpc","cpm","ctr"],
      "video": ["impressions","views","cpv","vtr"],
      "rtb": ["total_time","queries","value","success","no_bid","skipped","errors","timeouts","wins","win_ratio"],
      //nur für Publisher
      "wpn": ["subscriptions","unsubscriptions","sent"]
    }
}

Das einzige Feld, das keine spezifische Metrikprojektion zulässt, ist "goals"

Parameter „limit“

Die Anzahl der Datensätze, die in dieser Antwort zurückgegeben werden sollen.

Eigenschaft	limit
Typ	optional
Variablentyp	Ganzzahl
Standardwert	50

Beispiel:

{
    "limit": 25
}

Parameter „offset“

Die Position, ab der die Datensätze abgerufen werden sollen.

Eigenschaft	offset
Typ	optional
Variablentyp	Ganzzahl
Standardwert	0

Beispiel

{
    "offset": 150
}

Beispiel 1

Kampagnenstatistik des Werbetreibenden mit Filterung.

Anfrage:

{
    "detailed": true,
    "totals": 1,
    "filter": {
      "date_from": "2019-03-10",
      "date_to": "2019-03-11",
      "country_iso": ["USA"]
    },
    "group_by": ["campaign_id"],
    "order_by": [
      {
        "field": "campaign_id",
        "order": "desc"
      }
    ]
    "projection": {
        "base": ["*"],
        "video": ["*"],
        "rtb": ["*"]
      },
    "limit": 2,
    "offset": 0
  }

Antwort:

{
  "request_metadata": {
    "count": 4,
    "limit": 2,
    "offset": 0
  },
  "result": [
    {
      "clicks": 0,
      "cost": 1.3302,
      "cpc": 0,
      "cpm": 0.45586017820425,
      "ctr": 0,
      "group_by": {
        "campaign_id": {
          "active": "1",
          "campaign_ad_type_name": "Popunders",
          "id": "1234567",
          "name": "Ron Mainstream Campaign "
        }
      },
      "impressions": 2918,
      "rtb": {
        "avg_cpm": 0.15582967823432,
        "avg_total_time": 89.522714492492,
        "errors": 112,
        "errors_ratio": 0.011368411650186,
        "no_bid": 870594,
        "no_bid_ratio": 88.368490823053,
        "queries": 985186,
        "response_ratio": 11.57101298638,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 984590,
        "timeouts": 484,
        "timeouts_ratio": 0.049127778916875,
        "total_time": 88196525,
        "value": 1776.396,
        "win_ratio": 0.29842080581738,
        "wins": 2940
      },
      "video": {
        "cpv": 0,
        "impressions": 0,
        "views": 0,
        "vtr": 0
      }
    },
    {
      "clicks": 0,
      "cost": 18.1621655,
      "cpc": 0,
      "cpm": 1.8273634671496,
      "ctr": 0,
      "group_by": {
        "campaign_id": {
          "active": "1",
          "campaign_ad_type_name": "Popunders",
          "id": "7654321",
          "name": "Ron Mainstream Campaign Test"
        }
      },
      "impressions": 9939,
      "rtb": {
        "avg_cpm": 1.4753505300475,
        "avg_total_time": 88.777190144965,
        "errors": 46,
        "errors_ratio": 0.0014192869995779,
        "no_bid": 3209674,
        "no_bid_ratio": 99.031490893114,
        "queries": 3241064,
        "response_ratio": 0.8964340105595,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 3238728,
        "timeouts": 2290,
        "timeouts_ratio": 0.070655809326814,
        "total_time": 287732555,
        "value": 4286.48343,
        "win_ratio": 0.30665855410445,
        "wins": 9939
      },
      "video": {
        "cpv": 0,
        "impressions": 0,
        "views": 0,
        "vtr": 0
      }
    }
  ],
  "result_total": {
    "clicks": 0,
    "cost": 74.0473595,
    "cpc": 0,
    "cpm": 2.0864288391096,
    "ctr": 0,
    "impressions": 35490,
    "rtb": {
      "avg_cpm": 0.23441613972984,
      "avg_total_time": 87.995789332859,
      "errors": 539,
      "errors_ratio": 0.0049868154705264,
      "no_bid": 9771471,
      "no_bid_ratio": 90.405422546568,
      "queries": 10808501,
      "response_ratio": 9.5135301370653,
      "skipped": 0,
      "skipped_ratio": 0,
      "success": 10799741,
      "timeouts": 8221,
      "timeouts_ratio": 0.07606050089647,
      "total_time": 951102577,
      "win_ratio": 0.32861171035651,
      "wins": 35518
    },
    "video": {
      "cpv": 0,
      "impressions": 0,
      "views": 0,
      "vtr": 0
    }
  }
}

Beispiel 2

Werbetreibendenstatistik nach Datum für den aktuellen Monat, sortiert nach Impressionen.

Anfrage:

{
  "group_by": ["date"],
  "order_by": [
    {
      "field": "impressions",
      "order": "desc"
    }
  ]
  "projection": {
      "base": ["*"],
      "video": ["*"],
      "rtb": ["*"]
    }
}

Antwort:

{
  "request_metadata": {
    "count": 3,
    "limit": 50,
    "offset": 0
  },
  "result": [
    {
      "clicks": 0,
      "cost": 624.2439917,
      "cpc": 0,
      "cpm": 1.0978015474007,
      "ctr": 0,
      "group_by": {
        "date": {
          "date": "2019-03-02"
        }
      },
      "impressions": 568631,
      "rtb": {
        "avg_cpm": 0.31273156270632,
        "avg_total_time": 114.34705591799,
        "errors": 4143,
        "errors_ratio": 0.0076578188576312,
        "no_bid": 48085697,
        "no_bid_ratio": 88.8804144989,
        "queries": 54101567,
        "response_ratio": 10.971772776933,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 54021598,
        "timeouts": 75826,
        "timeouts_ratio": 0.14015490530986,
        "total_time": 6186354907,
        "value": 185634.35958,
        "win_ratio": 1.1633248996281,
        "wins": 629377
      },
      "video": {
        "cpv": 0,
        "impressions": 0,
        "views": 0,
        "vtr": 0
      }
    },
    {
      "clicks": 0,
      "cost": 622.1688691,
      "cpc": 0,
      "cpm": 1.1800128762878,
      "ctr": 0,
      "group_by": {
        "date": {
          "date": "2019-03-01"
        }
      },
      "impressions": 527256,
      "rtb": {
        "avg_cpm": 0.27775587567531,
        "avg_total_time": 118.91585420372,
        "errors": 2954,
        "errors_ratio": 0.0078196779097434,
        "no_bid": 32641750,
        "no_bid_ratio": 86.407573260111,
        "queries": 37776492,
        "response_ratio": 13.412992397494,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 37708708,
        "timeouts": 64830,
        "timeouts_ratio": 0.17161466448499,
        "total_time": 4492223815,
        "value": 140737.73563,
        "win_ratio": 1.4077723257099,
        "wins": 531807
      },
      "video": {
        "cpv": 0,
        "impressions": 0,
        "views": 0,
        "vtr": 0
      }
    },
    {
      "clicks": 0,
      "cost": 441.843491,
      "cpc": 0,
      "cpm": 0.96186339096399,
      "ctr": 0,
      "group_by": {
        "date": {
          "date": "2019-03-03"
        }
      },
      "impressions": 459362,
      "rtb": {
        "avg_cpm": 0.26462497173837,
        "avg_total_time": 116.9210100884,
        "errors": 2183,
        "errors_ratio": 0.0059889808787451,
        "no_bid": 32174177,
        "no_bid_ratio": 88.268681100486,
        "queries": 36450275,
        "response_ratio": 11.500815837466,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 36366256,
        "timeouts": 81836,
        "timeouts_ratio": 0.22451408116948,
        "total_time": 4261802971,
        "value": 110932.87869,
        "win_ratio": 1.2852029237091,
        "wins": 468460
      },
      "video": {
        "cpv": 0,
        "impressions": 0,
        "views": 0,
        "vtr": 0
      }
    }
  ]
}

Beispiel 3

Publisher-Statistik nach date und region_id, sortiert nach impressions.

Anfrage:

{
  "detailed": true,
  "filter": {
    "date_from": "2019-03-10",
    "date_to": "2019-03-11",
    "country_iso": ["USA"]
  },
  "group_by": ["date", "region_id"],
  "order_by": [
    {
      "field": "impressions",
      "order": "desc"
    }
  ],
  "projection": {
    "base": ["*"],
    "video": ["*"],
    "wpn": ["*"],
    "rtb": ["*"]
  }
  "limit": 30,
  "offset": 0
}

Antwort:

{
  "request_metadata": {
    "count": 2,
    "limit": 30,
    "offset": 0
  },
  "result": [
    {
      "clicks": 3087,
      "cpc": 0.033842716164561,
      "cpm": 0.069188574849649,
      "ctr": 0.20444155402072,
      "group_by": {
        "date": {
          "date": "2019-03-11"
        },
        "region_id": {
          "country_iso": "USA",
          "country_long_name": "Vereinigte Staaten von Amerika",
          "country_short_name": "Vereinigte Staaten",
          "id": 5332921,
          "name": "Kalifornien"
        }
      },
      "impressions": 1494954,
      "revenue": 104.4724648,
      "rtb": {
        "avg_cpm": 0,
        "avg_total_time": 0,
        "bid_response_ratio": 0,
        "errors": 0,
        "errors_ratio": 0,
        "no_bid": 0,
        "no_bid_ratio": 0,
        "queries": 0,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 0,
        "timeouts": 0,
        "timeouts_ratio": 0,
        "total_time": 0,
        "value": 0,
        "win_ratio": 0,
        "wins": 0
      },
      "video": {
        "cpv": 0.038451404048583,
        "impressions": 15013,
        "views": 2717,
        "vtr": 18.097648704456
      },
      "wpn": {
        "subscriptions": 0,
        "unsubscriptions": 0
      }
    },
    {
      "clicks": 3071,
      "cpc": 0.03151133555845,
      "cpm": 0.066658890819906,
      "ctr": 0.21153940205505,
      "group_by": {
        "date": {
          "date": "2019-03-10"
        },
        "region_id": {
          "country_iso": "USA",
          "country_long_name": "Vereinigte Staaten von Amerika",
          "country_short_name": "Vereinigte Staaten",
          "id": 5332921,
          "name": "Kalifornien"
        }
      },
      "impressions": 1436818,
      "revenue": 96.7713115,
      "rtb": {
        "avg_cpm": 0,
        "avg_total_time": 0,
        "bid_response_ratio": 0,
        "errors": 0,
        "errors_ratio": 0,
        "no_bid": 0,
        "no_bid_ratio": 0,
        "queries": 0,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 0,
        "timeouts": 0,
        "timeouts_ratio": 0,
        "total_time": 0,
        "value": 0,
        "win_ratio": 0,
        "wins": 0
      },
      "video": {
        "cpv": 0.036216808196108,
        "impressions": 14921,
        "views": 2672,
        "vtr": 17.907646940554
      },
      "wpn": {
        "subscriptions": 0,
        "unsubscriptions": 0
      }
    }
  ]
}

Beispiel 4

Publisher-Statistik nach site_id mit Projektion.

Anfrage:

{
  "detailed": true,
  "projection": {
    "base": ["*"],
    "video": ["*"],
    "wpn": ["*"],
    "rtb": ["*"]
  },
  "filter": {
    "date_from": "2019-03-10",
    "date_to": "2019-03-11",
    "country_iso": ["USA"]
  },
  "group_by": ["site_id"],
  "order_by": [
    {
      "field": "impressions",
      "order": "desc"
    }
  ],
  "limit": 30,
  "offset": 0
}

Antwort

{
  "request_metadata": {
    "count": 2,
    "limit": 30,
    "offset": 0
  },
  "result": [
    {
      "clicks": 14320,
      "cpc": 0.028298959692737,
      "cpm": 0.057945765404939,
      "ctr": 0.20476288186597,
      "group_by": {
        "site_id": {
          "id": "11223344",
          "name": "nice-example.com"
        }
      },
      "impressions": 6916414,
      "revenue": 405.2411028,
      "rtb": {
        "avg_cpm": 0,
        "avg_total_time": 0,
        "bid_response_ratio": 0,
        "errors": 0,
        "errors_ratio": 0,
        "no_bid": 0,
        "no_bid_ratio": 0,
        "queries": 0,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 0,
        "timeouts": 0,
        "timeouts_ratio": 0,
        "total_time": 0,
        "value": 0,
        "win_ratio": 0,
        "wins": 0
      },
      "video": {
        "cpv": 0.031519102652252,
        "impressions": 77041,
        "views": 12857,
        "vtr": 16.688516504199
      },
      "wpn": {
        "subscriptions": 0,
        "unsubscriptions": 0
      }
    },
    {
      "clicks": 14148,
      "cpc": 0.028769196296296,
      "cpm": 0.063791981699323,
      "ctr": 0.22173710048179,
      "impressions": 6314909,
      "revenue": 407.0265892,
      "rtb": {
        "avg_cpm": 0,
        "avg_total_time": 0,
        "bid_response_ratio": 0,
        "errors": 0,
        "errors_ratio": 0,
        "no_bid": 0,
        "no_bid_ratio": 0,
        "queries": 0,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 0,
        "timeouts": 0,
        "timeouts_ratio": 0,
        "total_time": 0,
        "value": 0,
        "win_ratio": 0,
        "wins": 0
      },
      "video": {
        "cpv": 0.036406671663685,
        "impressions": 65620,
        "views": 11180,
        "vtr": 17.037488570558
      },
      "wpn": {
        "subscriptions": 0,
        "unsubscriptions": 0
      }
    }
  ]
}