Rastreamento da Atividade do Visitante dentro do conteúdo Flash Rich Media

Os sites arquitetados usando o Flash exigem atenção especial em relação à captura de ações de visitante executadas dentro do conteúdo de mídia avançada.

Usando o Flash ActionScript, você pode fazer alterações simples em seus Flash filmes existentes para permitir o rastreamento de todas as interações do visitante com o filme, como cliques em botões ou movimentos do mouse.

Para facilitar o rastreamento da atividade do Visitante no seu Flash filme, siga as etapas abaixo:

1. Adicione o seguinte código ActionScript ao seu filme. Este código representa uma função que pode ser chamada por eventos dentro do Flash filme que você deseja rastrear.

   // FLASH TAG CODE BEGIN 
   var FLASHTAGURI = "[PATH_TO_WEB_SERVER]/flashtag.txt"; 
   function tag(PAGENAME,VARIABLES) { 
   loadVariablesNum(FLASHTAGURI+”?”+"PAGENAME="+PAGENAME+"&"+VARIABLES,0); 
   } 
   // FLASH TAG CODE END
   

2. Crie um arquivo em branco com o nome flashtag.txt e coloque-o em seus servidores da Web.

3. Na função na Etapa 1, substitua o espaço reservado [PATH_TO_WEB_SERVER] pelo caminho totalmente qualificado ou relativo para o local do flashtag.txt arquivo. Por exemplo:

   var FLASHTAGURI = http://www.mysite.com/flashtag/flashtag.txt”;
   

4. Adicione o seguinte código ActionScript a todos os eventos a serem rastreados. Este código representa uma chamada de função usada para capturar dados sobre o evento:

   on(release) {tag("[PUT_PAGE_NAME_HERE]","[PUT_ADDITIONAL_VAR_HERE]");}
   

   Este exemplo ilustra o uso do evento on(release); no entanto, a função tag() pode ser referenciada por meio de qualquer evento que você queira rastrear, como um evento on(press), on(rollover), on(rollout) ou on(keypress).

   O espaço reservado [PUT_PAGE_NAME_HERE] deve ser substituído por uma string que representa o nome da página ou do evento que você está rastreando. A variável [PUT_PAGE_NAME_HERE]pode ser modificada manualmente ou por meio de referência de variável para indicar um nome exclusivo para a página ou evento dentro do Flash aplicativo. O valor que substitui o espaço reservado [PUT_PAGE_NAME_HERE] pode consistir em um nome simples ou pode ser estruturado para representar uma estrutura hierárquica semelhante a um URI completo. Por exemplo:

   on(release) {tag(“/about_us/index.swf","[PUT_ADDITIONAL_VAR_HERE]");}
   

   A Adobe recomenda que, antes da implantação do código, você compile uma especificação por escrito para nomes de páginas e nomes de eventos para facilitar o alinhamento dos requisitos de negócios e das tarefas de desenvolvimento e reduzir a possibilidade de ciclos de desenvolvimento adicionais.

5. Se desejar, variáveis adicionais podem ser coletadas e associadas a páginas ou eventos no Flash filme. Para fazer isso, substitua o espaço reservado [PUT_ADDITIONAL_VAR_HERE] por um conjunto de pares de nome=valor separados por um E comercial (&). Por exemplo:

   on(release) {tag(“/about_us/index.swf"," var1=value1&var2=value2");}
   

   As variáveis podem ser modificadas manualmente ou por meio de referência de variável para indicar atributos adicionais a serem coletados e associados à página ou ao evento. Se não houver variáveis adicionais aplicáveis para coletar, remova [PUT_ADDITIONAL_VAR_HERE].

   A configuração do rastreamento de visitantes no conteúdo de mídia Flash avançada está concluída. Quando o evento for chamado, a função de (PAGENAME,VARIABLES) tag será chamada, resultando em uma solicitação HTTP para o arquivo a seguir. Esta função será chamada além de outras funções que podem ser acionadas conforme definido no seu Flash filme:

   http://www.mysite.com/flashtag/flashtag.txt?PAGENAME=/about_us/index.swf&var1=value1&var2=value2
   

A solicitação HTTP resultante da função Flash Tag ActionScript resulta na coleta das seguintes informações em relação a cada evento dentro do Flash filme. A última linha da tabela (query do W3C Name cs-uri) representa as informações coletadas para as variáveis adicionais especificadas na sua chamada de função.