카카오 키워드광고 API는 카카오 키워드광고 플랫폼의 광고계정, 캠페인, 광고그룹, 소재, 키워드와 관련된 설정 정보를 API로 조회하고 이와 관련된 성과 지표를 확인할 수 있는 기능을 제공합니다. 또한, 광고계정, 캠페인, 광고그룹, 소재, 키워드에 대한 ON/OFF 및 일예산, 입찰가 등을 변경할 수 있으며 광고를 집행하기 위한 부가적 기능의 이미지, 서류 등의 정보를 등록, 조회할 수 있는 기능을 제공합니다.
프리미엄링크 유형의 API만 제공하며, 톡채널광고 유형은 보고서 API만 제공됩니다.
키워드광고 기능 소개
사용 권한
카카오 키워드광고 API는 비즈 앱으로 전환하고 비즈니스 인증을 도입한 카카오디벨로퍼스 앱이라면 별도 권한 신청 없이 카카오 키워드광고 가입 후 사용 가능합니다.
카카오 키워드광고 API는 비즈 앱에서만 사용 가능하며, 각 비즈 앱에서 비즈니스 인증으로 발급받은 비즈니스 토큰과 광고계정번호로 호출할 수 있습니다. 기존 앱이 있는 경우, 앱 관리 페이지의 [앱] > [일반] > [비즈니스 정보]에서 해당 앱의 비즈 앱 여부를 확인할 수 있습니다. 기존 앱이 없는 경우, 앱 생성을 참고하여 새로운 비즈 앱을 등록합니다.
카카오 키워드광고 가입
광고주와 대행사는 카카오 키워드광고에 가입하여 카카오 키워드광고 API를 사용할 수 있습니다. 각 사용자는 광고계정의 마스터 또는 멤버 권한을 갖고 있어야 합니다. [설정] > [광고계정 관리] > [멤버관리]에서 멤버를 초대하거나 해제할 수 있습니다. 또한 각 사용자의 카카오계정은 본인인증을 받은 상태여야 합니다.
광고계정은 광고집행을 관리하는 단위로, 광고주가 직접 생성하거나 광고 운영을 대행하는 대행사가 직접 생성할 수 있습니다. 대행사에서 광고계정을 생성할 경우 광고주 정보를 별도로 기입할 수 있습니다. 광고계정의 사업자 정보는 세금계산서 발행정보의 기준이 됩니다.
비즈채널
광고 집행을 하기 위해 홍보할 웹사이트입니다. 검색 사용자에게 광고로 노출하는 사업자 정보입니다.
캠페인
가장 상위의 전략 단위로, 캠페인의 전략 변경으로 캠페인에 소속된 모든 광고그룹의 광고를 편리하게 관리할 수 있습니다.
광고그룹
캠페인 하위에 광고그룹을 생성할 수 있으며, 광고그룹별로 게재 설정, 입찰가, 집행기간 등 상세한 전략 설정이 가능합니다.
키워드
사용자가 검색 시 입력한 검색어를 지칭합니다. 광고그룹 내 다양한 키워드를 생성할 수 있으며, 생성한 소재를 노출하기 위한 단어입니다. 광고 집행을 결정하는 중요한 단위로 생성한 소재와 관련성 높은 키워드를 설정하면 효과적인 광고 성과를 볼 수 있습니다.
소재
텍스트 및 이미지, 전화번호 등 다양한 노출방식으로 소재들을 설정할 수 있으며, 생성한 소재 형식으로 광고가 노출됩니다.
소재연결
생성된 소재들은 광고그룹과 연결되어야 합니다. 검색한 키워드가 속해있는 광고그룹 내 연결된 소재가 노출됩니다.
이미지
광고에 함께 노출되는 확장소재에서 사용하기 위한 이미지입니다.
심사서류
비즈채널과 소재 심사에 필요한 서류를 관리할 수 있습니다.
픽셀 & SDK
카카오 픽셀은 광고계정이 소유하고 있는 웹사이트에 설치할 수 있으며, 카카오 SDK는 모바일 애플리케이션에 설치하여 카카오 서비스 활동 로그를 수집하는 도구입니다. 설치된 픽셀 및 SDK를 사용해 실제 방문, 회원가입, 검색, 장바구니, 구매, 앱 실행, 앱 설치 등의 행위를 할 때 그 내역에 대하여 정보를 수집하여 사용자의 행동 분석 및 최적화된 운영에 활용할 수 있습니다.
사업자 정보
광고를 집행하기 위한 사업자 광고계정 생성시, 사업자의 정보를 확인할 수 있습니다.
보고서
집행한 광고의 결과를 항목별로 구성하여 확인할 수 있는 맞춤화된 보고서로 최근 2년간의 데이터를 제공합니다. 광고계정, 캠페인, 광고그룹, 키워드, 소재별로 구분하여 보고서를 만들 수 있으며, 기본 지표 외에도 전체 노출수, 클릭당비용, 평균노출순위 등 추가 지표도 함께 확인할 수 있습니다.
사용하는 ID 종류
ID 사용시 주의 사항
카카오 키워드광고 플랫폼에서 다운로드한 자료의 ID에는 앞자리에 'K' 문자가 붙어 있지만(예: K1234567890), API에서 사용하는 각 ID는 Long 타입의 숫자로만 이뤄져 있습니다(예: 1234567890).
API 호출 시 각 ID 파라미터 값은 Long 타입 숫자만 사용 가능한 점에 주의합니다.
이름
설명
adAccountId
광고계정 ID
bizChannelId
비즈채널 ID
campaignId
캠페인 ID
adGroupId
광고그룹 ID
keywordId
키워드 ID
creativeId
소재 ID
creativeLinkId
소재연결 ID
imageId
이미지 ID
reviewDocumentId
심사서류 ID
변경 이력
변경 날짜
변경 이력
2024.1.30
신규 API 추가
광고계정 목록 조회: 페이지 형식의 응답 제공, 광고계정 개수 제한 없이 사용 가능, 기존 API 제공 종료일(2024.5.9)
