Esta página foi traduzida pela API Cloud Translation.

Acompanhamento do Google Analytics para Adobe Flash

Com o componente de acompanhamento do Google Analytics para Adobe Flash, é fácil implementar o Google Analytics no seu conteúdo em Flash. Este componente, desenvolvido pela Adobe Systems, Inc., contém todas as funcionalidades do código JavaScript do Google Analytics. O componente Rastreamento em Flash é um objeto de acompanhamento compilado nativo para o Bigtable 3, tornando a implementação do Google Analytics intuitiva em ambientes Flash e de desenvolvimento Flex.

Por que usar o acompanhamento do Flash?

Sem o componente de rastreamento do Google Analytics para Adobe Flash, o acompanhamento do conteúdo do Adobe Flash com o Google Analytics envolve vários obstáculos técnicos. Primeiro, você precisa desenvolver uma interface personalizada para o ga.js, para que seu aplicativo Flash possa executar o método adequado 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 reduzir o desempenho quando o acesso for 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árias finalidades 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 de Flash está disponível para qualquer conteúdo em Flash incorporado a 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 pode ser transferido por 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:

ID da propriedade da Web: também é conhecido como número do UA do código de acompanhamento e é semelhante a UA-xxxxx-yy, em que x's e y's são substituídos pelos números que correspondem às informações da sua conta e da vista (perfil) do objeto que você está acompanhando. Consulte Propriedade da Web para mais informações.
o modo de rastreamento: escolha o modo bridge ou o modo AS3. Esse modo determina como o acompanhamento se comunica com os servidores do Google Analytics e é descrito detalhadamente abaixo.
o modo de depuração: independentemente do ambiente ou do modo de acompanhamento usado, você pode ativar a depuração para validar e testar seu 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 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 da campanha funcione. Este parâmetro ativa o acesso de leitura ao URL da página e às informações de referência exigidas pelo código de acompanhamento do Flash. Sem allowscriptaccess, o código de acompanhamento do Analytics fica degradado corretamente. 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 a conteúdo em Flash incorporado. O modo bridge simplifica a comunicação Flash-to-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 de pageTracker, você usará esse objeto 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 é necessário fazer referência ao arquivo de origem JavaScript ga.js básico na sua página HTML. O snippet de código a seguir ilustra como isso seria configurado usando o ambiente do Adobe Flex com o ActionScript 3:
```
tracker = new GATracker( this, "UA-12345-22", "Bridge", false );
```

Para que o modo bridge funcione corretamente, ExternalInterface.available precisa ser definido como verdadeiro no código do ActionScript 3. Isso também significa que o 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 esse modo se você controla o código do Adobe Flash ActionScript 3, mas não controla o ambiente de hospedagem de seu aplicativo do Adobe Flash. Por exemplo, se você estiver desenvolvendo conteúdo em Flash para distribuição para vários sites, use o modo AS3. O modo AS3 é completamente independente do código de acompanhamento de ga.js e contém toda a funcionalidade de acompanhamento do Google Analytics. Não é necessário instalar um acompanhamento do ga.js separado neste modo. Além disso, o modo AS3 utiliza o mecanismo de armazenamento Flash para rastrear as informações de sessão do 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 vai 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. Você pode ativar o recurso de solução de problemas definindo 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 (em inglês)

Plano flexível

Controle de versões

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

Você também pode 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