Reporting API
Api

Birleşik istatistik raporu

Tek uç nokta, tek satır biçimi: `{ dimensions, metrics }`. - metrics: views, spending, clicks (geçerli/bot-filtrelenmiş), conversions, revenue. - dimensions: genel toplam için boş bırakın; `date` granülerliğe göre kovalara ayırır; bir varlık boyutu (campaign|ad|keyword) isteğe bağlı olarak date ile birleştirilebilir. - keyword yalnızca toplamdır ve views/spending/clicks destekler (conversions/revenue değil). - `date` unix epoch saniyedir (UTC, kova başlangıcı). Topluluk verisi kapsam dışıdır.

GET
/v1/report
AuthorizationBearer <token>

In: header

Query Parameters

from*string

Başlangıç (dahil, ISO 8601)

to*string

Bitiş (dahil, ISO 8601). En fazla 90 gün.

metrics*array<>

Virgülle ayrılmış. örn. views,spending,clicks,conversions,revenue

dimensions?array<>

Virgülle ayrılmış kırılım. Tek genel-toplam satırı için boş bırakın. 'date' granülerliğe göre kovalara ayırır; bir varlık boyutu (campaign|ad|keyword) date ile birleştirilebilir (keyword hariç, o yalnızca toplamdır).

granularity?string

Yalnızca dimensions içinde 'date' varken kullanılır.

campaign_id?number

Sahip olunan tek bir kampanya id ile sınırla

ad_id?number

Sahip olunan tek bir reklam id ile sınırla

page?
limit?

Sayfa başına en fazla satır (sunucu tarafında sınırlanır).

Response Body

application/json

curl -X GET "https://example.com/v1/report?from=2026-06-01T00%3A00%3A00Z&to=2026-06-30T23%3A59%3A59Z&metrics=views%2Cspending%2Cclicks"

{  "meta": {    "granularity": "daily",    "dimensions": [      "campaign",      "date"    ],    "metrics": [      "views",      "spending",      "clicks"    ],    "total": 240,    "page": 1,    "limit": 500,    "has_more": false  },  "data": [    {      "dimensions": {        "date": 1780617600,        "campaign_id": 10,        "name": "Summer Launch"      },      "metrics": {        "views": 52100,        "spending": 3421.1,        "clicks": 88      }    }  ]}