> ## 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 KakaoTalk Channel data source in Adriel.

## Introduction

KakaoTalk Channel (카카오톡 채널) is a Korean messaging platform used by businesses and creators to reach followers on KakaoTalk. This connector tracks follower (friend) counts on public KakaoTalk channels, refreshed on a 4-hour cadence.

Unlike marketing connectors, KakaoTalk Channel is a public connector — no OAuth is required. A connection is created by supplying one channel ID per asset, and friend-count data is read from the public KakaoTalk channel profile page.

To connect this data source, see [How to connect KakaoTalk Channel to Adriel](/data-sources/g-n/kakaotalk-channel/how-to-connect).

## Data refresh strategy

### Architecture data

Each data source tracks a single public KakaoTalk channel, identified by its channel ID. To track multiple channels, a separate data source is created for each.

### Reports data

This connector follows a simple-cache pattern: every 4 hours, data for each connected channel is re-fetched and the cache is overwritten. The refresh runs at 30 minutes past the hour, every 4 hours (UTC).

There is no historical backfill. Unlike marketing connectors, KakaoTalk Channel does not retroactively load historical data on connection. Data accumulates day-by-day starting from the date the channel is connected.

## Architecture levels

Data source → Channel

## 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 `friendCount` is the literal field name the connector exposes.
</Note>

### Followers

| Metric             | Description                                                                        | Data type | API Key            |
| ------------------ | ---------------------------------------------------------------------------------- | --------- | ------------------ |
| Friend count       | Total number of followers of the channel at the time of fetch.                     | Number    | `friendCount`      |
| Friend count delta | Change in friend count versus the previous day's cached value, computed by Adriel. | Number    | `friendCountDelta` |
| Row count          | Number of rows returned in the current query.                                      | Number    | `rowCount`         |

Both `friendCount` and `friendCountDelta` are aggregated as sum.

## Breakdowns

### Channel

| Breakdown    | Description                        | API Key       |
| ------------ | ---------------------------------- | ------------- |
| Channel name | Display name of the Kakao channel. | `channelName` |
| Channel ID   | Unique channel ID.                 | `channelId`   |
| Date         | Split reports by day.              | `date`        |

### Time

<Note>
  Kakao returns channel-level daily counts; Adriel groups those records into these time views.
</Note>

| Breakdown           | Description       |
| ------------------- | ----------------- |
| Daily breakdown     | Split by day.     |
| Monthly breakdown   | Split by month.   |
| Quarterly breakdown | Split by quarter. |

## Limitations

* **Public scrape, no OAuth** — this is a public connector. There is no authentication step at connection or refresh time; only the channel ID is needed.
* **No historical backfill** — historical follower counts prior to the connection date are not available. Data begins accumulating from the moment the channel is connected.
* **Friend count delta computed server-side** — `friendCountDelta` is not returned by Kakao. It is computed by Adriel as the difference between the current fetch's `friendCount` and the previous day's cached value.
* **Channel-only granularity** — the KakaoTalk Channel data model has no campaign or ad hierarchy, only channel-level daily counts. Breakdowns beyond date and channel are not applicable.

## See also

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