Настройка 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_flash.swc для реализации отслеживания с помощью компонента Analytics. Поместите компонент в правильный каталог компонентов, и он появится на панели «Компоненты» ( Окно — Компоненты ).

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

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

Простой пример Flash-компонента аналитики

В следующем фрагменте кода показано, как можно отслеживать кнопку во Flash, когда кто-то нажимает на нее. В этом примере экземпляр кнопки в ActionScript называется playGame . При нажатии кнопки вызывается метод 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-контента и его доставки в правильное представление (профиль) в вашей учетной записи Analytics.
• Режим отслеживания . Допустимые параметры: Bridge или AS3 .
• Режим отладки . Установите debug значение false для производственного использования и значение true для проверки и устранения неполадок.

Простой пример библиотеки аналитики

В следующем примере на сцене существует мувиклип с названием 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");
} 

Вернуться к вершине