픽셀 이벤트 테스트 가이드

토스애즈 관리자센터에서 픽셀 이벤트 테스트 기능을 사용할 수 있습니다.

픽셀 이벤트 테스트는 광고주 사이트에 설치한 웹 픽셀이 정상적으로 연결되어 있는지, 그리고 사이트에서 발생한 토스애즈 이벤트가 정상적으로 수집되는지 확인할 수 있는 기능입니다.

PC에서 직접 사이트를 열어 테스트하는 방식과 함께, 이벤트 테스트 화면의 QR 코드를 모바일 기기로 스캔해 실제 모바일 환경에서도 웹 픽셀 이벤트를 테스트할 수 있습니다. 모바일에서 이벤트를 발생시킨 뒤 결과는 PC의 관리자센터 이벤트 테스트 화면에서 확인합니다.

픽셀 이벤트 테스트란?

픽셀 이벤트 테스트는 사이트에 설치한 토스 웹 픽셀이 정상적으로 동작하는지 확인하는 기능입니다.

관리자센터에서 테스트할 사이트 URL을 열고, 사이트에서 이벤트를 발생시키면 수집된 이벤트 정보를 테스트 결과에서 확인할 수 있습니다.

이를 통해 다음 항목을 확인할 수 있습니다.

확인 항목

설명

❶ 테스트 대상 URL

현재 테스트 중인 사이트 URL을 확인할 수 있습니다. URL이 다르면 URL 변경을 눌러 테스트할 사이트로 변경할 수 있습니다.

❷ 픽셀 연결 상태

테스트한 사이트에 토스 웹 픽셀이 정상적으로 연결되었는지 확인할 수 있습니다. 연결된 경우 테스트 결과 영역에 연결됨 상태와 연결된 도메인이 표시됩니다.

❸ 수집된 이벤트

사이트에서 발생한 이벤트가 테스트 결과에 표시됩니다. 이벤트명과 이벤트 유형을 확인할 수 있습니다.

❹ 이벤트 받은 시각

이벤트가 수집된 시각을 확인할 수 있습니다. 여러 이벤트를 테스트할 때 어떤 행동에서 발생한 이벤트인지 구분하는 데 사용할 수 있습니다.

❺ 이벤트 상세 정보

이벤트가 발생한 URL, 매개변수 개수, 매개변수 값, 수신 경로, 토스 기여 여부를 확인할 수 있습니다.

❻ 테스트 결과 초기화

모두 지우기를 통해 현재 화면에 표시된 테스트 결과를 초기화하고 다시 테스트할 수 있습니다.

사용 전 확인 사항

이벤트 테스트를 시작하기 전에 아래 내용을 확인해 주세요.

테스트하려는 사이트에 토스애즈 웹 픽셀이 설치되어 있어야 합니다.
테스트하려는 이벤트가 사이트에 설치되어 있어야 합니다.
관리자센터에서 확인할 픽셀의 전환추적 코드를 선택할 수 있어야 합니다.
테스트할 사이트 URL에 PC 또는 모바일 기기에서 접속할 수 있어야 합니다.
이벤트 발생을 위해 상품 조회, 장바구니 담기, 회원가입, 구매 등 실제 테스트 행동을 수행할 수 있어야 합니다.
모바일 테스트 시 QR 코드를 스캔할 수 있는 실제 모바일 기기를 준비해 주세요.

테스트 결과는 사이트 환경, 브라우저 설정, 네트워크 상태, 픽셀 설치 방식에 따라 반영 시간이 최대 1분까지 소요될 수 있습니다.

사용 방법

전환추적 코드를 선택합니다

토스애즈 관리자센터에서 테스트하려는 픽셀의 전환추적 코드를 선택합니다.

여러 개의 픽셀 또는 전환추적 코드를 사용 중이라면, 테스트하려는 광고주 사이트에 설치된 코드와 동일한 항목을 선택해야 합니다.
잘못된 전환추적 코드를 선택하면 이벤트가 정상적으로 발생해도 테스트 결과에서 확인되지 않을 수 있습니다.

이벤트 테스트 탭으로 이동합니다

선택한 전환추적 코드의 상세 화면에서 이벤트 테스트 탭으로 이동합니다.

이 화면에서 테스트할 사이트 URL과 테스트 결과를 확인할 수 있습니다.

테스트할 사이트 URL을 확인합니다

이벤트 테스트 화면에 표시된 사이트 URL이 실제 테스트하려는 사이트와 일치하는지 확인합니다.

URL이 다르다면 URL 변경을 눌러 테스트할 사이트 URL로 변경합니다.
URL을 변경한 뒤에는 해당 URL에서 테스트를 진행해 주세요.

PC 또는 모바일에서 이벤트를 발생시킵니다

PC에서 테스트하는 경우

테스트할 사이트로 이동한 뒤 확인하려는 이벤트가 발생하도록 행동합니다.

모바일에서 테스트하는 경우

PC의 이벤트 테스트 화면에 표시된 QR 코드를 모바일 기기로 스캔합니다.
QR 코드로 열린 테스트 사이트의 URL이 의도한 주소와 일치하는지 확인합니다.
모바일 사이트에서 상품 조회, 장바구니 담기, 회원가입, 구매 등 확인하려는 이벤트가 발생하도록 행동합니다.
PC의 관리자센터 이벤트 테스트 화면으로 돌아와 수집 결과를 확인합니다.

토스 앱으로 QR 코드를 스캔하면 인앱 WebView 환경에서도 모바일 웹 픽셀의 동작을 확인할 수 있습니다. 단, 이 기능은 웹 픽셀 테스트를 위한 기능으로 앱 SDK 또는 인앱 SDK 연동 상태를 확인하는 기능은 아닙니다.

설치 가능한 이벤트와 이벤트별 호출 방식은 토스 픽셀 연동하기 가이드의 픽셀 표준 이벤트 리스트에서 확인할 수 있습니다.

테스트 결과를 확인합니다

이벤트가 정상적으로 발생 후 수집되면 테스트 결과에 이벤트 정보가 표시됩니다.

테스트 결과에서는 다음 정보를 확인할 수 있습니다.

항목

설명

❶ 이벤트명

수집된 표준 이벤트 또는 이벤트 이름

❷ 수집 시각

이벤트가 관리자센터에 수집된 시간

❸ URL

이벤트가 발생한 페이지 URL

❹ 매개변수

이벤트와 함께 전달된 상세 값

❺ 수신 경로

이벤트가 어떤 경로로 수신되었는지에 대한 정보

❻ 토스 기여

해당 이벤트가 토스 기여로 확인되는지 여부

테스트 결과에서 확인할 수 있는 내용

픽셀 연결 상태

웹 픽셀이 사이트에 정상적으로 연결되어 있는지 확인할 수 있습니다.

테스트 결과 영역에서 연결 상태는 연결됨 또는 연결끊김으로 표시됩니다.

연결됨: 테스트한 사이트에서 픽셀이 정상적으로 감지된 상태
연결끊김: 테스트한 사이트에서 픽셀이 감지되지 않았거나 이벤트 수집이 확인되지 않은 상태

이벤트가 표시되지 않는다면 다음 항목을 확인해 주세요.

확인 항목

설명

픽셀 설치 여부

사이트에 토스애즈 픽셀 코드가 설치되어 있는지 확인

전환추적 코드 일치 여부

관리자센터에서 선택한 코드와 사이트에 설치된 코드가 같은지 확인

URL 일치 여부

테스트 화면의 URL과 실제 테스트한 URL이 일치하는지 확인

이벤트 발생 여부

사이트에서 실제로 이벤트가 발생하는 행동을 했는지 확인

이벤트 수집 여부

사이트에 설치한 토스애즈 이벤트가 정상적으로 수집되는지 확인할 수 있습니다.

예를 들어 구매 이벤트를 테스트하는 경우, 구매 완료 페이지에 도달했을 때 구매 이벤트가 테스트 결과에 표시되어야 합니다.
이벤트가 표시되더라도 이벤트명이 예상과 다르거나 필요한 매개변수가 누락되어 있다면 설치 값을 다시 확인해야 합니다.

이벤트 수집 시각

이벤트가 수집된 시간을 확인할 수 있습니다.

같은 이벤트를 여러 번 테스트하는 경우, 수집 시각을 기준으로 어떤 테스트 행동에서 발생한 이벤트인지 구분할 수 있습니다.
테스트 시에는 이벤트를 발생시킨 시간과 테스트 결과의 수집 시각을 함께 비교해 주세요. 이벤트가 수집되는 데 최대 1분까지 소요될 수 있습니다.

이벤트 상세 값

이벤트 상세 화면에서는 이벤트와 함께 전달된 값을 확인할 수 있습니다.

주요 확인 항목은 다음과 같습니다.

항목

확인 방법

URL

이벤트가 의도한 페이지에서 발생했는지 확인

매개변수

상품 ID, 가격, 통화, 주문 ID 등 필요한 값이 포함되었는지 확인

수신 경로

이벤트가 정상적인 경로로 수신되었는지 확인

토스 기여 여부

해당 이벤트가 토스 기여로 확인되는지 확인

매개변수는 캠페인 최적화와 성과 측정에 영향을 줄 수 있으므로, 필요한 값이 누락되지 않았는지 확인하는 것이 좋습니다.

토스 기여 여부 확인하기

테스트 결과에서 이벤트의 토스 기여 여부를 확인할 수 있습니다.

토스 기여 여부는 사이트에서 발생한 이벤트가 토스애즈 광고 유입과 연결되는지 확인하는 데 참고할 수 있는 정보입니다.

토스 기여: 예 : 토스애즈 광고 유입 정보가 유지된 상태에서 이벤트가 수집된 경우
토스 기여: 아니오 : 이벤트는 수집되었지만, 토스애즈 광고 유입 정보와 연결되지 않은 경우
토스 기여: 아니오 로 표시되는 주요 원인 중 하나는 tcid 유실입니다. tcid는 광고 클릭 후 사이트로 이동하는 과정에서 토스애즈 광고 유입을 식별하는 데 사용되는 값입니다.
사이트 이동 과정에서 이 값이 유지되지 않으면 이벤트는 수집되더라도 토스 기여로 확인되지 않을 수 있습니다.
토스 기여: 아니오가 표시된다면, 먼저 광고 클릭 후 최종 이벤트 발생 페이지까지 tcid가 유지되는지 확인해 주세요.

tcid 보존이 필요한 경우 토스 픽셀 TCID 보존 가이드를 참고해 수정할 수 있습니다.

자주 발생하는 상황 (FAQ)

지원 범위 및 주의사항

PC 웹과 실제 모바일 기기에서 웹 픽셀의 연결 및 이벤트 수집 여부를 테스트할 수 있습니다.
모바일 화면 크기, 모바일 브라우저, 카메라 등 모바일 환경에서만 재현되는 흐름을 확인할 때 QR 테스트를 사용할 수 있습니다.
기존 PC 테스트 방식도 계속 사용할 수 있으며, 모바일 QR 테스트가 PC 테스트를 대체하지 않습니다.
이 기능은 웹 픽셀 테스트만 지원하며 앱 SDK 또는 인앱 SDK 연동 테스트는 지원하지 않습니다.
이벤트명과 전달된 매개변수는 확인할 수 있지만, 값의 비즈니스 적합성까지 자동으로 검증하지는 않습니다.
이벤트 테스트에서 발생한 테스트 이벤트는 실제 집계 데이터에 반영되지 않습니다.

QR 코드를 스캔해도 사이트가 열리지 않아요

아래 항목을 순서대로 확인해 주세요.

이벤트 테스트 화면의 URL이 모바일에서 접속 가능한 주소인지 확인합니다.
모바일 기기의 네트워크, VPN, 사내망 또는 로그인 제한 여부를 확인합니다.
이벤트 테스트 화면을 새로 확인한 뒤 현재 표시된 QR 코드를 다시 스캔합니다.
다른 QR 스캐너 또는 기본 카메라 앱으로 다시 시도합니다.

모바일에서 이벤트를 발생시켰지만 결과가 표시되지 않아요

아래 항목을 순서대로 확인해 주세요.

관리자센터에서 올바른 전환추적 코드를 선택했는지 확인합니다.
모바일에서 QR 코드로 연 사이트가 이벤트 테스트 화면의 URL과 같은지 확인합니다.
모바일 사이트에 웹 픽셀과 테스트하려는 이벤트가 설치되어 있는지 확인합니다.
광고 차단, 추적 방지 설정 또는 브라우저 개인정보 보호 설정을 확인합니다.
이벤트 발생 후 최대 1분까지 기다린 뒤 PC의 테스트 결과를 다시 확인합니다.

이벤트가 테스트 결과에 표시되지 않아요

아래 항목을 순서대로 확인해 주세요.

관리자센터에서 올바른 전환추적 코드를 선택했는지 확인합니다.
테스트 URL이 실제 이벤트를 발생시킨 사이트 URL과 같은지 확인합니다.
사이트에 픽셀 코드가 설치되어 있는지 확인합니다.
테스트하려는 이벤트가 해당 페이지 또는 버튼에 설치되어 있는지 확인합니다.
브라우저의 광고 차단 확장 프로그램이나 추적 방지 설정이 켜져 있는지 확인합니다.
이벤트 발생 후 잠시 기다린 뒤 테스트 결과를 다시 확인합니다.

이벤트는 표시되지만 매개변수가 비어 있어요

이벤트 코드는 실행되었지만 상세 값이 전달되지 않았을 가능성이 있습니다.

상품 ID, 주문 금액, 통화, 주문 ID 등 이벤트별로 필요한 값이 정상적으로 전달되고 있는지 확인해 주세요.

다른 이벤트가 표시돼요

사이트에서 의도한 이벤트가 아닌 다른 이벤트가 실행되고 있을 수 있습니다.

이 경우 다음을 확인해 주세요.

테스트한 페이지에 어떤 이벤트 코드가 설치되어 있는지 확인합니다.
버튼 클릭, 페이지 진입, 결제 완료 등 이벤트 발생 조건이 올바른지 확인합니다.
동일한 페이지에서 여러 이벤트가 동시에 실행되는 구조인지 확인합니다.

토스 기여 여부가 기대와 달라요

이벤트는 수집되었지만 토스 기여: 아니오로 표시된다면 광고 유입 정보가 이벤트 발생 시점까지 유지되지 않았을 수 있습니다.

광고 클릭 후 최종 이벤트 발생 페이지까지 tcid가 유지되는지 확인해 주세요. 자세한 내용은 위의 토스 기여 여부 확인하기 섹션을 참고해 주세요.

테스트 시 권장 방식

정확한 확인을 위해 아래 방식으로 테스트하는 것을 권장합니다.

테스트할 전환추적 코드를 먼저 선택합니다.
테스트할 사이트 URL을 관리자센터에서 확인합니다.
PC 테스트는 하나의 브라우저에서 진행하고, 모바일 테스트는 이벤트 테스트 화면에 표시된 QR 코드를 스캔해 동일한 테스트 흐름에서 진행합니다.
모바일 테스트 중에는 PC의 이벤트 테스트 화면을 닫거나 다른 전환추적 코드로 이동하지 않습니다.
하나의 이벤트를 발생시킨 뒤 테스트 결과를 확인합니다.
여러 이벤트를 테스트할 경우 이벤트별로 시간을 나누어 진행합니다.
테스트 결과의 수집 시각과 실제 테스트 시간을 비교합니다.
이벤트 상세 값에서 URL, 매개변수, 수신 경로, 토스 기여 여부를 함께 확인합니다.
테스트 결과가 많아지면 모두 지우기로 초기화한 뒤 다시 테스트합니다.

이전픽셀 이벤트 수집 확인하기 다음잠재고객 모으기 웹훅 연동 가이드

마지막 업데이트 20일 전