Integração do Pixel Sojern

Se você está executando campanhas publicitárias através do Sojern, pode conectar sua conta Sojern ao Wink inserindo seu ID do Contêiner GTM do Sojern no portal Wink. Uma vez conectado, o pixel de rastreamento do Sojern é disparado automaticamente para sua propriedade — cobrindo toda a jornada do hóspede desde a busca até a reserva concluída.

Dica

Isso pressupõe que você já tenha uma conta Sojern ativa e tenha recebido seu ID do Contêiner GTM do seu gerente de conta Sojern. Se você ainda não tem uma conta Sojern, visite sojern.com/contact para começar.

---

O Que Você Precisa Fazer

1. Obtenha seu ID do Contêiner GTM do Sojern

   Entre em contato com seu gerente de conta Sojern e solicite seu ID do Contêiner GTM. Ele segue o formato GTM-XXXXXXX. Isso é diferente do seu ID do Pixel Sojern — certifique-se de pedir especificamente pelo ID do Contêiner GTM.

2. Insira no Portal Wink

   Faça login em my.wink.travel, selecione sua conta e vá para a aba Customizações. Cole seu ID do Contêiner GTM do Sojern no campo Sojern e salve. Sua integração estará ativa.

3. Confirme com seu Gerente de Conta Sojern

   Informe ao seu gerente de conta Sojern que a integração está ativa. Ele pode verificar do lado deles se o pixel está disparando corretamente em wink.travel para sua propriedade e se os dados estão fluindo para sua conta Sojern.

Nota

Você não precisa colocar nenhum código de pixel em seu próprio site para esta integração. O Wink carrega seu contêiner Sojern automaticamente em todas as páginas onde sua propriedade está ativa.

Esta configuração funciona para qualquer ID de Contêiner GTM personalizado. Usamos o Sojern apenas como exemplo, pois é uma integração muito comum.

---

O Que o Wink Faz do Nosso Lado

Para transparência, aqui está o que o Wink configura para fazer essa integração funcionar:

• Um campo para o ID do Contêiner GTM do Sojern está disponível na aba Customizações do seu portal Wink. Quando você insere seu ID do Contêiner, o Wink valida o formato e o armazena com segurança vinculado à sua propriedade.
• Em todas as páginas onde sua propriedade está ativa no Wink, seu ID do Contêiner GTM do Sojern é renderizado na página e o sistema de gerenciamento de tags do Wink carrega dinamicamente seu contêiner Sojern junto com o seu próprio. Isso acontece automaticamente — não são necessários passos manuais da equipe Wink por propriedade.
• Seu contêiner Sojern é carregado de forma assíncrona, o que significa que não afeta o desempenho de carregamento da página para seus hóspedes.
• O rastreamento próprio do Wink e o pixel Sojern rodam em paralelo, lendo dos mesmos dados de evento compartilhados. Cada evento de reserva que o Wink rastreia está simultaneamente disponível para seu contêiner Sojern.
• Quando sua propriedade não está sendo visualizada — por exemplo, quando um hóspede está navegando por outro hotel no Wink — seu contêiner Sojern não é carregado. Isso garante que o Sojern receba apenas dados relevantes para sua propriedade.

---

Referência do DataLayer

O Wink envia eventos compatíveis com GA4 para o dataLayer durante toda a jornada do hóspede. Seu contêiner GTM lê deste mesmo dataLayer compartilhado, então qualquer gatilho ou variável que você configurar tem acesso a todas as propriedades descritas abaixo.

Cada evento segue a estrutura padrão GA4 Enhanced Ecommerce: uma string event de nível superior e um objeto ecommerce. Antes de cada push, o Wink limpa o payload ecommerce anterior para evitar que dados antigos vazem para novos gatilhos.

Nota

Padrão de reset do dataLayer

O Wink reseta o objeto ecommerce antes de cada push de evento:

dataLayer.push({ ecommerce: null });   // limpa evento anterior
dataLayer.push({ event: '...', ecommerce: { ... } });

Não confie na persistência das propriedades ecommerce entre eventos. Sempre leia-as no momento do gatilho dentro do mesmo evento.

---

Eventos da Jornada de Reserva

Esses eventos disparam automaticamente conforme o hóspede avança pelo funil de reserva. Configure seus gatilhos GTM como gatilhos de Evento Personalizado que correspondam aos nomes dos eventos abaixo.

Etapa	Evento	Quando Dispara
1	view_item_list	Grade ou lista de inventário de hotéis carregada
2	view_item	Hóspede visualiza uma página específica da propriedade
3	add_to_cart	Hóspede adiciona um quarto ao carrinho
4	begin_checkout	Página de checkout/pagamento carregada
5	add_payment_info	Hóspede seleciona um método de pagamento
6	login	Hóspede autentica via SSO
7	purchase	Reserva confirmada
8	refund	Reserva cancelada

---

view_item_list

Dispara quando uma grade ou lista de inventário de hotéis é renderizada.

{
  "event": "view_item_list",
  "ecommerce": {
    "item_list_id": "featured_hotels",
    "item_list_name": "Featured Hotels",
    "items": [ ]
  }
}

---

view_item

Dispara quando um hóspede visualiza uma propriedade específica.

{
  "event": "view_item",
  "ecommerce": {
    "currency": "USD",
    "value": 299.00,
    "items": [ ]
  }
}

---

add_to_cart

Dispara quando um hóspede adiciona um quarto ao carrinho.

{
  "event": "add_to_cart",
  "ecommerce": {
    "currency": "USD",
    "value": 299.00,
    "items": [ ]
  }
}

---

begin_checkout

Dispara quando a página de checkout/pagamento é carregada.

{
  "event": "begin_checkout",
  "ecommerce": {
    "currency": "USD",
    "value": 299.00,
    "coupon": "SUMMER10",
    "items": [ ]
  }
}

coupon está presente apenas quando um código de desconto foi aplicado.

---

add_payment_info

Dispara quando o hóspede seleciona ou confirma um método de pagamento.

{
  "event": "add_payment_info",
  "ecommerce": {
    "currency": "USD",
    "value": 299.00,
    "coupon": "SUMMER10",
    "payment_type": "STRIPE",
    "items": [ ]
  }
}

payment_type é preenchido a partir do tipo de adquirente de pagamento. coupon está presente apenas quando um código de desconto foi aplicado.

---

login

Dispara quando um hóspede autentica via single sign-on.

{
  "event": "login",
  "ecommerce": {
    "method": "IAM"
  }
}

---

purchase

Dispara quando uma reserva é confirmada.

{
  "event": "purchase",
  "ecommerce": {
    "currency": "USD",
    "transaction_id": "bc-a1b2c3d4",
    "value": 299.00,
    "coupon": "SUMMER10",
    "shipping": 0.00,
    "tax": 0.00,
    "items": [
      {
        "item_id": "rr-xyz789",
        "item_name": "Deluxe Ocean Suite",
        "item_brand": "Grand Resort",
        "item_category": "GUEST_ROOM",
        "price": 299.00,
        "quantity": 1,
        "property_id": "prop-abc123",
        "property_name": "Grand Resort Maldives",
        "property_brand": "Grand Collection",
        "property_chain": "Luxury Hotels International",
        "city_name": "Malé",
        "country_code": "MV",
        "start_date": "2026-06-01",
        "end_date": "2026-06-05",
        "num_adults": 2,
        "num_children": 0,
        "cancellation_policy": "Refundable",
        "rate_plan_id": "rp-summer2026",
        "room_rate_id": "rr-xyz789",
        "room_rate_name": "Summer Escape — Bed & Breakfast",
        "num_perks": 2,
        "room_location": "Overwater",
        "room_view": "Ocean",
        "room_classification": "Suite"
      }
    ]
  }
}

transaction_id é o identificador único do contrato de reserva. coupon, shipping e tax estão presentes apenas quando aplicáveis.

---

refund

Dispara quando uma reserva é cancelada.

{
  "event": "refund",
  "ecommerce": {
    "currency": "USD",
    "transaction_id": "bc-a1b2c3d4",
    "value": 299.00,
    "coupon": "SUMMER10",
    "shipping": 0.00,
    "tax": 0.00,
    "items": [ ]
  }
}

transaction_id corresponde ao evento purchase da mesma reserva. coupon, shipping e tax estão presentes apenas quando aplicáveis.

---

Propriedades do Item

Todos os eventos que incluem um array items compartilham o mesmo esquema de item. Cada propriedade é opcional, a menos que marcada como obrigatória.

Campos padrão GA4

Esses campos são nativamente entendidos pelo GA4 e aparecem em relatórios padrão de ecommerce sem configuração adicional.

Propriedade	Tipo	Obrigatório	Descrição
item_id	string	Sim	Identificador único para o quarto ou produto
item_name	string	—	Nome do quarto ou produto
affiliation	string	—	Nome do afiliado ou vendedor
coupon	string	—	Código de cupom aplicado ao item
currency	string	—	Código de moeda ISO 4217 (ex: USD)
creative_name	string	—	Nome criativo usado em uma promoção
creative_slot	string	—	Posição do slot da peça promocional
discount	number	—	Valor do desconto aplicado
index	number	—	Posição na lista (base 1)
item_brand	string	—	Nome do hotel ou marca
item_category	string	—	Tipo de produto — ex: GUEST_ROOM, ACTIVITY, ATTRACTION, MEETING_ROOM, RESTAURANT, SPA
item_list_id	string	—	Identificador da lista a que o item pertence
item_list_name	string	—	Nome exibido da lista
location_id	string	—	Coordenadas geográficas da propriedade
price	number	—	Preço unitário
promotion_id	string	—	Identificador da promoção
promotion_name	string	—	Nome exibido da promoção
quantity	number	—	Quantidade (padrão 1)

Parâmetros personalizados com escopo de item

Esses parâmetros carregam contexto de reserva específico do Wink. O GA4 não os exibe automaticamente em relatórios — você deve registrar cada um como uma dimensão personalizada com escopo de item na sua propriedade GA4 antes que apareçam em explorações ou relatórios padrão. Veja Dimensões Personalizadas no GA4 abaixo para instruções.

Propriedade	Tipo	Descrição
property_id	string	Identificador da propriedade Wink
property_name	string	Nome exibido da propriedade
property_brand	string	Marca à qual a propriedade pertence
property_chain	string	Cadeia à qual a propriedade pertence
property_url_name	string	Slug amigável para URL da propriedade
city_name	string	Cidade onde a propriedade está localizada
country_code	string	Código do país ISO 3166-1 alfa-2
start_date	string	Data do check-in no formato YYYY-MM-DD
end_date	string	Data do check-out no formato YYYY-MM-DD
num_adults	number	Número de adultos na reserva
num_children	number	Número de crianças na reserva
cancellation_policy	string	Um dos: Refundable, Non-Refundable, Refundable-With-Restrictions, Non-Refundable-With-Restrictions
rate_plan_id	string	Identificador do plano tarifário
room_rate_id	string	Identificador da tarifa específica do quarto
room_rate_name	string	Nome exibido da tarifa do quarto
num_perks	number	Número de benefícios incluídos na tarifa
room_location	string	Descrição da localização do quarto (ex: Overwater, Garden)
room_view	string	Descrição da vista do quarto (ex: Ocean, City)
room_classification	string	Classificação ou categoria do quarto (ex: Suite, Standard)
bed_type	string	Configuração da cama do quarto (ex: King, Twin)

---

Dimensões Personalizadas no GA4

O GA4 ignora parâmetros personalizados de item em relatórios até que você os registre explicitamente como dimensões personalizadas com escopo de item. Você só precisa registrar os parâmetros que pretende usar em relatórios — não é necessário registrar todos os 20.

1. Abra Definições Personalizadas

   No GA4, vá para Admin (ícone de engrenagem no canto inferior esquerdo) → selecione sua propriedade → Exibição de dados → Definições personalizadas.

2. Crie uma nova dimensão personalizada

   Clique em Criar dimensões personalizadas.

3. Preencha os detalhes da dimensão

   • Nome da dimensão — o rótulo legível que aparece nos relatórios GA4 (veja a tabela abaixo)
   • Escopo — selecione Item
   • Parâmetro do evento — o nome exato do parâmetro conforme aparece no dataLayer (veja a tabela abaixo)
   • Descrição — opcional, mas recomendada

4. Salve e repita

   Clique em Salvar, depois repita para cada parâmetro que deseja rastrear.

Nota

Dimensões personalizadas podem levar até 24 horas para começar a aparecer nos relatórios GA4 após o registro. Dados históricos coletados antes do registro não são preenchidos retroativamente.

O GA4 permite até 50 dimensões personalizadas com escopo de item por propriedade em propriedades padrão (propriedades 360 permitem mais).

Use a tabela a seguir como referência ao criar dimensões personalizadas. O valor do Parâmetro do evento deve corresponder exatamente — o GA4 diferencia maiúsculas de minúsculas.

Nome da dimensão	Parâmetro do evento	Tipo
ID da propriedade	property_id	Texto
Nome da propriedade	property_name	Texto
Marca da propriedade	property_brand	Texto
Cadeia da propriedade	property_chain	Texto
Nome URL da propriedade	property_url_name	Texto
Nome da cidade	city_name	Texto
Código do país	country_code	Texto
Data do check-in	start_date	Texto
Data do check-out	end_date	Texto
Número de adultos	num_adults	Número
Número de crianças	num_children	Número
Política de cancelamento	cancellation_policy	Texto
ID do plano tarifário	rate_plan_id	Texto
ID da tarifa do quarto	room_rate_id	Texto
Nome da tarifa do quarto	room_rate_name	Texto
Número de benefícios	num_perks	Número
Localização do quarto	room_location	Texto
Vista do quarto	room_view	Texto
Classificação do quarto	room_classification	Texto
Tipo de cama	bed_type	Texto

---

Eventos Adicionais Disponíveis

Os seguintes eventos estão disponíveis no dataLayer do Wink, mas não fazem parte do funil padrão de reserva. Eles podem ser disparados por outras interações na plataforma.

add_to_wishlist

{
  "event": "add_to_wishlist",
  "ecommerce": {
    "currency": "USD",
    "value": 299.00,
    "items": [ ]
  }
}

remove_from_cart

{
  "event": "remove_from_cart",
  "ecommerce": {
    "currency": "USD",
    "value": 299.00,
    "items": [ ]
  }
}

select_item

{
  "event": "select_item",
  "ecommerce": {
    "item_list_id": "featured_hotels",
    "item_list_name": "Featured Hotels",
    "items": [ ]
  }
}

view_cart

{
  "event": "view_cart"
}

Nenhum payload ecommerce é incluído com este evento.

view_promotion

{
  "event": "view_promotion",
  "ecommerce": {
    "creative_name": "Summer Banner",
    "creative_slot": "hero",
    "promotion_id": "promo_001",
    "promotion_name": "Summer Sale",
    "items": [ ]
  }
}

select_promotion

{
  "event": "select_promotion",
  "ecommerce": {
    "creative_name": "Summer Banner",
    "creative_slot": "hero",
    "promotion_id": "promo_001",
    "promotion_name": "Summer Sale",
    "items": [ ]
  }
}

search

{
  "event": "search",
  "ecommerce": {
    "search_term": "beachfront resort"
  }
}

select_content

{
  "event": "select_content",
  "ecommerce": {
    "content_type": "hotel",
    "content_id": "prop_12345"
  }
}

share

{
  "event": "share",
  "ecommerce": {
    "method": "copy_link",
    "content_type": "hotel",
    "item_id": "prop_12345"
  }
}

sign_up

{
  "event": "sign_up",
  "ecommerce": {
    "method": "email"
  }
}

generate_lead

{
  "event": "generate_lead",
  "ecommerce": {
    "currency": "USD",
    "value": 0.00
  }
}

join_group

{
  "event": "join_group",
  "ecommerce": {
    "group_id": "group_abc"
  }
}

earn_virtual_currency

{
  "event": "earn_virtual_currency",
  "ecommerce": {
    "virtual_currency_name": "WinkPoints",
    "value": 100
  }
}

spend_virtual_currency

{
  "event": "spend_virtual_currency",
  "ecommerce": {
    "virtual_currency_name": "WinkPoints",
    "value": 50,
    "item_name": "Room Upgrade"
  }
}

level_start

{
  "event": "level_start",
  "ecommerce": {
    "level_name": "Gold"
  }
}

level_end

{
  "event": "level_end",
  "ecommerce": {
    "level_name": "Gold",
    "success": true
  }
}

level_up

{
  "event": "level_up",
  "ecommerce": {
    "level": 2,
    "character": "traveler"
  }
}

post_score

{
  "event": "post_score",
  "ecommerce": {
    "score": 980,
    "level": 2,
    "character": "traveler"
  }
}

unlock_achievement

{
  "event": "unlock_achievement",
  "ecommerce": {
    "achievement_id": "first_booking"
  }
}

tutorial_begin

{
  "event": "tutorial_begin",
  "ecommerce": {}
}

tutorial_complete

{
  "event": "tutorial_complete",
  "ecommerce": {}
}

---

virtualPageView

Este é um evento personalizado do Wink — não faz parte do conjunto padrão de eventos GA4. Ele é enviado a cada navegação de página e carrega contexto de dispositivo e sessão. Não inclui um objeto ecommerce.

{
  "event": "virtualPageView",
  "device": "Desktop",
  "deviceAgent": "Mozilla/5.0 ...",
  "os": "MacOS",
  "path": "/hotels/grand-resort",
  "title": "Grand Resort — Wink",
  "userId": "user_abc123",
  "startDate": "2026-06-01",
  "endDate": "2026-06-05",
  "guests": "2",
  "rooms": "1"
}

Propriedade	Descrição
device	Tipo de dispositivo detectado — Desktop, Android, iPhone, iPad ou similar
deviceAgent	String bruta do user agent
os	Sistema operacional detectado — Windows, MacOS, Linux, UNIX
path	Caminho da página atual
title	Título da página atual
userId	Identificador do usuário autenticado (omitido quando não logado)
startDate	Data do check-in da sessão de busca atual
endDate	Data do check-out da sessão de busca atual
guests	Número de hóspedes da sessão de busca atual
rooms	Número de quartos da sessão de busca atual