- 인쇄
- PDF
TROCCO 웹 행동 로그 수집 SDK - 각종 기능
- 인쇄
- PDF
개요
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) });