Introduction
Moloco is a mobile and CTV (Connected TV) programmatic advertising platform for app growth and performance marketing. The connector retrieves campaign performance across four hierarchy levels from the Moloco Cloud CM API v1, authenticated through a short-lived Bearer token exchanged from four user-supplied credentials. 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 Moloco to Adriel.Data refresh strategy
Architecture data
Architecture covers the ad account and its campaigns, ad sets, and ads. It 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. Cache-only. Report data comes from cached daily performance snapshots rather than live calls to Moloco. Dashboard values are composed from the last snapshot, so the most recent few hours of activity are not yet reflected, and metrics based on uniqueness (such as reach) can be overvalued across date ranges longer than one day. Initial fill. On data source creation, the cache fills with the last 730 days of daily data at the ad account, campaign, ad set, and ad levels. Refresh schedule. The cache refreshes every hour (UTC), syncing the last 60 days across the ad account, campaign, ad set, and ad levels. Data is considered reliable within the cache sync window. Older data may be incomplete or inaccurate due to legacy caching behavior.Architecture levels
Ad account → Campaign → Ad set → Ad The ad set level maps to the Moloco API’sAD_GROUP_ID, and the ad level maps to CREATIVE_ID.
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
impressions is the literal Moloco API field or Adriel cell key. Italic text describes how a value is produced when it doesn’t map cleanly to a single API field.Performance
Video engagement
Conversions
Installs and conversions are exposed under Moloco’s
conversions:moloco_reports:* namespace, which keeps them distinct from the generic conversion metrics on other connectors.Breakdowns
Standard hierarchy
Time grouping
Moloco returns daily records; Adriel groups them into these views for reporting. Each grouping has its own maximum date range (see Date range limits).
Limitations
- No platform breakdowns — Moloco reports support only the account, campaign, ad-set, and ad hierarchy plus date groupings. Audience, device, geographic, and placement breakdowns are not available.
- Cache-only delivery — reports are served from scheduled snapshots, not on-demand pulls, so the most recent few hours of activity are not yet reflected. Reach across long date ranges can be overvalued, as with any cache-only connector.
- Slower wide ad-level queries — ad-level (per-creative) reports are fetched in smaller date chunks than higher levels because the Moloco API enforces a tighter range limit for them, so wide ad-level date ranges can take longer to load.
API references
See also
- How to connect Moloco to Adriel (paired how-to)
- Amazon DSP data reference