> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adriel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Data reference

> Metrics, breakdowns, refresh cadence, and limits for the Kakao Moment data source in Adriel.

## 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-sources/g-n/kakao-moment/how-to-connect).

## 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

<Note>
  **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.
</Note>

### Performance

<Note>
  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.
</Note>

| Metric               | Description                                       | Data type  | API Key                                  |
| -------------------- | ------------------------------------------------- | ---------- | ---------------------------------------- |
| Ad spend (excl. VAT) | Pre-VAT spend as returned by Kakao.               | Currency   | `cost`                                   |
| Ad spend (incl. VAT) | Reported spend with Korean 10% VAT applied.       | Currency   | *Adriel-computed (cost × 1.1)*           |
| Impressions          | Number of times the ads were shown.               | Number     | `imp`                                    |
| Clicks               | Ad clicks.                                        | Number     | `click`                                  |
| Clicks (all)         | Total clicks; equal to Clicks for this connector. | Number     | `click`                                  |
| Reach                | Unique users who saw the ad at least once.        | Number     | `reach`                                  |
| CTR                  | Click-through rate.                               | Percentage | *Adriel-computed (clicks ÷ impressions)* |
| CPC                  | Cost per click.                                   | Currency   | *Adriel-computed (spend ÷ clicks)*       |

### Video

| Metric      | Description       | Data type | API Key     |
| ----------- | ----------------- | --------- | ----------- |
| Video views | Video play count. | Number    | `videoView` |

### Conversion

<Note>
  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.
</Note>

| Metric           | Description                                                | Data type  | API Key                                      |
| ---------------- | ---------------------------------------------------------- | ---------- | -------------------------------------------- |
| Conversions      | Attributed actions matching the defined conversion events. | Number     | *Resolved from conversion-key mapping*       |
| Conversion value | Monetary value of attributed conversions.                  | Currency   | *Resolved from conversion-value mapping*     |
| Revenue (Pixel)  | Revenue rolled up from Pixel-attributed purchases.         | Currency   | `conv_purchase_p_7d`                         |
| ROAS             | Return on ad spend.                                        | Ratio      | *Adriel-computed (conversion value ÷ spend)* |
| CPA              | Cost per action.                                           | Currency   | *Adriel-computed (spend ÷ conversions)*      |
| CVR              | Conversion rate.                                           | Percentage | *Adriel-computed (conversions ÷ clicks)*     |

### Budget and configuration

| Metric       | Description                                                                     | Data type | API Key                |
| ------------ | ------------------------------------------------------------------------------- | --------- | ---------------------- |
| Daily budget | Configured daily budget on the campaign or ad group.                            | Currency  | `dailyBudgetAmount`    |
| Bid strategy | Configured bid strategy on the campaign or ad group.                            | Text      | `bidStrategy`          |
| Objective    | Campaign objective.                                                             | Text      | `objective.detailType` |
| Status       | Campaign, ad group, or creative status, mapped from Kakao's Korean status text. | Text      | `statusDescription`    |

### Campaign structure metadata

| Metric          | Description                        | Data type | API Key                          |
| --------------- | ---------------------------------- | --------- | -------------------------------- |
| Ad account name | Name of the ad account.            | Text      | `name`                           |
| Campaign name   | Campaign name.                     | Text      | `name`                           |
| Ad group name   | Ad group (ad set) name.            | Text      | `name`                           |
| Creative name   | Creative (ad) name.                | Text      | `name`                           |
| Channel         | Channel where the ad is published. | Text      | *Resolved from channel metadata* |

### UTM tracking

<Note>
  **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.
</Note>

| Metric       | Description                      | Data type | API Key                          |
| ------------ | -------------------------------- | --------- | -------------------------------- |
| UTM Source   | Parsed `utm_source` parameter.   | Text      | *Adriel-parsed from landing URL* |
| UTM Medium   | Parsed `utm_medium` parameter.   | Text      | *Adriel-parsed*                  |
| UTM Campaign | Parsed `utm_campaign` parameter. | Text      | *Adriel-parsed*                  |
| UTM Content  | Parsed `utm_content` parameter.  | Text      | *Adriel-parsed*                  |
| UTM Term     | Parsed `utm_term` parameter.     | Text      | *Adriel-parsed*                  |

## Breakdowns

### Campaign structure

| Breakdown | Description                           | API Key    |
| --------- | ------------------------------------- | ---------- |
| Campaign  | Group by campaign.                    | `campaign` |
| Ad group  | Group by ad group (mapped to ad set). | `adSet`    |
| Creative  | Group by creative (ad).               | `ad`       |
| Channel   | Group by channel ID.                  | `channel`  |

### Audience and delivery

<Note>
  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.
</Note>

| Breakdown       | Description                                           | API Key             |
| --------------- | ----------------------------------------------------- | ------------------- |
| Age             | Audience age range.                                   | `age`               |
| Gender          | Audience gender.                                      | `gender`            |
| Age + gender    | Combined age and gender bucket.                       | `ageGender`         |
| Device target   | Mobile or PC.                                         | `deviceTarget`      |
| Placement       | Where the ad ran — KakaoTalk, Daum, or partner sites. | `platformPlacement` |
| Hour of day     | Hourly breakdown.                                     | `hourOfDay`         |
| Location        | Geographic region within Korea.                       | `location`          |
| Creative format | Banner, video, or native.                             | `creative`          |

### Time and date grouping

<Note>
  Kakao returns daily records; Adriel aggregates them into these views for reporting.
</Note>

| Breakdown | Description                      |
| --------- | -------------------------------- |
| Daily     | Split reports by day.            |
| Weekly    | Split reports by week.           |
| Monthly   | Split reports by calendar month. |

## 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

* [How to connect Kakao Moment to Adriel](/data-sources/g-n/kakao-moment/how-to-connect) (paired how-to)
* [Kakao Message data reference](/data-sources/g-n/kakao-message/data-reference) — for KakaoTalk channel message ads
* [Kakao Keyword Ads data reference](/data-sources/g-n/kakao-keyword-ads/data-reference) — for Kakao's search-keyword advertising platform