JavaScript personalizado (códigos de rastreio)

Descrição geral

A opção JavaScript personalizado permite integrar os seus próprios scripts de rastreio ou análise diretamente na sua experiência Drimify.
É habitualmente utilizada com ferramentas como o Facebook Pixel, o Google Analytics, o Google Tag Manager ou qualquer outro serviço de terceiros que exija um excerto de código JavaScript.
Esta opção encontra-se no painel Definições do seu projeto, na secção JavaScript personalizado.

⚠️ Importante: Apenas é suportado JavaScript executado no navegador. Não é possível utilizar scripts executados no servidor ou no backend.

Para que serve

Pode utilizar o JavaScript personalizado para:

• Monitorizar visualizações de páginas e o comportamento dos utilizadores
• Acionar eventos quando a experiência é carregada
• Integrar o rastreio de conversões (por exemplo, eventos do Facebook Pixel)
• Ligar a sua experiência a ferramentas de análise ou marketing
• Adicionar lógica personalizada em ecrãs específicos

Assim, tem toda a flexibilidade para ligar a Drimify às ferramentas de rastreio que utiliza.

Como adicionar o seu script

1. Abra o seu projeto no painel da Drimify.
2. Aceda a Definições.
3. Desloque-se até à secção JavaScript personalizado.
4. Cole o seu código JavaScript diretamente no campo.
5. Confirme que a definição foi guardada e publique a sua experiência, caso ainda não o tenha feito.

O seu script será automaticamente inserido na versão publicada da sua experiência.

Exemplo: Facebook Pixel

Segue-se um exemplo de um script de rastreio padrão do Facebook Pixel que pode adicionar:

<!-- Facebook Pixel Código -->
<script>
  !function(f,b,e,v,n,t,s)
  {if(f.fbq)return;n=f.fbq=function(){n.callMethod?
  n.callMethod.apply(n,arguments):n.queue.push(arguments)};
  if(!f._fbq)f.fbq=n;n.push=n;n.loaded=!0;n.version='2.0';
  n.queue=[];t=b.createElement(e);t.async=!0;
  t.src=v;s=b.getElementsByTagName(e)[0];
  s.parentNode.insertBefore(t,s)}(window, document,'script',
  'https://connect.facebook.net/en_US/fbevents.js');
  fbq('init', 'YOUR_PIXEL_ID');
  fbq('track', 'PageView');
</script>

Substitua YOUR_PIXEL_ID pelo identificador do seu Facebook Pixel.

Rastrear um lead ou uma conversão quando alguém se regista

O JavaScript personalizado é executado uma única vez, quando a experiência é carregada. As experiências Drimify são aplicações de página única: o endereço no navegador não muda ao passar de um ecrã para o seguinte. Por isso, um script neste campo ou uma regra de URL no Gestor de Eventos da Meta não consegue detetar o momento em que um participante submete o formulário de registo. Utilize uma das duas configurações seguintes.

Opção 1: os jogadores acedem diretamente à ligação do seu jogo (por exemplo, a partir de um anúncio da Meta)

1. Na etapa Integrações da aplicação, adicione um webhook e ative a opção Após a submissão do formulário. O webhook é acionado sempre que um participante submete um formulário. Consulte Configurar integrações de webhook na sua aplicação.
2. Configure o webhook para enviar os dados para o seu próprio endpoint ou para uma ferramenta de automatização e encaminhe cada chamada para a Meta como um evento Lead, através da API de Conversões da Meta (ou de uma API equivalente do lado do servidor na sua plataforma de publicidade).

Mantenha o código base do Pixel no campo de JavaScript personalizado para rastrear as visitas ao jogo.

Opção 2: o jogo está incorporado no seu site

Carregue o Pixel na sua própria página e acione o evento através dos callbacks do código de integração HTML (widget). O callback onComplete é acionado quando o participante chega ao último ecrã. Assim, se o formulário de registo aparecer antes do ecrã final, cada chamada a onComplete corresponde a um participante registado:

widget.onComplete = function (event) {
  fbq('track', 'Lead');
};

No caso de um Calendário De Advento, Combo™ ou Percurso Dinâmico™, utilize antes onRouteChange e o ecrã final. Consulte Integração avançada do código de integração HTML (widget) através da API.

Âmbito de execução

• Os scripts são executados no navegador do participante.
• O script é executado depois de a experiência ser carregada, garantindo a compatibilidade com a maioria dos serviços de análise.

Notas de segurança

• É estritamente proibido utilizar scripts maliciosos ou intrusivos.
• Utilize apenas JavaScript de fornecedores de confiança.
• Os scripts devem cumprir o RGPD e a restante legislação aplicável em matéria de privacidade.
• É da sua responsabilidade informar os participantes sobre qualquer rastreio ou recolha de dados.

Resolução de problemas

O seu script não é executado?

• Verifique se o código está entre etiquetas <script>, caso seja necessário.
• Certifique-se de que não existem erros de sintaxe.
• Se o rastreio se basear em eventos, confirme que os respetivos acionadores estão corretamente posicionados.
• Consulte a sua plataforma de análise para confirmar se o evento foi recebido.

Precisa de ajuda?

Se tiver dúvidas sobre como integrar um determinado script, contacte o fornecedor da ferramenta de rastreio (Facebook, Google, etc.) para obter instruções.
Se considerar que o seu script deveria funcionar, mas tal não acontecer, contacte a nossa equipa de apoio e explique em detalhe o que pretende fazer.

Actualizado em: 29/10/2026