Skip to main content

​
Introduction

Buzzvil is a Korean mobile lock-screen advertising network. The connector pulls campaign performance data across four hierarchy levels — ad account, campaign, ad set, and ad — from the Buzzvil public API, authenticated with a static API token issued by Buzzvil. 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 Buzzvil to Adriel.

​
Data refresh strategy

​
Architecture data

Architecture covers the ad account, campaigns, ad sets, and ads. The hierarchy refreshes twice daily, at 4:00 PM (UTC) and 5:00 AM (UTC).

​
Reports data

Reports include daily performance for the ad account, campaigns, ad sets, and ads. Real-time. Report data is fetched from Buzzvil on demand when a dashboard loads, so the latest values are always visible. On top of that, a scheduled hourly sync (UTC) refreshes the last 30 days for the ad account, campaign, ad set, and ad levels. Long-range queries are fetched in chunks of up to 100 days.

​
Architecture levels

Ad account → Campaign → Ad set → Ad The ad account level is synthesized by Adriel — Buzzvil does not natively expose an ad-account hierarchy — so that widgets can group by ad account consistently with other marketing connectors.

​
Date range limits

​
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 impression is the literal Buzzvil report field name. Italic text describes how a value is produced when it doesn’t map cleanly to a single API field.

​
Reach & impressions

​
Click performance

​
Cost & efficiency

Currency values are reported in the account currency read from the first ad group at connection time and pinned to the data source.

​
Engagement

​
Conversion performance

​
Breakdowns

Buzzvil supports grouping by hierarchy level and by date. It does not expose audience, device, placement, or geographic segmentation breakdowns.

​
Ad structure

The ad account breakdown groups by the single ad account Adriel synthesizes per data source, since Buzzvil has no native ad-account level.

​
Time & date

​
Limitations

  • No segmentation breakdowns — Buzzvil exposes no audience, device, placement, or geographic breakdowns. Only hierarchy and date grouping are available.
  • Synthetic ad account level — Buzzvil has no native ad-account hierarchy; Adriel synthesizes one ad account per data source so data can be grouped consistently with other connectors.
  • Currency captured once at connect time — the reporting currency is read from the first ad group during connection setup and pinned to the data source. If the underlying account currency changes upstream, reconnect the data source to pick up the new value.
  • Missing conversion fields — the four conversions:buzzvil:* engagement fields are taken directly from the raw report row; when absent they are reported as undefined rather than zero.
  • Deleted elements not provided — data for campaigns or ad sets deleted upstream is not returned; a deleted item encountered during a report fetch is surfaced as a soft-error row and the rest of the query continues.
  • No conversion value — Buzzvil reports conversion counts but not conversion value, so revenue- and ROAS-style metrics are not available.

​
API references

  • Buzzvil public API base endpoint: https://ad.buzzvil.com/api/public/
  • Connection validation and asset discovery use the Buzzvil adgroups endpoint.

​
See also