Kakao Keyword Ads Integration

Kakao Keyword Ads is currently scheduled for release, and the integration cannot be set up from the dashboard yet. The procedure below describes how to integrate it after release.

In adstage, you can track campaign parameters generated by Kakao Keyword Ads and analyze conversion performance. In addition, with cost integration you can view the cost data of running campaigns in the adstage dashboard.

You can find the Kakao Keyword Ads integration screen in the adstage dashboard under 연동 > 광고 채널 연동 > Kakao Keyword Ads, which consists of two tabs: 채널 연동 and 비용 연동.

1. Channel Integration

In the 채널 연동 tab, campaign parameters are tracked through Kakao Keyword Ads' tracking URL feature.

Kakao Keyword Ads does not support tracking templates or macros. Instead, when you enable the tracking URL feature, tracking parameters are automatically appended to the landing URL.

Setup Steps

Step	Description
1. Set up tracking URL	In the Kakao Keyword Ads campaign settings, set the `추적 URL` option to `설정`. To track campaign parameters, you must enable the tracking URL feature.
2. Install the web SDK	Install the adstage web SDK on the web page (landing page) where ad traffic arrives.
3. Configure URL query mapping	Use the web SDK's URL query mapping feature to map the parameters added by Kakao Keyword Ads to adstage parameters.
4. Set up deep links (optional)	If the landing page has an app install or deep link button, connect it to the SDK to track web-to-app conversions.

You can find instructions on how to install the web SDK in the guide below.

Install the adstage web SDK

Recommended URL Query Mapping Settings

If you configure the web SDK's URL query mapping feature as shown below, you can map the parameters added by Kakao Keyword Ads to adstage parameters.

urlQueryMapping: {
  campaign: "utm_campaign",
  campaign_id: "k_campaign",
  ad_group_id: "k_adgroup",
  term: ["k_keyword", "utm_term"],
  term_id: "k_keyword_id",
  creative_id: "k_creative"
}

Automatically Added Tracking Parameters

When the tracking URL feature is enabled, Kakao Keyword Ads automatically adds the following parameters to the landing URL.

Parameter	Description
`utm_source`	Marketing source (fixed value "kakao")
`utm_medium`	Link type (fixed value "keyword")
`utm_campaign`	Premium link type
`utm_term`	User search term
`k_campaign`	Campaign ID
`k_adgroup`	Ad group ID
`k_keyword`	Registered keyword
`k_keyword_id`	Keyword ID
`k_creative`	Creative ID
`k_rank`	Ad exposure rank

2. Cost Integration

In the 비용 연동 tab, the cost data of Kakao Keyword Ads campaigns is collected into adstage.

Item	Description
Collected metrics	Cost (channel), clicks (channel), impressions (channel)
Collection range	Cost data for the last 7 days (D-6 to D-0)
Collection interval	Every 4 hours (KST 0:00, 4:00, 8:00, 12:00, 16:00, 20:00)

Enabling Cost Integration

In the 비용 연동 tab, enable 비용 데이터 수집. You cannot add an integration account before enabling it.
When you click 연동 계정 추가, the Kakao account authentication (OAuth) window opens. Log in with the Kakao account that runs Kakao Keyword Ads and approve the permissions.
Once authentication is complete, the list of ad accounts accessible with that account is displayed in the dialog. Select the ad account you want to integrate and complete the integration.

To use Kakao Keyword Ads cost integration, you need the keyword_management permission in the Kakao Developers center. Without this permission, the ad account list cannot be loaded.

Managing Integration Accounts

Once the integration is complete, you can check the integration status in the ad account list table.

Item	Description
Ad account	Name and ID of the integrated ad account
Status	Current status of the cost integration
Last data update	The time cost data was last collected
Kakao account	The Kakao account email or business name used for authentication
Manage	Delete the integration account

3. Notes

Since Kakao Keyword Ads does not support tracking templates or macros, you must use the tracking URL feature together with the web SDK's URL query mapping.
To track tracking parameters, the adstage web SDK must be installed on the landing page.
To use cost integration, you need the keyword_management permission in the Kakao Developers center.
Discrepancies in numbers may occur between Kakao Keyword Ads and adstage. This is due to differences in aggregation timing, time zone, and filtering criteria.

Kakao Keyword Ads Integration

Table of Contents