Настройка Adobe Flex

В этом документе описано все, что вам нужно знать для настройки отслеживания Google Analytics для Adobe Flash в среде разработки Adobe Flex.

Получить библиотеку отслеживания

Загрузите код (в формате ZIP) со страницы http://code.google.com/p/gaforflash/downloads/list . Следуйте инструкциям в файле readme.txt , чтобы установить компонент Flex. В отличие от компонентов Analytics Flash, в загрузке находится только один файл библиотеки: /lib/analytics_flex.swc .

Добавьте код в свой проект

Прежде чем вы сможете начать использовать код отслеживания в своем проекте, вам необходимо связать загруженный вами файл SWC в качестве ресурса проекта.

  1. Выберите Проект->Свойства . Для вашего проекта появится диалоговое окно «Свойства».
  2. Нажмите «Путь сборки Flex» и выберите вкладку «Путь к библиотеке» .
  3. Нажмите «Добавить SWC...» на панели «Путь к библиотеке» . Появится диалоговое окно «Добавить SWC» .
  4. Перейдите в папку, в которой вы распаковали Google Analytics API, выберите файл lib/analytics.swc и нажмите «ОК» .
    Или просто поместите файл analytics.swc в каталог /libs вашего проекта Flex.

Пример компонента Flex MXML

В следующем примере показано, как настроить отслеживание кнопки внутри файла MXML. Чтобы инициализировать компонент MXML, выполните следующие действия:

  • Установите параметр пространства имен XML . Задайте параметр пространства имен XML вашего объекта отслеживания следующим образом: xmlns:analytics="com.google.analytics.components.*"
  • Задайте имя объекта . В приведенном ниже примере параметру id присвоено значение tracker .
  • Используйте параметр account для идентификатора веб-ресурса . Идентификатор веб-ресурса — это уникальная строка, используемая для отслеживания активности вашего Flash-контента и его доставки в правильное представление (профиль) в вашей учетной записи Analytics.
  • Установите режим отслеживания с помощью параметра mode . Используйте Bridge в качестве параметра, если вы создаете файл MXML и вам нужен простой способ реализации отслеживания. Используйте AS3 , если вам удобно писать код с помощью ActionScript3. Режим AS3 позволяет импортировать все классы отслеживания GA, на основе которых вы можете создавать и настраивать свои собственные объекты отслеживания.
  • Установите режим отладки с помощью параметра visualDebug . Используйте true , чтобы включить отладку и проверку вашей программы; в противном случае установите для этого параметра значение false для производственного использования.

В примере на сцену добавляется кнопка mybutton . Компонент отслеживания Flex создается с помощью tracker имен и настраивается с использованием его параметров. Наконец, к mybutton добавляется событие onButtonClick . При нажатии кнопки виртуальный просмотр страницы /hello world увеличивается на один счетчик.

<?xml version="1.0" encoding="utf-8"?>
<mx:Application
    xmlns:mx="http://www.adobe.com/2006/mxml"
    layout="absolute" width="800" height="600"
    >

    <mx:Script>
            public function onButtonClick():void
            {
                tracker.trackPageview( "/hello world" );
            }
    </mx:Script>

    <analytics:FlexTracker
        xmlns:analytics="com.google.analytics.components.*"
        id="tracker"
        account="UA-111-222"
        mode="AS3"
        visualDebug="false"
     />

    <mx:Button id="mybutton" label="hello world" click="onButtonClick()" />

</mx:Application>

Пример Flex ActionScript 3

В более сложных ситуациях вам может потребоваться вызвать собственные классы отслеживания ActionScript 3 непосредственно из файлов ресурсов ActionScript. Хотя этот пример также является файлом MXML, все экземпляры отслеживания выполняются в тегах <MX:script> . Этот же процесс можно использовать для добавления отслеживания в другие проекты ActionScript 3.

В этом примере на сцену добавляется кнопка mybutton . В теги скрипта импортируются две библиотеки:

com.google.analytics.GATracker; //this is the actual tracking class
com.google.analytics.AnalyticsTracker; //this is an interface that the GATracker class implements

После импорта библиотек создается tracker отслеживания переменных отслеживания. После добавления приложения на сцену вызывается onComplete , который создает экземпляр объекта отслеживания. Четыре параметра, необходимые для создания экземпляра объекта GATracker:

  • Ссылка на текущий объект отображения . В приведенном ниже примере this ссылается на экранный объект.
  • Идентификатор веб-ресурса . Идентификатор веб-ресурса — это уникальная строка, используемая для отслеживания активности вашего Flash-контента и его доставки в правильное представление (профиль) в вашей учетной записи Analytics.
  • Режим отслеживания . Допустимые параметры: Bridge или AS3 .
  • Режим отладки . Установите debug значение false для производственного использования и значение true для проверки и устранения неполадок.

Наконец, в методе щелчка myButton функция onButtonClick отслеживает виртуальный просмотр страницы на нашем объекте отслеживания.

При запуске этого приложения каждый раз, когда пользователь нажимает кнопку, на серверы отслеживания Google Analytics отправляется виртуальный просмотр страницы «Привет, мир».

<?xml version="1.0" encoding="utf-8"?>
<mx:Application
    xmlns:mx="http://www.adobe.com/2006/mxml"
    layout="absolute"
    width="800" height="600"
    addedToStage="onComplete()"
    >
    <mx:Script>
        <![CDATA[
            import com.google.analytics.GATracker;
            import com.google.analytics.AnalyticsTracker;

            public var tracker:AnalyticsTracker;

            private function onComplete():void
            {
                tracker = new GATracker( this, "UA-111-222", "AS3", false );
            }

            public function onButtonClick():void
            {
                tracker.trackPageview( "/hello/world" );
            }

        ]]>
    </mx:Script>

    <mx:Button id="mybutton" label="hello world" click="onButtonClick()" />

</mx:Application>