> ## 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 Keyword Ads data source to Adriel: sign in with a Kakao Business account, choose an account, and import keyword performance.

Kakao Keyword Ads is the search-keyword advertising platform operated by Kakao, alongside Naver Search Ads and Google Ads as one of the three pillars of Korean search advertising. Connecting it imports keyword-level performance, the full campaign hierarchy, and Kakao Pixel conversion events into Adriel dashboards. Cost 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 Keyword Ads account being connected.
* Permission to grant the connector read access to keyword data through Kakao Business OAuth.
* A live Kakao Pixel on the destination site or app, if conversion data should be imported.

## Connect Kakao Keyword Ads

<Steps>
  <Step title="Open the data source">
    On the **Data Sources** page, search for **Kakao Keyword Ads** and select it.
  </Step>

  <Step title="Sign in to Kakao Business">
    Sign in to the Kakao Business account in the pop-up window and grant the requested read permissions.
  </Step>

  <Step title="Choose the account">
    On the data source settings, choose the **Account ID** to connect.
  </Step>

  <Step title="Submit">
    Click **Submit** to complete the connection. Initial data availability can take up to one business day.
  </Step>
</Steps>

## What gets imported

The connector imports the full campaign hierarchy (ad account → campaign → ad group → ad → keyword), daily performance metrics (impressions, clicks, cost, and derived rates), and Kakao Pixel conversion events across both 1-day and 7-day attribution windows. Breakdowns cover device target, placement, hour of day, and date. Cost is exposed in two variants — with and without 10% Korean VAT — so widgets can match either accounting convention.

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

## Troubleshooting

<AccordionGroup>
  <Accordion title="Ad-set queries return TOO_MUCH_DATA_REQUESTED">
    Kakao's API does not accept aggregate queries spanning all campaigns at once. Ad-set-level widgets without a campaign filter can exceed the API's query limit on large accounts. Add a campaign filter to the widget to resolve.
  </Accordion>

  <Accordion title="Ad spend differs between the two cost metrics">
    Two cost metrics are exposed: one with 10% Korean VAT included and one without. Both reflect what Kakao reports. Choose the variant that matches the figures being compared.
  </Accordion>

  <Accordion title="Connection auto-disconnects after reconnecting">
    If the reconnecting Kakao account does not have access to the original ad account, Kakao returns a no-permission error and the connection is disconnected automatically. Reconnect using a Kakao account with access to the same ad account.
  </Accordion>

  <Accordion title="Hourly breakdown returns no data beyond 62 days">
    Kakao enforces a 62-day maximum lookback when hour-of-day breakdown is requested. Daily-granularity queries can go much further back.
  </Accordion>

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

## Related

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

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

  <Card title="How to connect Kakao Moment" href="/data-sources/g-n/kakao-moment/how-to-connect">
    Connect Kakao's display advertising platform.
  </Card>

  <Card title="How to connect Naver Search Ads" href="/data-sources/g-n/naver-search-ads/how-to-connect">
    Connect a comparable Korean search advertising platform.
  </Card>
</CardGroup>