kadam_adv_get_stats
Read-only
Retrieve advertiser statistics with support for custom reports, per-site analytics, and conversion logs, using flexible metrics and groupings.
Instructions
Advertiser statistics. reportType: 'custom' (default, report builder), 'sites' (per-site), or 'conversions' (event log). For custom reports use names like 'spend,clicks,ctr' (metrics) and 'day,campaign,country' (groupBy).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reportType | No | custom | |
| period | No | 7days | |
| dateFrom | No | ||
| dateTo | No | ||
| page | No | ||
| perPage | No | ||
| sortBy | No | ||
| sortOrder | No | ||
| groupBy | No | Comma-separated groupings, e.g. 'day,campaign,country' (incl. campaign_group). Unknown names are reported back. | |
| metrics | No | Comma-separated metric names, e.g. 'spend,clicks,ctr,cpa,conversions,income,roi' (income = profit). Unknown names are reported back; see report-dimensions for the full list. | spend,clicks,impressions,ctr |
| campaignIds | No | ||
| countries | No | ||
| creativeIds | No | ||
| view | No | all | |
| searchQuery | No | ||
| conversionTypes | No | Comma-separated conversion type IDs (for reportType=conversions) | |
| folderIds | No | Comma-separated campaign group (folder) IDs (for reportType=conversions) | |
| audienceIds | No | Comma-separated audience IDs (for reportType=conversions) | |
| timezone | No | Timezone offset in hours (for reportType=conversions) |