LogoLogo
카카오비즈니스비즈니스관리자
  • 카카오비즈니스 가이드
  • 카카오비즈니스 바로가기
  • 비즈니스 세미나 바로가기
  • 비즈니스 시작하기
    • 카카오비즈니스 통합 가입
  • 채널
    • 소개
    • 채널 만들기
    • 운영하기
      • 대시보드
      • 프로필
      • 소식
      • 메시지
      • 비즈니스도구
      • 채팅
      • 통계/관리
      • 월렛/캐시 (비즈월렛)
      • 서비스 연결
    • FAQ
  • 광고
    • 소개
    • 카카오모먼트
      • 퀵스타트 가이드
      • 광고 유형
        • 카카오 비즈보드
          • 캠페인 만들기
          • 광고그룹 만들기
          • 소재 만들기
          • 카카오 비즈보드 제작가이드
          • 익스팬더블
        • 카카오 비즈보드 CPT
          • 집행 프로세스
            • 캠페인 만들기
            • 광고그룹 만들기
            • 소재 만들기
          • 제작가이드
          • 제한업종
          • 모션 비즈보드
            • 제작가이드
          • 커스텀 비즈보드
            • 제작가이드
        • 디스플레이 광고
          • 캠페인 만들기
          • 광고그룹 만들기
          • 소재 만들기
          • 디스플레이 광고 제작가이드
        • 브랜딩 디스플레이 광고
          • 집행 프로세스
          • 리치팝 올데이
            • 광고 만들기
            • 제작가이드
          • 포커스 보드
            • 광고 만들기
            • 제작가이드
          • 제한업종
        • 포커스 풀뷰beta
          • 집행 프로세스
          • 광고 만들기
          • 제작가이드
          • 제한업종
        • 프로필 풀뷰beta
          • 집행 프로세스
          • 광고 만들기
          • 제작 가이드
          • 제한업종
        • 동영상 광고
          • 캠페인 만들기
          • 광고그룹 만들기
          • 소재 만들기
          • 동영상 광고 제작가이드
        • 채널 메시지
          • 캠페인 만들기
          • 광고그룹 만들기
          • 소재 만들기
          • 메시지 만들기
            • 메시지 등록
            • 메시지 발송 설정
            • 메시지 대시보드
            • 메시지 보고서
          • 채널 메시지 제작가이드
          • 채널 메시지 집행가이드
          • 채널 메시지 발송 유의사항
        • 개인화 메시지
          • 사전 준비하기
          • 캠페인 만들기
          • 광고그룹 만들기
          • 소재 만들기
          • 개인화 메시지 제작가이드
        • 쇼핑 광고
          • 캠페인 만들기
          • 광고그룹 만들기
          • 소재 만들기
          • 쇼핑 광고 제작가이드
        • 상품 카탈로그
          • 캠페인 만들기
          • 광고그룹 만들기
          • 소재 만들기
          • 트래킹 URL 입력가이드
          • 상품 카탈로그 제작가이드
      • 지표 확인하기
        • 대시보드
        • 보고서
        • SKAdNetwork
      • 운영하기
        • 광고자산 관리
        • 타겟 관리
        • 계정 관리
        • 결제 관리
        • 전환 최적화 가이드
          • 전환 최적화 점검가이드
          • FAQ
        • 카카오 클릭 ID 랜딩 테스트 가이드
        • 동영상 조회수 연동 관리
        • 광고계정 운영 가이드
        • 광고 집행 권장사항
      • 심사가이드
        • 집행 기준 및 준수사항
        • 제한업종
        • 업종별 가이드
        • 소재 구성 가이드
    • 검색 광고
      • 키워드광고
        • 광고 만들기
        • 제작가이드
        • 운영하기
          • 소재 관리
          • 도구 관리
          • 효율 관리
          • 계정 관리
          • 결제 관리(비즈월렛)
          • 광고계정 운영 가이드
        • 심사가이드
          • 제한업종
          • 업종별가이드
          • 등록기준
      • 브랜드검색 광고
        • 광고 만들기
        • 제작가이드
        • 운영하기
          • 도구 관리
          • 효율 관리
          • 계정 관리
          • 결제 관리(비즈월렛)
          • 광고계정 운영 가이드
        • 심사가이드
          • 업종별가이드
          • 키워드/소재가이드
      • 톡채널검색
        • 광고 만들기
        • 제작가이드
        • 심사가이드
          • 제한업종
          • 업종별가이드
          • 등록기준
    • 브랜드 메시지
    • 알림톡
      • 알림톡 제작가이드
        • 이미지형 제작가이드
      • 알림톡 심사가이드
        • 알림톡 화이트리스트
        • 알림톡 블랙리스트
      • 메시지 발송 유의사항
    • 상담톡
    • 카카오쇼핑 광고센터
      • 광고 그룹
      • 광고선택 및 계약
      • 광고센터 월렛 생성하기
      • 지불 방식
      • 광고 집행
      • 대시보드
      • 리포트 (준비중)
      • 광고상품 소개서
    • 기타 광고 서비스
      • 브랜드이모티콘
        • 상품가이드
    • 광고피해신고
      • 광고 차단/신고 안내
      • 불법영업 피해 예방
  • 서비스/도구
    • 카카오싱크
      • 설계하기
      • 도입하기
      • 활용하기
      • FAQ
    • 톡체크아웃
      • 가입하기
      • 판매 관리
      • 정산 관리
      • 고객혜택 관리
      • 고객 관리
      • 판매점정보
      • 고객확인정보
      • 통계
      • 판매점 정책서
        • 판매점 입점 조건
        • 입점 심사 정책
        • 서비스 이용 규칙
    • 카카오톡 예약하기
      • 시작하기
      • 입점
      • 예약
      • 쿠폰
      • 정산
      • 통계
      • 관리
      • 장소
      • 상품
        • 시간예약형
        • 날짜/시간형
        • 날짜형
        • 상시형
        • 병원 예약형
        • 네일샵형
      • 메시지
      • 홍보
    • 카카오톡 주문하기
      • 입점하기
      • 운영하기
    • 카카오맵 매장관리
      • 가입하기
      • 매장 등록
      • 매장 수정/관리
      • 카카오맵 전용번호 관리
      • 소식/후기 관리
      • 매장 삭제/대표자 변경
      • 운영자 관리
    • 비즈니스폼
      • 만들기
      • 활용하기
      • 확인하기
      • 참고하기
    • 비즈플러그인
      • 만들기
      • 확인하기
      • 활용하기
    • 픽셀 & SDK
      • 서비스/도구 > 픽셀 & SDK
      • 픽셀 & SDK 연동 관리
      • 픽셀 & SDK 만들기
      • 카카오 픽셀 헬퍼(Pixel Helper)
      • 카카오 클릭 ID (kclid)
    • 카탈로그
    • 이미지 에디터
    • 챗봇 관리자센터
      • 시작하기
        • 챗봇 관리자센터 개요
        • 챗봇 관리자센터 준비하기
        • 챗봇 도우미
      • 튜토리얼
        • 챗봇 기획하기
        • 챗봇 만들기
          • 튜토리얼 1단계
          • 튜토리얼 2단계
          • 튜토리얼 3단계
        • 알아두면 유용한 팁!
        • 챗봇 제작 팁
      • 주요개념
        • 시나리오
        • 엔티티
        • 블록
        • 발화 패턴
        • 파라미터 설정
        • 응답 설정
        • 컨텍스트
        • Event API
        • 플러그인
        • 스킬
        • 배포
        • 학습
        • 통계
        • 인사이트
        • 권한
        • 봇테스트
        • 작업이력
        • 관리자
        • 봇 설정
        • 알림센터
        • 지식베이스
        • 머신러닝
        • ML+
        • 월렛
        • 내 정보
      • 스킬 개발 가이드
        • 스킬 만들기
        • 블록에 스킬 적용하기
        • 플러그인에 스킬 적용하기
        • 응답 타입별 JSON 포맷
        • 스킬 오류 내역 확인하기
        • AI 챗봇 콜백 개발 가이드
      • 기타
    • 지식
      • 주요 개념들
        • 지식 베이스
        • 지식
        • 카테고리
        • 작업 이력
        • 배포 이력
        • 관리자
        • 설정
    • 선물하기 for Biz
      • 회원가입
      • 선물발송
      • 취소/환불
      • 증빙
      • 선물발송도구
        • 이벤트메이커
        • 임직원/거래처 목록 관리
        • 기념일 예약 선물
        • 오픈API
    • 카카오톡 스토어
      • 입점하기
      • 카카오톡 채널 연동
      • 스토어/판매자 정보관리
      • 상품/리뷰관리
      • 고객혜택관리
      • 판매관리
      • 마케팅 메시지 관리
      • 통계
      • 정산관리
      • 스토어보드 발행 및 관리
      • 라이브 관리
      • 카카오톡 브랜드스토어
    • 비즈월렛
      • 비즈월렛 생성하기
      • 비즈월렛 운영하기
        • 연결/변경/해제/삭제
        • 멤버 초대 및 관리자 요청
        • 비즈월렛 알림
      • 비즈월렛 결제관리
        • 캐시 관리
        • 결제 카드 관리
        • 증빙 서류 관리
    • 카카오톡 지갑
      • 가입하기
      • 입장하기
        • MY BIZ
        • 대시보드
      • 이용기관 등록하기
        • 딜러사
          • 이용기관 등록
          • 기관 추가
        • 이용기관
          • 등록 정보 확인
          • 채널 정보 등록
          • 앱 정보 등록
      • 이용기관 관리하기
        • 딜러사
          • 이용기관 조회
          • 기관 조회
          • 기관 수정
        • 이용기관
          • 기관 조회
          • 기관 수정
      • 계약 관리하기
        • 딜러사
          • 딜러계약 조회
          • 이용기관 계약조회
          • 이용기관 계약추가
        • 이용기관
          • 계약 조회
          • 계약 추가
      • 정보 관리하기
      • 사용량 조회하기
      • 정산 관리하기
  • 파트너 지원 프로그램
    • 카카오광고 고객센터
      • 광고계정 맞춤 컨설팅
      • 문의게시판
      • 원격지원서비스
    • 광고주 성장 프로그램
      • 지원 프로그램
      • 스타터 리워드 프로그램
    • 카카오 RTB 연동
      • Bid Specification
      • Appendix
      • Sample
    • 크로스미디어
      • 제작가이드
    • 공식 대행사 리스트
      • KPP
      • ㄱ~ㅂ
      • ㅅ~ㅇ
      • ㅈ~ㅎ
    • 소상공인 지원 혜택
      • 비즈월렛 확인하는 방법
      • 비즈월렛 만드는 방법
      • 메시지 발송 비용 충전 확인하기
      • 카카오톡 채널 활성화 방법
        • 채널 기본 세팅
          • 채널 생성
          • 비즈월렛 생성
          • 소식 작성
          • 웰컴메시지
          • 채널홈 설정
        • 채널 응용 기능
          • 1:1 채팅 활성화
          • 채널추가 요청 메시지
          • 자주 쓰는 답변 관리
          • 채팅방 메뉴
          • 간편 채팅
          • 챗봇
        • 채널 친구 모으기
          • 카카오톡 채널 URL 활용하기
          • 1:1 채팅을 통한 추가 인증
          • 온/오프라인 홍보 도구
        • 채널 메시지 보내기
          • 메시지 보내기
          • 메시지 보내기(쿠폰형)
        • 서비스/비즈 도구 활용
          • 상담톡
          • 카카오싱크
          • 카카오톡 예약하기
          • 알림톡
          • 톡체크아웃
          • 카카오톡 스토어
          • 카카오맵 매장관리
    • 카카오비즈니스 자격증
      • 출제 범위 및 학습 콘텐츠
  • 개발자 지원 가이드
    • 카카오디벨로퍼스
    • 챗봇 관리자센터
Powered by GitBook
On this page
  • 1. 카카오 픽셀 헬퍼(Pixel Helper)란?
  • 2. 픽셀 헬퍼로 어떤 것들을 할 수 있나요?
  • 3. 픽셀 헬퍼 설치하기
  • 4. 픽셀 헬퍼에서 조회되는 이벤트 상세 정보
  • 5. 픽셀 헬퍼로 문제 해결하기
  • 픽셀이 정상적으로 설치되지 않았습니다.
  • 유효한 광고쿠키 식별자(aid)가 없습니다.
  • 로드 시간이 오래 걸립니다.
  • 이벤트가 중복 호출되고 있습니다.
  • 유효한 매개변수가 아닙니다.
  • 유효한 상품ID가 아닙니다.
  • 유효한 구매금액이 아닙니다.
  • 통화코드가 형식에 맞지 않습니다.
  • 6. 위 답변으로도 문제 해결이 어려우신가요?

Was this helpful?

  1. 서비스/도구
  2. 픽셀 & SDK

카카오 픽셀 헬퍼(Pixel Helper)

Previous픽셀 & SDK 만들기Next카카오 클릭 ID (kclid)

Last updated 10 months ago

Was this helpful?

1. 카카오 픽셀 헬퍼(Pixel Helper)란?

픽셀 헬퍼란 웹사이트에 카카오 픽셀 코드가 잘 설치되어 이벤트가 정상 전송되는지 확인할 수 있는 크롬 확장 프로그램(Chrome Extension)입니다. 픽셀 헬퍼를 설치하여 이벤트가 잘 전송되고 있는지, 매개변수가 정상적으로 유입되는지 실시간으로 체크해 보세요.

2. 픽셀 헬퍼로 어떤 것들을 할 수 있나요?

  • 웹사이트에서 픽셀이 설치되어 이벤트가 정상 전송되는지 즉시 확인할 수 있습니다.

  • 수집에 문제가 되는 부분들에 대해 이상 알림을 제공하여 즉시 조치할 수 있습니다.

  • 광고 효율 향상을 위한 픽셀 세팅 개선 가이드를 제공합니다.

3. 픽셀 헬퍼 설치하기

  1. 'Chrome에 추가'를 클릭하여 픽셀 헬퍼를 다운로드합니다.

  1. 확장 프로그램을 추가하면, 픽셀 헬퍼가 크롬 툴바에 아이콘과 함께 표시됩니다.

4. 픽셀 헬퍼에서 조회되는 이벤트 상세 정보

항목
설명
예시

전송 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

5. 픽셀 헬퍼로 문제 해결하기

픽셀 코드가 정상적으로 설치되지 않았거나, 전송에 필요한 이벤트/매개변수가 잘못 설정된 경우 픽셀 헬퍼에서는 이상 알림을 제공합니다.

대표적인 이상 알림 유형은 다음과 같습니다.

픽셀이 정상적으로 설치되지 않았습니다.

웹사이트에 픽셀 코드가 감지되었으나 정상적으로 설치되지 않은 원인으로는, 픽셀&SDK 에서 발급한 유효한 픽셀&SDK ID가 아니거나, 픽셀 코드 내 에러가 존재하여 이벤트 전송에 필요한 정보들을 활성화할 수 없을 경우 이상 알림을 제공합니다. 또한, 웹사이트 내 픽셀을 설치하였더라도 폐쇄망 등 외부 네트워크 사용이 불가한 환경일 경우 정상 설치 여부를 감지할 수 없습니다.

따라서, 유효한 픽셀&SDK ID가 맞는지 픽셀&SDK 서비스 도구에서 확인이 필요하며, 폐쇄망이 아닌 환경에서 픽셀 이벤트가 전송되는지 확인해주세요. 코드 에러의 경우 개발자에게 문의가 필요합니다.

유효한 광고쿠키 식별자(aid)가 없습니다.

카카오 광고쿠키 식별자(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

상품 금액

유효한 상품ID가 아닙니다.

유저의 상품 반응과 관련된 이벤트(ViewContent, AddToCart, AddToWishList, Purchase) 내 매개변수로 상품ID를 함께 전송할 수 있습니다. 이 때, 유효한 상품ID 값을 전송하지 않는 경우 상품 리타게팅 추천을 위한 최적화 학습에 부정적인 영향을 줄 수 있으며, 이는 광고 노출 및 반응 효율에도 부정적인 영향을 끼치게 됩니다.

따라서, 정확한 리타게팅 학습을 위해 유효한 상품ID 형식을 확인하여 전송해주세요.

유효한 상품ID 형식

  • 가능 : 영문(대/소), 숫자, 대시(-), 언더바(_)

  • 불가능 : 한글, 대시/언더바를 제외한 기타 특수문자, 공백

상품ID 수집 예시

  • Kakao-Pillow_01 -> 유효한 상품ID

  • 카카오-필로우_#01 -> 유효한 상품ID가 아님 (한글, 특수문자가 포함됨)

유효한 구매금액이 아닙니다.

유효한 구매금액은 숫자, 소수점, 천단위 구분기호(콤마)가 포함되며, 문자 및 특수문자는 포함할 수 없습니다. 구매금액 형식이 유효하지 않을 경우 정상 구매금액으로 저장하지 않습니다. 구매금액이 정상 수집되지 않으면 보고서 내 ROAS 지표가 정확하게 측정되기 어렵고, 전환 최적화 학습에 부정적인 영향을 줄 수 있습니다.

따라서, 보다 정확한 광고 성과 측정 및 최적화 학습을 위해 구매금액이 올바르게 설정되었는지 꼭 확인해주세요.

구매금액 수집 예시

구매금액 100,000 -> 구매금액(krw_total_price) : 100000

구매금액 100.00 -> 구매금액(krw_total_price) : 100.00

통화코드가 형식에 맞지 않습니다.

구매 이벤트 전송 시 구매금액에 대한 통화코드(currency)를 설정할 수 있습니다. 통화코드가 유효하지 않을 경우 구매금액을 저장하지 않으므로 통화코드를 올바르게 설정 부탁드립니다. 유효한 통화코드는 ISO 4217 국제 표준 규격을 준수하며, 대표적인 통화코드는 아래를 참고해주세요.

통화코드
통화이름
국가

KRW

원

대한민국

USD

달러

미국

EUR

유로

유럽연합(EU)

GBP

파운드

영국

CNY

위안

중국

AUD

호주 달러

호주

JPY

엔

일본

HKD

홍콩 달러

홍콩

INR

인도 루피

인도

CAD

캐나다 달러

캐나다

통화코드를 세팅하지 않는 경우, 디폴트 통화코드인 KRW 로 저장됩니다.

세팅된 통화코드가 유효하지 않을 경우 구매금액이 정상적으로 수집되지 않습니다.

6. 위 답변으로도 문제 해결이 어려우신가요?

위 문제해결 가이드로 해결이 어려우시거나, 추가 도움이 필요하신 경우 아래의 사이트를 통해 문의해주세요.

를 방문하여 '카카오 픽셀 헬퍼'를 검색합니다.

크롬 웹스토어
카카오 Developers
카카오 비즈니스 라운지