이 문서에서는 Adobe Flash 개발 환경을 위해 Adobe Flash에 대한 Google 애널리틱스 추적을 설정하기 위해 알아야 할 모든 사항을 다룹니다.
구성요소 파일 가져오기
플래시 추적 구성요소 파일은 http://code.google.com/p/gaforflash/downloads/list에서 다운로드할 수 있는 단일 ZIP 파일로 압축됩니다.
readme.txt
파일의 안내에 따라 플래시 구성요소를 설치합니다.
- 현재 Adobe Flash CS3이 열려 있으면 애플리케이션을 종료합니다.
- 다음 위치 중 하나에
Google
디렉터리를 만듭니다.- Windows:
C:\Program Files\Adobe\ Adobe Flash CS3\language\Configuration\Components
- Mac OS X:
Macintosh HD/Applications/Adobe Flash CS3/Configuration/Components
- Windows:
- 구성요소 ZIP 파일의 압축을 푼 위치로 이동하여 다음 파일을 이전 단계에서 만든 디렉터리에 복사합니다.
lib/analytics_flash.swc
- 애널리틱스 구성요소lib/analytics.swc
— 애널리틱스 라이브러리 구성요소
두 구성요소 모두 기능은 동일하지만 서로 다른 개발 스타일을 위한 편의를 위해 제공됩니다.
애널리틱스 구성요소. 플래시 콘텐츠를 개발했으나 액션스크립트 3에 익숙하지 않은 경우 이 구성요소를 사용하세요. 애널리틱스 구성요소는 완전한 추적 패키지입니다. 요소를 스테이지로 바로 드래그 앤 드롭하고 요소 검사기에서 몇 가지 간단한 구성을 수행하면 애널리틱스 추적 기능을 사용하여 컨트롤에 태그를 지정할 수 있습니다.
AnalyticsLibrary 구성요소입니다. 액션스크립트 3에 익숙하다면 AnalyticLibrary 구성요소를 사용할 수 있습니다. 요소를 플래시 라이브러리로 드래그하고 추적 클래스를 액션스크립트 코드로 직접 가져옵니다.
애널리틱스 구성요소 사용하기
애널리틱스 구성요소를 통해 추적을 구현하려면 analytics_flash.swc
를 사용하세요. 구성요소를 올바른 구성요소 디렉터리에 배치하면 구성요소 패널 (창 - 구성요소)에 표시됩니다.
- 구성요소를 스테이지로 드래그하고 속성 대화상자에서 인스턴스 이름을 지정합니다.
- 구성요소 검사기 패널 (Windows - 구성요소 검사기)에서 다음과 같이 구성요소를 구성합니다.
- 애널리틱스 웹 속성 ID를 추가합니다.
- 브리지 모드 또는 AS3 모드를 선택합니다.
- 시각적 디버그 사용 설정 여부를 나타냅니다.
- 액션스크립트 코드에서 방금 만든 구성요소의 인스턴스에 표준 GA 추적 호출을 추가합니다.
플래시가 시각적 구성요소와 작동하는 방식 때문에 플래시 애플리케이션의 두 번째 프레임에서 추적을 시작하는 것이 좋습니다. 첫 번째 프레임에서 추적을 초기화해야 하는 경우 요소가 플래시 콘텐츠 내에서 완전히 초기화되도록 이벤트 핸들러 내에 추적 호출을 배치해야 합니다.
간단한 애널리틱스 플래시 구성요소의 예
다음 코드 스니펫은 사용자가 플래시에서 버튼을 클릭할 때 버튼을 추적하는 방법을 보여줍니다. 이 예에서 버튼 인스턴스의 이름은 액션스크립트에서 playGame
입니다. 버튼을 클릭하면 onButtonClick
메서드가 호출되고 이 메서드는 trackPageview()
메서드를 호출합니다. 이렇게 하면 가상 페이지 /myGame1
의 페이지 조회수가 증가합니다.
playGame.addEventListener( MouseEvent.CLICK, onButtonClick ); function onButtonClick( event:Event ):void { tracker.trackPageview( "/myGame1"); }
AnalyticsLibrary 구성요소 사용
analytics.swc
파일을 사용하여 AnalyticsLibrary 구성요소를 통해 추적을 구현합니다. 이 요소를 사용하면 AS3 코드에서 직접 추적 개체를 인스턴스화할 수 있습니다. AnalyticsLibrary 구성요소가 적절한 위치에 배치되면 구성요소 패널에 표시됩니다. 그러면 요소 패널에서 요소를 라이브러리로 드래그하고 라이브러리에서 라이브러리를 액션스크립트 코드로 가져올 수 있습니다.
추적 객체 초기화
Adobe Flash 환경을 사용하여 다음 매개변수를 사용하여 추적 개체를 초기화합니다.
- 현재 표시 객체를 참조합니다. 아래 예에서
this
는 표시 객체를 참조합니다. - 웹 속성 ID. 웹 속성 ID는 플래시 콘텐츠에서 발생한 활동을 추적하고 이를 애널리틱스 계정의 올바른 보기 (프로필)에 전달하는 데 사용되는 고유한 문자열입니다.
- 추적 모드. 유효한 매개변수는
Bridge
또는AS3
입니다. - 디버그 모드 프로덕션 용도로
debug
를false
로 설정하고 유효성 검사 및 문제 해결을 위해true
로 설정합니다.
간단한 AnalyticsLibrary 예제
다음 예에서는 playGame이라는 영화 클립이 스테이지에 있습니다. 마우스 클릭을 수신 대기하는 이벤트 핸들러와 함께 tracker
라는 새 추적 객체가 생성됩니다. 버튼을 클릭하면 onButtonClick
함수가 호출됩니다. trackPageview()
메서드는 클릭이 발생할 때마다 가상 페이지 /myGame1
의 페이지 조회수를 증가시킵니다.
import com.google.analytics.AnalyticsTracker; import com.google.analytics.GATracker; var tracker:AnalyticsTracker = new GATracker( this, "UA-111-222", "AS3", true ); playGame.addEventListener( MouseEvent.CLICK, onButtonClick ); function onButtonClick ( event:Event ):void { tracker.trackPageview("/myGame1"); }