토스 픽셀 연동하기

토스 애즈에서 캠페인 운영중인 웹사이트에 토스 픽셀을 설치하여, 전환 이벤트를 수집할 수 있습니다.

현재 토스애즈 픽셀 버전상, 독립몰(자사몰) 버전으로 개발되어 있어 호스팅사 적용시 데이터의 정상적인 수집이 어려울 수 있습니다.

전환 코드 생성하기

전환 추적 코드를 생성할 광고 계정에 접속하여 광고 도구 > 전환 및 추적 연동 메뉴를 클릭해주세요.

전환 추적 코드를 생성해주세요.

생성한 전환 추적 코드의 ID를 복사해주세요.

토스 픽셀 설치하기

픽셀 설치

<script type="text/javascript" charset="UTF-8" src="https://static.toss.im/lex/v1.js"></script>

토스 픽셀을 활용하기 위해서는, <head>와 </head> 태그 사이에 script tag 를 추가해주셔야 이벤트 데이터 수집이 가능해요. 광고 캠페인 혹은 목표에 따라 추가적으로 트래킹하고자 하는 전환 이벤트가 있으시다면 아래의 리스트 중 희망하는 이벤트를 확인해주세요. 그리고, 이벤트 별 스크립트 코드를 삽입하면, 전환 이벤트 데이터를 수집할 수 있습니다.

이벤트 별 스크립트 코드

광고를 통해서 발생시키고자 하는 결과에 따라 적합한 이벤트의 스크립트 코드 설치가 필요합니다. 예를 들어, 구매 목적의 캠페인을 운영하고 계시다면 장바구니 담기 / 구매 이벤트를 선택해주시면 됩니다.

이벤트 별 스크립트 코드는 전환 이벤트가 발생하는 지점에 맞춰서 삽입해주셔야 합니다. 그래야, 정합성 높게 전환 이벤트 데이터를 수집할 수 있어요.

예를 들어, 상품 상세 페이지를 조회하고 → 이어서 장바구니 담기까지 완료한 이벤트를 추적하고 싶으시다면

(1) 상품 상세페이지에 “상품/콘텐츠 상세페이지 조회” 이벤트 스크립트 코드 삽입 (2) 장바구니 추가 버튼 클릭 이벤트 발생 시 “장바구니 담기” 이벤트 스크립트 코드 삽입

을 진행하시면 2가지 이벤트를 원활하게 추적할 수 있습니다 :)

페이지 방문 (page view)

사용자가 방문하는 모든 페이지에 설치하는 것을 권장합니다.
전환코드는 문자열(string) 형태로 사용해주세요.

<script type="text/javascript" charset="UTF-8" src="https://static.toss.im/lex/v1.js"></script>

<script type="text/javascript">
    new TossPixel('전환 코드').pageView();
</script>

회원가입 완료 페이지에 삽입하는 것을 권장합니다.
전환코드는 문자열(string) 형태로 사용해주세요.

<script type="text/javascript" charset="UTF-8"src="https://static.toss.im/lex/v1.js"></script>

<script type="text/javascript">
    new TossPixel('전환 코드').signUp();
</script>

상품/콘텐츠 상세페이지 조회 (product view)

상품 상세 페이지, 혹은 콘텐츠의 상세 페이지를 방문할 때 발생하는 이벤트입니다.
상품/콘텐츠의 상세 페이지에 삽입하는 것을 권장합니다.
전환코드는 문자열(string) 형태로 사용해주세요.

<script type="text/javascript" charset="UTF-8" src="https://static.toss.im/lex/v1.js"></script>

<script type="text/javascript">
    new TossPixel('전환 코드').productView({
        product_id: "{상품ID}",
	category_id: "{상품 카테고리 ID}",
        category_name: "{상품 카테고리명}",
        price: 1000.123,
        currency: '{통화명}',
    });
</script>

이벤트 파라미터
- product_id : 쇼핑몰에서 관리하고 계시는 상품 별 고유 ID 값을 의미합니다.
- category_id : 조회한 상품의 카테고리 ID를 의미합니다.
- category_name : 조회한 상품의 카테고리 명을 의미합니다.
- price : 조회한 상품/콘텐츠의 가격을 의미합니다.
- currency : 상품 가격의 통화를 의미합니다. ex) KRW

위 이벤트 파라미터 값들 중 존재하지 않는 값은 제외하고 전달주셔도 됩니다.

장바구니 담기 (add to cart)

유저가 상품/콘텐츠 등을 장바구니에 담을 때 발생하는 이벤트입니다.
장바구니 추가 버튼을 누르는 것과 같은 이벤트에 동적으로 스크립트가 작동하는 방식으로 구현하는 것을 권장합니다.
전환코드는 문자열(string) 형태로 사용해주세요.

<script type="text/javascript" charset="UTF-8" src="https://static.toss.im/lex/v1.js"></script>

<script type="text/javascript">
    new TossPixel('전환 코드').addToCart({
        product_id: "{상품ID}",
        category_id: "{상품 카테고리 ID}",
        category_name: "{상품 카테고리명}",
        total_price: 1000.123,
        total_quantity: 1,
        currency: '{통화명}',
    });
</script>

이벤트 파라미터
- product_id : 쇼핑몰에서 관리하고 계시는 상품 별 고유 ID 값을 의미합니다.
- category_id : 장바구니에 담긴 상품의 카테고리 ID를 의미합니다.
- category_name : 장바구니에 담긴 상품의 카테고리 명을 의미합니다.
- total_price : 장바구니에 담긴 총 가격을 의미합니다.
- total_quantity : 장바구니에 담긴 총 수량을 의미합니다.
- currency : 상품 가격의 통화를 의미합니다. ex) KRW

위 이벤트 파라미터 값들 중 존재하지 않는 값은 제외하고 전달주셔도 됩니다.

구매 (purchase)

유저가 상품/콘텐츠 등을 구매할 때 발생하는 이벤트입니다.
구매 완료 페이지에 삽입하는 것을 권장합니다.
전환코드는 문자열(string) 형태로 사용해주세요.

<script type="text/javascript" charset="UTF-8" src="https://static.toss.im/lex/v1.js"></script>

<script type="text/javascript">
    new TossPixel('전환 코드').purchase({
        product_id: "{상품ID}",
        category_id: "{상품 카테고리 ID}",
        category_name: "{상품 카테고리명}",
        total_price: 1000.123,
        total_quantity: 1,
        currency: '{통화명}',
    });
</script>

이벤트 파라미터
- product_id : 쇼핑몰에서 관리하고 계시는 상품 별 고유 ID 값을 의미합니다.
- category_id : 구매한 상품의 카테고리 ID를 의미합니다.
- category_name : 구매한 상품의 카테고리 명을 의미합니다.
- total_price : 구매한 상품의 총 가격을 의미합니다.
- total_quantity : 구매한 상품의 총 수량을 의미합니다.
- currency : 상품 가격의 통화를 의미합니다. ex) KRW

위 이벤트 파라미터 값들 중 존재하지 않는 값은 제외하고 전달주셔도 됩니다.

리드 수집 (lead)

사용자가 이벤트 참여, 상담 신청 등을 하기 위해 DB를 제출했을 때 발생하는 이벤트입니다.
상담 신청하기, 보험료 조회하기 등 리드 제출 버튼을 누르는 것과 같은 이벤트에 동적으로 스크립트가 작동하게 구현하거나, 리드 제출 완료 페이지에 삽입하는 것을 권장합니다.
전환코드는 문자열(string) 형태로 사용해주세요.

<script type="text/javascript" charset="UTF-8"src="https://static.toss.im/lex/v1.js"></script>

<script type="text/javascript">
    new TossPixel('전환 코드').lead({
        leadType: 'Consultation',
    });
</script>

이벤트 파라미터
- leadType : 아래 항목을 참고하여, 업종에 적합한 리드 타입으로 삽입해주세요.
  이벤트 참여
  Event
  상담 신청
  Consultation
  시승 신청
  TestDrive
  무료체험 신청
  FreeTrial
  사전예약
  Preorder
  보험료 조회
  QuoteCheck
  대출한도 조회
  LoanCheck

유의사항

광고 랜딩 페이지의 URL이 단축 URL 이거나 리다이렉션이 되는 경우, 추적 파라미터가 리다이렉션 과정에서 사라질 수 있습니다. 이 경우 전환 성과 트래킹이 어려우므로 가능하면 원본 링크를 그대로 활용해주세요.

Previous싱귤러 연동하기 Next전환 추적 연동을 위한 유의사항 안내

Last updated 21 days ago

전환 코드 생성하기

토스 픽셀 설치하기

픽셀 설치

이벤트 별 스크립트 코드

페이지 방문 (page view)

회원가입 (sign up)

상품/콘텐츠 상세페이지 조회 (product view)

장바구니 담기 (add to cart)

구매 (purchase)

리드 수집 (lead)

유의사항