このドキュメントでは、Adobe Flash 開発環境で Adobe Flash 向け Google アナリティクス トラッキングを設定する際に知っておくべきポイントについて説明します。
コンポーネント ファイルの取得
Flash トラッキング コンポーネント ファイルは 1 つの ZIP ファイルに圧縮されており、http://code.google.com/p/gaforflash/downloads/list からダウンロードできます。
readme.txt
ファイルの指示に従って Flash コンポーネントをインストールします。
- 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
- アナリティクス ライブラリ コンポーネント
どちらのコンポーネントの機能も同じですが、それぞれの開発スタイルに対応することが目的です。
アナリティクス コンポーネント。Flash コンテンツを作成している方で、NDK 3 に習熟していない場合は、このコンポーネントを使用してください。Analytics コンポーネントは、完全なトラッキング パッケージです。コンポーネントをステージに直接ドラッグ アンド ドロップし、コンポーネント インスペクタに簡単な設定をいくつか作成するだけで、コントロールにいつでも Analytics トラッキングを付けることができるようになります。
AnalyticsLibrary コンポーネント。Macro 3 に精通している場合は、AnalyticLibrary コンポーネントを使用できます。コンポーネントを Flash ライブラリにドラッグし、トラッキング クラスを ActionScript コードに直接インポートします。
Analytics コンポーネントの使用
analytics_flash.swc
を使用して、アナリティクス コンポーネントを介したトラッキングを実装します。コンポーネントを適切な Component ディレクトリに配置すると、[Components] パネル(Window - Components)に表示されます。
- コンポーネントをステージにドラッグし、[プロパティ] ダイアログでインスタンス名を付けます。
- [Component Inspector] パネル(Windows - [Component Inspector])で、次のようにコンポーネントを設定します。
- Analytics ウェブ プロパティ ID を追加します。
- [ブリッジ] モードまたは [AS3] モードを選択します。
- ビジュアル デバッグをオンまたはオフにするかどうかを示します。
- 作成したコンポーネントのインスタンスに標準の Google アナリティクス トラッキング呼び出しを追加します。
Flash は視覚要素と連携するので、通常は Flash アプリケーションの 2 番目のフレームからトラッキングを開始するのが最適です。最初のフレームでトラッキングを初期化する必要がある場合は、イベント ハンドラ内にトラッキングの呼び出しを配置して、コンポーネントが Flash コンテンツ内で完全に初期化されるようにします。
シンプルな Analytics Flash コンポーネントの例
次のコード スニペットは、Flash 内のボタンがクリックされたときにトラッキングする方法を示しています。この例の場合、ボタンのインスタンス名は NDK 内で playGame
となっています。ボタンがクリックされると、onButtonClick
メソッドが呼び出され、さらに trackPageview()
メソッドが呼び出されます。これにより、仮想ページ /myGame1
のページビュー数が増加します。
playGame.addEventListener( MouseEvent.CLICK, onButtonClick ); function onButtonClick( event:Event ):void { tracker.trackPageview( "/myGame1"); }
AnalyticsLibrary コンポーネントの使用
AnalyticsLibrary コンポーネントを介してトラッキングを実装するには、analytics.swc
ファイルを使用します。このコンポーネントを使用すると、トラッキング オブジェクトを AS3 コードで直接インスタンス化できます。AnalyticsLibrary コンポーネントが適切な場所に配置されると、[コンポーネント] パネルに表示されます。コンポーネントを [Components] パネルからライブラリにドラッグし、そこからライブラリを ActionScript コードにインポートできるようになります。
トラッキング オブジェクトの初期化
Adobe Flash 環境を使用して、次のパラメータを指定してトラッキング オブジェクトを初期化します。
- 現在の表示オブジェクトを参照する。以下の例では、
this
は表示オブジェクトを参照しています。 - ウェブ プロパティ ID。ウェブ プロパティ ID は、Flash コンテンツに対するアクティビティをトラッキングしてアナリティクス アカウントの適切なビュー(旧プロファイル)に配信するために使用される一意の文字列です。
- トラッキング モード:有効なパラメータは
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"); }