Data reference

​

Introduction

Adform is a global independent advertising technology platform offering DSP, ad serving, and audience tools for display, video, and rich media campaigns. The connector pulls campaign performance from the Adform Buyer Stats API, with breakdowns and metrics discovered dynamically from Adform’s metadata endpoints so the available field set always reflects the current API surface. As a marketing connector, metrics, breakdowns, and currencies are standardized so widgets can aggregate across sources without additional configuration. To connect this data source, see How to connect Adform to Adriel.

​

Data refresh strategy

​

Architecture data

Architecture covers advertisers, campaigns, line items or orders, and creatives. It is discovered dynamically through Adform’s stats metadata APIs at data source creation and refreshed alongside reports.

​

Reports data

Reports include daily performance for advertisers, campaigns, line items, and creatives. Simple cache. Report data is fetched once per day and the cache is fully refreshed. Dashboards read from this cache rather than querying Adform on demand. Refresh schedule. Reports refresh once daily at 1:00 AM UTC. Each refresh pulls a fixed 397-day historical window in a single request; because date is not driven by the dashboard, the entire window is always re-fetched.

​

Architecture levels

Advertiser → Campaign → Line item / Order → Creative (Banner / Adgroup)

​

Date range limits

The Adform connector always operates over a fixed 397-day historical window. Queries that span dates outside this window return no data for the missing range, and the dashboard date range does not change the window that is fetched.

​

Metrics

Metrics are discovered dynamically from Adform’s v1/buyer/stats/metadata/metrics endpoint at data source creation, so the available set reflects what the connected Adform account exposes. Metrics with sub-specifications are expanded into compound entries of the form {metricTitle}_{specTitle}_{valueTitle}. The commonly used set includes:

​

Reach & impressions

​

Click performance

​

Cost & spend

​

Engagement

​

Video performance

​

Conversion performance

​

Breakdowns

Breakdowns are discovered dynamically from Adform’s v1/buyer/stats/metadata/dimensions endpoint, with a maximum of 8 selected per data source.

​

Campaign structure

​

Creative

​

Device & browser

​

Audience

​

Placement

​

Time

​

Limitations

• Hard 8 breakdown / 10 metric cap — Adform’s Stats API enforces a maximum of 8 breakdowns and 10 metrics per data source (Adform Reporting Stats API). Selecting more raises an error and the data source is not created. To report on a wider field set, create multiple data sources.
• Some breakdowns and metrics are blocked — a subset of breakdowns and metrics is excluded because their compatibility with other fields cannot be reliably determined. Picking a blocked breakdown surfaces a “breakdown not available” error; picking a blocked metric surfaces a “metrics not available” error. Certain breakdown selections also dynamically exclude incompatible metrics from the picker before submission.
• Fixed 397-day window — each fetch always pulls a 397-day history, and the report query is not influenced by the dashboard date range (Adform Reporting Stats API). Data outside this window is not available.
• Deleted elements are not provided — once an element is removed from Adform, it is no longer returned by the connector.
• Reports are generated asynchronously — very large report requests may take time to build before data is available.

​

API references

• Adform API documentation

​

See also

• How to connect Adform to Adriel (paired how-to)
• Adform FAQs — common questions about Adform data source behavior