TROCCO 웹 행동 로그 수집 SDK - 각종 기능
    • 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 웹 행동 로그에서 이벤트 로그를 선택하여 전송할 수 있습니다.

    코드 내 각종 파라미터

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

    매개변수명필수데이터 유형설명
    actionstring인터랙션 유형
    카테고리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_msecnumber세션 타임아웃 시간(밀리초)1800000
    cookie_prefixstringTROCCO 웹 행동 로그 수집 SDK가 사용하는 쿠키의 키 이름 접두사__na_
    cookie_hoststring데이터를 저장할 때 사용하는 쿠키 도메인
    도메인 앞에 . 를 부여한 경우, 해당 도메인 산하의 서브도메인 간에 세션과 사용자 ID가 공유된다.
    배달 대상 사이트 호스트
    customer_idstring사이트의 고객 ID 등을 저장하기 위한 필드
    데이터 타입이 string이라는 점에 유의하시기 바랍니다.
    ----------------------------------------------------------------------------------------------.

    코드 샘플

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

    
    

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

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

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

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

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

    속성명데이터 유형설명
    site_idstringprimeNumber가 발급한 사이트 전용 ID
    user_idstring1st Party Cookie(사이트 도메인) 기반의 고유 ID(UUIDv4로 생성)
    session_idstring세션 내 고유 ID(UUIDv4로 생성)
    browser_heightnumber브라우저의 세로 너비
    browser_widthnumber브라우저 너비
    언어string브라우저 언어
    session_numnumber해당 사용자의 누적 세션 횟수
    session_start_timenumber세션 시작 날짜 및 시간
    session_channel_urlstring세션 시작 시 유입 경로 URL
    mediumstring구글 애널리틱스의 utm_medium에 해당되는 값
    sourcestring구글 애널리틱스의 utm_source에 해당되는 값
    캠페인string구글 애널리틱스의 utm_campaign에 해당하는 값
    키워드string구글 애널리틱스의 utm_term에 해당하는 값
    ad_idstringGoogle Ads 등 광고 ID
    urlstring정규화 및 디코딩된 URL
    referer_urlstring정규화 및 디코딩된 리퍼러 URL
    customer_idstring고객 ID
    browser_timenumber사용자의 브라우저 시간에 PageView가 발생한 날짜와 시간
    pv_numnumber해당 세션 내 누적 PageView 횟수

    코드 샘플

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

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

    이 문서가 도움이 되었습니까?