Configuração do Adobe Flash

Este documento aborda tudo o que você precisa saber para configurar o Acompanhamento do Google Analytics para o ambiente de desenvolvimento do Adobe Flash.

Obtenha os arquivos de componentes

Os arquivos do componente de acompanhamento em Flash são compactados em um único arquivo ZIP que pode ser transferido por download em http://code.google.com/p/gaforflash/downloads/list.

Siga as instruções no arquivo readme.txt para instalar os componentes Flash.

1. Se o Adobe Flash CS3 estiver aberto, feche-o.
2. Crie um diretório Google em um destes locais:
   • No Windows: C:\Program Files\Adobe\ Adobe Flash CS3\language\Configuration\Components
   • No Mac OS X: Macintosh HD/Applications/Adobe Flash CS3/Configuration/Components
3. Navegue até o local onde você descompactou o arquivo ZIP do componente e copie os seguintes arquivos para o diretório criado na etapa anterior:
   • lib/analytics_flash.swc: o componente Analytics
   • lib/analytics.swc: o componente da biblioteca Analytics

Ambos os componentes têm a mesma funcionalidade, mas são fornecidos como conveniência para diferentes estilos de desenvolvimento.

Componente "Analytics". Se você desenvolve conteúdo em Flash content, mas não está familiarizado com ActionScript 3, use este componente. O componente Analytics é um pacote de acompanhamento completo. Basta arrastar e soltar os componentes diretamente no palco, fazer algumas configurações simples no inspetor de componentes e você estará pronto para marcar seus controles com o acompanhamento do Google Analytics.

Componente AnalyticsLibrary. Se estiver familiarizado com ActionScript 3, você poderá usar o componente AnalyticsLibrary. Arraste o componente para a biblioteca do Flash e importe as classes de acompanhamento diretamente para o código em ActionScript.

Como usar o componente Analytics

Use o analytics_flash.swc para implementar o acompanhamento pelo componente Analytics. Coloque o componente no diretório "Component" correto. Ele aparecerá no painel "Componentes" (Janela - Componentes).

1. Arraste o componente para o cenário e dê um nome de instância na caixa de diálogo Propriedades.
2. Configure o componente no painel do Inspetor de componentes (Windows - Inspetor de componentes):
   • Adicione seu ID da propriedade da web do Google Analytics.
   • Selecione o modo Bridge ou o modo AS3.
   • Indica se a depuração visual está ativada ou desativada.
3. No código do ActionScript, adicione as chamadas de acompanhamento do GA padrão para a instância do componente recém-criado.

Devido à maneira como o flash trabalha com componentes visuais, é geralmente melhor começar a acompanhar no segundo quadro do aplicativo Flash. Se precisar inicializar o acompanhamento no primeiro quadro, coloque as chamadas de acompanhamento dentro de manipuladores de eventos para garantir que o componente seja completamente inicializado dentro do conteúdo do Flash.

Um exemplo simples de componente Analytics para Flash

O snippet de código a seguir mostra como um botão em Flash pode ser acompanhado quando alguém clica nele. Neste exemplo, a instância do botão tem o nome de playGame no ActionScript. Quando o botão é clicado, o método onButtonClick é chamado, o que, por sua vez, invoca o método trackPageview(). Isso incrementa a contagem de exibições de página para a página virtual /myGame1.

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

Voltar ao início

Como usar o componente AnalyticsLibrary

Use o arquivo analytics.swc para implementar o acompanhamento pelo componente AnalyticsLibrary. Esse componente permite instanciar um objeto de acompanhamento diretamente no seu código do AS3. Quando o componente AnalyticsLibrary estiver no local adequado, ele aparecerá no painel “Componentes”. Você poderá, então, arrastar o componente do painel Componentes para sua biblioteca e, a partir daí, importar as bibliotecas para o código em ActionScript.

Inicialize o objeto de acompanhamento

Usando o ambiente do Adobe Flash, inicialize o objeto de acompanhamento com os seguintes parâmetros:

• Faça referência ao objeto de exibição atual. No exemplo abaixo, this faz referência ao objeto de exibição.
• O ID da propriedade da Web. O ID da propriedade da Web é a string exclusiva usada para acompanhar a atividade no seu conteúdo em Flash e exibi-la para a vista da propriedade (perfil) correta na sua conta do Google Analytics.
• O modo de rastreamento. Os parâmetros válidos são Bridge ou AS3.
• O modo de depuração. Defina debug como false para uso em produção e como true para validação e solução de problemas.

Um exemplo simples de AnalyticsLibrary

No exemplo a seguir, há um clipe de filme chamado playGame no palco. Um novo objeto de acompanhamento chamado tracker é criado com um manipulador de eventos que detecta um clique do mouse. Quando o botão recebe um clique, a função onButtonClick é chamada. Para cada clique, o método trackPageview() incrementa a contagem de visualizações de página da página virtual /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");
} 

Voltar ao início