카카오 키워드 광고

카카오 키워드 광고는 '추적 URL' 기능을 통해 광고 클릭 후 이동하는 최종 랜딩 URL에 입찰 키워드, 검색 키워드 등 개별 광고 클릭에 대한 정보를 파라미터로 제공하며, 해당 기능과 에어브릿지 웹 SDK의 'urlQueryMapping' 기능을 활용하여 카카오 키워드 광고의 전환 성과 측정을 지원하고 있습니다.

카카오 키워드 광고의 전환 성과 측정을 위해서는 광고의 랜딩 페이지에 반드시 에어브릿지 웹 SDK가 설치를 필수로 하며, 추가로 아래 3가지 설정이 필요합니다.

카카오 키워드 광고의 '추적 URL 기능' 설정
에어브릿지 웹 SDK 설치 및 urlQueryMapping 기능 설정
에어브릿지 웹 SDK의 setDownloads 또는 setDeeplinks 설정

주의하세요

카카오 키워드 광고는 '추적 템플릿(추적 경유 사이트)' 기능 및 '추적 매크로' 기능을 지원하지 않습니다.

설정 방법

1. '추적 URL' 기능 설정

카카오 키워드 광고 대시보드 내에서 성과 추적을 위한 캠페인의 '추적 URL' 기능을 설정합니다. 캠페인 레벨의 '추적 URL 기능'은 신규 캠페인 생성 시 [고급] 하위 메뉴에서 설정하거나 기존에 생성한 캠페인의 [수정] 메뉴에서도 설정할 수 있습니다.

'추적 URL' 기능을 설정하면, 키워드 광고 클릭 후 최종 랜딩 페이지의 URL에 카카오 키워드 광고에서 제공하는 모든 추적 파라미터가 자동으로 추가되며, 카카오 키워드 광고에서 제공하는 추적 파라미터의 종류는 다음과 같습니다.

명칭	파라미터명	설명
마케팅매체	utm_source	트래픽을 보내는 마케팅매체 구분값으로, 'kakao' 고정값이 맵핑
링크유형	utm_medium	트래픽이 발생된 링크의 유형으로, 'keyword' 고정값이 맵핑
캠페인유형	utm_campaign	프리미엄링크 타입값
검색어	utm_term	검색 영역에서 사용자가 검색한 검색어 (인코딩 방식: UTF-8)
캠페인 ID	k_campaign	캠페인ID
광고 그룹 ID	k_adgroup	광고그룹ID
매체 유형 및 구분	k_media	아래 2개의 게재지면 구분값 - PREMIUM_LINK_SEARCH - PREMIUM_LINK_CONTENT
키워드	k_keyword	광고플랫폼 등록 키워드 (인코딩 방식: UTF-8)
키워드ID	k_keyword_id	키워드 ID
키워드확장여부	k_keyword_type	0: 기본매칭, 1 : 고급매칭(확장)
검색어	k_query	검색 영역에서 사용자가 검색한 검색어 (인코딩 방식: UTF-8) utm_term과 동일값
소재ID	k_creative	광고소재관리에 저장된 소재 ID
광고그룹에 연결된 소재ID	k_creativelink	광고그룹에 연결된 소재연결 ID
광고순위	k_rank	노출된 광고의 광고 영역에서 순위

주의하세요

‘추적 URL’ 기능을 설정하면 위 목록에 있는 전체 파라미터가 URL에 추가됩니다. 최종 랜딩 페이지에 특정 파라미터만 선택해 추가할 수 없습니다.

또한, 키워드별 최종 랜딩 URL에 UTM 파라미터를 사용하고 있는 경우 카카오 검색 광고의 추적 URL 기능에 의해 UTM 파라미터가 중복으로 추가되게 됩니다. 추적 URL 기능을 정상적으로 사용하려면 키워드별 랜딩 URL의 UTM 파라미터를 제거하는 것을 권장드립니다.

2. 에어브릿지 웹 SDK 설치

아래 가이드에 따라 카카오 키워드 광고의 최종 랜딩 페이지에 에어브릿지 웹 SDK를 설치합니다.

에어브릿지 웹 SDK 설치하기

3. 'urlQueryMapping' 기능 설정

카카오 키워드 광고의 최종 랜딩 페이지의 URL에 추적 파라미터들이 추가되면, 'urlQueryMapping' 기능을 사용하여 해당 파라미터의 값들을 에어브릿지 캠페인 파라미터와 맵핑하는 코드를 추가합니다. 에어브릿지 웹 SDK의 'urlQueryMapping' 기능에 대한 더욱 자세한 설명은 아래 페이지에서 확인 가능합니다.

urlQueryMapping 자세히 보기

앞서 안내드린 카카오 키워드 광고에서 제공하는 추적 파라미터와 에어브릿지 캠페인 파라미터간의 맵핑 및 'urlQueryMapping' 설정은 아래 코드를 참고 부탁드리며, 필요에 따라서 일부 파라미터는 맵핑을 변경하셔도 무방합니다.

airbridge.init({
   app: "ablog",
   webToken: "YOUR_WEB_TOKEN",
   urlQueryMapping: {
      channel: "utm_source",
      campaign : "utm_campaign",
      campaign_id : "k_campaign",
      ad_group_id : "k_adgroup",
      ad_creative_id: "k_creative",
      content : "utm_content",
      term : ["k_keyword", "utm_term"],
      term_id : "k_keyword_id",
      medium : "utm_medium"
      sub_id_1 : "k_media"
   }
});

4. 'setDownloads' 또는 'setDeeplinks' 설정

웹사이트로 유입된 유저들의 Web To App 전환 성과를 측정하기 위해서는 에어브릿지 웹 SDK의 'setDownloads' 또는 'setDeeplinks' 설정이 필요합니다. 이는 웹사이트 내에서 앱 설치, 딥링크를 유도하는 버튼과 에어브릿지 웹 SDK를 연결하는 작업으로, 버튼 클릭 시 리다이렉트 및 성과 추적을 위한 정보를 에어브릿지 웹 SDK에서 처리하게 됩니다.

'setDownloads' 또는 'setDeeplinks' 설정을 위한 가이드는 아래 문서를 참고해주시기 바랍니다.

'추적 URL' 기능 사용 시 유의사항

카카오 키워드 광고에서 제공하는 '추적 URL' 기능 사용 시 다음과 같은 유의사항이 있습니다. 따라서 아래 유의사항들을 확인 후 선택적으로 활용하시기 바랍니다.

만약 아래 유의사항들로 인해 '추적 URL' 기능 활용이 어려운 경우, '추적 URL' 기능을 미설정하고, 에어브릿지 웹 SDK에서 제공하는 'utmParsing' 기능을 사용하여 직접 키워드 레벨에서 추가한 UTM 파라미터 값을 기준으로 성과 측정도 가능합니다.

utmParsing 자세히 보기

최종 랜딩 URL의 UTM 파라미터 중복

카카오 키워드 광고에서 제공하는 '추적 URL' 기능 사용 시 최종 랜딩 URL의 파라미터로 광고와 관련된 정보를 얻을 수 있지만 카카오에서 제공하는 모든 추적 파라미터가 추가되기 때문에 키워드 레벨의 최종 랜딩 URL에 직접 구성한 UTM 파라미터가 포함된 경우 최종 랜딩 URL에는 카카오에서 추가한 UTM 파라미터까지 중복으로 추가될 수 있습니다.

예를들면 아래와 같습니다.

최종 랜딩 URL 설정 :

https://www.airbridge.io?utm_source=kakao_sa&utm_campaign=brand_campaign

추적 URL 기능 설정 후 최종 랜딩 URL :

https://www.airbridge.io?utm_source=kakao_sa&utm_campaign=brand_campaign&utm_source=kakao&utm_medium=keyword&utm_campaign=PREMIUM_LINK&utm_term=mobileattribution&k_campaign=1280681628886&k_adgroup=17527256&k_media=PREMIUM_LINK_SEARCH&k_creative=207830190790615040&k_creativelink=207853640880037888&k_rank=15&k_keyword=%EA%B0%80%ED%9E%88%EB%A9%80%ED%8B%B0%EB%B0%A4&k_keyword_id=2424825294&k_keyword_type=0&k_query=mobileattribution

노란색 영역의 파라미터가 카카오 키워드 광고의 '추적 URL' 기능에 의해 자동으로 추가되는 파라미터입니다.

UTM 파라미터가 중복되면 UTM 파라미터의 위치에 따라서 파싱 및 기여 정보에 사용하는 파라미터가 결정됩니다. 에어브릿지의 'urlQueryMapping' 기능의 경우 중복되는 파라미터가 존재하면 앞에 위치한 값으로 기여 정보로 사용하게 되며, 만약 Google Analytics 등에서도 성과를 함께 확인하는 경우 파라미터가 중복되는 경우에 어떠한 값이 기여정보로 사용되는지는 별도로 확인이 필요합니다.

UTM 파라미터 커스텀 설정 불가

카카오 키워드 광고에서 제공하는 '추적 URL' 기능 설정으로 인해 추가되는 UTM 파라미터는 카카오 키워드 광고에 의해 어떤 값이 맵핑될지 규칙이 이미 정해져있기 때문에 원하는 값을 직접 설정할 수가 없습니다.

예) utm_source : 'kakao' 로 고정, utm_campaign : 카카오 키워드 광고의 프리미엄링크 타입값 , utm_medium : 'keyword' 로 고정

캠페인 성과 확인 시 캠페인 ID 값으로만 확인 가능

카카오 키워드 광고에서 제공하는 '추적 URL' 기능에서 제공하는 추적 파라미터들은 검색어 및 입찰 키워드 값들을 제외하고는 모두 ID 값으로 제공이 됩니다. (예. campaign_id, ad_group_id)

따라서 대시보드 내에서 성과 확인 시에도 카카오 키워드 광고에서 캠페인 설정 시에 입력한 값들이 아닌 ID 값으로만 확인이 가능합니다.

비용 연동

에어브릿지 대시보드에서 카카오 검색 광고 계정 로그인을 통해 캠페인을 운영 중인 계정의 비용 데이터를 연동하여 전환 성과와 함께 조회할 수 있습니다.

비용 연동을 통해서 조회할 수 있는 지표는 다음과 같습니다.

Metrics
- 노출수: Impressions (Channel)
- 클릭수: Clicks (Channel)
- 광고비용: Cost (Channel)

Groupby
- Event Datetime 필드
  - Event Date, Event Year, Event Month, Event Week, Event Day of the month, Event Day of the week, Event Hour
- 캠페인 파라미터
  - Channel, Campaign, Ad Group, Ad Term, Campaign ID, Ad Group ID, Ad Term ID, Ad Account ID

주의하세요

카카오 키워드 광고는 캠페인 단계에서 추적 URL을 설정하면 랜딩 URL에 사전 정의된 파라미터를 자동으로 추가합니다. 자세한 내용은 카카오 고객센터의 추적 URL 제공 파라미터 를 참고하시기 바랍니다.

설정하기

비용 연동을 설정하는 방법은 다음과 같습니다.

[ Integrated Ad Channels > 카카오 키워드 광고 > 비용 연동 ] 메뉴에서 카카오 키워드 광고 비용 연동 토글을 켭니다.
현재 카카오 키워드 광고 캠페인을 운영하고 있는 카카오 계정으로 로그인하고 접근권한을 허용합니다.
카카오 로그인을 성공적으로 마치면 에어브릿지 대시보드에 돌아와 연동할 카카오 키워드 광고 계정을 선택하여 연동을 완료합니다. 로그인한 계정에서 접근 가능한 광고 계정들 중 현재 연동이 완료된 상태의 광고 계정은 리스트에 노출되지 않습니다.
연동이 완료되면 연동된 광고 계정이 리스트에 추가되며, 연동 정보를 확인할 수 있습니다.
- 연동 직후에는 Waiting 상태로 표시됩니다. 이후 데이터 연동 스케줄에 맞춰 데이터가 동기화되면 Active 상태로 표시됩니다.

대시보드 설정 변경

대시보드에서 설정을 변경하는 경우 최근 수정일 및 해당 액션을 수행한 최근 수정 계정 정보가 표기되며, 화살표 아이콘을 클릭하여 해당 날짜 및 'Kakao.keywordad' 로 검색된 Activity History로 빠르게 이동할 수 있습니다.

중단하기

‘비용 연동 토글’을 비활성화하면 연동된 모든 광고 계정을 통한 비용 연동이 중단됩니다.
연동을 중지하는 시점부터 데이터를 가져오지 않으며, 연동 중단 이전의 데이터는 계속 확인할 수 있습니다.
연동된 광고 계정을 삭제하지 않은 상태로 '비용 연동' 토글만 비활성화하면 연동된 계정 정보는 저장됩니다.
이후 토글을 다시 활성화하면 저장되었던 계정 정보를 불러오며 별도의 로그인이 필요하지 않습니다.

연동 계정 삭제

잘못된 광고 계정을 연동했거나 해당 광고 계정으로 더이상 광고를 운영하지 않는 경우 연동된 광고 계정 테이블의 우측에 위치한 ['관리' > '삭제'] 를 클릭하여 광고 계정을 삭제할 수 있습니다.

광고 계정 추가

기존에 연동을 완료한 카카오 광고 계정 외에 다른 광고 계정을 추가하려는 경우 '카카오 로그인' 버튼을 클릭하여 카카오 광고 계정을 추가로 등록할 수 있습니다. 이후 과정은 비용 연동 설정과 동일합니다.

비용 데이터 참고사항

업데이트 주기

'카카오 키워드 광고 비용 연동' 토글이 활성화 상태에서 광고 계정 등록이 완료되면 비용 데이터 수집이 시작됩니다. 에어브릿지는 비용 데이터를 매일 KST(한국표준시간) 오전 12시(0시)부터 4시간 주기로 하루 총 6번(0시, 4시, 8시, 12시, 16시, 20시) 업데이트합니다. 주기마다 오늘(D-0)부터 6일 전(D-6)까지의 비용 데이터가 업데이트됩니다.

연동 상태

Waiting: 광고 계정 추가 후 4시간 간격의 업데이트가 진행되기 전까지의 대기 상태입니다. 비용 데이터 업데이트는 매일 4시간 간격으로(0시, 4시, 8시, 12시, 16시, 20시) 진행됩니다.
Active: 최근에 정상적으로 비용 데이터 업데이트가 완료되었으며, 가장 최근의 업데이트 완료 시간이 노출됩니다.
Error: 아래 상황 중 하나에 해당하는 경우, 비용 데이터가 정상적으로 업데이트되지 않습니다.
- 카카오 로그인 정보가 올바르지 않습니다
  - 로그인 에러로, 연동된 계정의 비밀번호 변경 등과 같은 이슈로 인해 발생합니다. 이슈 해결을 위해서는 해당 계정을 삭제 후 광고 계정을 다시 등록합니다.
- 카카오 API가 응답하지 않습니다
  - 가장 최근에 진행된 업데이트 작업에서 카카오 키워드 광고 API가 응답하지 않은 경우입니다.
Warning: 가장 최근에 진행된 업데이트 작업에서 데이터를 업데이트 시도하였으나 오늘 포함 최근 7일 동안 캠페인이 운영되지 않아 연동된 데이터가 없는 경우입니다.
Expired: 아래 상황 중 하나에 해당하는 경우, 비용 데이터가 정상적으로 업데이트되지 않습니다.
- 카카오 키워드 광고 연동 토큰이 만료된 경우
- 카카오 키워드 광고 관리자가 에어브릿지 Dashboard 앱의 Access 권한을 삭제한 경우
- 연동된 광고 계정이 비활성화된 경우

데이터 조회하기

연동된 비용 데이터는 Actuals 리포트에서 아래 메트릭을 추가하여 조회할 수 있습니다.

Touchpoint
- Impressions (Channel)
- Clicks (Channel)
Cost
- Cost (Channel)

Impressions vs Impressions(Channel)

'Impressions', 'Clicks' 메트릭은 에어브릿지에서 트래킹 링크를 통해 직접 수집한 데이터이며, 'Impression (Channel)', 'Click (Channel)' 메트릭은 매체(카카오 키워드 광고) 연동을 통해 수집한 데이터입니다.

데이터 조회 시 유의 사항

카카오 키워드 광고의 비용 데이터 조회 시 아래 사항들에 유의하시기 바랍니다.

비용 데이터 수치 차이
- 비용 데이터는 변경될 수 있습니다. 카카오에서 최근 7일 내의 비용 데이터를 업데이트하면 에어브릿지에도 비용 데이터가 업데이트됩니다.
- 비용 데이터는 실시간이 아닌 4시간 간격으로 업데이트 됩니다. 따라서 비용 데이터 조회 시점에 따라서 매체 측 데이터와 약간의 오차가 발생할 수 있습니다. 예를 들어, 2022년 4월 14일의 데이터는 2022년 4월 15일 조회 데이터와 2022년 4월 16일 조회 데이터에 차이를 보일 수 있습니다. 데이터 조회 시점에 새롭게 업데이트 된 데이터가 있는 경우, 업데이트된 값을 다시 가져오기 때문입니다.
비용 데이터에 없는 Groupby 항목
- Actuals 리포트에서 캠페인, 광고 그룹, 광고 키워드 이외의 항목으로 Groupby를 설정하면 해당 Groupby 행에는 비용 데이터가 표시되지 않습니다.
  - Campaign ID로 Group by를 설정하면 해당 Campaign ID에 대한 Cost(Channel) 값 노출됩니다.
  - Campaign ID 값 외에 Email of tracking link creator 등의 항목(비용 데이터로 수집할 수 없는 항목)을 추가하면 Email of tracking link creator 값이 있는 행에는 Cost(Channel) 값이 노출되지 않습니다.

카카오 키워드 광고

설정 방법

1. '추적 URL' 기능 설정

2. 에어브릿지 웹 SDK 설치

3. 'urlQueryMapping' 기능 설정

4. 'setDownloads' 또는 'setDeeplinks' 설정

'추적 URL' 기능 사용 시 유의사항

최종 랜딩 URL의 UTM 파라미터 중복

UTM 파라미터 커스텀 설정 불가

캠페인 성과 확인 시 캠페인 ID 값으로만 확인 가능

비용 연동

설정하기

중단하기

연동 계정 삭제

광고 계정 추가

비용 데이터 참고사항

업데이트 주기

연동 상태

데이터 조회하기

데이터 조회 시 유의 사항

카카오 키워드 광고

문제가 해결되지 않았나요?