Visão geral

Aproveite a nova API de Merchandising para identificar ofertas com mais facilidade e beneficiar-se de técnicas de aprendizado de máquina.

Utilize o aprendizado de máquina para 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 ofertas com dados para criar uma estratégia vencedora para year-long e experiências para traveler-facing, como e-mails promocionais, widgets de aplicativos, banners de sites e experiências em carrossel.

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

Ponto final do conteúdo da campanha

• Fornece detalhes da próxima campanha, incluindo o ID da campanha, as datas de início e término da reserva e da estadia, e o número de propriedades participantes.
• Permite acesso direto aos recursos da campanha Expedia-curated, como imagens temáticas da campanha, imagens do destino, sugestões de texto, etc.
• Receba informações sobre campanhas de oferta por tempo limitado (LTO) com período de reserva nos próximos seis meses, bem como campanhas permanentes disponíveis durante todo o 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
• Período de estadia
• Valores iguais ou superiores a zero para obter o desconto mínimo.
• Ofertas de longo prazo versus ofertas permanentes

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

• Reserva e datas da viagem
• Desconto mínimo e máximo em porcentagem

Outros detalhes

O endpoint de Conteúdo da Campanha pode ajudá-lo a aproveitar os recursos de Expedia-curated para criar experiências de merchandising de traveler-facing, como e-mails promocionais, widgets de aplicativos, banners de sites, etc.

Você pode usar o campo property_count na resposta do Conteúdo da Campanha para determinar o maior número de propriedades que oferecem ofertas em uma campanha. Recomendamos que você verifique o property_count próximo à data de início da reserva da campanha, pois a participação de propriedade em campanhas de merchandising é dinâmica e a participação das propriedades tende a ser mais completa e confiável à medida que o lançamento da campanha se aproxima.

Fim das promoções

• Apresenta todas as ofertas e descontos disponíveis associados a uma campanha específica.
• Capacidade de pesquisar e filtrar ofertas com a ajuda de múltiplos parâmetros de solicitação, incluindo a possibilidade de solicitar ofertas para uma campanha específica ou para várias campanhas diferentes.
• Permite que você sempre encontre as ofertas mais atraentes e com maior número de up-to-date para construir uma campanha com propriedade.

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

• ID da campanha e/ou ID propriedade
• Intervalo de datas reserváveis
• Período de estadia
• Valores iguais ou superiores à pontuação mínima de avaliação, à classificação mínima por estrelas e/ou ao desconto mínimo.
• Distinção entre tempo limitado e permanente
• Member-only e mobile-only bandeiras de acordo
• 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
• Período de reservas, período de estadia, datas indisponíveis e janela de compra antecipada.
• Distinção entre tempo limitado e permanente
• A ferramenta learning-powered atribui pontuações de relevância exclusivas para o seu negócio, referentes às ofertas, propriedades e destinos retornados na resposta.
• Informações específicas sobre destinos e identificação da cadeia de lojas
• Link tokenizado para a API de conteúdo Rapid propriedade existente para extrair imagens property-level e apresentá-las em suas experiências de merchandising.

Outros detalhes

Você pode facilmente pesquisar e filtrar os resultados de Promoções para encontrar ofertas mais específicas, tendo assim controle total sobre quais ofertas apresenta aos viajantes. Você também pode selecionar essas ofertas para criar seus próprios temas de campanha, em vez de usar as campanhas Expedia-defined e os recursos associados.

Se você quiser pesquisar ofertas para um período de reserva específico, pode passar valores para as datas bookable_start e bookable_end. Por exemplo, ao inserir 2025-10-15 (15 de outubro de 2025) no campo bookable_start e 2025-10-30 (30 de outubro de 2025) no campo bookable_end, você receberá todas as ofertas que podem ser reservadas entre 15 e 30 de outubro, inclusive. No entanto, se você quiser ver um conjunto maior de ofertas, pode usar a data bookable_start ou bookable_end.

Por exemplo:

• Ao inserir 2025-10-15 (15 de outubro de 2025) no campo bookable_start, você receberá todas as ofertas que podem ser reservadas a partir de 15 de outubro. Isso proporcionará uma gama maior de ofertas.

• Ao inserir apenas 2025-10-30 (30 de outubro de 2025) no campo bookable_end, você receberá todas as ofertas que podem ser reservadas até 30 de outubro. Novamente, isso proporcionará um leque maior de ofertas.

As ofertas ficam disponíveis para reserva de acordo com o fuso horário de propriedade. Portanto, se uma oferta para um propriedade em Sydney, Austrália, começar no dia 21 de março, ela ficará disponível para reservas à 0h01, horário de Sydney, para todos os parceiros do mundo.

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

Você pode começar a fazer solicitações à API de promoções com antecedência, mas também deve solicitá-las o mais próximo possível da data de início da campanha de reservas para obter a representação mais precisa e atualizada das ofertas das propriedades. Isso ocorre porque a participação das propriedades tende a ser mais completa e confiável à medida que a data de lançamento da campanha se aproxima.

Sugerimos também que solicite as promoções alguns dias após o início da campanha, para que receba sempre a lista de ofertas mais recente e atualizada. Além disso, sugerimos que você solicite a API de promoções diariamente para obter uma lista atualizada das ofertas fornecidas pelos imóveis.

Se você estiver interessado em criar campanhas de merchandising destination-based, você pode fazer uma solicitação à API de Promoções region-specific usando o region_id relevante da API Rapid Geography. 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.

Recomendações com aprendizado de máquina

As pontuações de relevância do The Machine learning-powered, apresentadas na resposta de Promoções, são exclusivas para cada organização. Portanto, a pontuação/classificação que você recebe será diferente da de qualquer outra pessoa. 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. As ofertas, propriedades e destinos da Higher-scoring têm grande potencial para gerar conversões entre sua base de viajantes exclusiva.

Atualmente, você receberá pontuações de relevância para as 10 mil melhores ofertas em cada campanha. Em nossos testes, descobrimos que o valor e o impacto dessa pontuação se tornaram insignificantes após as primeiras 10 mil transações.

Com base no seu caso de uso, você pode usar o parâmetro sort_by para definir a ordem de classificação da resposta de Promoções, optando por 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ê passar por sort_by = promotion, receberá todos os resultados de ofertas classificados por high-to-low (de 1 a 10.000) de acordo com nosso algoritmo proprietário de aprendizado de máquina. Você pode usar essa opção de classificação para obter as melhores ofertas recomendadas, que nosso modelo prevê que terão maior taxa de conversão.
• Se você clicar em sort_by = property, receberá todos os resultados de negócios das propriedades classificadas com high-to-low de acordo com nosso algoritmo proprietário de aprendizado de máquina.
• Se você clicar em sort_by = destination, receberá todos os resultados de ofertas dos destinos classificados com high-to-low de acordo com nosso algoritmo proprietário de aprendizado de máquina.

Nota: Recomendações de aprendizado de máquina também estão disponíveis no Portal Marketing Hub. Para mais detalhes, entre em contato com seu gerente de conta.

Alterações feitas na API de Disponibilidade de Compras

Para obter os detalhes mais recentes sobre disponibilidade, preços em tempo real, reembolso, informações sobre comissões, etc., você deve fazer uma solicitação padrão à API de Disponibilidade de Compras da Rapid. 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 novo filtro dealdisponível no endpoint de Disponibilidade de Compras Rápidas para receber apenas tarifas que apresentem promoções ativas. Isso lhe dá a flexibilidade de criar uma solicitação de compras com foco exclusivo em merchandising e garantir que todas as taxas retornadas tenham um atributo deal.
• Um novo cabeçalho de solicitação chamado Campaign-Idestá disponível no endpoint de Disponibilidade de Compras da Rapid para que você possa indicar que a chamada específica à API de Disponibilidade de Compras que você está fazendo não é uma chamada regular e, na verdade, se deve aos seus esforços promocionais de merchandising (em outras palavras, isso significará que uma solicitação à API de Disponibilidade de Compras foi feita quando o viajante entrou na experiência de compra devido a uma promoção de campanha). Aceitaremos apenas um ID de campanha por chamada à API de Compras. Este ID de campanha nos ajudará a monitorar o desempenho da sua campanha e a desenvolver melhores modelos de aprendizado de máquina e aprimoramentos de API para você.
• Se você deseja visualizar o desempenho da sua campanha no Portal Marketing Hub, será necessário passar o parâmetro ID da campanha na sua chamada à API de Compras. Caso tenha alguma dúvida, entre em contato com seu gerente de conta.

Nota: 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%"
. }
}

Nota: Os ide descriptiondisponíveis na resposta da API de Merchandising são diferentes daqueles retornados na resposta da API de Compras. Recomendamos vivamente que utilize os campos ide descriptionretornados pela API de Merchandising.

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 as 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.

Acessar API Explorer