가젯 추적

이 도움말에서는 애널리틱스 가젯 추적을 위해 새 가젯 API를 사용하는 방법을 설명합니다. 이 API는 향상된 데이터 모델과 성능 추적 기능을 제공하여 가젯에 대한 애널리틱스 보고서 통계를 수집합니다.

  1. 시작하기 전에
  2. 가젯 추적
  3. 추적 메서드
  4. 사용 고려사항
  5. 팁
 

시작하기 전에

Google 애널리틱스에서는 계정에 추가한 고유한 웹사이트 도메인 또는 하위 도메인이 별도의 보기 (프로필)에서 추적되고 별도의 도메인 ID가 할당됩니다. 각 가젯은 gmodules.com 호스트 사이트의 자체 하위 도메인에서 작동하므로, 만든 각 가젯이 고유한 보기 (프로필)에서 고유한 도메인 ID를 사용하여 추적해야 합니다.

가장 간단한 방법은 Google 애널리틱스에서 고유 ID를 생성하도록 하는 것입니다.

  1. 시작하려면 Google Analytics에 로그인하거나 Google Analytics 계정에 가입하세요.
    • 신규 사용자에게는 새 계정 가입 페이지가 표시됩니다.
    • 기존 사용자는 애널리틱스 설정 페이지로 이동하여 웹사이트 보기 (프로필) 추가를 클릭해야 합니다. (새 도메인을 선택해야 합니다.)
  2. 두 페이지 중 하나에서 올바른 웹사이트 URL을 입력하세요.
    3. 웹사이트 URL은 Google 애널리틱스 소프트웨어가 도메인 ID와 연결하는 문자열에 불과하므로, 가공 여부에 관계없이 유효한 웹사이트 URL 문자열이 될 수 있습니다. 추적 코드를 웹페이지에 전혀 설치하지 않을 것이며 웹사이트 페이지에 액세스할 필요가 없습니다.
  3. 버튼을 클릭하여 다음 화면으로 이동합니다.
    4. 추적 코드 스니펫이 표시되면 고유 도메인 ID를 스크래치패드에 복사합니다. 자동으로 생성된 코드 스니펫에는 이 도메인 ID가 UA-123456-1 형식으로 포함됩니다.
  4. Finish 버튼을 클릭합니다.
    5. 보기 (프로필) 목록에 웹사이트 URL의 이름이 표시됩니다. 또한 해당 보기 (프로필)에 대해 수정 링크를 클릭하고 수정을 다시 클릭하여 보기 (프로필) 이름을 더 의미 있는 이름으로 변경할 수 있습니다.
  5. 생성된 도메인 ID를 가젯 추적 코드에서 사용합니다.
    6. 애널리틱스 도메인 ID의 형식은 다음과 같습니다.
    UA-123456-1
 

가젯 추적

가젯을 추적하려면 다음과 같이 가젯 코드에 다음 세 가지를 추가해야 합니다.

  1. 기능을 사용 설정하는 중입니다.
  2. 추적기 객체 만들기
  3. 두 가지 방법 중 하나를 사용하여 가젯 추적

다음 가젯 코드 샘플은 각 코드 추가 항목을 보여주며 아래에 설명되어 있습니다. 이 샘플 파일을 사용하여 나만의 가젯을 시작할 수 있습니다.

<?xml version="1.0" encoding="UTF-8" ?>
<Module>
  <ModulePrefs title="Analytics Test">
     <!-- Sets the feature -->
     <Require feature="com.google.gadgets.analytics" /> 
     <Require feature="setprefs" /> 
  </ModulePrefs>
  <UserPref 
      name="counter"
      datatype="hidden"
      default_value="0" />
  <Content type="html"> 
  <![CDATA[ 
      <script>
      // Track this gadget using Google Analytics.

      // Creates a tracking object and uses reportPageview method to call gadget view
      var ga = new _IG_GA("UA-00000-1");
      ga.reportPageview('/view/counterGadget');

      // Suppose, for example, you have a gadget with two counter buttons.
      // You can track interactions with those counters via Analytics.

      // Increment value of "counter" user preference
      function incrementCounter() {
         var count = prefs.getInt("counter");

         prefs.set("counter", count + 1);

         // Tracks button click as an event
         ga.reportEvent("Counter Gadget", "Increment", "Button", 0);
      }

      // Reset value of "counter" userpref to 0
      function resetCounter(){
         prefs.set("counter", 0);

         // Tracks button click as an event
         ga.reportEvent("Counter Gadget", "Reset", "Button", 0);
      }
      </script>
      <form name="counter">
      <input type=button value="Reset" name="reset" onClick="resetCounter()">
      <input type=button value="Count" name="count" onClick="incrementCounter()">
      </form>
  ]]>
  </Content>
</Module>

1. 기능 사용 설정

먼저 기능 네임스페이스를 통해 애널리틱스 라이브러리를 가져와 기능을 사용 설정합니다.

 <Require feature="com.google.gadgets.analytics" />

2. 추적기 객체 만들기

Analytics 추적 API는 ga.js 추적 코드와 동일한 객체 지향 모델을 따릅니다. 따라서, 가젯을 추적하기 전에 다음과 같이 추적기 객체를 인스턴스화합니다.

var ga = new _IG_GA("UA-123456-1");

여기에 위의 단계에 따라 생성된 도메인 ID를 입력합니다.

전체 도메인 ID와 끝자리 숫자를 사용해야 합니다. 그렇지 않으면 추적 객체 호출이 실패합니다.

3. 가젯 추적

가젯 API는 가젯에서 상호작용을 추적하는 데 사용할 수 있는 두 가지 메서드를 제공합니다.

  • 가상 URL 방법
    • ga.reportPageview(path);

    이 방법은 가젯 통계를 특별 페이지 조회로 추적하며 이전 버전의 애널리틱스 가젯 API에서 사용된 방법과 동일합니다. 이 방법을 사용하면 기존의 애널리틱스 보고서 레이아웃에 영향을 주지 않으면서 기존의 가젯 추적 코드를 업데이트할 수 있습니다. 웹페이지의 보고 데이터를 보는 것과 마찬가지로 가젯에서 보고 데이터를 볼 수 있습니다.

    가상 URL 메서드를 사용하여 가젯 상호작용을 추적하는 경우 각 호출은 메서드에 매개변수로 제공한 문자열에 대한 페이지 요청으로 기록됩니다. 이 동작을 이용하여 조작된 URL 경로를 전달하면 웹사이트 페이지 보고서와 마찬가지로 Google 애널리틱스 인터페이스에서 가젯에 대한 보고서를 볼 수 있습니다. 예를 들어 별도의 경로를 사용하여 가젯 보기와 가젯 상호작용을 추적할 수 있습니다. 

    ga.reportPageview('/view/counterGadget');
ga.reportPageview('/click/increment');
ga.reportPageview('/click/reset');

  • 이벤트 추적 메서드
    • ga.reportEvent(name, action, [[]label], [[]value]);

    이 방법은 새 애널리틱스 가젯 API에서만 사용할 수 있습니다. 이 방법을 사용하면 가젯에 대한 사용자 상호작용과 별도로 페이지 조회 (예: 가젯 렌더링)를 추적할 수 있습니다.

    참고: 현재 이벤트 추적은 비공개 베타 버전으로 제공됩니다. 이벤트 추적에 대한 액세스 권한이 없는 경우 가상 URL 방법을 사용합니다.

    이벤트 메서드는 가젯 추적에 사용할 수 있는 다른 모델을 제공합니다. 첫째, 이벤트 호출은 페이지 조회 호출과 별도로 계산되며 결과 데이터는 Google 애널리틱스 콘텐츠 보고서의 별도 부분에 표시됩니다. 따라서 사용자 상호 작용으로 인해 가젯 보기의 전체 숫자가 부풀려지지 않아도 가젯에서의 사용자 상호 작용과 별도로 가젯의 보기를 추적할 수 있습니다. 두 번째로 이 방법에서는 이벤트 추적 모델을 사용하며, 이 모델의 구조는 가젯에서 사용자 상호작용을 분석하도록 특별히 설계되었습니다. 이 모델에서는 라벨과 값 모두 선택적 매개변수입니다.

    카운터 예제를 사용하면 이벤트 메서드를 사용하여 트리거되는 가젯 함수를 추적할 수 있으며, 두 경우 모두 버튼인 컨트롤 유형을 전달할 수 있습니다. 

    ga.reportEvent("Counter Gadget", "Increment", "Button");
ga.reportEvent("Counter Gadget", "Reset", "Button");

    이 예는 매우 간단한 예이지만 이벤트 추적 모델은 가젯의 고유한 추적 요구사항을 활용하도록 조정할 수 있는 매우 유연한 구조입니다. 자세한 내용은 이벤트 추적 문서를 참고하세요.

 

추적 방법

현재 애널리틱스 기능에서 제공하는 메서드는 다음과 같습니다. 사용법은 위에 설명되어 있습니다.

  • reportPageview()
    • 콘텐츠 보고서를 올바르게 채우려면 문자열이 필요합니다. 일반적으로 이 문자열은 보고 용도로 정의하는 경로 형식입니다. 이 메서드에 전달된 값은 utmp 변수를 통해 GIF 요청으로 전송됩니다. 이 방법을 사용하여 가젯 로드 및 가젯 상호작용을 추적할 수 있습니다. 
    ga.reportPageview("/view/gadgetName");
    parameters
    String  path 이 요소의 가상 URL에 제공할 경로입니다.

  • reportEvent()
    • 추적된 데이터를 이벤트 추적 보고서에 올바르게 삽입하려면 가젯의 이름과 액션 매개변수가 필요합니다. 다른 매개변수는 선택사항입니다. 이 메서드를 통해 전달된 값은 utme 변수U의 GIF 요청 뷰에서 전송됩니다.

    parameters
    String  name  필수사항.이벤트 추적 보고서의 최상위 수준에서 사용되는 문자열입니다. 예를 들어 여러 가젯 요소에 대한 상호작용을 추적하는 경우에는 이 매개변수에 가젯 자체의 이름을 사용할 수 있습니다. 그러면 가젯에 대한 모든 상호작용 추적이 Google 애널리틱스 보고서의 동일한 섹션에 집계됩니다.

    String  action  필수사항입니다. 이벤트 추적 보고서에서 가젯 상호작용을 더 세분화하는 문자열입니다. 자세한 내용은 이벤트 추적 문서를 참고하세요.

    String  label  선택사항. 가젯의 보조 세그먼트로 사용할 수 있는 문자열입니다.

    Int  value  선택사항. 가젯 상호작용에 대한 값으로 제공할 수 있는 숫자입니다. 이 수는 메서드가 호출될 때마다 집계됩니다.

 

사용 고려사항

Google 애널리틱스 가젯 API를 사용할 때는 다음과 같은 몇 가지 사항을 고려해야 합니다.

  • 지원되는 컨테이너
    • Google 애널리틱스 가젯 API에서는 다음을 포함하되 이에 국한되지 않는 다양한 유형의 컨테이너를 지원합니다.
    • iGoogle
    • 배급 열기
    • 오픈소셜
    • 가젯
  • 지원되지 않는 가젯 유형
    • Google 애널리틱스 가젯 API는 다음 가젯 유형을 지원하지 않습니다.
    • 인라인 가젯 (type=html-inline)
    • 매플릿
    • URL 유형 가젯 (type-url)
    • Google 애드센스의 가젯 광고
  • 도메인 고려사항
    • 가젯에 애널리틱스 기능이 필요한 경우 가젯이 <subdomain>.gmodules.com(으)로 리디렉션됩니다. 여기서 <subdomain>은 임의의 고유한 하위 도메인입니다. 따라서 가젯의 모든 콘텐츠가 해당 하위 도메인 아래에 표시됩니다. 예를 들면 3nvma227-a.gmodules.com입니다. 또한 모든 Google 애널리틱스 추적 쿠키가 이 고유한 하위 도메인에 설정됩니다. 따라서 애널리틱스 추적 기능은 매플릿을 지원하지 않으며, 플래시 콘텐츠가 추적 기능에 액세스할 수 있도록 특별히 허용해야 합니다 (아래 참조).
  • Flash 콘텐츠를 사용하는 가젯
    • Flash 콘텐츠를 사용하는 가젯은 allowScriptAccess 매개변수를 항상으로 설정하여 Flash URL과 가젯 URL 간 통신을 사용 설정해야 합니다. 
    _IG_EmbedFlash("example.swf", "wrapper", {allowScriptAccess: "always"});
 

팁

가상 URL 방식을 가장 효과적으로 활용하는 방법

가젯의 이벤트 추적 방법에 액세스할 수 없는 경우 가상 URL 방법으로 가젯을 추적하기 위한 다음 권장사항을 따르세요.

  • 가젯 로드를 명확하게 분류합니다.
    • 가젯 상호작용 측정항목과 별도로 가젯 로드/조회 통계를 분류하는 경로를 제공하여, 가젯 로드 시 ga.reportPageview()를 호출할 수 있습니다. 이렇게 하면 가젯에 대한 콘텐츠 보고 데이터가 가젯에서의 상호작용과 별도의 '디렉토리'에 보관되므로, 전체 조회수를 가젯 자체의 상호작용 수와 별도로 확인할 수 있습니다. 예를 들어 가젯에서 다음 코드 스니펫을 사용하여 가젯 로드에 관한 모든 통계를 표시할 수 있습니다. 
      ga.reportPageview('/view/gadgetName');
  • 다양한 상호작용 유형을 서로 분류합니다.
    • 다양한 사용자 상호작용을 분류하는 경로로 ga.reportPageview()를 호출합니다. 이렇게 하면 상호작용 데이터를 추적하려는 경우 가젯 링크, 가젯 버튼 또는 기타 위젯에 대해 별도의 콘텐츠 보고서를 얻을 수 있습니다. 예를 들면 다음과 같습니다.
    • ga.reportPageview('/link/click');
    • ga.reportPageview('/link/submit');

이벤트 추적 방법 사용

Google 애널리틱스 보고서의 이벤트 추적 기능에 액세스할 수 있다면 매우 유연한 데이터 모델을 활용하여 객체 추적을 최대한 활용할 수 있습니다. 이때 다음 도움말을 참고하세요.

  • ga.reportPageview()를 사용하여 가젯 보기 또는 노출을 추적하고 ga.reportEvent()를 사용하여 가젯 상호작용을 추적합니다.
    • 가젯 상호작용은 콘텐츠 보고서의 페이지 데이터에 표시되고 가젯 상호작용은 콘텐츠 보고서의 이벤트 섹션에 표시됩니다.
  • document.referrer를 매개변수로 사용하여 가젯이 배치된 위치를 확인합니다.
    • 가젯에서 document.referrer는 일반적으로 컨테이너의 페이지 URL이므로 ga.reportEvent() 메서드의 라벨 매개변수로 전달할 수 있습니다.
    var containerPage = document.referrer;
ga.reportEvent("Counter Gadget", "Increment", containerPage, 0);

문제 해결

타사 도구를 사용하여 가젯의 GIF 요청 문자열을 분석하여 데이터가 예상대로 Google 애널리틱스 보고서에 전송되는지 확인할 수 있습니다. 가젯이 올바르게 호스팅되고 테스트 페이지에서 작동하면 다음과 같이 GIF 요청 문자열을 분석합니다.

  • 페이지 조회 방법
    • GIF 요청 매개변수에서 utmp 변수를 찾습니다. 이 변수와 연결된 정보는 Google 애널리틱스 보고서에 가젯의 '경로'로 전송됩니다.
  • 이벤트 추적 방법
    • GIF 요청 매개변수에서 utme 변수를 찾습니다. 이 정보는 5(object*action*label)(value) 형식이어야 합니다.

추적 코드 문제 해결에 대한 자세한 내용은 GATC 문제 해결 가이드를 참고하세요.