픽셀 & SDK 만들기
Last updated
Last updated
픽셀&SDK는 '카카오계정' 기준으로 생성을 하고, 원하는 ‘광고계정’에 권한을 추가하는 방식입니다. 하나의 사업자는 하나의 픽셀&SDK에 카카오톡 채널, 톡스토어, 선물하기, 웹사이트, 앱을 함께 연동하는 것이 광고 성과를 높이는데 도움이 됩니다.
STEP 1. 비즈니스 관리자센터 > 서비스/도구 > 픽셀 & SDK에서 [픽셀 & SDK 만들기]를 클릭하세요. 카카오모먼트/키워드 광고 관리자센터 > 픽셀 & SDK 연동관리에서도 픽셀 & SDK를 만들 수 있습니다.
STEP 2. 픽셀 & SDK를 등록해주세요. 픽셀&SDK 이름은 목적에 맞게 구별하기 쉽도록 설정해주세요.
STEP 3. 픽셀 & SDK 생성 후 카카오서비스/웹/앱 및 광고계정을 연동하세요. 카카오서비스, 웹사이트, 앱을 연동하여, 각 서비스에서 발생하는 방문, 회원가입, 구매와 같은 이벤트를 수집하세요. 이벤트를 수집하면 광고 성과를 높일 수 있습니다.
카카오서비스 연동하기 운영 중인 카카오서비스(카카오톡 채널, 톡스토어, 선물하기, 카카오페이 구매)에서 이벤트 수집을 해보세요.
[연동 가능 조건]
이미 타 픽셀 & SDK와 연동된 카카오서비스를 선택할 경우, 기존 픽셀 & SDK와 서비스의 연동은 해제됩니다. 카카오서비스 연동 시 꼭 주의해서 연동해주세요.
웹 카카오픽셀 설치하기 운영 중인 웹사이트에 픽셀 스크립트를 설치하거나 쇼핑몰 호스팅 업체를 통해, 픽셀이 보낸 이벤트를 수집합니다.
앱 카카오SDK 설치하기 운영 중인 앱에 SDK를 설치하거나 앱 트래커 업체를 통해 SDK가 보낸 이벤트를 수집합니다.
광고계정 연동 마스터/멤버 권한을 가진 광고계정 목록을 보여줍니다. 픽셀 & SDK와 연동할 광고계정을 선택하세요. 광고계정 연동 시 모먼트/키워드 광고 관리자센터 내 '픽셀 & SDK 연동 관리'에서도 연동 내역을 확인할 수 있습니다.
픽셀 & SDK 만들기 완료 후, 픽셀 & SDK 설치 프로세스를 모두 완료해야 정상적인 데이터 수집이 가능합니다.
STEP 1. 발급받은 픽셀&SDK ID(Track ID)를 확인하여 다음 단계의 안내에 따라 카카오 픽셀을 웹사이트에 설치해주세요.
STEP 2. 각 이벤트별 스크립트를 복사해서 랜딩페이지에 삽입합니다. 개발자 또는 대행사를 통해 픽셀을 설치하는 경우, 발급받은 코드를 이벤트 별로 복사해 담당자에게 전달하세요.
모든 웹페이지에 설치하는 것을 권장합니다.
<script type="text/javascript" charset="UTF-8" src="//t1.daumcdn.net/kas/static/kp.js"></script>
<script type="text/javascript">
kakaoPixel('Track ID 입력').pageView();
</script>
방문(PageView) 이벤트는 모든 페이지에 설정하는 것이 좋습니다. 그 외 이벤트는 정확히 이벤트 내용에 맞는 페이지에 설치해야 이후 광고 최적화가 잘 이루어집니다.
예를 들어 방문 이벤트를 모든 페이지에 설정했다면, 장바구니 페이지에는 장바구니 보기(ViewCart) 이벤트를 설치하고, 구매완료 페이지에는 구매(Purchase) 이벤트를 설치해야 합니다.
회원가입을 완료한 페이지에 삽입하는 것을 권장합니다.
<script type="text/javascript" charset="UTF-8" src="//t1.daumcdn.net/kas/static/kp.js"></script>
<script type="text/javascript">
kakaoPixel('Track ID 입력').pageView();
kakaoPixel('Track ID 입력').completeRegistration();
</script>
검색을 완료한 페이지에 삽입하는 것을 권장하며, 검색키워드를 추가하면 광고효율을 높이는데 도움이 됩니다.
<script type="text/javascript" charset="UTF-8" src="//t1.daumcdn.net/kas/static/kp.js"></script>
<script type="text/javascript">
kakaoPixel('Track ID 입력').pageView();
kakaoPixel('Track ID 입력').search({
keyword: '검색키워드 입력'
});
</script>
콘텐츠 / 상품의 상세페이지에 삽입하는 것을 권장합니다. 상품고유값은 상품명이 아닌, 쇼핑몰 내부 DB로 관리하는 고유ID값을 의미하며, 상품고유값을 추가하면 광고효율을 높이는데 도움이 됩니다.
<script type="text/javascript" charset="UTF-8" src="//t1.daumcdn.net/kas/static/kp.js"></script>
<script type="text/javascript">
kakaoPixel('Track ID 입력').pageView();
kakaoPixel('Track ID 입력').viewContent({
id: '상품고유값 입력'
});
</script>
장바구니 추가 버튼을 누르는 것과 같은 이벤트에 동적으로 스크립트가 작동하는 방식으로 구현하는 것을 권장합니다.
<script type="text/javascript" charset="UTF-8" src="//t1.daumcdn.net/kas/static/kp.js"></script>
<script type="text/javascript">
kakaoPixel('Track ID 입력').addToCart({
id: '상품고유값 입력'
});
</script>
관심상품 추가 버튼을 누르는 것과 같은 이벤트에 동적으로 스크립트가 작동하는 방식으로 구현하는 것을 권장합니다.
<script type="text/javascript" charset="UTF-8" src="//t1.daumcdn.net/kas/static/kp.js"></script>
<script type="text/javascript">
kakaoPixel('Track ID 입력').addToWishList({
id: '상품고유값 입력'
});
</script>
장바구니를 보는 웹페이지에 설치하는 것을 권장합니다.
<script type="text/javascript" charset="UTF-8" src="//t1.daumcdn.net/kas/static/kp.js"></script>
<script type="text/javascript">
kakaoPixel('Track ID 입력').pageView();
kakaoPixel('Track ID 입력').viewCart();
</script>
구매를 완료한 웹페이지에 설치하는 것을 권장하며, 상세 주문내역을 추가하면 광고효율을 높이는데 도움이 됩니다. 구매금액을 전송하면 카카오모먼트 보고서에서 전환금액을 함께 표시할 수 있습니다. currency 항목에는 ISO 4217 기준의 3문자 통화코드를 입력합니다.
<script type="text/javascript" charset="UTF-8" src="//t1.daumcdn.net/kas/static/kp.js"></script>
<script type="text/javascript">
kakaoPixel('Track ID 입력').pageView();
kakaoPixel('Track ID 입력').purchase({
total_quantity: "3", // 주문 내 상품 개수(optional)
total_price: "500", // 주문 총 가격(optional)
currency: "KRW", // 주문 가격의 화폐 단위(optional, 기본 값은 KRW)
products: [ // 주문 내 상품 정보(optional)
{ id: "상품고유값 입력", name: "상품명1", quantity: "2", price: "200"},
{ id: "상품고유값 입력", name: "상품명2", quantity: "1", price: "100"}
]
});
</script>
잠재고객'은 특정 서비스를 신청하기 전의 사용자를 대상으로 사용합니다. 적합한 사용 대상과 권장하는 태그값은 다음과 같습니다.
권장 태그 추가 목적 (태그값)
사전예약 (PreBooking)
상담신청 (Consulting)
시승신청 (DrivingTest)
대출한도조회 (LoanLimitCheck)
보험료조회 (InsuranceCheck)
<script type="text/javascript" charset="UTF-8" src="//t1.daumcdn.net/kas/static/kp.js"></script>
<script type="text/javascript">
kakaoPixel('Track ID 입력').pageView();
kakaoPixel('Track ID 입력').participation();
</script>
'서비스신청'은 특정 서비스를 신청한 사용자를 대상으로 사용합니다. 적합한 사용 대상과 권장하는 태그값은 다음과 같습니다.
권장 태그 추가 목적 (태그값)
서비스신청 (SignUp)
구독완료 (Subscription)
카드발급 (CardIssuance)
계좌개설 (OpeningAccount)
대출신청 (LoanApplication)
<script type="text/javascript" charset="UTF-8" src="//t1.daumcdn.net/kas/static/kp.js"></script>
<script type="text/javascript">
kakaoPixel('Track ID 입력').pageView();
kakaoPixel('Track ID 입력').signUp();
</script>
사용자가 로그인을 완료한 페이지에 삽입하는 것을 권장합니다.
<script type="text/javascript" charset="UTF-8" src="//t1.daumcdn.net/kas/static/kp.js"></script>
<script type="text/javascript">
kakaoPixel('Track ID 입력').pageView();
kakaoPixel('Track ID 입력').login();
</script>
사용자가 게임 시작 등 특정 행동을 수행하기 위한 준비를 완료한 시점에서 수집을 권장합니다.
<script type="text/javascript" charset="UTF-8" src="//t1.daumcdn.net/kas/static/kp.js"></script>
<script type="text/javascript">
kakaoPixel('Track ID 입력').pageView();
kakaoPixel('Track ID 입력').preparation();
</script>
사용자가 게임 시작 등 특정 행동을 시작하기 위한 튜토리얼을 완료한 시점에서 수집하는 것을 권장합니다.
<script type="text/javascript" charset="UTF-8" src="//t1.daumcdn.net/kas/static/kp.js"></script>
<script type="text/javascript">
kakaoPixel('Track ID 입력').pageView();
kakaoPixel('Track ID 입력').tutorial();
</script>
사용자가 게임 레벨 달성 등 특정 목표를 달성하였을 때 삽입하는 것을 권장합니다. 레벨 정보를 태그값으로 삽입하여 특정 레벨을 달성한 이벤트로 활용 가능합니다.
<script type="text/javascript" charset="UTF-8" src="//t1.daumcdn.net/kas/static/kp.js"></script>
<script type="text/javascript">
kakaoPixel('Track ID 입력').pageView();
kakaoPixel('Track ID 입력').missionComplete();
</script>
STEP 1. 발급받은 픽셀&SDK ID(Track ID)를 확인하여 다음 단계의 안내에 따라 카카오 SDK를 앱에 설치해주세요.
STEP 2. github에서 iOS/Android별 가이드를 확인하고 SDK를 설치하세요. 개발자 또는 대행사를 통해 SDK를 설치하는 경우, 트랙아이디/수집 희망 이벤트/추가한 태그값을 정확히 전달하세요.
STEP 3. 설치 완료 후 픽셀&SDK 이벤트 수집현황이 ‘수집중' 인지 확인합니다.
쇼핑몰 호스팅 업체를 이용하는 경우, 아래 업체명을 눌러 쉽게 픽셀 스크립트를 설정하는 방법을 확인하세요.
카페 24 ▶ 바로가기
메이크샵 ▶ 바로가기
고도몰 ▶ 바로가기
식스샵 ▶ 바로가기
앱 트래커 업체를 이용하는 경우, 아래 업체명을 눌러 SDK와 연결하는 방법을 확인하세요.
Adbrix ▶ 바로가기
Adjust ▶ 바로가기
Airbridge ▶ 바로가기
Appsflyer ▶ 바로가기
Branch ▶ 바로가기
Kochava ▶ 바로가기
Singular ▶ 바로가기
Wisetracker ▶ 바로가기
MMP 포스트백으로 들어온 일부 이벤트 명은 픽셀&SDK 표준 이벤트명으로 자동 치환됩니다. 자세한 규칙은 아래 리스트에서 확인할 수 있습니다.
[픽셀&SDK 표준 이벤트명과 치환되는 MMP 이벤트명 리스트]
[표준 이벤트명 중복]
MMP 이벤트명 내 픽셀&SDK 표준 이벤트명으로 치환 가능한 키워드가 2개 이상 포함될 경우 아래와 같이 우선순위를 통해 하나의 픽셀&SDK 표준 이벤트로 최종 치환됩니다.
우선 순위 Purchase > Participation > SignUp > ViewCart > AddToCart > AddToWishlist > Complete Registration > AppInstall > MissionComplete > Preparation > Tutorial > Login > ViewContent > Search > AppLaunch
예를 들어, AddToCart_viewCart 라는 이벤트명으로 이벤트가 수집되면 이벤트 우선순위에 따라 최종적으로 AddToCart 이벤트로 치환하여 적용합니다.
픽셀&SDK 표준이벤트로 치환되지 않는 MMP 이벤트는 태그를 추가하여 표준이벤트 하위 지표로 사용할 수 있습니다. 커스텀 이벤트 설정은 반드시 카카오 픽셀&SDK 내 태그 설정과 MMP 포스트백 설정이 모두 완료되어야 정상적으로 활용할 수 있습니다.
[MMP 포스트백 이벤트 명 설정]
[입력 포맷] 이벤트 + |(파이프라인) + 태그
정상 입력 케이스
[주의] 중복 입력 케이스
MMP 커스텀 이벤트를 설정한 뒤 비즈니스관리자센터 > 내 픽셀 & SDK 에서 태그를 설정합니다. 픽셀&SDK에 동일한 태그를 설정하여 커스텀 이벤트를 생성하지 않을 경우 커스텀 이벤트 기준으로 모수가 수집되지 않습니다.
[예시] 결제 정보를 저장한 유저들의 모수만 구분하여 수집
MMP사 관리자페이지(대시보드)에서 AddPaymentInfo 이벤트를 Purchase|addpaymentinfo 으로 설정하고 내 픽셀&SDK에서도 동일한 이벤트와 태그로 구성된 커스텀 이벤트를 발급합니다. 서비스 출처는 '선택안함'으로 설정해주세요.
Participation/SignUp 이벤트의 경우 발급할 수 있는 태그가 지정되어 있습니다. MMP사에서 이벤트의 커스텀 입력도 가능할 경우, 아래의 태그로 입력하여 표준이벤트 하위 지표로 구분할 수 있습니다.
MMP 커스텀 이벤트 입력 예시: Participation|Consulting
픽셀&SDK 태그값 상세
회원가입, 주문, 결제, 배송 등 브랜드에서 사용자의 활동에 따라 카카오톡으로 발송하는 정보성 메시지를 픽셀&SDK와 연동할 수 있습니다.
왜 톡채널 정보성 메시지와 픽셀&SDK를 연동하나요?
웹사이트나 앱이 없는 광고주도 전환 측정을 할 수 있습니다. 광고 클릭 후 다른 경로로 구매하는 전환도 수집할 수 있습니다.
톡채널 정보메시지와 픽셀&SDK를 연동하게 되면 메시지를 수신한 사용자에게서 발생한 액션은 메시지 템플릿으로 측정이 가능하며, 측정한 데이터는 카카오모먼트 플랫폼에서 타게팅으로 활용이 가능합니다.
톡채널 정보성 메시지를 보내고 있다면, 더 나은 광고 운영을 위해 픽셀&SDK에 톡채널을 연동해보세요.
STEP 1. 카카오비즈니스 관리자센터 > 서비스/도구 > 픽셀 & SDK(ID) 클릭 > 카카오서비스 연동을 선택하세요.
STEP 2. 마스터/매니저 권한을 가진 서비스 목록이 표시되며, 픽셀 & SDK와 연동할 서비스를 선택하세요.
STEP 3. 카카오톡 채널이 연동되면 [서비스] 목록에 표시됩니다. 연동한 카카오톡 채널에 템플릿이 연동되면 그 다음날부터 [이벤트/태그 설정] 항목으로 목록에 표시됩니다.
STEP 4. 카카오톡 채널 정보성메시지의 템플릿은 자동으로 적절한 이벤트 값으로 치환됩니다.
자동 치환되는 표준 이벤트는 회원가입/구매/잠재고객/서비스신청이며, 그 외 이벤트는 수동 설정을 해야만 이벤트별로 모수를 확인할 수 있습니다. 자동으로 치환된 이벤트도 수동으로 변경 및 태그 설정이 가능합니다.
이벤트 값 자동 치환 항목
STEP 5. 자동 치환 되는 이벤트 외에 이벤트는 직접 수동 설정할 수 있습니다.
[이벤트/태그 설정 > 이벤트 설정 전 템플릿]에서 이벤트를 지정하고자 하는 템플릿의 [이벤트] 항목 옆 연필 아이콘을 눌러 원하는 이벤트를 설정합니다.
STEP 6. 카카오톡 정보성 메시지의 템플릿을 유저가 열람하면 이벤트 수집이 시작되며, 익일부터 [수집 이벤트 > 커스텀 이벤트]에서 유입 서비스에서 '카카오톡 채널' 을 확인할 수 있습니다.
톡채널 정보성메시지를 통해 유입한 이벤트는 사용자가 열람한 시간을 기준으로 합니다.
톡채널 정보성메시지가 발송된 시간으로부터 7일을 초과하여 열람한 이벤트는 수집하지 않습니다.
픽셀 & SDK를 삭제하면 기존에 연동한 템플릿은 모두 자동으로 해제됩니다.
STEP 7. 커스텀 이벤트는 하위 지표 태그를 통해 설정 할 수 있습니다.
[이벤트/태그 설정]에서 커스텀 이벤트를 지정하고자 하는 템플릿의 [이벤트 > 태그] 설정에서 이벤트와 하위 지표 태그를 설정하면 커스텀 이벤트 지표를 확인할 수 있습니다. 아래 리스트를 통해 이벤트 별 설정할 수 있는 하위 지표 태그를 참고하세요.
이벤트 하위 태그없이 이벤트만 설정하는 것도 가능하지만, 기본 이벤트로 수집된 다른 픽셀 및 SDK 모수와 구분이 되지 않는 점은 참고하시기 바랍니다.
이벤트별 설정 가능한 태그 항목
[픽셀 & SDK 정보 > 픽셀 & SDK 연동 현황 > 수집 이벤트]에서 ‘talkchannel’ 태그가 적용된 이벤트가 ‘수집중'인지 확인해주세요.
STEP 8. 전환지표 설정을 확인해주세요. 정보성 메시지의 템플릿을 열람하여 수집된 이벤트를 타게팅으로 활용하되, 전환으로 집계하기를 원하지 않는 경우 전환지표 설정을 미설정으로 변경해주세요. 이벤트를 선택하되 전환지표가 미설정인 경우, 톡채널 정보성메시지 이벤트는 정상 수집되며 전환 대상 이벤트로는 활용하지 않습니다.
전환지표 설정의 기본값은 '설정' 입니다.
픽셀 & SDK 대시보드 표기 | 픽셀 & SDK 표준 이벤트명 | MMP 이벤트명 |
---|---|---|
Case | MMP 커스텀 이벤트 입력 예시 | 픽셀&SDK 커스텀 이벤트 치환 |
---|---|---|
Case | MMP 커스텀 이벤트 입력 예시 | 픽셀&SDK 커스텀 이벤트 치환 |
---|---|---|
이벤트 | 태그명 | 태그값 |
---|---|---|
1차 카테고리 | 2차 카테고리 | 적용 대상 | 치환 표준이벤트 | 치환 이벤트코드 |
---|---|---|---|---|
이벤트명 (코드명) | 이벤트 하위 태그 / 코드명 |
---|---|
카카오서비스
연동 가능 조건
카카오톡 채널
픽셀 & SDK 마스터/멤버가 서비스의 마스터/매니저일 경우
픽셀 & SDK 마스터/멤버가 광고계정의 마스터/매니저일 경우
톡스토어
픽셀 & SDK 마스터/멤버가 서비스의 마스터/매니저일 경우
픽셀 & SDK 마스터/멤버가 광고계정의 마스터/매니저일 경우
선물하기
픽셀 & SDK 마스터/멤버가 서비스의 마스터/매니저일 경우
픽셀 & SDK 마스터/멤버가 광고계정의 마스터/매니저일 경우
톡체크아웃
구)카카오페이 구매
픽셀 & SDK에 연동된 톡체크아웃 서비스가 있는 경우
※ 톡체크아웃은 톡체크아웃 서비스에서 직접 픽셀 & SDK와 연동 작업이 필요합니다.
톡체크아웃 서비스 담당자 측에 문의 바랍니다.
회원가입
Complete Registration
registration / join
검색
Search
search
콘텐츠/상품 조회
ViewContent
viewcontent / productview / productlistview / contentview / viewproduct / viewitem
장바구니 보기
ViewCart
viewcart
장바구니 추가
AddToCart
addtocart / addpaymentinfo / spent / credit
관심상품 추가
AddToWishlist
wishlist
서비스신청
SignUp
signup
잠재고객
Participation
participation
구매
Purchase
purchase / completeorder / orderconfirmation
설치
AppInstall
install / firstappopen
로그인
Login
login / inappenter
사전준비
Preparation
character / nickname / prepare / preparation
튜토리얼
Tutorial
tutorial / trial / synopsis / cutscene
목표달성
MissionComplete
level / job / stage / quest / episode / mission / goal / achievement / dayevent / reach / clear
앱실행
AppLaunch
정의되지 않은 모든 이벤트
딥링크 오픈 유저들의 모수를 구분하여 수집
etc|deeplinkopen applaunch|deeplinkopen
AppLaunch|deeplinkopen
결제정보를 저장한 유저들의 모수를 구분하여 수집
etc|addpaymentinfo addtocart|addpaymentinfo
AppLaunch|addpaymentinfo
AddToCart|addpaymentinfo
표준 이벤트 간 중복이 발생
addtocart_viewcart|XXXX
AddToCart|XXXX
Participation (잠재고객)
사전예약 상담신청 시승신청 대출한도조회 보험료조회
PreBooking Consulting DrivingTest LoanLimitCheck InsuranceCheck
SignUp (서비스신청)
서비스가입 구독완료 카드발급 계좌개설 대출신청
SignUp Subscription CardIssuance OpeningAccount LoanApplication
회원
회원가입
회원가입 완료 내용의 템플릿 가입에 따른 축하적립금/쿠폰을 포함
회원가입
CompleteRegistration
구매 (렌탈 포함)
구매완료
주문완료, 구매완료
구매
Purchase
상품가입
상품가입
서비스신청
SignUp
진행상태
입금안내, 입금완료, 구매확정, 상품발송, 상품출고, 제품준비중, 입고지연, 주문내역확인의 내용의 템플릿
구매
Purchase
구매예약/입고알림
입고알림 예약, 사전구매 템플릿
잠재고객
Participation
예약(예매)
예약완료
예약완료, 예매완료, 서비스/진료예약, 대관예약, 상담예약, 예약 결제완료 등의 템플릿
구매
Purchase
리포팅
계약/견적
계약서, 견적서, 계약 서명요청 등의 템플릿
잠재고객
Participation
회원가입 (CompleteRegistration)
채널 이벤트_회원가입 / talkchannel
검색 (Search)
채널 이벤트_검색 / talkchannel
콘텐츠/상품 조회 (ViewContent)
채널 이벤트_콘텐츠상품조회 / talkchannel
장바구니보기 (ViewCart)
채널 이벤트_장바구니보기 / talkchannel 채널 이벤트_상담완료 / talkchannel_consulting 채널 이벤트_계약완료 / talkchannel_booking
장바구니추가 (AddToCart)
채널 이벤트_장바구니추가 / talkchannel
관심상품추가 (AddToWishList)
채널 이벤트_관심상품추가 / talkchannel
구매 (Purchase)
채널 이벤트_구매 / talkchannel 채널 이벤트_첫구매 / talkchannel_first
잠재고객 (Participation)
채널 이벤트_잠재고객 / talkchannel 채널 이벤트_사전예약 / talkchannel_prebooking 채널 이벤트_상담신청 / talkchannel_consulting 채널 이벤트_시승신청 / talkchannel_drivingtest 채널 이벤트_대출한도조회 / talkchannel_loanlimitcheck 채널 이벤트_보험료조회 / talkchannel_insurancecheck
서비스신청 (SignUp)
채널 이벤트_서비스신청 / talkchannel 채널 이벤트_구독완료 / talkchannel_subscription 채널 이벤트_카드발급 / talkchannel_cardissuancee 채널 이벤트_계좌개설 / talkchannel_openingaccount 채널 이벤트_대출신청 / talkchannel_loanapplication
앱실행 (AppLaunch)
채널 이벤트_앱실행 / talkchannel 채널 이벤트_쿠폰관련 / talkchannel_coupon 채널 이벤트_포인트관련 / talkchannel_point
앱설치 (AppInstall)
채널 이벤트_앱설치 / talkchannel