toss ads 광고주 가이드
  • Toss ads
    • toss ads 바로가기
    • 토스애즈 시작하기
      • 회원 가입
      • 비즈니스 그룹 생성
      • 비즈니스 그룹 운영
      • 광고계정 생성
      • 광고계정 운영
      • 광고계정 이관
  • 토스애즈 주요 에이전시 리스트
  • 토스 광고 상품 한 눈에 보기
  • 광고 상품별 가이드
    • 배너 광고
      • 캠페인 목표
        • 방문 유도하기
        • 도달률 높이기
        • 잠재고객 모으기
        • 10대 인지도 높이기
        • 구매 유도
        • 앱설치 유도
      • 배너 광고 유형
      • 캠페인 생성하기
        • 광고 세트 설정하기
        • 광고 운영하기
      • 배너 유형 별 소재 가이드
        • 리스트 배너 가이드
        • 썸네일 배너 가이드
        • 모먼트 배너 가이드
        • 풀페이지 배너 가이드
        • 잠재고객 모으기 가이드
        • 영상 용량 및 화질 변경 가이드
      • 성과 확인하기
    • 라이브 쇼핑
      • 광고 생성하기
      • 소재 가이드
      • 성과 확인하기
    • 숏폼
      • 광고 생성하기
      • 소재 가이드
      • 성과 확인하기
    • 머니알림
      • 광고 생성하기
      • 머니알림 유형 별 소재 가이드
        • 일반형
        • 라이브형
        • 키워드형
      • 성과 확인하기
    • 행운퀴즈
      • 광고 생성하기
      • 소재 가이드
      • 성과 확인하기
    • 두근두근 1등 찍기
      • 광고 생성하기
      • 소재 가이드
      • 성과 확인하기
    • 신용점수 보드
      • 광고 생성하기
      • 소재 가이드
      • 성과 확인하기
    • 버튼 누르기
      • 광고 생성하기
      • 소재 가이드
      • 성과 확인하기
    • 이번 주 미션
    • 일주일 방문 미션
    • 쇼핑배너
  • 심사 및 운영 정책
    • 서비스 운영 정책
    • 공통 준수사항 안내
    • 광고 불가 업종 안내
    • 소재 심사 규정
    • 업종별 심사 가이드
  • 광고 도구 및 자산
    • 전환 및 추적 도구
      • 전환 이벤트
      • 에어브릿지 연동하기
      • 애드저스트 연동하기
      • 브랜치 연동하기
      • 앱스플라이어 연동하기
      • 디파이너리 연동하기
      • 싱귤러 연동하기
      • 토스 픽셀 연동하기
      • 전환 추적 연동을 위한 유의사항 안내
      • 전환 추적 링크 필수/권장 항목 안내
        • 에어브릿지
        • 앱스플라이어
        • 디파이너리
        • 싱귤러
        • 브랜치
        • 애드저스트
    • 타겟/오디언스
      • 광고 반응 타겟
  • 광고머니 및 정산
    • 광고 머니 관리
      • 광고 머니 충전하기
      • 광고 머니 환불하기
      • 무상 광고머니
    • 광고 위약금 안내
    • 정산하기
      • 선불 계정의 정산
      • 후불 계정의 정산
      • 대행수수료 정산
Powered by GitBook
On this page
  • 전환 코드 생성하기
  • 토스 픽셀 설치하기
  • 픽셀 설치
  • 이벤트 별 스크립트 코드
  • 유의사항
  1. 광고 도구 및 자산
  2. 전환 및 추적 도구

토스 픽셀 연동하기

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

Last updated 3 days ago

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

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

전환 코드 생성하기


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

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

  • 생성한 전환 추적 코드의 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>

회원가입 (sign up)

  • 회원가입 완료 페이지에 삽입하는 것을 권장합니다.

  • 전환코드는 문자열(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 이거나 리다이렉션이 되는 경우, 추적 파라미터가 리다이렉션 과정에서 사라질 수 있습니다. 이 경우 전환 성과 트래킹이 어려우므로 가능하면 원본 링크를 그대로 활용해주세요.