Skip to main content

​
Introduction

Kakao Moment is the display advertising platform run by Kakao, the operator of KakaoTalk, Korea’s dominant messaging app. It serves banner, video, and native ads across KakaoTalk, Daum, and Kakao’s partner sites. The connector queries the Kakao Moment OpenAPI v4 for campaign, ad group, and creative performance, with eight segmentation breakdowns covering age, gender, device, region, hour of day, placement, and creative format. KakaoTalk channel message ads are handled by the separate Kakao Message data source, and Kakao’s search-keyword advertising is handled by Kakao Keyword Ads. 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 Kakao Moment to Adriel.

​
Data refresh strategy

​
Architecture data

Architecture covers ad accounts, campaigns, ad groups, and creatives. It refreshes twice daily at 4:00 PM UTC and 5:00 AM UTC. On data source creation, the cache fills with 365 days of historical architecture data at the ad account, campaign, ad set, and ad levels.

​
Reports data

Reports include daily performance metrics for ad accounts, campaigns, ad sets, and ads. Cache-only. Report data comes from cached daily performance snapshots. When a dashboard is opened, the response is composed by aggregating the most recent snapshots. Uniqueness caveat. Metrics based on uniqueness, such as reach, can be overvalued when viewed across a date range longer than one day. Refresh schedule. Reports refresh on three layered schedules:
  • 6:00 AM UTC and 8:00 AM UTC — sync the last 1 day for campaign, adSet, and ad
  • 5:00 PM, 12:00 AM, 2:00 AM, and 4:00 AM UTC — sync the last 24 days for campaign, adSet, and ad
  • 9:00 PM UTC — syncs the last 24 days for campaign, adSet, and ad, and for the ad-account-level breakdowns hourOfDay, age, gender, location, deviceTarget, creative, and ageGender
Data is considered reliable within the cache sync period. Data outside this range may be incomplete or not fully accurate due to legacy caching behavior.

​
Architecture levels

Ad account → Campaign → Ad group (ad set) → Creative (ad)

​
Date range limits

The connector enforces a maximum look-back window per date-breakdown granularity. Report queries are fetched from the source in day-level chunks, and only day grouping is supported at the report level; weekly and monthly views are aggregated by Adriel from the daily data.

​
Attribution windows

Kakao Moment conversion metrics are reported across attribution windows. Pixel and SDK conversion events are imported in 1-day and 7-day variants where the platform provides them. For example, a purchase event is exposed as both a 1-day and a 7-day count (purchase_1D and purchase_7D), each producing a separate metric variant.

​
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 cost is the literal Kakao Moment API field name. Italic text describes how a value is produced when it does not map cleanly to a single API field.

​
Performance

Currency values are reported in KRW; if the ad account currency differs from the workspace currency, spend is converted using the current day’s exchange rate.

​
Video

​
Conversion

Conversion events tracked in the ad account are imported automatically and only appear on the dashboard when the underlying event is active. For each imported event, Adriel also derives ROAS, CPA, and conversion rate.

​
Budget and configuration

​
Campaign structure metadata

​
UTM tracking

UTM values are parsed by Adriel, not returned by Kakao. Adriel reads the UTM query parameters from each ad’s configuration and landing URL and exposes them as both metrics and breakdowns.

​
Breakdowns

​
Campaign structure

​
Audience and delivery

These segmentation breakdowns are available only at the ad-account level; splitting them by campaign, ad group, or creative is not supported by the Kakao Moment API.

​
Time and date grouping

Kakao returns daily records; Adriel aggregates them into these views for reporting.

​
Limitations

  • 12-month data guarantee — access is guaranteed for the most recent 12 months. Older data relies on the legacy cache and may be incomplete or unavailable.
  • No deleted-data retrieval — when an element is deleted in the ad account, its data can no longer be retrieved and is missing from reports.
  • Ad-account-level segmentation only — age, gender, age + gender, device target, placement, hour of day, location, and creative-format breakdowns cannot be split by campaign, ad group, or creative.
  • Uniqueness metrics — reach and other uniqueness-based metrics can be overvalued across date ranges longer than one day.
  • Day grouping only — report data can only be grouped by day at the source; other granularities are aggregated by Adriel.
  • Sponsored-brand ads unsupported — sponsored-brand ad types are not yet supported by the Kakao Moment API and are skipped.

​
API references

  • Kakao Moment OpenAPI v4 — https://apis.moment.kakao.com/openapi/v4
  • Authentication: Kakao Business OAuth 2.0 (Bearer access token; legacy connections use the refresh-token flow)

​
See also