Data reference - Adriel Knowledge Base

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.

Breakdown	Max range
Daily	93 days
Weekly	1 year
Monthly	2 years

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 columnsData type uses Adriel’s 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; where the same raw field name is shared across objects (Kakao returns name for the ad account, ad, ad set, and campaign), it’s shown qualified as object.field (for example account.name) so each row stays unique; italic marks a value Adriel computes, parses, or derives. Some raw fields back several rows — for example cost backs both spend metrics and click backs both click metrics — so the same key can appear more than once; that’s the shared source field, not a duplicated entry.

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.

Basic

Metric	Description	Data type	API Key
Result Indicator	The metric Kakao Moment uses to represent the result for the campaign objective.	Text	Adriel-derived
Results	The results recorded for the campaign’s configured objective.	Text	Adriel-derived

Campaign Attributes

Metric	Description	Data type	API Key
Ad Account Name	The name of the Kakao Moment ad account.	Text	`account.name`
Ad Name	The name of the Kakao Moment ad.	Text	`ad.name`
Ad Set Name	The name of the Kakao Moment ad group.	Text	`adset.name`
Ad Spend	The amount spent on Kakao Moment ads during the reporting period, before VAT.	Currency	`cost`
Bid Cap	The bid amount configured for the selected ad groups.	Currency	`bidAmount`
Bid Strategy	The bidding strategies configured for the selected ad groups.	Text	`bidStrategy`
Budget	The configured daily budget for the selected campaign or ad group.	Currency	`dailyBudgetAmount`
Campaign Name	The name of the Kakao Moment campaign.	Text	`campaign.name`
Creative Type	The format of the ad creative.	Text	Adriel-side
Creative URL	The image or landing URLs associated with the ad creative.	URL	`image.url`, `messageElement.thumbnailUrl`, `messageElement.buttonAssetGroups.mobileLandingUrl`, `messageElement.buttonAssetGroups.pcLandingUrl`, `messageElement.itemAssetGroups.mobileLandingUrl`, `messageElement.itemAssetGroups.pcLandingUrl`
Daily Budget	The daily budget amount configured for the selected campaign or ad group.	Currency	`dailyBudgetAmount`
Ends	The scheduled end date of the campaign or ad group.	Date	Adriel-side
Is Active	Whether the campaign, ad group, or ad is currently active.	Text	Adriel-side
Landing URL	The destination URLs people can reach from the ads.	URL	`landingInfo.url`, `landingUrl`, `pcLandingUrl`, `mobileLandingUrl`, `rspvLandingUrl`, `messageElement.buttonAssetGroups.mobileLandingUrl`, `messageElement.buttonAssetGroups.pcLandingUrl`, `messageElement.itemAssetGroups.mobileLandingUrl`, `messageElement.itemAssetGroups.pcLandingUrl`
Lifetime Budget	The total lifetime budget configured for the selected campaign or ad group.	Currency	Adriel-side
Objective	The marketing objectives configured for the selected campaigns.	Text	`objective.detailType`, `campaignTypeGoal.goal`
Starts	The scheduled start date of the campaign or ad group.	Date	Adriel-side
Status	The current delivery status of the selected campaign, ad group, or ad.	Text	`statusDescription`
Status Text	The delivery status label for the campaign, ad group, or ad.	Text	Adriel-side
UTM Campaign	The UTM campaign values attached to the ad landing URLs.	Text	Adriel-parsed
UTM Content	The UTM content values attached to the ad landing URLs.	Text	Adriel-parsed
UTM Medium	The UTM medium values attached to the ad landing URLs.	Text	Adriel-parsed
UTM Source	The UTM source values attached to the ad landing URLs.	Text	Adriel-parsed
UTM Term	The UTM term values attached to the ad landing URLs.	Text	Adriel-parsed

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

Campaign Structure

Metric	Description	Data type	API Key
Ad Account ID	The Kakao Moment identifier of the ad account.	Text	`ad_account_id`
Ad ID	The Kakao Moment identifier of the ad.	Text	`creative_id`
Ad Set ID	The Kakao Moment identifier of the ad group.	Text	`ad_group_id`
Campaign ID	The Kakao Moment identifier of the campaign.	Text	`campaign_id`
Channel	The advertising channel where the ads are published.	Text	Adriel-derived

Computed Metric

These are calculated by Adriel from other metrics; they have no single underlying Kakao Moment field.

Metric	Description	Data type	API Key
ROAS	Return on ad spend — conversion value divided by spend.	Ratio	Adriel-computed

Conversion Performance

Metric	Description	Data type	API Key
Revenue	The purchase revenue attributed within Kakao Pixel or SDK measurement.	Currency	`conv_purchase_p_7d`

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.

Creative Attributes

Metric	Description	Data type	API Key
Creative Image	The unique visual identifier of the ad creative image.	Text	Adriel-side

Impression Click Performance

Metric	Description	Data type	API Key
Clicks (All)	The total number of clicks recorded on the ads.	Number	`click`
CPC	Cost per click — spend divided by clicks.	Currency	Adriel-computed
CPM	Cost per thousand impressions.	Currency	Adriel-computed
CTR	Click-through rate — clicks divided by impressions.	Percentage	Adriel-computed
Impressions	The number of times the ads were shown.	Number	`imp`
Link Clicks	The number of clicks recorded on the ads.	Number	`click`

Kakao Moment-specific

These metrics exist only for Kakao Moment and aren’t part of any cross-connector category. Every group above is a standard category shared with other connectors.

Metric	Description	Data type	API Key
Ad Spend(incl. VAT)	The amount spent on Kakao Moment ads during the reporting period, including 10% VAT.	Currency	`cost`

Breakdowns

Basic

Breakdown	Description	API Key
Channel	Groups results by advertising channel.	Adriel-assigned

Campaign Structure

Breakdown	Description	API Key
Ad Name	Groups results by ad name.	Adriel-side
Ad Set Name	Groups results by ad group name.	Adriel-side
Campaign Name	Groups results by campaign name.	Adriel-side
Platform	Groups results by the platform where the ads were delivered.	Adriel-side
Status	Groups results by the current delivery status of the selected entities.	Adriel-side

Creatives

Adriel post-processes ad creatives to generate these breakdowns.

Breakdown	Description	API Key
Ad Copy	Groups results by words detected in the creative content.	Adriel-side
Color Clustering	Groups results by the dominant color cluster detected in the creative.	Adriel-side
Creative Image	Groups results by the hashed signature of the creative image.	Adriel-side
Emoji Analysis	Groups results by emojis detected in the creative content.	Adriel-side
Facebook Creative Image	Groups results by the creative image asset.	Adriel-side

Date

Kakao returns daily records; all time-grouping breakdowns are Adriel-side aggregations of the same underlying daily data.

Breakdown	Description	API Key
Auto Time Breakdown	Groups results by the automatically selected time granularity for the date range.	Adriel-side
Daily Breakdown	Groups results by day.	Adriel-side
Hourly Breakdown	Groups results by hour of day.	`hour`
Monthly Breakdown	Groups results by month.	Adriel-side
Quarterly Breakdown	Groups results by quarter.	Adriel-side
Week Date Breakdown	Groups results by the starting date of each week.	Adriel-side
Week Number Breakdown (W#)	Groups results by week number in the year.	Adriel-side
Weekly Breakdown (Start: Mon)	Groups results by calendar week.	Adriel-side
Weekly Breakdown (Start: Sun)	Groups results by Sunday-to-Saturday week.	Adriel-side
Yearly Breakdown	Groups results by year.	Adriel-side

Others

Breakdown	Description	API Key
No Grouping	Returns all selected results in a single group.	Adriel-side

Kakao Moment-specific

These breakdowns exist only for Kakao Moment and aren’t part of any cross-connector category. Every group above is a standard category shared with other connectors.

Breakdown	Description	API Key
Ad	Groups results by Kakao Moment ad.	`creative_id`
Ad Account	Groups results by Kakao Moment ad account.	`ad_account_id`
Ad Set	Groups results by Kakao Moment ad group.	`ad_group_id`
Age	Groups results by the audience age band.	`age_band`
Age/Gender	Groups results by combined audience age band and gender.	`age_band`, `gender`
Campaign	Groups results by Kakao Moment campaign.	`campaign_id`
Creative	Groups results by the creative format.	`creative_format`
Creative Description	Groups results by the descriptive text used in the creative, such as alt text.	`altText`
Creative Headline	Groups results by the title text used in the creative when one is available.	`messageElement.title`
Device Target	Groups results by the targeted device type.	`device_type`
Gender	Groups results by the audience gender.	`gender`
Location	Groups results by the audience location.	`location`
Placement	Groups results by the placement where the ad was delivered.	`placement`

Audience and delivery breakdowns — Age, Age/Gender, Gender, Device Target, Location, and Placement — are available only at the ad-account level; splitting them by campaign, ad group, or creative is not supported by the Kakao Moment API.

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)

​Introduction

​Data refresh strategy

​Architecture data

​Reports data

​Architecture levels

​Date range limits

​Attribution windows

​Metrics

​Basic

​Campaign Attributes

​Campaign Structure

​Computed Metric

​Conversion Performance

​Creative Attributes

​Impression Click Performance

​Kakao Moment-specific

​Breakdowns

​Basic

​Campaign Structure

​Creatives

​Date

​Others

​Kakao Moment-specific

​Limitations

​API references

​See also

Introduction

Data refresh strategy

Architecture data

Reports data

Architecture levels

Date range limits

Attribution windows

Metrics

Basic

Campaign Attributes

Campaign Structure

Computed Metric

Conversion Performance

Creative Attributes

Impression Click Performance

Kakao Moment-specific

Breakdowns

Basic

Campaign Structure

Creatives

Date

Others

Kakao Moment-specific

Limitations

API references

See also