Acompanhamento do Google Analytics para Adobe Flash

O componente de acompanhamento do Google Analytics para Adobe Flash facilita a implementação do Google Analytics no seu conteúdo em Flash. Esse componente, desenvolvido pela Adobe Systems, Inc., contém todas as funcionalidades do código JavaScript do Google Analytics. O componente de acompanhamento do Flash é um objeto de acompanhamento compilado nativo do ActionScript 3, que torna a implementação do Google Analytics intuitiva em ambientes de desenvolvimento em Flash e Flex.

Por que usar o acompanhamento do Flash?

Sem o componente de acompanhamento do Google Analytics para Adobe Flash, o acompanhamento de conteúdo em Adobe Flash com o Google Analytics envolveria várias dificuldades técnicas. Primeiro, você precisa desenvolver uma interface personalizada para ga.js. Assim, seu aplicativo em Flash pode executar o método apropriado do Google Analytics, como trackPageview() ou trackEvent(). Além disso, você também deve saber com antecedência se o conteúdo em Flash terá acesso ao DOM (modelo de objeto de documento) do navegador, já que o acompanhamento falha para objetos nos quais o acesso ao DOM seja negado (em geral, quando o conteúdo reside em sites de terceiros). Isso envolve entender como usar a chamada ExternalInterface no ActionScript 3 para acessar o DOM do navegador e fazer a degradação quando o acesso é negado.

O Google Analytics para o componente Adobe Flash simplifica o acompanhamento do conteúdo em Flash e cuida muito bem do acesso DOM. Ele é útil para vários fins de acompanhamento comuns em Flash, como:

um widget em Flash incorporado a uma página HTML
um aplicativo Flex independente ou um site somente em Flash hospedado em uma página HTML
um jogo ou programa Flex/Flash distribuído em que o desenvolvedor não controla onde o widget será posicionado

Tenha em mente que os aplicativos de acompanhamento em Flash têm algumas variações estruturais em relação ao acompanhamento de páginas de websites. É essencial estar familiarizado com o acompanhamento do Google Analytics para compreender o funcionamento do plug-in. Você também pode visualizar a documentação de design desse projeto para obter informações detalhadas sobre como o modelo de acompanhamento do Google Analytics foi transportado para esse componente.

Observação:no momento, o acompanhamento do Flash está disponível para qualquer conteúdo em Flash incorporado em uma página da Web. Não há suporte no momento para o acompanhamento de dados enviados do Adobe Air, Shockwave ou por meio do Flash IDE (por exemplo, usando o Test Movie).

Ambientes de desenvolvimento com suporte

Você pode desenvolver o acompanhamento do Google Analytics para Flash no ambiente Adobe Flash ou Adobe Flex. Cada ambiente requer um componente diferente, que está disponível para download em http://code.google.com/p/gaforflash/. Esses componentes têm como base o ActionScript 3 e podem ser configurados de duas maneiras em cada ambiente:

No Adobe Flash

Adicione e configure um componente simples no inspetor de componentes e arraste-o para o cenário.
Importe as bibliotecas de acompanhamento do Flash diretamente para sua biblioteca e comece a escrever o código.

No Adobe Flex

Inclua um componente MXML configurado em um arquivo MXML.
Importe as bibliotecas de acompanhamento do Flash para seus arquivos de tags de script/AS3.

Voltar ao início

Como funciona o componente?

Para usar o componente de acompanhamento do Flash em seu ambiente, use as ferramentas visuais no Flash ou configure o objeto de acompanhamento diretamente em seu código. Independentemente de você estar configurando o componente visualmente ou por código, deve fornecer os seguintes elementos:

O ID da propriedade da Web: também é conhecido como o número de UA do seu código de acompanhamento e é semelhante a UA-xxxxx-yy, em que os x e y são substituídos pelos números que correspondem às informações da sua conta e da vista da propriedade (perfil) do objeto que você está acompanhando. Consulte Propriedade da Web para mais informações.
o modo de rastreamento: escolha o modo bridge ou AS3. Esse modo determina como o acompanhamento se comunica com os servidores do Google Analytics e é descrito detalhadamente abaixo.
Modo de depuração: independentemente do ambiente ou do modo de acompanhamento usado, é possível ativar a depuração para validar e testar o acompanhamento.

Modos de acompanhamento

Dependendo de como você distribui o conteúdo em Flash, o componente do Google Analytics para Flash se comunicará com os servidores do Google Analytics intermediando a comunicação entre o conteúdo em Flash em uma instalação existente de acompanhamento do Google Analytics ou comunicando-se diretamente com os servidores do Google Analytics. Esses dois modos são chamados de modo bridge e modo AS3, respectivamente. Os dois modos usam a mesma funcionalidade de acompanhamento do Google Analytics e é fácil alternar o aplicativo em Flash de um modo para outro. Além de escolher um modo de comunicação para o acompanhamento do Google Analytics, você também pode usar um modo de depuração para solucionar problemas ou validar o acompanhamento.

Em ambos os modos, allowscriptaccess precisa ser igual a always para que o acompanhamento de campanhas funcione. Esse parâmetro ativa o acesso de leitura ao URL da página e às informações do referenciador exigidas pelo código de acompanhamento do Flash. Sem allowscriptaccess, o código de acompanhamento do Google Analytics faz uma degradação suave. Ele ainda fornece a maioria dos dados de atividade do usuário, mas não será confirmado para o modelo de atribuição de campanha do Google Analytics.

Modo bridge

Use este modo se você controla a página HTML e o conteúdo em Flash. Esse modo é melhor se você já tiver implementado o acompanhamento do Google Analytics (ga.js) no seu site e quiser adicionar o acompanhamento ao conteúdo em Flash incorporado. O modo bridge simplifica a comunicação entre o Flash e o JavaScript, fornecendo uma interface unificada do ActionScript 3 para o código ga.js. Ele fornece a conexão das chamadas do ActionScript 3 para o Google Analytics JavaScript para que o acompanhamento funcione.

A conexão com o código de acompanhamento do Google Analytics pode ser configurada por meio do ID da propriedade da web de duas maneiras:

Método mais comum. O objeto do código de acompanhamento do Google Analytics já existe na sua página com um nome próprio, como pageTracker. Nesse caso, você fornece a referência completa do DOM para o objeto de acompanhamento. Por exemplo, se o objeto for chamado pageTracker, você se referirá a ele no código como window.pageTracker. Por exemplo, o snippet de código a seguir ilustra como isso seria configurado usando o ambiente Adobe Flex com o ActionScript 3:
```
tracker = new GATracker( this, "window.pageTracker", "Bridge", false );
```
Método alternativo. Se você não tiver criado um objeto de acompanhamento de página em sua página, poderá simplesmente passar o ID da propriedade da web, e o objeto de código de acompanhamento JavaScript será criado para você. Com esse método, ainda será necessária a referência ao arquivo de origem JavaScript ga.js de base na sua página HTML. O snippet de código a seguir ilustra como isso pode ser configurado usando o ambiente Adobe Flex com o ActionScript 3:
```
tracker = new GATracker( this, "UA-12345-22", "Bridge", false );
```

Para que esse modo funcione corretamente, ExternalInterface.available precisa ser definido como verdadeiro no código do ActionScript 3. Isso também significa que allowScriptAccess precisa ser definido como always na página HTML que incorpora o conteúdo em Flash. O exemplo a seguir ilustra o código HTML configurado para o modo de intermediação:

<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>

Voltar ao início

Modo AS3

Use este modo se você controla o código do Adobe Flash Action 3, mas não o ambiente de hospedagem do seu aplicativo Adobe Flash. Por exemplo, se você estiver desenvolvendo conteúdo em Flash para distribuição para vários sites, use o modo AS3. Esse modo é totalmente independente do código de acompanhamento ga.js e contém toda a funcionalidade de acompanhamento do Google Analytics. Não é necessário fazer uma instalação separada de rastreamento do ga.js com esse modo. Além disso, o modo AS3 utiliza o mecanismo de armazenamento do Flash para rastrear informações de sessão para o usuário.

Para determinados parâmetros do DOM, como idioma, o componente AS3 tenta recuperar os valores do navegador. Se os valores não estiverem presentes, o componente usará o valor equivalente do Flash ou usará no como padrão.

Solução de problemas e validação

O componente de acompanhamento do Google Analytics para Adobe Flash fornece um modo de depuração para simplificar a validação e a solução de problemas. Quando ativado, todos os dados são interceptados e enviados para uma tela em uma caixa de texto, em vez dos servidores do Google Analytics. Nesse modo, você pode ver os dados em tempo real que, de outra forma, seriam coletados pelo servidor. Esse recurso também ajuda a manter os dados de teste separados dos dados de produção. Para ativar o recurso de solução de problemas, defina a opção visualDebug como true no inspetor de componentes.

Exemplos

Para obter exemplos detalhados sobre a implementação do acompanhamento em diferentes ambientes de desenvolvimento, consulte:

Flash

Flex

Controle de versões

A versão mais recente dos componentes de acompanhamento está como um arquivo ZIP em http://code.google.com/p/gaforflash/downloads/list. Cada download contém todos os componentes de acompanhamento, além da documentação relacionada. O nome do arquivo de download exibirá o número da versão do código que ele contém.

Também é possível usar as seguintes instruções no código para imprimir o número da versão atual do componente no console de saída.

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

Voltar ao início