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
1
Open the data source
On the Data Sources page, search for Kakao Keyword Ads and select it.
2
Sign in to Kakao Business
Sign in to the Kakao Business account in the pop-up window and grant the requested read permissions.
3
Choose the account
On the data source settings, choose the Account ID to connect.
4
Submit
Click Submit to complete the connection. Initial data availability can take up to one business day.
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.Troubleshooting
Ad-set queries return TOO_MUCH_DATA_REQUESTED
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.
Ad spend differs between the two cost metrics
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.
Connection auto-disconnects after reconnecting
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.
Hourly breakdown returns no data beyond 62 days
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.
Authentication expired
Authentication expired
Re-establish the connection from Connections > Kakao Keyword Ads > Reconnect to refresh credentials.
Related
Kakao Keyword Ads data reference
Metrics, breakdowns, and limits for Kakao Keyword Ads.
Kakao Keyword Ads FAQs
Common questions and expected behaviors for the Kakao Keyword Ads data source.
How to connect Kakao Moment
Connect Kakao’s display advertising platform.
How to connect Naver Search Ads
Connect a comparable Korean search advertising platform.
