Visão geral

Aproveite a nova API de Merchandising para identificar negócios com mais facilidade e se beneficiar de técnicas de aprendizado de máquina

Aproveite o aprendizado de máquina para ajudar você a identificar as ofertas e descontos mais relevantes para viajantes no vasto estoque global de promoções da Expedia Group. Ao usar a API de merchandising, você pode acessar uma variedade de conteúdo de campanha e lidar com dados para criar uma estratégia vencedora de year-long e experiências de traveler-facing, como e-mails promocionais, widgets de aplicativos, banners de sites e experiência de carrossel.

Também adicionamos um novo aplicativo no Portal de Parceiros que você pode usar para criar suas estratégias de merchandising e planejar, executar e monitorar campanhas. Este aplicativo está localizado em uma nova seção chamada Portal Marketing Hub. Entre em contato com seu gerente de conta para obter mais informações.

Ponto final do conteúdo da campanha

Fornece detalhes da próxima campanha, incluindo ID da campanha, datas de início e término da reserva e da estadia, e número de propriedades participantes.
Permite acesso direto aos ativos da campanha Expedia-curated, como imagens temáticas da campanha, imagens de destino, textos sugeridos, etc.
Receba informações sobre campanhas de ofertas por tempo limitado (LTO) com período de reserva nos próximos seis meses, bem como campanhas permanentes disponíveis ao longo do ano.

Você pode usar o endpoint de conteúdo da campanha para pesquisar campanhas futuras usando parâmetros de solicitação, incluindo:

Intervalo de datas reserváveis
Intervalo de datas de estadia
Valores iguais ou superiores aos do desconto mínimo
LTO versus ofertas perenes

Para campanhas LTO com uma janela de reserva superior a seis meses, os seguintes campos serão excluídos:

Reserva e datas da viagem
Desconto mínimo e máximo %

Outros detalhes

O endpoint de conteúdo da campanha pode ajudar você a aproveitar os ativos Expedia-curated para criar experiências de merchandising traveler-facing, como e-mails promocionais, widgets de aplicativos, banners de sites, etc.

Você pode usar o campo property_countna resposta do Conteúdo da Campanha para determinar o maior número de propriedades participantes. A participação do propriedade em campanhas de merchandising é dinâmica, por isso recomendamos que você avalie property_countaproximadamente 4 a 6 semanas antes do início de uma campanha para ter uma noção mais precisa de quantas propriedades oferecerão ofertas como parte da campanha.

O único tipo de região aceito pelo endpoint de promoções é city. Outros tipos de região, como multi_city_vicinity, point_of_interest, neighbourhood, etc. retornarão uma resposta em branco.

O parceiro continua responsável pelo marketing e pelas mensagens das campanhas em seus sites criados usando a nova API de Merchandising ou API de Compras e por garantir que todo esse marketing e mensagens estejam em conformidade com as leis e regulamentações aplicáveis.

Ponto final de promoções

Oferece todas as ofertas e descontos disponíveis associados a uma campanha específica.
Capacidade de pesquisar e filtrar ofertas com a ajuda de vários parâmetros de solicitação, incluindo a capacidade de solicitar ofertas para uma campanha específica ou em várias campanhas.
Permite que você sempre exiba as ofertas mais atraentes de up-to-date e propriedade para criar uma campanha high-converting.

Você pode usar o ponto de extremidade Promoções para filtrar e pesquisar facilmente ofertas usando parâmetros de solicitação como:

ID da campanha e/ou ID propriedade
Intervalo de datas reserváveis
Intervalo de datas de estadia
Em ou acima dos valores de pontuação mínima de avaliação, classificação mínima por estrelas e/ou desconto mínimo
Distinção entre tempo limitado e perene
Member-only e mobile-only sinalizadores de negociação
Super região ou destinos específicos
Ordem de classificação da pontuação de relevância do aprendizado de máquina

Os detalhes abaixo serão retornados na resposta da API de promoções:

ID da oferta, ID da campanha correspondente e ID propriedade
Intervalo de datas reserváveis, intervalo de datas de estadia, datas de restrição e janela de compra antecipada
Distinção entre tempo limitado e perene
Pontuações de relevância da máquina learning-powered exclusivas para sua empresa para as ofertas, propriedades e destinos retornados na resposta
Destinos específicos e informações de ID da cadeia
Link tokenizado para a API de conteúdo Rapid propriedade existente para extrair imagens property-level para apresentar em suas experiências de merchandising

Outros detalhes

Você pode facilmente pesquisar e filtrar a resposta de Promoções para obter ofertas mais direcionadas, para ter controle total sobre quais ofertas você exibe aos viajantes. Você também pode selecionar essas ofertas para criar seus próprios temas de campanha em vez de usar campanhas Expedia-defined e ativos associados.

Você pode usar o parâmetro de solicitação includeno endpoint Promoções para personalizar o tamanho da resposta recebida. Então, em vez de receber todos os campos de resposta, se você precisar retornar apenas alguns campos, você pode adicionar esses nomes de campos específicos no parâmetro include.

Você pode usar o campo property_countna resposta do Conteúdo da Campanha para determinar o maior número de propriedades participantes. A participação da propriedade em campanhas de merchandising é dinâmica, por isso recomendamos que você avalie aproperty_count aproximadamente 4 a 6 semanas antes do início da campanha para ter uma noção mais precisa de quantas propriedades oferecerão ofertas como parte da campanha.

Assim como nas orientações sobre conteúdo da campanha, recomendamos que você faça suas solicitações de promoções o mais próximo possível da data de início da campanha para garantir que você tenha o maior número de ofertas up-to-date.

Se você estiver interessado em criar campanhas de merchandising destination-based, você pode fazer uma solicitação de API de promoções region-specific usando o relevanteregion_id da API de Geografia Rápida.

Recomendações com aprendizado de máquina

As pontuações de relevância da Máquina learning-powered entregues na resposta de Promoções são exclusivas para cada organização, portanto, a pontuação/classificação que você recebe será diferente do que qualquer outra pessoa recebe. Você pode usar as recomendações de aprendizado de máquina para identificar as melhores ofertas, propriedades e destinos para promover em suas campanhas de merchandising. Ofertas, propriedades e destinos Higher-scoring terão uma probabilidade de impulsionar a conversão entre sua base exclusiva de viajantes.

Atualmente, você receberá pontuações de relevância para os 10 mil melhores negócios em cada campanha. Em nossos testes, descobrimos que o valor e o impacto dessa pontuação se tornaram insignificantes além dos primeiros 10 mil negócios.

Com base no seu caso de uso, você pode usar osort_by parâmetro para definir a ordem de classificação da resposta de promoções, escolhendo ordenar com base na oferta, propriedade ou relevância do destino, conforme determinado pelo nosso modelo de aprendizado de máquina para que você obtenha o máximo valor do merchandising em termos de visibilidade e reservas dos viajantes.

Se você passarsort_by = promotion você receberá todos os resultados de negócios classificados como high-to-low (1 a 10.000) de acordo com nosso algoritmo proprietário de aprendizado de máquina. Você pode usar essa classificação para obter as principais ofertas recomendadas que nosso modelo espera converter mais.
Se você passarsort_by = property você receberá todos os resultados de negócios das propriedades classificadas como high-to-low de acordo com nosso algoritmo proprietário de aprendizado de máquina.
Se você passarsort_by = destination você receberá todos os resultados de negócios dos destinos classificados como high-to-low de acordo com nosso algoritmo proprietário de aprendizado de máquina.

Observação: Recomendações de aprendizado de máquina também estão disponíveis no Portal Marketing Hub. Entre em contato com seu gerente de conta para obter mais detalhes.

Alterações feitas na API de disponibilidade de compras

Para obter os detalhes mais recentes sobre disponibilidade, preços ao vivo, reembolsabilidade, informações sobre comissões, etc., você deve fazer uma solicitação padrão ao Rapid's API de disponibilidade de compras Fizemos as seguintes alterações na API de compras para dar suporte aos fluxos de merchandising e tornar sua integração com a API de merchandising o mais tranquila possível:

Use o novodeal filtro disponível no ponto de extremidade de Disponibilidade de Compras Rápidas para receber apenas tarifas que apresentam promoções ativas. Isso lhe dá a flexibilidade de criar uma solicitação de compras com foco exclusivamente em merchandising e garantir que todas as taxas retornadas tenham umdeal atributo.
Um novo cabeçalho de solicitação chamado Campaign-Id está disponível no ponto de extremidade de disponibilidade de compras do Rapid para que você indique que a chamada específica da API de disponibilidade de compras que você está fazendo não é uma chamada regular e que, na verdade, é devido aos seus esforços promocionais de merchandising (em outras palavras, isso significará que uma solicitação da API de disponibilidade de compras foi feita quando o viajante entrou na experiência da loja devido a uma promoção de campanha). Aceitaremos apenas um ID de campanha por chamada da API de compras. Este ID de campanha nos ajudará a monitorar o desempenho da sua campanha e a projetar melhores modelos de aprendizado de máquina e melhorias de API para você.
Se quiser ver o desempenho da sua campanha no Hub do Portal Marketing, você precisará passar o parâmetro ID da campanha na sua chamada da API de compras. Caso tenha alguma dúvida, entre em contato com seu gerente de conta.

Observação: você pode solicitar detalhes da API de disponibilidade de compras para até 250 propriedades por vez.

Exemplo de resposta

"promotions": {
. "deal": {
.   "id": "999abc",
.   "description": "Book early and save 15%"
. }
}

**Observação: ** Os id e description disponíveis na resposta da API de merchandising são diferentes daqueles retornados na resposta da API de compras. Recomendamos fortemente que você use id e description retornados pela API de Merchandising.

O desconto mínimo proposto é calculado excluindo impostos e taxas. Você é responsável por garantir que o desconto a ser anunciado esteja em conformidade com as leis de publicidade de preços exigidas.

Detalhes da API

Explore as configurações de endpoint merchandising-related nesta página e, em seguida, use o API Explorer ou outro software de teste para entender como os exemplos e configurações de esquema se comparam à saída real.

Recursos adicionais

Não importa se deseja testar todos os pontos de extremidade da Rapid API, ou baixar a especificação OpenAPI ou a nossa coleção Postman Collection, você pode contar conosco.