Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 

Google Analytics - gtag 함수를 이용해 페이지 URL 수정 및 별도의 이벤트 생성 방법

예를 들어, 제 웹 사이트의 경우 글을 읽는 방식이 다음과 같이 2가지로 나뉩니다.

[query 문자열을 이용한 방식]
/default.aspx?mode=2&sub=0&wid=150

[url 경로를 이용한 방식]
/2/0/150

그래서, Google Analytics에서 제공하는 "Global Site Tag (gtag.js)"의 기본 "Tracking Code" 스크립트를 이용하면,

<!-- Global site tag (gtag.js) - Google Analytics -->
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-1264369-1"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'UA-1264369-1');
</script>

다음과 같이 중구난방으로 유입 URL이 들어옵니다.

gtag_path_location_1.png

그러니까, 제 경우에는 "url 경로 방식"으로 깔끔하게 유입 URL이 보이기를 바라는 것인데요, 다행히 GA 스크립트 측에서 이에 대한 방법을 제공하고 있습니다.

Measure pageviews
; https://developers.google.com/analytics/devguides/collection/gtagjs/pages

gtag('config', 'GA_MEASUREMENT_ID', {<pageview_parameters>});

지원되는 pageview_parameters로는 page_title, page_location, page_path가 있는데 이 중에서 page_path는 Host 이름을 제외한 경로, page_location은 Host 이름까지 포함한 경로인데 제 경우에는 다음과 같은 식으로 설정했습니다.

<script>
    window.dataLayer = window.dataLayer || [];
    function gtag() { dataLayer.push(arguments); }
    gtag('js', new Date());

    gtag('config', 'UA-1264369-1', {
        'page_location': 'https://www.sysnet.pe.kr/2/0/150'
    });
</script>

(물론, page_location의 값을 저런 식으로 하드 코딩해서는 안 되고 서버 측 스크립트에서 채워지도록 해야 할 것입니다.)

이렇게 설정한 후, Google Analytics에서 보이는 경로가 이제 다음과 같이 깔끔하게 바뀝니다.

gtag_path_location_2.png

참고로, page_location과 page_path의 값은 아무거나 하나만 설정해 주면 될 것입니다. 그리고 page_title은 HTML <title />에 설정하지 않은 값으로 채우고 싶을 때 선택적으로 설정하면 됩니다. 왜냐하면, Google Analytics는 기본적으로 HTML 페이지의 title 값을 수집해 다음과 같이 "Page Title"이 있는 페이지에서 보여주기 때문입니다.

gtag_path_location_3.png




사실 제 홈페이지가 전자 상거래의 성격은 아니어서 그다지 관심있는 지표가 없습니다. 그런데, 가끔 궁금했던 것이 각각의 글에 첨부한 예제 코드를 사용자들이 정말 다운로드를 할까?... 하는 점입니다.

물론, 첨부 파일을 다운로드하는 aspx 페이지에 서버 측 코드를 추가해 실행될 때마다 DB와 연동시켜 다운로드 횟수를 기록하면 될 텐데... 음... 이게 또 은근히 귀찮아서요. ^^; 어차피 제 웹 사이트에 크게 중요한 데이터도 아니어서 그냥 GA에 측에 맡기는 것이 더 좋을 것 같다는 판단이 듭니다.

GA도 이런 식의 요구 사항을 위해 gtag에 'event' 명령어를 제공하는데,

Measure Google Analytics Events
; https://developers.google.com/analytics/devguides/collection/gtagjs/events

gtag.js Parameter reference
; https://developers.google.com/gtagjs/reference/parameter

기본적으로 event 명령에는 action, event_category, event_label, value 속성들을 추가적으로 제공할 수 있습니다. 제 경우에는 많은 정보가 필요하지 않으므로 value를 빼고 다음과 같이 gtag 함수를 구성하고,

function gaDownloadEvent(category, downloadLink) {
    try {
        gtag('event', 'Download', {
            'event_category': category,
            'event_label': downloadLink,
        });
    } catch { }

    return true;
}

파일 다운로드를 하는 a 태그의 onclick에 연결했습니다.

<a onclick='return gaDownloadEvent("a_down", "331301885/12122")' href='https://www.sysnet.pe.kr/bbs/DownloadAttachment.aspx?fid=1536&amp;boardid=331301885'>[unref_param_sample.zip]</a>

그럼 다음과 같은 정도로 GA에서 확인할 수 있습니다.

gtag_path_location_4.png

재미있는 것은, Google Analytics가 개발자라기보다는 마케터들을 위한 도구이기 때문에 저런 식으로 코딩이 아닌 GA 측의 설정으로 '이벤트'를 처리하는 방법도 제공한다는 점입니다.

How To Track Downloads In Google Analytics - Complete Guide
; https://www.jeffalytics.com/track-downloads-google-analytics/

이름하여 Google Tag Manager인데, 아무래도 기능을 제공하는 것이다 보니 "Start for free"라는 문구로 봐서는 어느 정도 선을 넘어가게 되면 비용을 부담하는 방식인 것 같습니다. 장점이라면 마케터로 하여금 Tag Manager 설정 창을 이용해 일정한 규칙을 입력하는 방식으로 처리할 수는 있는데, 어쨌든 이벤트를 추적할 웹 페이지에 스크립트를 추가해야 한다는 점은 변함이 없습니다. 게다가 다음과 같은 식으로 2개를 넣어야 합니다.

<!-- head 태그 안에 추가 -->
<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','GTM-KRJG5WQ');</script>
<!-- End Google Tag Manager -->

<!-- body 태그 안에 추가 -->
<!-- Google Tag Manager (noscript) -->
<noscript> &lt;iframe src="https://www.googletagmanager.com/ns.html?id=GTM-KRJG5WQ"
height="0" width="0" style="display:none;visibility:hidden"></iframe> </noscript>
<!-- End Google Tag Manager (noscript) -->

보니까... 좀 지저분하죠? ^^ 따라서 개발자 입장에서는 저런 식으로 이벤트마다 스크립트를 덕지덕지 바른다는 것은 미관상 좋지 않을 것이므로 할 수 있다면 그냥 gtag를 이용해 처리하는 것이 더 좋을 듯합니다.




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]







[최초 등록일: ]
[최종 수정일: 5/5/2021]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 



2021-05-05 08시31분
[박세진] 안녕하세요. 문의드립니다. 구글애널리틱스를 통해 페이지 진입 이벤트 코드를 작성하려고 하는데, 앞부분에 명령어를 어떻게 작성해야할지 몰라서 문의드립니다. 예를 들면, 특정 버튼 클릭이벤트에 대한 명령어 태그는 onclick="('event','버튼클릭'),{'event_category':~~~~) 이런 형식으로 작성하니 제대로 추적이 되던데, 페이지 진입 이벤트 코드는 앞에 onclick이 아닌 어떤 명령어를 적용해야 할지요. 문의드립니다.
[guest]
2021-05-05 10시21분
@박세진 페이지 진입 코드는 한 번 실행하면 되는 거니까, 아무데나 두셔도 됩니다. 단지 ga 함수가 동작해야 하니까, 위의 글에서 보면 gtag 호출하는 함수 다음에 놓는 것이 좋을 것입니다. 예를 들면 이런 식입니다.

<script>
    window.dataLayer = window.dataLayer || [];
    function gtag() { dataLayer.push(arguments); }
    gtag('js', new Date());

    gtag('config', 'UA-1264369-1', {
        'page_location': 'https://www.sysnet.pe.kr/2/0/150'
    });

    // 아래의 내용에서 'page_enter', 'https://www.sysnet.pe.kr/2/0/150' 자신의 웹 사이트 상황에 맞게 적어주시면 됩니다.
    gtag('event', 'Download', {
            'event_category': 'page_enter',
            'event_label': 'https://www.sysnet.pe.kr/2/0/150',
        });
</script>
정성태

... 31  32  33  34  35  36  37  38  39  40  41  42  [43]  44  45  ...
NoWriterDateCnt.TitleFile(s)
12563정성태3/16/20219107개발 환경 구성: 551. C# - JIRA REST API 사용 정리 (3) jira-oauth-cli 도구를 이용한 키 관리
12562정성태3/15/202110264개발 환경 구성: 550. C# - JIRA REST API 사용 정리 (2) JIRA OAuth 토큰으로 API 사용하는 방법파일 다운로드1
12561정성태3/12/20218875VS.NET IDE: 159. Visual Studio에서 개행(\n, \r) 등의 제어 문자를 치환하는 방법 - 정규 표현식 사용
12560정성태3/11/202110174개발 환경 구성: 549. ssh-keygen으로 생성한 개인키/공개키 파일을 각각 PKCS8/PEM 형식으로 변환하는 방법
12559정성태3/11/20219630.NET Framework: 1028. 닷넷 5 환경의 Web API에 OpenAPI 적용을 위한 NSwag 또는 Swashbuckle 패키지 사용 [2]파일 다운로드1
12558정성태3/10/20219110Windows: 192. Power Automate Desktop (Preview) 소개 - Bitvise SSH Client 제어 [1]
12557정성태3/10/20217764Windows: 191. 탐색기의 보안 탭에 있는 "Object name" 경로에 LEFT-TO-RIGHT EMBEDDING 제어 문자가 포함되는 문제
12556정성태3/9/20217013오류 유형: 703. PowerShell ISE의 Debug / Toggle Breakpoint 메뉴가 비활성 상태인 경우
12555정성태3/8/20219063Windows: 190. C# - 레지스트리에 등록된 DigitalProductId로부터 라이선스 키(Product Key)를 알아내는 방법파일 다운로드2
12554정성태3/8/20218875.NET Framework: 1027. 닷넷 응용 프로그램을 위한 PDB 옵션 - full, pdbonly, portable, embedded
12553정성태3/5/20219326개발 환경 구성: 548. 기존 .NET Framework 프로젝트를 .NET Core/5+ 용으로 변환해 주는 upgrade-assistant, try-convert 도구 소개 [4]
12552정성태3/5/20218588개발 환경 구성: 547. github workflow/actions에서 Visual Studio Marketplace 패키지 등록하는 방법
12551정성태3/5/20217493오류 유형: 702. 비주얼 스튜디오 - The 'CascadePackage' package did not load correctly. (2)
12550정성태3/5/20217169오류 유형: 701. Live Share 1.0.3713.0 버전을 1.0.3884.0으로 업데이트 이후 ContactServiceModelPackage 오류 발생하는 문제
12549정성태3/4/20217705오류 유형: 700. VsixPublisher를 이용한 등록 시 다양한 오류 유형 해결책
12548정성태3/4/20218465개발 환경 구성: 546. github workflow/actions에서 nuget 패키지 등록하는 방법
12547정성태3/3/20218990오류 유형: 699. 비주얼 스튜디오 - The 'CascadePackage' package did not load correctly.
12546정성태3/3/20218590개발 환경 구성: 545. github workflow/actions에서 빌드시 snk 파일 다루는 방법 - Encrypted secrets
12545정성태3/2/202111343.NET Framework: 1026. 닷넷 5에 추가된 POH (Pinned Object Heap) [10]
12544정성태2/26/202111546.NET Framework: 1025. C# - Control의 Invalidate, Update, Refresh 차이점 [2]
12543정성태2/26/20219882VS.NET IDE: 158. C# - 디자인 타임(design-time)과 런타임(runtime)의 코드 실행 구분
12542정성태2/20/202112221개발 환경 구성: 544. github repo의 Release 활성화 및 Actions를 이용한 자동화 방법 [1]
12541정성태2/18/20219487개발 환경 구성: 543. 애저듣보잡 - Github Workflow/Actions 소개
12540정성태2/17/20219831.NET Framework: 1024. C# - Win32 API에 대한 P/Invoke를 대신하는 Microsoft.Windows.CsWin32 패키지
12539정성태2/16/20219742Windows: 189. WM_TIMER의 동작 방식 개요파일 다운로드1
12538정성태2/15/202110123.NET Framework: 1023. C# - GC 힙이 아닌 Native 힙에 인스턴스 생성 - 0SuperComicLib.LowLevel 라이브러리 소개 [2]
... 31  32  33  34  35  36  37  38  39  40  41  42  [43]  44  45  ...