TROCCO 웹 행동 로그 수집 SDK - 각종 기능

Prev Next

개요

TROCCO 웹 행동 로그 수집 SDK는 추가적으로 자바스크립트 코드를 삽입하거나 스크립트를 실행하여 다음과 같은 작업을 수행할 수 있습니다.

이 페이지에서는 각각의 방법을 샘플 코드와 함께 설명합니다.

이벤트 추적 추가

아래 Ja value1'}` 부분은 아래 커스텀 컬럼 추가를 참고하시기 바랍니다.

Nanalytics('send','event',{category:<category>,action:<action>,label:<label>,value:<value >,sendPageviewIfSessionExpired:(<boolean>)}, {custom_column_1:(<boolean>)}, {custom_column_1:(<custom_column_1:) 'value1'});

또한, 수집된 이벤트는 타겟 - TROCCO 웹 행동 로그에서 이벤트 로그를 선택하여 전송할 수 있습니다.

코드 내 각종 파라미터

필수 열에 ✓가 표시된 매개변수는 반드시 코드에 포함시켜야 합니다.

매개변수명 필수 데이터 유형 설명
action string 인터랙션 유형
카테고리 string 인터랙션에 사용된 오브젝트
라벨 - string 이벤트 분류에 사용
가치 - number 이벤트 관련 수치
sendPageviewIfSessionExpired - boolean 이벤트 발동 시 세션이 만료된 경우 PageView를 전송하여 세션을 갱신할 것인지 여부

코드 샘플

다음은 사용자가 외부 사이트 링크를 클릭한 로그를 가져오는 코드 샘플입니다.
또한, string 타입의 파라미터 값을 지정하고 싶다면 설정값 부분을 따옴표로 묶어주세요.

<a >https://example.com/</a>

커스텀 컬럼 추가

페이지뷰 로그와 이벤트 로그 모두 사용자 정의 컬럼을 설정하여 원하는 컬럼을 수집 데이터에 포함시킬 수 있습니다.

커스텀 컬럼 설정 개수

커스텀 컬럼은 설정할 수 있는 개수가 제한되어 있습니다.

  • 페이지뷰 로그의 경우: 최대 10개의 컬럼까지
  • 이벤트 로그의 경우: 최대 5개의 컬럼까지

코드 샘플

아래 코드 샘플의 컬럼 이름( custom_column_x 부분)과 그 값은 적절히 수정해 주세요.
값은 string 타입(문자열)으로만 지정할 수 있습니다.

페이지뷰 로그의 경우

자바스크립트 코드 삽입 에 기재되어 있는 삽입용 자바스크립트 코드의 Nanalytics('send','pageview'); 행을 아래와 같이 수정합니다.

Nanalytics('send','pageview',{custom_column_1: 'value1', custom_column_2: 'value2'});

이벤트 로그의 경우

이벤트 추적 추가에서 설명한 자바스크립트 코드를 기반으로 합니다.

<a >https://example.com/</a>

기존 설정 변경

아래 자바스크립트 코드를 추가로 삽입하여 TROCCO 웹 행동 로그 수집 SDK의 내부 설정을 일부 변경할 수 있습니다.

Nanalytics('config','<setting_name>',<setting_value>);

변경 가능한 설정 항목 목록

일반적으로 다음 설정에는 기본값이 사용됩니다.

설정명(setting_name) 데이터 유형 설정 내용 기본값
session_expire_msec number 세션 타임아웃 시간(밀리초) 1800000
cookie_prefix string TROCCO 웹 행동 로그 수집 SDK가 사용하는 쿠키의 키 이름 접두사 __na_
cookie_host string 데이터를 저장할 때 사용하는 쿠키 도메인
도메인 앞에 . 를 부여한 경우, 해당 도메인 산하의 서브도메인 간에 세션과 사용자 ID가 공유된다.
배달 대상 사이트 호스트
customer_id string 사이트의 고객 ID 등을 저장하기 위한 필드
데이터 타입이 string이라는 점에 유의하시기 바랍니다.
-

코드 샘플

자바스크립트 코드 임베딩에서 설명한 임베딩용 코드의 Nanalytics('setup',... )행과 Analytics('send',...) ) 라인 사이에 다음과 같은 라인을 추가한다.
또한, string 타입의 설정값을 변경하고 싶다면 설정값 부분을 따옴표로 묶어주세요.


스크립트 실행을 통한 수집 데이터 확보

TROCCO 웹 행동 로그 수집 SDK가 수집한 데이터는 아래 스크립트를 실행하여 얻을 수 있습니다.
웹 브라우저의 개발자 도구 등으로 값을 확인하고 싶을 때 등에 사용하세요.

Nanalytics('get', [<callback_function>]);

스크립트로 얻을 수 있는 데이터 목록

콜백 함수의 인수는 다음과 같은 속성 이름을 가진 객체가 됩니다.
값이 존재하지 않으면 undefined가 됩니다.

속성명 데이터 유형 설명
site_id string primeNumber가 발급한 사이트 전용 ID
user_id string 1st Party Cookie(사이트 도메인) 기반의 고유 ID(UUIDv4로 생성)
session_id string 세션 내 고유 ID(UUIDv4로 생성)
browser_height number 브라우저의 세로 너비
browser_width number 브라우저 너비
언어 string 브라우저 언어
session_num number 해당 사용자의 누적 세션 횟수
session_start_time number 세션 시작 날짜 및 시간
session_channel_url string 세션 시작 시 유입 경로 URL
medium string 구글 애널리틱스의 utm_medium에 해당되는 값
source string 구글 애널리틱스의 utm_source에 해당되는 값
캠페인 string 구글 애널리틱스의 utm_campaign에 해당하는 값
키워드 string 구글 애널리틱스의 utm_term에 해당하는 값
ad_id string Google Ads 등 광고 ID
url string 정규화 및 디코딩된 URL
referer_url string 정규화 및 디코딩된 리퍼러 URL
customer_id string 고객 ID
browser_time number 사용자의 브라우저 시간에 PageView가 발생한 날짜와 시간
pv_num number 해당 세션 내 누적 PageView 횟수

코드 샘플

다음은 session_num의 값을 출력하는 코드 샘플입니다.

Nanalytics('get',function(value) { console.log(value.session_num) });