Vrbo link-off

Acabe com os obstáculos e ofereça aos seus viajantes 2 milhões de aluguéis por temporada com a Vrbo.

Fizemos uma parceria com a Vrbo para oferecer a você e aos seus viajantes 2 milhões de aluguéis por temporada via Rapid.

Os viajantes escolhem aluguéis por temporada pelo espaço, pelas comodidades de luxo e em busca de uma experiência que não encontram em um hotel. Esses viajantes costumam reservar estadias mais longas e fazem reservas com valores médios mais altos. Então, por que não aproveitar para superar as expectativas dos seus viajantes?

Aluguéis por temporada

O Vrbo link-off é uma solução de fácil integração que vai aumentar a sua receita de aluguel por temporada, ao mesmo tempo em que elimina os principais desafios que surgem ao anunciar aluguéis por temporada. O viajante entra no seu site e é redirecionado para a Vrbo para concluir a reserva, tendo acesso a qualquer uma das 2 milhões de propriedades da Vrbo por meio de uma experiência do usuário otimizada.

A Vrbo vai:

• Mostrar tudo o que o seu viajante precisa saber sobre a propriedade.
• Garantir que os resultados mais relevantes sejam selecionados e organizados para os viajantes.
• Lidar com depósitos e cronogramas de pagamento.
• Oferecer suporte a viajantes por meio das suas ferramentas de atendimento ao cliente.

Você pode até mesmo associar a experiência de compra e finalização da Vrbo à marca, e todas as transações de clientes passam a ser rastreadas e ficar acessíveis para visualização por meio de relatórios da Vrbo.

Como começar

Existem três opções de integração abaixo, dependendo do nível de desenvolvimento que você deseja realizar:

1. Link-off básico

Inclua um hiperlink para uma guia de aluguel por temporada na barra de navegação do seu site ou adicione um prompt de aluguel por temporada na página de resultados de busca redirecionando o viajante para a Vrbo. Nenhuma integração de API é necessária para esta opção, o que significa que você já pode começar a oferecer aluguel por temporada hoje.

2. Widget de página de destino do aluguel por temporada

Ao criar uma página de destino que usa o widget de busca da Vrbo, você ganha mais tempo para contextualizar o viajante antes que ele seja redirecionado para a Vrbo. Essa opção também não requer nenhum desenvolvimento de API e permite que você comece sem demora.

3. Widget de página de destino do aluguel por temporada + resultados de busca

Além da opção 2, você também pode criar uma página de resultados de busca no seu site, mostrando as propriedades da Vrbo. Ao clicar em um aluguel por temporada para ver mais informações, viajantes acessam a Vrbo.

Esta opção exige integração com as APIs de  conteúdo e compras da Rapid. Entretanto, o seu investimento vai ser escalável no futuro, à medida que mais recursos de API são incorporados à Rapid para o inventário da Vrbo.

Guia de integração do Vrbo link-off

1. Geral

As instruções de integração abaixo são para quem conhece a Rapid API e tem acesso a ela. Os recursos do Vrbo Link-off estão disponíveis por meio das Rapid APIs de conteúdo e compras. Para acessar o inventário, é preciso ter aprovação e contrato com EPS, Vrbo e Partnerize. Depois de aprovado, o acesso é ativado pelo Partner Connect.

É necessária uma revisão da implementação do parceiro entre a EPS e o programa de afiliados da Vrbo antes do lançamento. Consulte os requisitos de lançamento aqui.

1.1 Fluxo da API

Existem várias maneiras de os parceiros usarem links que levam clientes à página de pagamento da Vrbo:

• Banner/link da campanha de marketing direto para a página de busca da Vrbo

• Widget de busca para a página de resultados da Vrbo

• Integração com as Rapid APIs de conteúdo e compras. Link da página de resultados de busca dos parceiros para a Vrbo.
  • Destino recomendado: a página de resultados de busca da Vrbo com a propriedade selecionada fixada na parte superior é recomendada para conseguir resultados de conversão melhores.
  • Destino alternativo: página de detalhes da propriedade (PDP) da Vrbo. A PDP da Vrbo oferece informações e ferramentas que não podem ser disponibilizadas de outra forma pela Rapid, como seleção de inventário adicional, conversas com gerentes da propriedade, resumo detalhado das taxas, agenda detalhada de pagamentos e um calendário de disponibilidade da propriedade.
  • Destino alternativo: página de pagamento da Vrbo.
    • É importante observar que a página de pagamento não pode oferecer todos os recursos que clientes de aluguel por temporada têm na PDP da Vrbo, inclusive:
      • Resumo detalhado das taxas
      • Detalhes da configuração da unidade, inclusive os tipos de cama em cada quarto
      • Agenda de pagamentos e detalhes completos da Política de Cancelamento
      • Comunicação com gerentes da propriedade
      • Identificador de propriedade Premium
      • Calendário de disponibilidade

Os resultados de busca de parceiros podem incluir até 1 milhão de propriedades disponíveis para reserva na hora, mas clientes têm acesso fácil a qualquer uma dos mais ou menos 2 milhões de propriedades da Vrbo após o link-off.

1.2 Experiência de viajante

1. Site parceiro: hóspedes inserem os critérios de busca.

2. Site parceiro: hóspedes veem propriedades/preços correspondentes aos critérios nos resultados de busca.

3. Site parceiro: hóspedes recebem informações sobre o relacionamento com a Vrbo e um link que leva ao site da Vrbo.

4. Vrbo: hóspedes visualizam a propriedade selecionada junto a outras do inventário da Vrbo na página de resultados do mecanismo de pesquisa (SERP).

5. Vrbo: hóspedes veem a página de detalhes da propriedade selecionada (ou alternativa):

   • É possível ver detalhes de tarifas, políticas, regras da casa, calendário de disponibilidade e informações do gerente da propriedade.
   • Também é possível enviar perguntas ao gerente da propriedade quando necessário. As informações de contato de hóspedes ficam protegidas.

6. Vrbo: hóspedes seguem o processo de compra da Vrbo para fazer uma reserva:

   • Veem a agenda de pagamentos, os depósitos caução e o contrato de locação.
   • Fornecem as informações de contato e os dados de pagamento.
   • Enviam a reserva.
   • O cartão é cobrado pela Vrbo e/ou pela empresa de administração terceirizada de acordo com a agenda de pagamentos.

7. Pós-reserva da Vrbo: hóspedes recebem a confirmação e o suporte da Vrbo:

   • Recebem a confirmação da Vrbo e/ou do gerente da propriedade por e-mail.
   • Gerenciam a reserva no site da Vrbo, em que é possível fazer perguntas ao gerente da propriedade, ver a fatura, consultar a agenda de pagamentos ou antecipar o próximo pagamento agendado.
   • Podem cancelar a reserva, se necessário.

1.3 Experiência de parceiro

1. O contrato com o Partnerize/Vrbo fornece o identificador de afiliado usado no URL de link-off.

2. Desenvolva/faça testes com a Rapid e o inventário da Vrbo.

3. Solicite o acesso para a associação de marcas.

4. Solicite acesso ao campo de fidelidade e aos relatórios da página de pagamento, se necessário.

5. Passe pela análise dos requisitos de lançamento.

6. Treine a equipe de suporte do parceiro quanto aos procedimentos de encaminhamento. Consulte a seção de suporte abaixo.

7. Deixe claro para os usuários que eles estão sendo direcionados a outro site para continuar as compras e reservas.

8. Acesse os relatórios do Partnerize para ver o tráfego de clientes (sem PII), incluindo cliques, dados de conversão e margem total/do parceiro.

2. API

2.1 API de geografia

• O inventário da Vrbo é compatível com as Rapid APIs de geografia da EPS.

2.2 Arquivos de conteúdo

• Para que o inventário da Vrbo apareça no arquivo de conteúdo da Rapid, inclua o cabeçalho beta=vrbo_srp na solicitação.
• Apenas propriedades da Vrbo vão ser retornadas.

2.3 APIs de conteúdo

• Para solicitar inventário da Vrbo, inclua o cabeçalho beta=vrbo_srp na solicitação.
• Apenas propriedades da Vrbo vão ser retornadas.
• Considerações sobre o inventário da Vrbo:
  • Os nomes das propriedades costumam ser mais longos, como "Fantástico apartamento a poucos passos da maravilhosa Meia Praia".
  • No momento, as propriedades da Vrbo são apenas de uma unidade.
  • Muitas vezes, gerentes de propriedade trabalham com as próprias casas. Por isso, manter a privacidade é fundamental. Os dois atributos de ofuscação indicam as preferências de gerentes quanto à distribuição da sua propriedade em sites parceiros e precisam ser refletidos:
    • Para propriedades da Vrbo, quando o endereço inclui obfuscation_required=true, nós ocultamos o endereço da nossa resposta de conteúdo. Entretanto, os parceiros ainda podem mostrar a cidade e o estado do endereço.

Exemplo:

"obfuscated_coordinates": {
                "latitude": 47.417954,
                "longitude": 12.42106
            },
"obfuscation_required": true

• Quando presente, registry_number é um campo de exibição obrigatória para todo o inventário de aluguel por temporada, inclusive da Vrbo. Quando esse valor existe, ele precisa ser exibido.
• O private_host_property (ID de atributo 1073745102) é um campo de exibição obrigatória em propriedades de aluguel por temporada e na Vrbo. Esse é um requisito obrigatório para todos os pontos de venda europeus. Quando esse valor existe, ele precisa ser exibido.

Exemplo:

"general": {
     "1073745021": {                    
          "id": "1073745102",
          "name": "Private host property"
                },

• Os campos de conteúdo abaixo podem não aparecer para as propriedades da Vrbo:
  • Classificação da propriedade: no momento, as classificações não estão disponíveis para propriedades da Vrbo.
  • Descrição do quarto: não é relevante para propriedades de aluguel por temporada de uma unidade. Veja a descrição da propriedade.
  • Plano tarifário: não é relevante para propriedades da Vrbo.
  • Informações sobre o quarto: todos os detalhes relacionados aos quartos estão disponíveis na descrição da propriedade.
• O conteúdo inclui estes novos campos:
  • Estatísticas:
    • 1073743378: número de quartos
    • 1073743379: número de banheiros
• house_rules: resumo das regras da propriedade, que informa se são aceitas crianças e quais são as políticas de animais de estimação, festas, fumantes etc.

Exemplo:

"policies": {
            "house_rules": [
                "Children welcome",
                "No pets",
                "No smoking",
                "No parties or events"
            ]
        },

• Descrição geral: muitas propriedades da Vrbo incluem uma descrição da propriedade fornecida pelo gerente.

Exemplo:

"Procurando algo diferente? Ficar em um apartamento pode ser a escolha certa para a sua viagem a Aurach bei Kitzbuehel. Relaxe com o conforto e as comodidades deste apartamento de 2 quartos com lareira. Você vai estar a 2 km da Área de Esqui Hahnenkamm, a 4 km da Área de Esqui Kitzbüeheler Horn e a 3 km do Estádio de Tênis Kitzbühel. Você pode aproveitar a quadra de tênis descoberta no local e crianças de todas as idades vão adorar a TV. Além disso, há estacionamento disponível durante toda a estadia."

• Nome do gerente, idiomas falados na propriedade e URL da imagem.

Exemplo:

"property_manager": {
      "name": "HHD AG | INTERHOME",
      "links": {
           "image": {
                    "method": "GET",
                    "href": "https://imageseu-ssl.homeaway.com/vd2/files/vv/profiles/1165196_use_1564652167.png"
                }
            }
        },
     "spoken_languages": {
          "de": {
                "id": "de",
                "name": "German"
            },
           "en": {
                "id": "en",
                "name": "English"
            },

• platform_property:TRUE: indica que a propriedade é da plataforma (em que a Vrbo é merchant of record), e não de IPM (gestão de propriedades integrada, em que o merchant of record é terceirizado). Essas informações podem ser utilizadas para filtrar as propriedades por plataforma, em que hóspedes têm acesso direto à Vrbo e às ferramentas dela. Para parceiros de teste de reserva, isso também pode ser usado para limitar o inventário com opção de reserva às propriedades da plataforma.
• vrbo_srp_id: indica o ID da propriedade da Vrbo no formato necessário para a construção do URL de link-off de SRP da Vrbo.

Exemplo:

"vrbo_srp_id": "651.2748905.3300127",

• listing_id: é necessário para construção do URL de link-off de PDP.

Exemplo:

"listing_id": "2748905",

• listing_number: é necessário para construção do URL de link-off de PDP.

Exemplo:

"listing_number": "3300127",

• listing_source: é necessário para construção do URL de link-off de PDP.

Exemplo:

"listing_source": "abritel",

• unit_number: é necessário para construção do URL de link-off de CXO.

Exemplo:

"unit_number": "/units/0002/c82d1ea6-7953-4984-baba-1664f8ded95d",

2.4 API de compras

• A disponibilidade de propriedades da Vrbo pode ser obtida da API de disponibilidade, inclusive com informações sobre os preços.
• O preço total retornado pela API de disponibilidade deve ser consistente com o que viajantes veem depois do link-off para Vrbo.com.
• O link de verificação de preço na resposta da API de compras para o inventário da Vrbo fica em branco no caso dos parceiros com link-off.
• Algumas informações na resposta da API de compras não são relevantes para as propriedades da Vrbo, incluindo:
  • Quartos: inclui grupos de camas e ocupação.
  • Tarifas: inclui comodidades do plano tarifário e descrição de oferta especial.
• Considerações sobre a resposta da API de compras:
  • Reserva de um quarto. Não há suporte para reservas de várias quartos, pois as propriedades da Vrbo têm disponibilidade única.
  • Não é possível reservar quartos para o mesmo dia. Uma mensagem de indisponibilidade vai ser retornada.
  • Tipos de tarifa compatíveis:
    • Apenas padrão, sem base/líquido ou pacote.
    • Tarifas somente de quarto.
  • Campos que podem não ser relevantes para o inventário da Vrbo:
    • ID do quarto
    • Nome do quarto
    • ID da tarifa
    • Os quartos disponíveis são sempre 0 para propriedades da Vrbo.
    • As propriedades da Vrbo têm um único tipo de tarifa, pois todas são de unidade única no momento.
    • Grupos de cama e configuração não são aplicáveis à Vrbo, pois nenhuma seleção/preferência está disponível.
    • Link da política de depósito: indisponível para reservas da Vrbo no momento, mas vai ser exposto mais tarde no teste. Enquanto isso, assim que houver mais informações, outras mensagens devem ser adicionadas à tela para informar a viajantes que a agenda de pagamentos completa vai ser fornecida após a reserva no e-mail de confirmação da Vrbo ou do gerente da propriedade.
    • Taxas da propriedade não incluem taxas cobradas pela estadia para o inventário da Vrbo.
    • ID e descrição da promoção não se aplicam ao inventário da Vrbo.
    • Propriedades alternativas não são relevantes para o inventário da Vrbo.
    • Recomendações de venda cruzada não são relevantes para o inventário da Vrbo.
• Novos campos de resposta da API de compras:
  • property_fee

Exemplo:

{
"type": "property_fee",
"value": "34.75",
"currency": "USD"
},

• traveler_service_fee

Exemplo:

{
"type": "traveler_service_fee",
"value": "30.25",
"currency": "USD"
}

• refundable_damage_deposit: valor cobrado no cartão de clientes como parte do último pagamento programado. Se as datas da reserva são iminentes e 100% da tarifa deve ser paga de imediato, o RDD pode ser cobrado junto com a tarifa. O RDD é reembolsado cerca de 10 dias após a partida de hóspedes, se a propriedade não tiver sido danificada.

Exemplo:

"fees": {
     "refundable_damage_deposit": {
          "request_currency": {
          "value": "150.00",
          "currency": "USD"
       },
     "billable_currency": {
          "value": "150.00",
          "currency": "USD"
      },
     "scope": "per_accommodation",
     "frequency": "per_stay"
   }
},

• card_on_file_fee: no lugar de um RDD, um valor pode ser cobrado no cartão de crédito cadastrado. Isso indica que a Vrbo tem o direito de realizar cobranças no cartão se hóspedes causarem danos à propriedade.

Exemplo:

"fees": {
     "card_on_file_fee": {
          "request_currency": {
          "value": "1382.74",
          "currency": "USD"
     },
     "billable_currency": {
         "value": "1000.00",
         "currency": "GBP"
     },
     "scope": "per_accommodation",
     "frequency": "per_stay"
     }
},

2.5 Outros

• Para parceiros com o Vrbo link-off, as seguintes Rapid APIs não são compatíveis:
  • Políticas de depósito
  • Opções de pagamento
  • Recomendações (venda cruzada/propriedades alternativas)
  • Verificação de preço
  • Reserva
  • Itinerário
  • Alterações secundárias
  • Cancelamento
  • Serviço de notificação

3. Construção de URL do Vrbo link-off

O link para a Vrbo é composto por duas partes:

1. URL do Partnerize, incluindo camref recebida como parte do processo de integração do Partnerize.

2. URL de destino da Vrbo.

Exemplo de URL de link-off completo:

https://prf.hn/click/camref:12...

3.1 URL do Partnerize

Consulte a documentação recebida da Vrbo como parte do seu contrato do Partnerize. Ela vai incluir instruções mais detalhadas sobre o formato do link do Partnerize.

Resumindo, ele usa o seguinte formato, onde "##########" é substituído pelo seu camref específico de parceiro recebido do Partnerize:

https://prf.hn/click/camref:##########/destination:

3.2 URL de destino da Vrbo

O URL de destino da Vrbo varia dependedo de para onde você quer direcionar viajantes no site da Vrbo. A opção SRP (página de resultados de busca com a propriedade selecionada fixada no topo) é recomendada para uma melhor conversão de hóspedes e acesso a cerca de 2 milhões de propriedades da Vrbo.

1. SRP: página de resultados de busca com a propriedade selecionada fixada na parte superior.

Benefício: viajantes chegam aos resultados de busca da Vrbo com a propriedade selecionada no topo. Viajantes têm a oportunidade de confirmar a localização da propriedade em um mapa e ver outras próximas (da seleção completa de mais de 2 milhões de propriedades da Vrbo, incluindo opções sem confirmação na hora).

Exemplo:

2. Página de detalhes da propriedade (PDP): hóspedes acessam a página de detalhes da propriedade selecionada.

Exemplo:

3. Página de pagamento (CXO): o link direciona hóspedes à página de pagamento da Vrbo. Esta é uma opção em fase de testes que deve ser discutida com o Partner Connect.

3.3 Construção de links

Construção do URL de provedor de rede afiliada

Consulte a documentação fornecida pelo provedor de rastreamento contratado pelo afiliado para a formação de URL.

Resultados de busca fixados (SRP)

Os URLs de SRP são compostos pelos seguintes componentes:

1. URL de rastreamento da rede afiliada
2. URL base da VRBO: https://www.vrbo.com/
3. Idioma/ponto de venda fora dos EUA (consulte a lista de localidades no apêndice): en-ca/
4. Datas: "results/arrival:[aaaa-mm-dd]/departure:[aaaa-mm-dd]
5. Hóspedes: ?adultsCount=3
6. Propriedade de destino para fixar no topo: &pinnedPropertyListing=
7. ID da marca: 321. (incluído no conteúdo da Rapid dentro de vrbo_srp_id)
8. ID do anúncio: 4654022. (incluído no conteúdo da Rapid dentro de vrbo_srp_id)
9. Número do anúncio: 5414675 (incluído no conteúdo da Rapid dentro de vrbo_srp_id)
10. Para pontos de venda fora dos EUA: &preferlocale=true

Exemplo:

https://www.vrbo.com/results/arrival:2020-11-02/departure:2020-11-06?adultsCount=3&pinnedPropertyListing=121.4654022.5414675

Exemplo de fora dos EUA:

https://www.vrbo.com/en-ca/results/arrival:2020-11-02/departure:2020-11-06?adultsCount=3&pinnedPropertyListing=121.4654022.5414675&preferlocale=true

Página de detalhes da propriedade (PDP)

Os URLs de SRP são compostos pelos seguintes componentes:

1. URL de rastreamento da rede afiliada
2. URL base da Vrbo: https://www.vrbo.com/
3. Pontos de venda fora dos EUA (consulte a lista de locais no apêndice abaixo): en-ca/
4. "p" para pontos de venda fora dos EUA
5. listing_id
6. Sufixo de origem do anúncio (consulte o apêndice abaixo). Observe que o sufixo para pontos de venda dos EUA e internacionais são diferentes.
7. Hóspedes: ?adultsCount=[3]
8. Datas: "&arrival:[AAAA-MM-DD]&departure:[AAAA-MM-DD]

Exemplo:

https://www.vrbo.com/4809266ha?adultsCount=2&arrival=2021-04-19&departure=2021-04-22

Exemplo de fora dos EUA:

https://www.vrbo.com/en-gb/p4809266?adultsCount=2&arrival=2021-04-19&departure=2021-04-22

Página de pagamento (CXO)

O URL de CXO inclui os seguintes componentes:

1. URL de rastreamento da rede afiliada
2. URL base da VRBO: https://www.vrbo.com/
3. Idioma/ponto de venda fora dos EUA (consulte a lista de localidades no apêndice): en-ca/
4. "/td/tc/checkout/?"
5. vrbo_srp_id
6. Listing_unit: ?unitLink=/units/0002/c82d1ea6-7953-4984-baba-1664f8ded95d"
7. Datas: "&arrivaDatel:mm/dd/aaaa&departureDate=mm/dd/aaaaa
8. Hóspedes: &adultsCount=[3]&childrenCount=[0]

Exemplo:

https://www.vrbo.com/td/tc/checkout/121.210223.3004988?unitLink=/units/0000/51b4650b-8f69-4813-bf2e-0ec13f6502b5&arrivalDate=03/09/2021&departureDate=03/12/2021&adultsCount=2&childrenCount=0

Exemplo de fora dos EUA:

https://www.vrbo.com/en-gb/td/tc/checkout/121.210223.3004988?unitLink=/units/0000/51b4650b-8f69-4813-bf2e-0ec13f6502b5&arrivalDate=03/09/2021&departureDate=03/12/2021&adultsCount=2&childrenCount=0

4. Suporte

Informação para clientes

Como parte de seu fluxo de link-off, é preciso informar a clientes que:

1. O link vai os direcionar a outro site para continuar as compras e reservas.
2. As reservas feitas com a Vrbo vão ser atendidas pela Vrbo. Clientes devem consultar as comunicações da Vrbo sobre o acesso ao suporte, pois o parceiro não tem registro da reserva ou ferramentas para ajudar a resolver problemas.

Integração à API

Em caso de dúvidas sobre os tópicos deste documento e em relação às Rapid APIs de conteúdo e compras, fale com o seu representante do EPS Partner Connect.

Link da Vrbo e experiência de compra da Vrbo

Para perguntas sobre o link do Partnerize, a página de destino da Vrbo, associação de marcas ou a experiência de compra/reserva/pós-reserva do cliente, entre em contato com o representante da equipe de afiliados da Vrbo.

Problemas pós-reserva

Em caso de dúvidas sobre reservas, é recomendado falar com gerentes da propriedade (dados de contato disponíveis no e-mail de confirmação da reserva) ou direto com o suporte da Vrbo. A EPS não tem acesso às ferramentas de suporte da Vrbo no momento, portanto, todas as perguntas relacionadas às reservas devem ser encaminhadas direto à equipe da Vrbo.

Relatórios

Dúvidas sobre relatórios de compras e reservas devem ser direcionadas à equipe de afiliados da Vrbo ou ao seu representante do Partnerize.

5. Apêndice

Idiomas compatíveis:

Moedas compatíveis:

URL base

Os URLs base abaixo representam a parte do link antes do ID da propriedade no link da Vrbo.

Sufixo de ID de propriedade para o URL de PDP

ID da propriedade vrbo.com dos EUA + sufixo

ID da propriedade vrbo.com de fora dos EUA + sufixo

O Guia de links Vrbo Partnerize pode ser baixado aqui.