Отслеживание Google Analytics для Adobe Flash

Компонент Google Analytics Tracking for Adobe Flash упрощает внедрение Google Analytics в ваш Flash-контент. Этот компонент, разработанный Adobe Systems, Inc., содержит все функциональные возможности кода Javascript Google Analytics. Компонент Flash Tracking представляет собой скомпилированный объект отслеживания, встроенный в ActionScript 3, что делает реализацию Analytics интуитивно понятной в средах разработки Flash и Flex.

Зачем использовать Flash-отслеживание?

Без компонента Google Analytics Tracking for Adobe Flash отслеживание контента Adobe Flash с помощью Google Analytics сопряжено с рядом технических препятствий. Во-первых, вам необходимо разработать собственный интерфейс для ga.js , чтобы ваше Flash-приложение могло выполнять соответствующий метод Analytics, например trackPageview() или trackEvent() . Кроме того, вы также должны предвидеть, будет ли ваш Flash-контент иметь доступ к объектной модели документа (DOM) браузера, поскольку отслеживание не удается для тех объектов, которым доступ к DOM запрещен (обычно, когда ваш контент находится на сторонних сайтах). Это предполагает понимание того, как использовать вызов ExternalInterface в ActionScript 3 для доступа к DOM браузера и снижения производительности в случае отказа в доступе.

Компонент Google Analytics для Adobe Flash упрощает отслеживание вашего Flash-контента и корректно обрабатывает доступ к DOM. Это полезно для ряда распространенных целей отслеживания во Flash, таких как:

  • встроенный виджет Flash на HTML-странице
  • отдельное приложение Flex или сайт только с Flash, размещенный на странице HTML
  • распространяемая Flex/Flash-игра или программа, в которой разработчик не может контролировать, где будет размещен виджет

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

Примечание. В настоящее время отслеживание Flash доступно для любого Flash-контента, встроенного в веб-страницу. Отслеживание данных, отправленных из Adobe Air, Shockwave или через Flash IDE (например, с помощью Test Movie), в настоящее время не поддерживается.

Поддерживаемые среды разработки

Вы можете разработать отслеживание аналитики для Flash в средах Adobe Flash или Adobe Flex. Для каждой среды требуется отдельный компонент, который можно загрузить с http://code.google.com/p/gaforflash/ . Эти компоненты основаны на ActionScript 3 и могут быть настроены одним из двух способов для каждой среды:

В Adobe Flash

  • Добавьте и настройте простой компонент в инспекторе компонентов и перетащите его на сцену.
  • Импортируйте библиотеки Flash Tracking прямо в свою библиотеку и приступайте к написанию кода.

В Adobe Flex

  • Включите компонент MXML, который вы настраиваете из файла MXML.
  • Импортируйте библиотеки Flash Tracking в теги скриптов/файлы AS3.

Как работает компонент?

Чтобы использовать компонент отслеживания Flash в своей среде, вы либо используете визуальные инструменты внутри Flash, либо настраиваете объект отслеживания непосредственно в своем коде. Независимо от того, настраиваете ли вы компонент визуально или с помощью кода, вы предоставляете следующие элементы:

  • идентификатор веб-ресурса . Он также известен как номер UA вашего кода отслеживания и выглядит как UA-xxxxx-yy , где x и y заменяются числами, соответствующими вашей учетной записи и информации о просмотре (профиле) объекта. вы отслеживаете. Дополнительную информацию см. в разделе Веб-ресурсы .
  • режим отслеживания — выберите режим моста или режим AS3 . Этот режим определяет, как ваше отслеживание взаимодействует с серверами Google Analytics, и подробно описан ниже.
  • режим отладки — независимо от того, какую среду или режим отслеживания вы используете, вы можете включить отладку, чтобы проверить и протестировать отслеживание.

Режимы отслеживания

В зависимости от того, как вы распространяете свой Flash-контент, компонент Analytics for Flash взаимодействует с серверами Analytics либо путем создания моста между Flash-контентом в существующей установке отслеживания Analytics, либо путем обмена данными напрямую с серверами Analytics. Эти два режима называются режимом моста и режимом AS3 соответственно. Оба режима используют одни и те же функции отслеживания Analytics, и ваше Flash-приложение можно легко переключить из одного режима в другой. Помимо выбора режима связи для отслеживания Analytics, вы также можете использовать режим отладки для устранения неполадок или проверки отслеживания.

В любом режиме allowscriptaccess always должен быть равен, чтобы отслеживание кампании работало. Этот параметр включает доступ для чтения к URL-адресу страницы и информации о реферере, требуемой кодом отслеживания Flash. allowscriptaccess код отслеживания Analytics постепенно ухудшается. Он по-прежнему предоставляет большую часть данных об активности пользователей, но не подтверждает модель атрибуции кампании Google Analytics.

Режим моста

Используйте этот режим, если вы управляете как HTML-страницей , так и Flash-контентом. Этот режим лучше всего подходит, если вы уже внедрили отслеживание Google Analytics ( ga.js ) на своем веб-сайте и хотите добавить отслеживание во встроенный Flash-контент. Режим моста упрощает взаимодействие Flash с JavaScript, предоставляя унифицированный интерфейс ActionScript 3 для кода ga.js Он обеспечивает соединение вызовов ActionScript 3 с JavaScript Analytics для обеспечения работы отслеживания.

Подключение к коду отслеживания Google Analytics можно настроить через параметр идентификатора веб-ресурса одним из двух способов:

  • Самый распространенный метод . Объект кода отслеживания Google Analytics уже существует на вашей странице под собственным именем, например pageTracker . В этом случае вы предоставляете полную ссылку DOM на объект отслеживания. Например, если ваш объект называется pageTracker , вы должны ссылаться на этот объект в своем коде как window.pageTracker . Например, следующий фрагмент кода иллюстрирует, как это можно настроить с использованием среды Adobe Flex с ActionScript 3:
    tracker = new GATracker( this, "window.pageTracker", "Bridge", false );

  • Альтернативный метод . Если вы не создали объект отслеживания страницы на своей странице, вы можете просто передать идентификатор своего веб-ресурса, и для вас будет создан объект кода отслеживания JavaScript. При использовании этого метода на вашей HTML-странице по-прежнему требуется ссылка на базовый исходный файл javascript ga.js Следующий фрагмент кода показывает, как это можно настроить с помощью среды Adobe Flex с ActionScript 3:
    tracker = new GATracker( this, "UA-12345-22", "Bridge", false );

Чтобы режим моста работал правильно, для ExternalInterface.available в коде ActionScript 3 должно быть установлено значение true. Это также означает, что allowScriptAccess always должен быть установлен на HTML-странице, в которую встроен Flash-контент. Следующий пример иллюстрирует HTML-код, настроенный для режима моста:

<object classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
     id="flex_component" width="800" height="600"
     codebase="http://fpdownload.macromedia.com/get/flashplayer/current/swflash.cab">
     <param name="movie" value="flex_component.swf" />
     <param name="quality" value="high" />
     <param name="bgcolor" value="#869ca7" />
     <param name="allowScriptAccess" value="always" />
     <embed src="flex_component.swf" quality="high" bgcolor="#869ca7"
         width="800" height="600" name="flex_component" align="middle"
         play="true"
         loop="false"
         quality="high"
         allowScriptAccess="always"
         type="application/x-shockwave-flash"
         pluginspage="http://www.adobe.com/go/getflashplayer">
      </embed>
</object>

Режим AS3

Используйте этот режим, если вы управляете кодом Adobe Flash ActionScript 3, но не контролируете среду размещения вашего приложения Adobe Flash. Например, если вы разрабатываете Flash-контент для распространения на многих сайтах, вам следует использовать режим AS3. Режим AS3 полностью независим от кода отслеживания ga.js и содержит все функции отслеживания Analytics. В этом режиме нет необходимости в отдельной установке отслеживания ga.js Кроме того, режим AS3 использует механизм флэш-памяти для отслеживания информации о сеансе пользователя.

Для некоторых параметров DOM, таких как язык, компонент AS3 пытается получить значения из браузера. Если значения отсутствуют, компонент либо использует эквивалентное значение Flash, либо по умолчанию имеет значение no .

Устранение неполадок и проверка

Компонент Google Analytics Tracking for Adobe Flash предоставляет режим отладки, упрощающий проверку и устранение неполадок. Если этот параметр включен, все данные отслеживания перехватываются и направляются на экран в текстовом поле, а не на серверы аналитики. В этом режиме вы можете видеть в режиме реального времени данные, которые в противном случае собирались бы сервером. Эта функция также помогает хранить тестовые данные вне ваших производственных данных. Вы можете включить функцию устранения неполадок, установив для параметра visualDebug значение true в инспекторе компонентов.

Примеры

Подробные примеры реализации отслеживания в различных средах разработки см. ниже:

Вспышка

Гибкий

Управление версиями

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

Вы также можете использовать следующие инструкции в своем коде для вывода текущего номера версии компонента в консоль вывода.

import com.google.analytics.API;
trace(API.version);