Skip to main content

​
Introduction

Simpli.fi is a programmatic advertising platform specializing in addressable, geo-fence, and site-list campaigns across display, video, CTV, and audio inventory. The connector exposes campaign-level performance — impressions, clicks, spend, conversions, and audience reach — from a Simpli.fi organization through its REST API. Two report modes are chosen when the data source is created and fixed thereafter. Campaign Stats returns a structured, paginated response across the campaign hierarchy. Custom Reports submits an asynchronous snapshot job and polls until a CSV result is ready. Each mode exposes a different metric and breakdown shape, so the exact fields available depend on the mode selected. As a marketing connector, metrics, breakdowns, and currency are standardized so widgets can aggregate alongside other ad-platform sources without additional configuration. To connect this data source, see How to connect Simpli.fi to Adriel.

​
Data refresh strategy

​
Architecture data

Organization, campaign, ad group, and ad metadata refresh alongside report data on the daily cache cycle. There is no separate architecture-only sync; the campaign hierarchy is rebuilt from the latest report snapshot.

​
Reports data

Simpli.fi is a daily-cache connector with a fixed warm window. Dashboard queries are served from the daily cache rather than fetched live on each load.
  • Initial fetch — after connection, the last 60 days of daily data are pulled into the cache.
  • Daily refresh — at 6:15 PM UTC, the latest 30 days of data are re-fetched and the cache is rewritten over that window.
Data older than the rolling 30-day window remains in the cache from earlier syncs and is not re-pulled. Late-arriving conversions or restated metrics that fall outside that window will not appear without a manual rebuild.

​
Architecture levels

Organization → Ad account → Campaign → Ad group → Ad / Creative

​
Metrics

How to read the columns Data type uses this vocabulary: Number, Currency, Percentage, Ratio, Duration, Date, Text, URL, Array, Boolean. API Key in code style like impressions is the literal Simpli.fi field name. Italic text describes how a value is produced when it doesn’t map cleanly to a single API field (for example, an Adriel-computed ratio or a column defined by a Custom Report).

​
Delivery & cost

​
Conversions

​
Video & engagement

Video and viewability metrics populate only when the underlying campaign runs video, CTV, or audio creative. Display-only campaigns leave these columns empty.

​
Addressable & geo

Geo-fence metrics populate only for addressable or geo-fence campaign types that track them.

​
Custom Report columns

​
Breakdowns

​
Account structure

​
Delivery & geography

​
Time & date grouping

Simpli.fi returns daily records; Adriel groups them into these views for reporting. All time-grouping breakdowns are Adriel-side aggregations of the same underlying daily data.

​
Custom Report columns

In Custom Reports mode, any non-metric column declared in the report definition is exposed as a breakdown for grouping.

​
Limitations

  • Two report modes, fixed per data source — Campaign Stats and Custom Reports are mutually exclusive and chosen at creation. Switching requires a new data source. Campaign Stats returns a structured paginated response; Custom Reports submits an asynchronous job and polls until the CSV snapshot is ready.
  • 30-day rolling refresh window — the daily 6:15 PM UTC sync only rewrites the most recent 30 days. Restatements and late-attributed conversions outside that window are not picked up on later runs; a manual rebuild is required to refresh deeper history.
  • 60-day historical backfill — only the last 60 days of daily data are loaded when a data source is created. Earlier dates are not available from the initial fetch; historical analysis beyond that range requires a Simpli.fi-side export.
  • Campaign-dependent metrics — geo-fence visit counts, viewability, and video completion metrics populate only when the underlying campaign type produces them.
  • API keys never expire — the App Key / User Key pair has no refresh lifecycle. Revoking the keys in Simpli.fi fails subsequent requests immediately until the connection is re-saved with replacement values.

​
API references

  • Simpli.fi platform — programmatic advertising platform
  • Simpli.fi REST API base URL: https://app.simpli.fi/api/ (Campaign Stats endpoint and Custom Report snapshot endpoints)

​
See also