Immersive Experience 2.0 no Motor de Reservas da Cloudbeds - Configuração e Personalização

Objetivo Configurar, incorporar e manter o Immersive Experience 2.0 do Motor de Reservas da Cloudbeds no site da sua propriedade.
Indicado para Administradores, gerentes, proprietários da propriedade e o desenvolvedor do site responsável pela implementação.
Use este recurso quando Você quiser instalar, configurar, personalizar ou solucionar problemas do Immersive Experience 2.0 no site da propriedade.
Requisitos Acesso às Incorporações Premium, domínio do seu site, código da sua propriedade e acesso ao HTML do seu site.
Resultado esperado O Immersive Experience 2.0 é carregado no site autorizado da propriedade usando o script loader suportado e o modo de incorporação selecionado.
Limitações Construtores de sites baseados em modelos ou sem código podem lidar com scripts personalizados de forma diferente. Não coloque tags do componente web do Immersive Experience 2.0 dentro de iframes.

Introdução

O Immersive Experience 2.0 do Motor de Reservas da Cloudbeds incorpora a jornada de reserva diretamente no site da sua propriedade, sem usar mascaramento baseado em iframe. Seu site deve estar autorizado por meio de domínios na Lista de permissões, e o script loader suportado deve ser instalado no HTML do site antes que o componente web possa ser exibido.

Use este guia para a implementação em si e para considerações técnicas que podem afetar o fluxo de reservas, incluindo Plataformas de Gerenciamento de Consentimento (CMPs), construtores de sites, rastreamento, parâmetros de busca e personalização de estilo. Para uma visão geral do Motor de Reservas, consulte Motor de Reservas da Cloudbeds: Tudo que você precisa saber.

Conteúdo

Sobre o Immersive Experience 2.0

O Immersive Experience 2.0 do Motor de Reservas da Cloudbeds é um componente baseado na web que permite aos hóspedes buscar disponibilidade, selecionar quartos e tarifas, inserir dados do hóspede e concluir o pagamento diretamente no site da sua propriedade. Ele pode ser implementado como uma experiência em página cheia ou aberto a partir de um botão Reservar Agora.

Principais benefícios

O Immersive Experience 2.0 apresenta recursos únicos projetados para elevar a experiência de reserva dos seus hóspedes no seu próprio site:

  • Taxas de conversão mais altas: Menos cliques, tempos de carregamento mais rápidos e uma experiência de marca coesa geram mais reservas.
  • Mais personalização: Crie uma experiência única e memorável para o hóspede sem as limitações de um iframe padrão.
  • Crescimento orientado por dados: Acesse métricas e informações-chave para otimizar seu processo de reserva e aumentar as reservas diretas.
  • Maior confiança: O fluxo de reserva seguro e fluido aumenta a confiança do hóspede, incentivando-o a concluir o processo de reserva.

Componentes baseados na web vs. baseados em iframe

Em contraste com sistemas baseados em iframe, este componente integrado baseado na web oferece:

  • Tempos de carregamento do site mais rápidos
  • Personalização de marca aprimorada
  • Fluxo de reserva unificado que garante que os hóspedes permaneçam no site desde a busca inicial até a conclusão do pagamento

Como é a aparência

O Immersive Experience 2.0 oferece duas opções flexíveis de incorporação para se adequar ao design do site da sua propriedade e ao fluxo do usuário. Você pode escolher incorporar uma experiência em página cheia do Immersive Experience ou criar e incorporar uma janela do Immersive Experience.

  • O embed de página inteira funciona exatamente como o nome indica: ele insere o Motor de Reservas completo diretamente dentro de uma página do seu site, proporcionando aos hóspedes uma jornada de reserva contínua e totalmente imersiva do início ao fim.

O embed de página inteira mantém o hóspede no site da propriedade enquanto ele busca acomodações disponíveis, revisa as tarifas e monta sua reserva.

Embed de página inteira da Experiência Imersiva 2.0 mostrando resultados da busca de acomodações, opções de quarto e tarifa, resumo da reserva e botão Reservar Agora

Durante a finalização da compra, os hóspedes inserem seus dados de contato, informações adicionais opcionais, hóspedes adicionais e preferências de comunicação sem sair do fluxo de reserva incorporado.

Etapa de informações do hóspede da Experiência Imersiva 2.0 mostrando campos do hóspede principal, horário estimado de chegada, informações adicionais, opção de hóspede adicional, preferências de comunicação e resumo da reserva

Antes de concluir a reserva, os hóspedes podem revisar as políticas de check-in, check-out, cancelamento e outros termos e condições da propriedade.

Modal de Termos e Condições da Experiência Imersiva 2.0 mostrando políticas de check-in e check-out, políticas de cancelamento, termos, caixa de seleção de concordância e botão Confirmar e Concluir Reserva

  • A opção de janela incorporada (embed pop-up) oferece uma alternativa elegante e moderna. Quando um hóspede clica no botão “Reservar Agora”, um painel lateral desliza suavemente a partir da borda da tela, oferecendo uma experiência de reserva compacta, porém totalmente funcional, sem que o usuário precise sair da página atual.

Na implementação com janela, o hóspede abre a Experiência Imersiva a partir do botão Reservar Agora da propriedade, enquanto o site original permanece visível atrás do painel de reserva.

Site da propriedade mostrando o botão Reservar Agora e a Experiência Imersiva 2.0 aberta como um painel pop-up de reserva com controles de data, hóspede, código promocional, filtro e busca

O fluxo de reserva inclui:

  • Pesquisa de Disponibilidade
  • Seleção de quarto
  • Exibição de tarifa
  • Oportunidades de Upsell
  • Registro de informações do hóspede
  • Processamento seguro de pagamento

 Dentro do fluxo de reserva do Immersive Experience 2.0 (janela e página completa), os detalhes da busca do hóspede, incluindo datas, número de hóspedes, códigos promocionais, quartos selecionados e progresso da finalização da compra, são automaticamente preservados por até 10 minutos de inatividade. Se o hóspede sair brevemente do fluxo de reserva e retornar dentro desse período, ele retomará exatamente de onde parou, proporcionando uma experiência de reserva mais fluida e reduzindo possíveis desistências.

Preço e disponibilidade

O acesso ao Immersive Experience 2.0 depende da sua assinatura Cloudbeds. Se as Incorporações Premium estiverem incluídas no seu pacote, você pode acessar o Immersive Experience 2.0 na seção Premium da guia Incorporações.

Se as Incorporações Premium não estiverem incluídas no seu pacote, a seção Premium pode exibir uma opção Contato com vendas. Clique em Contato com vendas para solicitar mais informações sobre a atualização para um pacote que inclua as Incorporações Premium.

 As Incorporações Premium incluem o Immersive Experience 2.0 e soluções relacionadas de componentes web. As Incorporações Básicas continuam disponíveis para implementações mais simples baseadas em widget.

Formas de pagamento personalizadas e suporte a processadores

  • Recomendações para suporte a processadores de pagamento: Não recomendamos o uso de processadores de pagamento não suportados no Immersive Experience. Uma vez que os processadores de pagamento não estejam mais em um domínio da Cloudbeds, não temos controle sobre a segurança ou conformidade PCI.
  • Limitações atuais: Formas de pagamento personalizadas devem ser usadas apenas em ambientes hospedados neste momento.
  • Suporte futuro: A equipe do Cloudbeds Payments está trabalhando para fornecer suporte oficial a esses processadores de pagamento por meio de conexões personalizadas dentro da interface do PMS. Esse recurso está previsto para lançamento em 2026. Os clientes podem esperar detalhes mais específicos sobre o cronograma conforme nos aproximamos da data de entrega.
  • Caminho de suporte: Para orientações específicas de implementação ou dúvidas sobre formas de pagamento personalizadas, entre em contato diretamente com nossa equipe do Cloudbeds Payments. Eles gerenciam todo o SDK de pagamentos e estão melhor posicionados para ajudar você.

Instalando o Immersive Experience 2.0

Complete a configuração abaixo para autorizar o domínio do seu site, carregar o script suportado da Immersive Experience e adicionar o componente do Motor de Reservas ao seu site. As etapas se aplicam tanto para a implementação de página completa quanto para o botão Reservar Agora.

 Qualquer valor exibido como {PARAMETER} é um espaço reservado. Substitua pelo seu valor real e remova as chaves.

 Não coloque as tags do componente web Immersive Experience 2.0 dentro de um iframe. Isso pode causar problemas de rolagem e exigiria a inclusão na lista de permissões de todos os itens na cadeia de iframes, o que não é recomendado.

Passo 1: Confirme o acesso às Incorporações Premium

 Importante: O acesso às Incorporações Premium depende da sua assinatura Cloudbeds.

  • Se as Incorporações Premium estiverem incluídas no seu pacote, você pode acessar as opções do Immersive Experience 2.0 em Motor de Reservas > Incorporações > Premium.
  • Se as Incorporações Premium não estiverem incluídas no seu pacote, a seção Premium pode exibir uma opção Contatar vendas. Clique em Contatar vendas para solicitar mais informações sobre como atualizar para um pacote que inclua as Incorporações Premium.
  • Se você for cliente do Cloudbeds Websites, pode entrar em contato com a equipe do Cloudbeds Websites para orientações sobre solicitações de implementação e ativação.

Passo 2: Adicione seu domínio à lista de domínios permitidos

Adicione o domínio onde você instalará o Immersive Experience 2.0 na seção Lista de permissões da Incorporação Premium selecionada. Você pode adicionar até 5 domínios.

  1. No seu Menu da Conta Account Menu.jpg, selecione Configurações Settings icon.png
  2. Clique em Motor de Reservas Booking Engine icon.png
  3. Clique na guia Incorporações.
  4. Na seção Premium, selecione a opção Immersive Experience que deseja instalar.
  5. No cartão Lista de permissões, clique em Adicionar domínio.
  6. Insira o domínio onde o Immersive Experience será instalado e salve suas alterações.

 Tanto domínios principais quanto subdomínios são suportados, por exemplo, meu-hotel.com e reservas.meu-hotel.com.

Guia Incorporações do Motor de Reservas mostrando a seção Premium e o cartão Lista de permissões usado para adicionar um domínio autorizado ao site

 Domínios na lista de permissões: como verificar o formato correto do domínio

Às vezes, o domínio de um site pode estar configurado de forma que exija a inclusão do www. Para cobrir ambas as possibilidades, verifique o formato do domínio que seu site utiliza antes de adicioná-lo.

  1. Abra seu site e observe a URL no seu navegador.
  2. Verifique se a URL inclui www. Por exemplo, pode aparecer como https://www.seudominio.com ou https://seudominio.com.

Depois de saber qual formato seu site usa, insira o domínio correspondente no campo Domínios na lista de permissões. Por exemplo, se seu site exibe com www, adicione seu domínio como www.seudominio.com.

 Por que os domínios devem estar na lista de permissões

A Experiência Imersiva é um componente web, não um iframe. Ela roda no seu site e faz requisições de API para os serviços da Cloudbeds a partir do seu domínio. A lista de permissões informa à Cloudbeds quais origens estão autorizadas para que essas requisições entre domínios sejam aceitas.

Passo 3: Adicione o script da Experiência Imersiva

Adicione o seguinte script no elemento <head> do documento HTML do seu site:

<script
  data-entry="immersive"
  src="https://static1.cloudbeds.com/booking-engine/latest/loader.js"
  nonce="+imGC13HmyB6zTZ1eTnZMw=="
  integrity="sha384-hd98w88pqnDT+lRLwyII/mRmbacols+VWYZF3HKdxnIlTYO+cF38GA1/I/+V8U4a"
  crossorigin="anonymous"
  type="text/plain"
  data-categories="essential"
></script>

 Se seu site usa uma Plataforma de Gerenciamento de Consentimento (CMP), conclua a configuração da CMP antes de publicar a implementação. Os requisitos da CMP variam conforme o provedor.

Passo 4: Incorpore o Motor de Reservas

Você pode exibir a Experiência Imersiva de duas formas:

  • Modo padrão (incorporação em página completa): Também conhecido como “incorporação em página completa”, este é o modo padrão onde o aplicativo do Motor de Reservas é totalmente integrado ao site anfitrião. Para incorporá-lo, inclua o seguinte trecho no HTML onde ele deve ser exibido:
<cb-immersive-experience mode="standard" property-code="{PROPERTY_CODE}" />
  • Modo popup (botão reservar agora): Este modo exibe o aplicativo do Motor de Reservas como uma janela com posição fixa e sobreposição. Para adicionar um botão Reservar Agora que abre a Experiência Imersiva em uma janela:
<cb-book-now-button property-code="{PROPERTY_CODE}" />

  Se você omitir o atributo mode, o componente usará o valor padrão standard.

 Encontre seu Código da Propriedade

Acesse o Menu da Conta > Configurações > Motor de Reservas > Guia Resumo. Seu código é o valor alfanumérico de 6 caracteres no final do link do seu Motor de Reservas:

https://hotels.cloudbeds.com/reservation/{PROPERTY_CODE}

No exemplo abaixo, o segmento destacado é o Código da Propriedade que você deve usar na sua incorporação (substitua as chaves e o valor no seu trecho).

Se o seu site usa uma Plataforma de Gerenciamento de Consentimento (CMP), configure a Experiência Imersiva para que os recursos necessários da Cloudbeds sejam tratados como essenciais e não sejam bloqueados antes que o fluxo de reservas possa carregar. Siga a configuração específica do provedor abaixo antes de publicar as alterações no site.

Use a configuração específica do provedor que se aplica ao seu CMP:

  • Cookiebot: data-cookieconsent="ignore"
  • OneTrust: data-ignore-consent="true"
  • Quantcast: data-quantcast-ignore="true"
  • Termly: Adicione o mapa de bloqueio personalizado abaixo antes do script do Termly, preferencialmente próximo ao início do HTML.
<script data-termly-config>
 window.TERMLY_CUSTOM_BLOCKING_MAP = {
  "cloudbeds.com": "essential",
  "clientstream.launchdarkly.com": "essential",
  "clientsdk.launchdarkly.com": "essential",
  "tile.openstreetmap.org": "essential",
  "tokenex.com": "essential",
  "stripe.com": "essential",
  "stripe.network": "essential",
  "braintreegateway.com": "essential",
  "dlocal.com": "essential",
  "authorize.net": "essential",
  "pagosonline.net": "essential",
  "paypal.com": "essential",
  "adyen.com": "essential"
 };
</script>

Classifique o carregador da Experiência Imersiva como necessário ou essencial na configuração do seu CMP. Use o ponto de entrada atual do carregador abaixo. O uso direto do cb-immersive-experience.js está obsoleto.

<script
  data-entry="immersive"
  src="https://static1.cloudbeds.com/booking-engine/latest/loader.js"
  nonce="+imGC13HmyB6zTZ1eTnZMw=="
  integrity="sha384-hd98w88pqnDT+lRLwyII/mRmbacols+VWYZF3HKdxnIlTYO+cF38GA1/I/+V8U4a"
  crossorigin="anonymous"
  type="text/plain"
  data-categories="essential"
></script>

 Aceitar o consentimento não desbloqueia um script que já tentou carregar. Após aceitar o consentimento, os hóspedes devem atualizar a página para que os recursos de mapa, imagem e pagamento previamente bloqueados apareçam.

Considerações sobre a configuração e solução de problemas

As seções abaixo destacam comportamentos e detalhes da implementação que são úteis saber antes de entrar no ar.

Compatibilidade com construtores de sites

  A Experiência Imersiva foi testada com sites personalizados. Construtores de sites com modelos ou sem código podem lidar com scripts personalizados de forma diferente, o que pode afetar a funcionalidade.

  • Injeção no head: Confirme que você pode adicionar o <script> da Experiência Imersiva dentro da tag <head> da página.
  • Lista de permissões: Certifique-se de que seus domínios ao vivo (e quaisquer domínios de teste/pré-visualização) estejam adicionados no cartão Domínios na lista de permissões para que as requisições da API sejam aceitas. Você pode adicionar até 5 domínios.
  • CSS/JS personalizado: Estilos ou scripts adicionados na seção de personalização do Motor de Reservas não são aplicados automaticamente à Experiência Imersiva; adicione-os diretamente no HTML do seu site.
  • Página de pagamento: A etapa de pagamento pode variar dependendo da Forma de Pagamento selecionada.
  • Se o hóspede escolher Apple Pay, Google Pay ou outra opção de pagamento de Terceiro, ele será redirecionado para a página do respectivo Terceiro para concluir o pagamento.
  • Após a transação ser concluída com sucesso, ele será redirecionado de volta para a página de confirmação da Experiência Imersiva.
  • Links profundos e parâmetros: Os parâmetros de busca são lidos apenas na carga inicial. Se você alterar a URL depois que o aplicativo carregar, recarregue a página para aplicá-los.

Portais

O Motor de Reservas exibe vários elementos em uma posição fixa na tela, por exemplo:

  • Modais
  • Dicas de ferramenta
  • Calendário
  • Verificador de tarifa
  • Banner do carrinho de compras (no celular)
  • Seletor de idioma e moeda

Esses elementos são exibidos dentro de um portal, o que significa que, em vez de seguir a estrutura da árvore DOM, eles são envolvidos por um elemento com a classe estática .cb-portal e adicionados ao final do body. Os portais possuem diferentes valores de z-index conforme a camada correspondente em nosso contexto de empilhamento.

A maioria dos sites possui seus próprios contextos de empilhamento e, dependendo de como são definidos no eixo z imaginário, podem ou não entrar em conflito com os contextos de empilhamento da Experiência Imersiva.

Por exemplo, se não forem definidos corretamente, o Verificador de Tarifas da Experiência Imersiva pode ser exibido sobre o menu de navegação móvel que pertence ao site da propriedade, ou um elemento flutuante no site da propriedade pode aparecer sobre o botão “Reservar Agora” no banner do carrinho de compras no celular, bloqueando-o e, portanto, impedindo o usuário de continuar com o processo de reserva.

No momento, temos 4 tipos de portais: modal, popover, sticky e tooltip. O tipo de portal usado em cada caso depende do tipo de elemento para o qual o portal é destinado. Portanto, todos os modais usarão um portal modal, o popover do Calendário e os seletores de idioma e moeda usam um portal popover, enquanto o banner do carrinho de compras no celular e o Verificador de Tarifas usam um portal sticky, para dar alguns exemplos.

Dependendo do tipo de portal, estes são os valores que a Experiência Imersiva usa para a propriedade CSS z-index:

  • Modal: 1400
  • Popover: 1500
  • Sticky: 1100
  • Tooltip: 1800

Solução de problemas com sobreposição de elementos

Quando enfrentar problemas com elementos exibidos pela Experiência Imersiva que estão sobrepondo outros elementos do site principal, recomendamos procurar o portal (elemento com a classe estática .cb-portal) que o contém e ajustar o valor do z-index conforme necessário, ou ajustar o valor do z-index do elemento do site principal.

Os valores de z-index para os diferentes tipos de portais renderizados pela Experiência Imersiva serão personalizáveis apenas redefinindo as variáveis CSS usadas para esse propósito, conforme mostrado no exemplo abaixo:

<style>
/* Abrangência para a raiz do Motor de Reservas ao sobrescrever */
.cb-bookingengine-root {
  --booking-engine-zIndices-sticky: 1100;
  --booking-engine-zIndices-modal: 1400;
  --booking-engine-zIndices-popover: 1500;
  --booking-engine-zIndices-tooltip: 1800;
}
</style>

 O Verificador de Tarifas está incluído em todos os pacotes do Motor de Reservas da Cloudbeds exceto nos planos Antigos. Propriedades com pacotes ativos podem ativá-lo sem custo adicional.

 

Parâmetros de busca e rastreamento

A Experiência Imersiva pode ler os parâmetros de busca suportados quando o aplicativo é carregado pela primeira vez e pode funcionar com ferramentas de análise e publicidade baseadas no site. Use as seções de referência abaixo quando precisar passar valores de busca, configurar o rastreamento ou entender os parâmetros do Google Hotel Ads.

Parâmetros de pesquisa

A Experiência Imersiva suporta os mesmos parâmetros de busca da versão hospedada. Os parâmetros são lidos apenas na carga inicial e não são atualizados dinamicamente.

Nome Tipo Descrição Exemplo
adults Número A quantidade de adultos para a reserva, usada na busca por acomodações disponíveis. adults=2
allotment_block_code Texto O código do bloqueio de alocação a ser usado ao buscar acomodações para as datas selecionadas. allotment_block_code=b123456
checkin AAAA-MM-DD A data selecionada para o check-in. checkin=2025-12-01
checkout AAAA-MM-DD A data selecionada para o check-out. Se o checkin for fornecido, mas o checkout não, o padrão será o dia seguinte. checkout=2025-12-01
currency Código ISO-4217 de 3 letras Moeda selecionada. Se nenhuma for fornecida, o Motor de Reservas usará a padrão da propriedade. currency=brl
crianças Número Quantidade de crianças para a reserva, usada na busca por acomodações disponíveis. crianças=1
promo Texto Código promocional para usar ao buscar acomodações para as datas selecionadas. promo=superpromo
rate_plan Texto separado por ponto e vírgula Para filtrar os resultados de acomodações com base nos planos tarifários, corresponde ao “Nome do Plano Tarifário Privado” no PMS. rate_plan=3DAYSTAY;LOWSEASON
rid Texto numérico separado por ponto e vírgula Lista de IDs de quartos para filtrar os resultados de acomodações. rid=27434;23421
room_type Texto de 3 letras separado por ponto e vírgula Corresponde à “Abreviação da Acomodação” no PMS e é usado para filtrar os resultados de acomodações. Se não forem fornecidos check-in e finalização da compra, o Motor de Reservas seleciona automaticamente amanhã e o dia seguinte. room_type=PRI;SHA
utm_source Texto Usado para identificar a origem da campanha de marketing (ex: Google, TripAdvisor, Trivago) utm_source=Google

Rastreamento e análise

A Experiência Imersiva suporta os mesmos parâmetros de busca que a versão hospedada. Os parâmetros são lidos a partir da localização da janela apenas no carregamento inicial do aplicativo, o que significa que alterações dinâmicas nos parâmetros de busca não terão impacto na Experiência Imersiva após seu carregamento.

Além disso, a Experiência Imersiva não atualiza a URL da janela como a versão hospedada faz após certas ações do usuário (por exemplo, selecionar datas de check-in e check-out).

  • Google Analytics 4 / GTM: O ID da tag do Google ou o ID do container do GTM deve ser inicializado no site da propriedade.
  • Google Ads: O rastreamento de conversão requer configuração manual no site da propriedade.
  • Meta Pixel: O script do Meta Pixel deve ser adicionado no <head> do HTML para inicialização.

Para detalhes adicionais de configuração, consulte a documentação de cada plataforma de rastreamento.

Adicione manualmente os scripts do Google Tag Manager (GTM) ou do Google Analytics 4 (GA4) no <head> do seu HTML para habilitar o rastreamento.

Parâmetros de busca do Google Hotel Ads

Esses parâmetros são adicionados pelo Google Hotel Ads e o Motor de Reservas os envia ao servidor na requisição ao fazer uma reserva:

Parâmetro
gha_advance_booking_window
gha_campaign_id
gha_google_site
gha_is_ad_click
gha_is_click_type_hotel
gha_is_click_type_room
gha_is_hotel_campaign
gha_is_promoted
gha_length
gha_payment_id
gha_price_displayed_total
gha_promo_code
gha_user_country
gha_user_currency
gha_user_device
gha_user_language
gha_user_list_id

Personalizando o Immersive Experience 2.0

Adapte o Immersive Experience usando atributos dos componentes, além do seu próprio CSS/JS no seu site.

 Códigos personalizados podem exigir manutenção ao longo do tempo

  • À medida que o Motor de Reservas evolui, personalizações aplicadas por você podem parar de funcionar ou precisar de atualizações.
  • Sempre que possível, teste as alterações em uma cópia de teste ou rascunho do seu site antes de publicar.

Atributos do componente para cb-immersive-experience e cb-book-now-button

Esses atributos são compartilhados pelos modos Padrão e Janela (consulte: Como incorporar o Motor de Reservas).

Os seguintes atributos são todos opcionais (exceto o property-code) e ambos os componentes web cb-immersive-experience e cb-book-now-button os suportam.

Nome Tipo Obrigatório Valor padrão Descrição
moeda (*) Código de moeda ISO-4217 de 3 letras Não Moeda padrão da Propriedade A moeda a ser usada para a carga inicial da Experiência Imersiva.
disable-css-title-reset yes | no Não no yes deve ser usado se a Propriedade quiser definir suas próprias regras CSS para os títulos na interface (h1… h6).
hide-custom-header yes | no Não no Para ocultar o cabeçalho personalizado definido no PMS.
hide-custom-footer yes | no Não no Para ocultar o rodapé personalizado definido no PMS.
hide-property-info yes | no Não no Para ocultar a seção de Informações da Propriedade em todas as páginas.
ignore-search-params (*) yes | no Não no A Experiência Imersiva, por padrão, lê os parâmetros de consulta na URL do site anfitrião e os utiliza no carregamento inicial do aplicativo. Ela suporta os mesmos parâmetros que o Motor de Reservas hospedado.
lang (*) auto-detect | código de idioma ISO 639-1 de 2 letras Não Idioma padrão da Propriedade. O idioma a ser usado no carregamento inicial da Experiência Imersiva; se nenhum for fornecido, a Experiência Imersiva verificará o atributo lang do HTML; se também não estiver definido, será usado o idioma padrão da propriedade. Se o valor auto-detect for fornecido, a Experiência Imersiva será carregada no idioma do navegador do usuário.
mode standard | popup Não standard O modo em que a Experiência Imersiva deve ser exibida. O modo popup deve ser usado quando a Experiência Imersiva for exibida dentro de um contêiner com altura fixa ou altura máxima.
property-code (*) Código alfanumérico de 6 dígitos que identifica sua propriedade. Sim Não aplicável O código alfanumérico de 6 dígitos que representa a propriedade. É o mesmo código usado na URL do Motor de Reservas: https://hotels.cloudbeds.com/reservation/{PROPERTY_CODE}.

  Os atributos marcados para o carregamento inicial são lidos apenas uma vez quando o aplicativo é iniciado. Alterá-los posteriormente na sua propriedade não afetará uma Experiência Imersiva já carregada.

Atributos personalizados do botão Reservar Agora

Essas opções se aplicam ao componente cb-book-now-button (confira a seção Incorporar o Motor de Reservas) e permitem que você estilize o botão e controle a etiqueta e as dimensões da janela.

Atributo Descrição
class-name Classe CSS para estilizar o botão.
close-label Etiqueta personalizada para o botão de fechar.
height Altura da janela.
width Largura da janela.

Exemplo do botão Reservar Agora com etiqueta, tamanho e classe CSS:

<cb-book-now-button
  property-code="{PROPERTY_CODE}"
  class-name="cb-book-now-button"
  label="Reservar Agora"
  height="90vh"
  width="90vw"
/>

Adicionar CSS e JavaScript personalizados para a Experiência Imersiva

O CSS ou JavaScript personalizado adicionado nos campos de personalização do Motor de Reservas não se aplica automaticamente à Experiência Imersiva. Eles devem ser adicionados manualmente ao documento HTML.

Adicione o atributo data-cb-immersive-experience-root às tags style e script para evitar conflitos.

Exemplo de CSS personalizado:

<style data-cb-immersive-experience-root>
  :is(#cb-bookingengine, .cb-bookingengine-root) {
    h1 {
      font-family: serif;
      font-size: 24px;
    }
  }
</style>

Próximo passo

Após instalar e testar o Immersive Experience 2.0 no seu domínio autorizado, avalie o guia da guia Incorporações do Motor de Reservas da Cloudbeds quando precisar comparar ou configurar outras opções de incorporação.

Esse artigo foi útil?
Usuários que acharam isso útil: 0 de 0

Comentários

0 comentário

Por favor, entre para comentar.