카카오 픽셀 헬퍼(Pixel Helper)
Last updated
Last updated
픽셀 헬퍼란 웹사이트에 카카오 픽셀 코드가 잘 설치되어 이벤트가 정상 전송되는지 확인할 수 있는 크롬 확장 프로그램(Chrome Extension)입니다. 픽셀 헬퍼를 설치하여 이벤트가 잘 전송되고 있는지, 매개변수가 정상적으로 유입되는지 실시간으로 체크해 보세요.
웹사이트에서 픽셀이 설치되어 이벤트가 정상 전송되는지 즉시 확인할 수 있습니다.
수집에 문제가 되는 부분들에 대해 이상 알림을 제공하여 즉시 조치할 수 있습니다.
광고 효율 향상을 위한 픽셀 세팅 개선 가이드를 제공합니다.
크롬 웹스토어를 방문하여 '카카오 픽셀 헬퍼'를 검색합니다.
'Chrome에 추가'를 클릭하여 픽셀 헬퍼를 다운로드합니다.
확장 프로그램을 추가하면, 픽셀 헬퍼가 크롬 툴바에 아이콘과 함께 표시됩니다.
픽셀이 설치된 웹사이트를 방문하여 픽셀이 설치되었는지 헬퍼를 통해 확인합니다.
픽셀 헬퍼에서 제공하는 이벤트 내 상세 정보는 다음과 같습니다.
| 항목 | 설명 | 예시 |
|---|---|---|
전송 URL | 실제 전송된 이벤트 원문입니다. | https://bc.ad.daum.net/bc?d={"track_id":"2699824790729606833","event_code":"Purchase","params":{},"props":{"lmt":"N"}, ... (이하생략) |
로드 시간 | 픽셀 코드가 호출되어 응답받는 데 소요된 시간입니다. (단위 : ms) | 51.24 ms |
픽셀 코드 | 웹사이트 내 작성된 픽셀 코드입니다. | kakaoPixel('2699824790729606833').addToWishList(); |
페이지 URL | 픽셀 코드가 호출된 상세 페이지입니다. | https://www.daum.net/product/123 |
전송 시간 | 픽셀 코드가 호출된 시간입니다. | 2024-05-24 09:01:45 |
픽셀 코드가 정상적으로 설치되지 않았거나, 전송에 필요한 이벤트/매개변수가 잘못 설정된 경우 픽셀 헬퍼에서는 이상 알림을 제공합니다.
대표적인 이상 알림 유형은 다음과 같습니다.
웹사이트에 픽셀 코드가 감지되었으나 정상적으로 설치되지 않은 원인으로는, 픽셀&SDK 에서 발급한 유효한 픽셀&SDK ID가 아니거나, 픽셀 코드 내 에러가 존재하여 이벤트 전송에 필요한 정보들을 활성화할 수 없을 경우 이상 알림을 제공합니다. 또한, 웹사이트 내 픽셀을 설치하였더라도 폐쇄망 등 외부 네트워크 사용이 불가한 환경일 경우 정상 설치 여부를 감지할 수 없습니다.
따라서, 유효한 픽셀&SDK ID가 맞는지 픽셀&SDK 서비스 도구에서 확인이 필요하며, 폐쇄망이 아닌 환경에서 픽셀 이벤트가 전송되는지 확인해주세요. 코드 에러의 경우 개발자에게 문의가 필요합니다.
카카오 광고쿠키 식별자(advertising id; aid)는 맞춤형 광고를 위해 카카오에서 발급하는 광고용 쿠키이며, 카카오 서비스를 방문할 경우 브라우저 단위로 발급됩니다. 따라서, 유효한 광고쿠키가 없음 알림이 표시되는 경우, 해당 브라우저에서 카카오 서비스를 방문한 적이 없거나, 브라우저의 3자 쿠키 차단 정책에 의해 카카오 광고쿠키가 정상 발급되지 못하여 발생한 문제일 수 있습니다.
브라우저 내 유효한 광고 쿠키가 없는 경우 픽셀은 정상적으로 이벤트를 수집할 수 없습니다.
따라서, 광고쿠키를 발급하기 위해서는 3자 쿠키 차단 정책이 적용되지 않은 브라우저에서 카카오 서비스(ex. https://www.daum.net)를 방문해주세요.
픽셀 로드 시간은 이벤트를 전송하는 픽셀 스크립트가 호출되어 응답받기까지 걸린 시간을 의미합니다. 픽셀 스크립트가 호출되기까지 너무 오래 걸리거나, 서버 응답에 문제가 생겨 로드 시간이 2초 이상일 경우 이상 알림을 제공합니다.
따라서, 로드 시간을 줄이기 위해서는 픽셀 코드 호출이 웹사이트 내 유저의 액션(ex. 구매완료)이 완료된 즉시 실행하도록 하는 것을 권장드립니다.
유저의 하나의 액션(ex. 버튼 클릭)에 동일한 픽셀&SDK ID로 3건 이상의 픽셀 이벤트 코드가 호출되는 경우 중복 호출 이상 알림을 제공합니다. 하나의 액션에 여러 이벤트를 호출하는 경우 최적화 학습 과정에 부정적인 영향을 미쳐 효율 저하가 발생할 수 있으며, 정확한 유저를 타게팅하기 어렵습니다.
따라서, 하나의 액션에는 유저의 행동을 의미하는 하나의 이벤트가 호출될 수 있도록 권장드립니다.
이벤트별로 정의된 유효 매개변수를 설정해야 하며, 정의된 매개변수가 아닌 경우 이상 알림을 제공합니다. 정의되지 않은 매개변수를 전송하더라도 픽셀 이벤트 전송은 가능하나, 해당 매개변수는 맞춤형 광고 타게팅 및 전환 최적화 학습에 활용할 수 없습니다.
유효한 매개변수가 아닙니다 이상 알림이 뜬 경우, 설정한 매개변수 ID에 오타가 있는 것은 아닌지 확인해주세요. 또한, 정의되지 않은 매개변수는 이벤트 내 포함하여 전송하지 않도록 주의해주세요.
이벤트별 정의된 매개변수는 아래와 같습니다.
| 이벤트 | 매개변수 ID | 매개변수 의미 |
|---|---|---|
ViewContent | id | 상품ID |
Search | keyword | 검색어 |
AddToCart | id | 상품ID |
AddToWishList | id | 상품ID |
Purchase | total_price | 총 구매금액 |
total_quantity | 총 구매건수 | |
currency | 통화코드 | |
products[n].id | 상품ID | |
products[n].name | 상품명 | |
products[n].quantity | 상품 건수 | |
products[n].price | 상품 금액 |
유저의 상품 반응과 관련된 이벤트(ViewContent, AddToCart, AddToWishList, Purchase) 내 매개변수로 상품ID를 함께 전송할 수 있습니다. 이 때, 유효한 상품ID 값을 전송하지 않는 경우 상품 리타게팅 추천을 위한 최적화 학습에 부정적인 영향을 줄 수 있으며, 이는 광고 노출 및 반응 효율에도 부정적인 영향을 끼치게 됩니다.
따라서, 정확한 리타게팅 학습을 위해 유효한 상품ID 형식을 확인하여 전송해주세요.
유효한 상품ID 형식
가능 : 영문(대/소), 숫자, 대시(-), 언더바(_)
불가능 : 한글, 대시/언더바를 제외한 기타 특수문자, 공백
Ex. Kakao-Pillow_01 -> 유효한 상품ID
카카오-필로우_#01 -> 유효한 상품ID가 아님
상품ID에 공백이 포함될 경우 시스템에서 자동 제거되지만, 정확한 상품ID 식별을 위해 공백이 포함되지 않도록 주의해주세요.
Ex. id : "Kakao Pillow 01" -> 상품ID : "KakaoPillow01"
상품ID에 콤마(,)가 포함될 경우 2개 이상의 상품ID로 구분되어 저장됩니다.
단일 상품이라면 상품ID 내 콤마(,)가 포함되지 않도록 주의해주세요.
Ex. id : "Kakao,Pillow_01" -> 상품ID : "Kakao", "Pillow01" 로 각각 저장됨
유효한 구매금액은 숫자, 소수점, 천단위 구분기호(콤마)가 포함되며, 문자 및 특수문자는 포함할 수 없습니다. 구매금액 형식이 유효하지 않을 경우 정상 구매금액으로 저장하지 않으며, 구매금액이 정상 수집되지 않으면 보고서 내 ROAS 지표가 정확하게 측정되기 어렵고, 전환 최적화 학습에 부정적인 영향을 줄 수 있습니다.
따라서, 보다 정확한 광고 성과 측정 및 최적화 학습을 위해 유효한 구매금액이 설정되었는지 꼭 확인해주세요.
구매금액 수집 예시
구매금액 100,000 -> 구매금액(krw_total_price) : 100000
구매금액 100.00 -> 구매금액(krw_total_price) : 100.00
구매 이벤트 전송 시 구매금액에 대한 통화코드(currency)를 설정할 수 있습니다. 구매금액은 원화(KRW) 기준으로 저장되며 원화가 아닌 통화코드 세팅 시, 해당 통화코드의 환율에 따라 원화로 환산되어 저장됩니다.
유효한 통화코드는 다음과 같습니다.
| 통화코드 | 통화이름 | 국가 |
|---|---|---|
KRW | 원 | 대한민국 |
USD | 달러 | 미국 |
EUR | 유로 | 유럽연합(EU) |
GBP | 파운드 | 영국 |
CNY | 위안 | 중국 |
AUD | 호주 달러 | 호주 |
JPY | 엔 | 일본 |
HKD | 홍콩 달러 | 홍콩 |
INR | 인도 루피 | 인도 |
CAD | 캐나다 달러 | 캐나다 |
통화코드 세팅이 없을 경우 디폴트 통화코드인 KRW로 저장됩니다.
세팅된 통화코드가 유효하지 않을 경우 구매금액을 정상 수집하지 않습니다.
위 문제해결 가이드로 해결이 어려우시거나, 추가 도움이 필요하신 경우 아래의 사이트를 통해 문의해주세요.
