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

# How to connect

> How to connect the Kakao Moment data source to Adriel: authorize a Kakao Business account, select an ad account, and import the campaign hierarchy.

Kakao Moment is Kakao's display and social advertising platform, serving banner, video, and native ads across KakaoTalk, Daum, and Kakao partner sites. Connecting it imports the campaign hierarchy and daily performance from the Kakao Moment OpenAPI v4, including ad-account-level segmentation breakdowns.

Kakao Moment is distinct from Kakao Keyword Ads (search) and from Kakao Message (KakaoTalk channel messaging), which require separate connections. Cost data is reported in Korean won (KRW); workspaces using a different display currency receive auto-converted values.

## Before you connect

The following are required:

* A Kakao Business account with admin access to the Kakao Moment ad account.
* Permission to grant the connector read access to ad data via Kakao Business OAuth.
* A live Kakao Pixel on the destination site or app, if conversion data is to be imported.
* A separate connection for Kakao Keyword Ads or Kakao Message, if those surfaces are also in use.

## Connect Kakao Moment

<Steps>
  <Step title="Give Adriel access to the Kakao Moment account">
    On the **Data Sources** page, search for **Kakao Moment** and select it. Sign in to the Kakao Moment account in the pop-up window, then allow Adriel to access the account.
  </Step>

  <Step title="Select the ad account">
    On the data source settings, choose the **Ad account** to connect. Choose one ad account per data source.
  </Step>

  <Step title="Submit">
    Click **Submit** to complete the connection. Initial data availability can take up to one business day, after which 365 days of historical data are available.
  </Step>
</Steps>

## What gets imported

The connector imports the campaign hierarchy from ad account to campaign to ad group (ad set) to creative, along with daily performance metrics including impressions, clicks, spend (both pre-VAT and with 10% Korean VAT applied), CTR, CPC, and video views. Conversion events configured on the Kakao account are imported as individual metrics. Ad-account-level segmentations cover age, gender, age + gender, device target, placement (KakaoTalk, Daum, partner sites), hour of day, location within Korea, and creative format.

For the complete list of metrics, breakdowns, and limits, see the [Kakao Moment data reference](/data-sources/g-n/kakao-moment/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Dashboard data lags the Kakao Moment UI">
    Report data is cache-only and refreshes on a layered schedule. The most recent hours may not be reflected until the next scheduled refresh.
  </Accordion>

  <Accordion title="Kakao Keyword Ads data does not appear">
    Kakao Keyword Ads and Kakao Moment are separate connectors with separate authentication scopes. Add a Kakao Keyword Ads connection to import that data.
  </Accordion>

  <Accordion title="Demographic and placement breakdowns missing at lower levels">
    Age, gender, age + gender, device target, placement, hour of day, location, and creative-format breakdowns are returned by the Kakao Moment API only at the ad-account level. Splitting them by campaign, ad set, or ad is not supported.
  </Accordion>

  <Accordion title="Ad spend differs between two cost metrics">
    Cost is exposed both pre-VAT (as Kakao returns it) and with 10% Korean VAT applied. Choose the variant that matches the accounting source being compared.
  </Accordion>

  <Accordion title="Authentication expired">
    Re-establish the connection from **Connections > Kakao Moment > Reconnect** to refresh credentials.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Kakao Moment data reference" href="/data-sources/g-n/kakao-moment/data-reference">
    Metrics, breakdowns, and limits for Kakao Moment.
  </Card>

  <Card title="Kakao Moment FAQs" href="/data-sources/g-n/kakao-moment/faqs">
    Common questions and expected behaviors for the Kakao Moment data source.
  </Card>

  <Card title="How to connect Kakao Keyword Ads" href="/data-sources/g-n/kakao-keyword-ads/how-to-connect">
    Connect Kakao search advertising.
  </Card>

  <Card title="How to connect Kakao Message" href="/data-sources/g-n/kakao-message/how-to-connect">
    Connect KakaoTalk channel message ads.
  </Card>
</CardGroup>