카카오 키워드광고 연동

카카오 키워드광고는 현재 출시 예정 상태로, 대시보드에서 연동을 진행할 수 없습니다. 아래는 출시 후 연동 절차 안내입니다.

adstage에서는 카카오 키워드광고(Kakao Keyword Ads)에서 발생한 캠페인 파라미터를 추적하고 전환 성과를 분석할 수 있습니다. 또한 비용 연동으로 운영 중인 캠페인의 비용 데이터를 adstage 대시보드에서 조회할 수 있습니다.

카카오 키워드광고 연동 화면은 adstage 대시보드 연동 > 광고 채널 연동 > Kakao Keyword Ads에서 확인할 수 있으며, 채널 연동과 비용 연동 두 개의 탭으로 구성됩니다.

1. 채널 연동

채널 연동 탭에서는 카카오 키워드광고의 추적 URL 기능을 통해 캠페인 파라미터를 추적합니다.

카카오 키워드광고는 추적 템플릿이나 매크로를 지원하지 않습니다. 대신 추적 URL 기능을 활성화하면 랜딩 URL에 추적 파라미터가 자동으로 추가됩니다.

설정 단계

단계	설명
1. 추적 URL 설정	카카오 키워드광고 캠페인 설정에서 `추적 URL` 항목을 `설정`으로 선택합니다. 캠페인 파라미터를 추적하려면 추적 URL 기능을 활성화해야 합니다.
2. 웹 SDK 설치	광고 트래픽이 유입되는 웹페이지(랜딩 페이지)에 adstage 웹 SDK를 설치합니다.
3. URL 쿼리 매핑 설정	웹 SDK의 URL 쿼리 매핑 기능을 사용하여 카카오 키워드광고가 추가한 파라미터를 adstage 파라미터에 매핑합니다.
4. 딥링크 설정(선택)	랜딩 페이지에 앱 설치·딥링크 버튼이 있다면 SDK와 연결하여 웹-투-앱 전환을 추적합니다.

웹 SDK 설치 방법은 아래 가이드에서 확인할 수 있습니다.

adstage 웹 SDK 설치하기

URL 쿼리 매핑 권장 설정

웹 SDK의 URL 쿼리 매핑 기능에 아래와 같이 설정하면 카카오 키워드광고가 추가한 파라미터를 adstage 파라미터로 매핑할 수 있습니다.

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"
}

자동 추가 추적 파라미터

추적 URL 기능을 활성화하면 카카오 키워드광고가 랜딩 URL에 아래 파라미터를 자동으로 추가합니다.

파라미터	설명
`utm_source`	마케팅 소스(고정값 "kakao")
`utm_medium`	링크 유형(고정값 "keyword")
`utm_campaign`	프리미엄 링크 유형
`utm_term`	사용자 검색어
`k_campaign`	캠페인 ID
`k_adgroup`	광고 그룹 ID
`k_keyword`	등록된 키워드
`k_keyword_id`	키워드 ID
`k_creative`	소재 ID
`k_rank`	광고 노출 순위

2. 비용 연동

비용 연동 탭에서는 카카오 키워드광고 캠페인의 비용 데이터를 adstage로 수집합니다.

항목	설명
수집 지표	비용(채널), 클릭수(채널), 노출수(채널)
수집 범위	업데이트 당일을 제외한 최근 30일 비용 데이터(D-30 ~ D-1)
수집 주기	4시간마다(KST 1시, 5시, 9시, 13시, 17시, 21시)

비용 연동 활성화하기

비용 연동 탭에서 비용 데이터 수집을 활성화합니다. 활성화하기 전에는 연동 계정을 추가할 수 없습니다.
연동 계정 추가를 클릭하면 카카오 계정 인증(OAuth) 창이 열립니다. 카카오 키워드광고를 운영하는 카카오 계정으로 로그인하고 권한을 승인합니다.
인증이 완료되면 해당 계정으로 접근 가능한 광고 계정 목록이 다이얼로그에 표시됩니다. 연동할 광고 계정을 선택한 뒤 연동을 완료합니다.

카카오 키워드광고 비용 연동을 사용하려면 카카오 개발자센터에서 keyword_management 권한이 필요합니다. 권한이 없으면 광고 계정 목록을 불러올 수 없습니다.

연동 계정 관리하기

연동을 완료하면 광고 계정 목록 표에서 연동 상태를 확인할 수 있습니다.

항목	설명
광고 계정	연동된 광고 계정의 이름과 ID
상태	비용 연동의 현재 상태
최근 데이터 업데이트	비용 데이터가 마지막으로 수집된 시각
카카오 계정	인증에 사용한 카카오 계정 이메일 또는 비즈니스 이름
관리	연동 계정 삭제

3. 주의사항

카카오 키워드광고는 추적 템플릿·매크로를 지원하지 않으므로, 추적 URL 기능과 웹 SDK의 URL 쿼리 매핑을 함께 사용해야 합니다.
추적 파라미터를 추적하려면 랜딩 페이지에 adstage 웹 SDK가 반드시 설치되어 있어야 합니다.
비용 연동을 사용하려면 카카오 개발자센터에서 keyword_management 권한이 필요합니다.
카카오 키워드광고와 adstage 간에 수치 차이가 발생할 수 있습니다. 이는 집계 시점, 타임존, 필터링 기준의 차이 때문입니다.

카카오 키워드광고 연동

목차