Настройка Adobe Flash

Этот документ охватывает все, что вам нужно знать, чтобы настроить отслеживание Google Analytics для Adobe Flash для среды разработки Adobe Flash.

Получить файлы компонентов

Файлы компонентов отслеживания Flash сжаты в один ZIP-файл, который можно загрузить по адресу http://code.google.com/p/gaforflash/downloads/list .

Следуйте инструкциям в readme.txt , чтобы установить компоненты Flash.

  1. Если у вас открыт Adobe Flash CS3, закройте приложение.
  2. Создайте каталог Google в одном из следующих мест:
    • Для Windows: C:\Program Files\Adobe\ Adobe Flash CS3\language\Configuration\Components
    • Для Mac OS X: Macintosh HD/Applications/Adobe Flash CS3/Configuration/Components
  3. Перейдите в папку, в которую вы распаковали ZIP-файл компонента, и скопируйте следующие файлы в каталог, созданный на предыдущем шаге:
    • lib/analytics_flash.swc — компонент аналитики
    • lib/analytics.swc — компонент библиотеки аналитики

Оба компонента имеют одинаковую функциональность, но предназначены для удобства разных стилей разработки.

Компонент аналитики . Если вы разрабатываете содержимое Flash, но не знакомы с ActionScript 3, используйте этот компонент. Компонент Analytics — это полный пакет отслеживания. Просто перетащите компоненты прямо на сцену, выполните несколько простых настроек в инспекторе компонентов, и вы готовы пометить свои элементы управления с помощью отслеживания Analytics.

Компонент AnalyticsLibrary . Если вы знакомы с ActionScript 3, вы можете использовать компонент AnalyticLibrary. Перетащите компонент в свою библиотеку Flash и импортируйте классы отслеживания непосредственно в код ActionScript.

Использование компонента Analytics

Используйте analytics_flash.swc для реализации отслеживания через компонент Analytics. Поместите компонент в правильный каталог Component, и он появится на панели Components ( Window - Components ).

  1. Перетащите компонент на сцену и дайте ему имя экземпляра в диалоговом окне свойств .
  2. Настройте компонент в панели Component Inspector ( Windows — Component Inspector ):
    • Добавьте идентификатор веб-ресурса Analytics.
    • Выберите режим моста или режим AS3 .
    • Укажите, включена ли визуальная отладка.
  3. В коде ActionScript добавьте стандартные вызовы отслеживания GA к экземпляру только что созданного компонента.

Из-за того, как Flash работает с визуальными компонентами, обычно лучше всего начинать отслеживание со второго кадра вашего приложения Flash. Если вам нужно инициализировать отслеживание в первом кадре, поместите вызовы отслеживания в обработчики событий, чтобы убедиться, что компонент полностью инициализирован в содержимом Flash.

Пример простого компонента Analytics Flash

В следующем фрагменте кода показано, как можно отслеживать кнопку во Flash, когда кто-то нажимает на нее. В этом примере экземпляр кнопки называется playGame в вашем ActionScript. Когда кнопка нажата, вызывается метод onButtonClick , который, в свою очередь, вызывает метод trackPageview() . Это увеличивает количество просмотров виртуальной страницы /myGame1 .

playGame.addEventListener( MouseEvent.CLICK, onButtonClick );
function onButtonClick( event:Event ):void
{
  tracker.trackPageview( "/myGame1");
}

Использование компонента AnalyticsLibrary

Используйте файл analytics.swc для реализации отслеживания с помощью компонента AnalyticsLibrary. Этот компонент позволяет создавать экземпляр объекта отслеживания непосредственно в коде AS3. Как только компонент AnalyticsLibrary окажется в нужном месте, он появится на панели «Компоненты». Затем вы можете перетащить компонент с панели «Компоненты» в свою библиотеку и оттуда импортировать библиотеки в свой код ActionScript.

Инициализировать объект отслеживания

Используя среду Adobe Flash, инициализируйте объект слежения со следующими параметрами:

  • Ссылка на текущий экранный объект . В приведенном ниже примере this ссылка на экранный объект.
  • Идентификатор веб-ресурса . Идентификатор веб-ресурса – это уникальная строка, используемая для отслеживания действий с вашим Flash-контентом и доставки его в нужное представление (профиль) в вашем аккаунте Google Analytics.
  • Режим слежения . Допустимые параметры: 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");
}