Os clientes com planos a partir do nível Tier 3 têm acesso ao acompanhamento de e-commerce no motor de reservas (BE) da RoomRaccoon. Esta funcionalidade permite monitorizar com detalhe as conversões de reservas, os valores e os tipos de quarto; essenciais para optimizar campanhas publicitárias e medir o retorno do investimento (ROI).

Recomendamos vivamente a utilização do Google Tag Manager (GTM) para configurar este acompanhamento. O GTM proporciona maior flexibilidade na gestão de etiquetas (tags), activadores (triggers) e variáveis, sem necessidade de alterar directamente o código do site ou do motor de reservas. Além disso, facilita a integração com plataformas de terceiros, como Google Analytics 4, Google Ads e Meta Pixel.

Ao seguir este guia, poderá:

• Captar dados de reservas em cada confirmação

• Enviar eventos de e-commerce estruturados para as suas ferramentas de análise

Consulte os guias para programadores da Google aqui.

Pré-requisitos

Antes de iniciar, certifique-se de que possui:

• Uma conta Google Tag Manager

• Acesso ao contêiner GTM integrado no seu motor de reservas RoomRaccoon (contacte o suporte caso tenha dúvidas)

• Uma propriedade Google Analytics 4 (GA4) associada

• Acompanhamento de e-commerce activado em GA4 através de:
   Administração > Fluxos de dados > Web > Medição avançada

Modelo de importação GTM: Acompanhamento de e-commerce pré-configurado

Para facilitar a configuração e garantir consistência, a RoomRaccoon fornece um modelo de contêiner GTM pronto a importar.
 Este modelo inclui etiquetas, activadores e variáveis pré-definidas para registar todos os principais eventos de e-commerce no motor de reservas:

Eventos incluídos:

• purchase

• add_to_cart

• begin_checkout

• add_payment_info

• search

• login

Conteúdo do contêiner:

Etiquetas:

• Etiqueta de configuração GA4 (var_GA4_ID)

• Etiquetas de eventos GA4 (purchase, add_to_cart, search, etc.)

Activadores:

• Activadores de eventos personalizados para cada evento de e-commerce

Variáveis:

• Variável pré-definida do ID GA4 (var_GA4_ID)

• Variáveis integradas activadas (URL da página, Referenciador, etc.)

Esta versão foi limpa de etiquetas de teste ou legado e está pronta para produção.

Transferir o modelo GTM (pré-configurado)

Para começar rapidamente, transfira o modelo de contêiner GTM da RoomRaccoon, desenvolvido especificamente para o acompanhamento de e-commerce.

Clique aqui para transferir o ficheiro JSON do contêiner GTM (v21)

O ficheiro inclui:

• Etiquetas de eventos GA4 (purchase, add_to_cart, begin_checkout, etc.)

• Activadores personalizados

• Configuração pré-definida de GA4

• Variáveis organizadas numa pasta designada “NEW events”

Nota: o ficheiro está comprimido. Extraia o conteúdo antes de importar o ficheiro .json para o seu espaço de trabalho GTM.

Importante: actualizar o seu ID de medição GA4

Após a importação:

1. Aceda a GTM > Variáveis

2. Localize a variável var_GA4_ID

3. Substitua G-1MDBS4KE2X pelo seu próprio ID GA4

4. Teste utilizando o modo de pré-visualização no motor de reservas

5. Guarde as alterações antes de publicar

Caso não o faça, os dados serão enviados para a conta de teste da RoomRaccoon, e não para a sua.

Pré-visualizar e testar

• Utilize o modo de pré-visualização do GTM para confirmar que as etiquetas estão a ser activadas

• Aceda ao DebugView no GA4 para verificar a recepção dos eventos

Publicar

Depois de testar:

• Submeta e publique a nova versão do contêiner

Permissões e acesso

Se o seu GTM for gerido por terceiros (desenvolvedor ou agência):

• Envie-lhes o ficheiro do contêiner e estas instruções

• Esclareça que esta é a implementação recomendada pela RoomRaccoon

Acompanhamento entre domínios: garantir atribuições correctas

Caso o site principal do hotel e o motor de reservas RoomRaccoon estejam em domínios diferentes, é necessário configurar o acompanhamento entre domínios.
 Isto garante que as sessões dos utilizadores não são divididas, mantendo a atribuição de conversões correcta no GA4.

Exemplo de utilização:

• Site principal: www.hotel-website.com

• Motor de reservas: booking.roomraccoon.com

Sem este acompanhamento, o GA4 poderá registar duas sessões separadas para um mesmo utilizador, muitas vezes classificando a origem como "Direct" ou "Referral", distorcendo os dados de marketing.

Como configurar o acompanhamento entre domínios no GTM

Passo 1: Activar ligação entre domínios na etiqueta GA4

• Caso utilize o modelo GTM fornecido, localize a etiqueta GA4 ou a variável settings 4 GA4 New

• Abra a configuração da etiqueta ou variável e adicione o seguinte campo em "Campos a definir":

  • Nome: linker

  • Valor: true

• Em "Cross-domain tracking", adicione os dois domínios:

  • www.hotel-website.com

  • booking.roomraccoon.com

Passo 2: Definir os domínios para ligação automática

• Na mesma etiqueta ou variável, adicione:

  • Nome do campo: autoLinkDomains

  • Valor: www.hotel-website.com,booking.roomraccoon.com

Nota: certifique-se de que os links entre domínios utilizam elementos <a> ou botões que mantenham os parâmetros de URL.

Testar o acompanhamento entre domínios

Após publicar:

• Utilize o DebugView do GA4 e o Tag Assistant

• Simule uma reserva desde o site principal até ao motor de reservas

• Confirme que a sessão é única no GA4

• Verifique se os campos session_source e session_medium estão correctamente atribuídos

Lembrete final

Se estiver a utilizar o modelo GTM da RoomRaccoon:
 Deverá configurar manualmente o acompanhamento entre domínios
 Isto não vem activado por defeito, uma vez que cada propriedade utiliza domínios diferentes

Variáveis GTM para dados da reserva

Para enviar valores de transacção a outras etiquetas de acompanhamento, é necessário criar três variáveis que capturam o ID da transacção, o código da moeda e o valor total.
 Estes dados são extraídos do dataLayer.push() na página de confirmação de reserva da RoomRaccoon (evento: "purchase").

1. DLV_TransActionID

• Tipo: Variável da camada de dados

• Nome: DLV_TransActionID

• Nome no dataLayer: eventModel.transaction_id
   Notas: Captura a referência única da reserva (ex: RR123456)

2. DLV_Currency

• Tipo: Variável da camada de dados

• Nome: DLV_Currency

• Nome no dataLayer: eventModel.currency
   Notas: Código ISO da moeda (ex: EUR)

3. DLV_PurchaseValue

• Tipo: Variável da camada de dados

• Nome: DLV_PurchaseValue

• Nome no dataLayer: eventModel.value
   Notas: Valor total da reserva (ex: 354.00)

Sugestões para teste

Depois de criar as variáveis:

• Utilize o modo de pré-visualização no GTM

• Valide se as três variáveis são preenchidas quando o evento “purchase” é accionado

• Verifique no separador de variáveis do debugger do GTM se os valores correctos são exibidos

Estas variáveis podem ser utilizadas com GA4, Meta Pixel, Google Ads Conversion, entre outros.

Configurar o evento de compra do Meta Pixel no GTM

Segue-se a forma de utilizar estas variáveis com o Meta Pixel:

1. Criar uma nova etiqueta

• Tipo: HTML personalizado

• Nome: Meta Pixel – Purchase

<script>

  fbq('track', 'Purchase', {

    value: {{DLV_PurchaseValue}},

    currency: '{{DLV_Currency}}',

    contents: [{

      id: '{{DLV_TransActionID}}',

      quantity: 1

    }],

    content_type: 'product'

  });

</script>

Este script envia o evento de compra com o valor, moeda e ID de transacção correctos.

2. Definir o activador

• Tipo de activador: Evento personalizado

• Nome do evento: purchase

• Nome do activador: Purchase_event_Trigger

3. Testar a configuração

• Active o modo de pré-visualização no GTM

• Realize uma reserva de teste

• Verifique no Meta Pixel Helper ou no Gestor de Eventos se:

  • O evento "Purchase" é disparado

  • Os valores de moeda e montante são correctos

  • O ID de transacção é enviado como contents.id

Dicas adicionais

• Assegure-se de que a etiqueta base do Meta Pixel está presente em todas as páginas (ou carregada via GTM)

• Caso utilize o Consent Mode, garanta que a etiqueta respeita os estados de consentimento

• Utilize a sequência de etiquetas para atrasar o envio do evento de compra até que o pixel base esteja carregado