개요

새로운 머천다이징 API를 활용하여 더 쉽게 거래를 식별하고 머신 추천( learning-powered )의 혜택을 누리세요.

머천다이징 API는 Expedia-sourced 숙박 시설 할인, 관련 캠페인 및 자산, 머신러닝을 기반으로 한 개인화된 거래, 목적지, 숙박 시설 랭킹에 직접 액세스할 수 있는 기능을 제공합니다. 머천다이징 API를 사용하여 프로모션 이메일, 앱 위젯, 웹사이트 배너, 캐러셀 경험 등 여행자 또는 agent-facing 마케팅 경험을 채우고 성공적인 year-long 머천다이징 전략을 실행할 수 있습니다.

또한 마케팅 섹션에 액세스할 수 있습니다. Partner Portal 계정에서 예정된 캠페인을 검색하고, 맞춤형 거래 목록을 내보내고, 사용할 캠페인 카피와 이미지를 선택하고, 여행 트렌드와 캠페인 실적을 추적할 수 있습니다. 포털에 마케팅 섹션이 표시되지 않으면 다음과 같이 제출하세요. 지원 티켓.

캠페인 콘텐츠 엔드포인트

캠페인 콘텐츠 엔드포인트는 캠페인 ID, 예약 및 숙박 시작일과 종료일, 숙박 시설 참여자 수 등 예정된 캠페인 세부 정보를 제공합니다. 캠페인 주제 이미지, 목적지 이미지, 추천 카피 등 Expedia-curated 캠페인 자산에 직접 액세스하여 프로모션 이메일, 앱 위젯, 웹사이트 배너를 포함한 traveler-facing 또는 agent-facing 머천다이징 경험을 제작할 수 있습니다. 또한 향후 6개월 이내의 예약 기간이 있는 기간 한정 프로모션(LTO) 캠페인과 연중 내내 이용 가능한 상시 캠페인에 대한 정보를 받을 수 있습니다.

캠페인 콘텐츠 엔드포인트를 사용하여 다음과 같은 요청 매개변수를 사용하여 예정된 캠페인을 검색할 수 있습니다:

예약 가능한 날짜 범위
숙박 날짜 범위
최소 할인을 위한 값 이상
LTO와 에버그린 오퍼 비교

예약 기간이 6개월을 초과하는 LTO 캠페인의 경우 다음 필드가 제외됩니다:

예약 및 여행 기간
최소 및 최대 할인율

기타 세부 정보

캠페인 콘텐츠 응답의 property_count 필드를 사용하여 캠페인 내에서 거래를 제공하는 숙박 시설의 가장 많은 up-to-date 수를 확인할 수 있습니다. 머천다이징 캠페인 참여는 유동적이며, 캠페인 시작이 가까워질수록 숙박 시설의 참여가 가장 완전하고 신뢰할 수 있는 경향이 있으므로 캠페인 예약 시작일에 가까운 property_count 에서 확인하는 것이 좋습니다.

캠페인 콘텐츠 응답의 min_discount 및 max_discount 필드를 사용하여 해당 캠페인 내에서 사용할 수 있는 최소 및 최대 할인율을 결정할 수 있습니다. 예를 들어, 해당 캠페인에서 숙박 시설가 제공하는 가장 높은 할인이 60%인 경우 API 응답의 max_discount 값은 60%가 되고, 해당 캠페인에서 숙박 시설가 제공하는 가장 낮은 할인이 4%인 경우 min_discount 필드 값은 4%가 됩니다.

파트너는 머천다이징 API 또는 숙박 시설 사용하여 구축한 사이트의 캠페인 마케팅 및 메시지에 대한 책임이 있으며, 이러한 모든 마케팅 및 메시지가 관련 법률 및 규정을 준수하는지 확인해야 합니다.

프로모션 엔드포인트

프로모션 응답을 쉽게 검색하고 필터링하여 보다 타겟팅된 거래를 표시할 수 있으므로 여행자에게 어떤 거래를 표시할지 완벽하게 제어할 수 있습니다. 또한 이러한 거래를 큐레이션하여 Expedia-defined 캠페인 및 관련 에셋을 사용하는 대신 나만의 캠페인 테마를 구축할 수도 있습니다.

특정 캠페인과 관련된 거래 및 할인을 제공합니다.
특정 캠페인 또는 여러 캠페인에 대한 거래를 요청하는 기능을 포함하여 여러 요청 매개변수를 사용하여 거래를 검색하고 필터링할 수 있습니다.
up-to-date, high-converting 캠페인을 구축하기 위해 항상 가장 매력적인 숙박 시설 거래를 표시할 수 있습니다.

프로모션 엔드포인트를 사용하면 다음과 같은 요청 매개변수를 사용하여 거래를 쉽게 필터링하고 검색할 수 있습니다:

캠페인 ID 및/또는 숙박 시설 ID
예약 가능한 날짜 범위
숙박 날짜 범위
최소 리뷰 점수, 최소 별점 및/또는 최소 할인에 대한 값 이상
한시적 대 상시적 구분
Member-only 및 mobile-only 거래 플래그
슈퍼 지역 또는 특정 목적지
머신 러닝 관련성 순위 정렬 순서

프로모션 API 응답으로 아래 세부 정보가 반환됩니다:

프로모션 ID, 해당 캠페인 ID, 숙박 시설 ID
예약 가능한 날짜 범위, 숙박 날짜 범위, 블랙아웃 날짜 및 사전 구매 기간
한시적 대 상시적 구분
기계 learning-powered 거래에 대한 비즈니스 고유의 관련성 순위, 숙박 시설 및 응답에 반환된 목적지
특정 목적지 및 체인 ID 정보
기존 숙박 시설 콘텐츠 API에 대한 토큰화된 링크를 통해 property-level 이미지를 가져와 머천다이징 경험에 표시할 수 있습니다.

기타 세부 정보

설정된 예약 기간에 대한 상품을 검색하려면 bookable_start 및 bookable_end 날짜 값을 모두 전달하면 됩니다. 예를 들어, bookable_start 필드에 2025-10-15 (2025년 10월 15일)을 입력하고2025-10-30 (2025년 10월 30일)을 bookable_end 필드에 입력하면 10월 15일부터 10월 30일 사이에 예약 가능한 모든 상품을 받을 수 있습니다. 그러나 더 많은 거래를 보고 싶다면 bookable_start 또는 bookable_end 날짜를 사용할 수 있습니다. 예:
- bookable_start필드에 2025-10-15 (2025년 10월 15일)을 입력하면 10월 15일 이후 예약 가능한 모든 상품을 받을 수 있습니다. 이렇게 하면 더 많은 거래가 제공됩니다.
- bookable_end필드에 2025-10-30 (2025년 10월 30일)만 입력하면 10월 30일 이전에 예약 가능한 모든 딜을 받을 수 있습니다. 다시 말하지만, 이렇게 하면 더 많은 거래를 제공할 수 있습니다.
거래는 숙박 시설의 시간대에 따라 시작됩니다(i.e. 예약 가능). 예를 들어, 3월 21일에 호주 시드니에서 숙박 시설 거래가 시작되면 시드니 시간으로 오전 12시 1분부터 전 세계 모든 파트너를 대상으로 예약이 시작됩니다.
프로모션 엔드포인트에서 include 요청 매개변수를 사용하여 수신하는 응답의 크기를 사용자 지정할 수 있습니다. 따라서 모든 응답 필드를 수신하는 대신 몇 개의 필드만 반환해야 하는 경우 include 매개변수에 특정 필드 이름을 추가할 수 있습니다.
프로모션 API에 미리 요청을 시작할 수 있지만, 가장 정확한 up-to 날짜 표시를 위해 캠페인 예약 가능 시작일에 최대한 가깝게 요청해야 숙박 시설에서 거래를 확인할 수 있습니다. 캠페인이 시작되기 약 2주 전을 권장합니다. 이는 캠페인 시작이 가까워질수록 숙박 시설의 참여가 가장 완전하고 신뢰할 수 있는 경향이 있기 때문입니다.
- 또한 캠페인이 시작되고 며칠 후에 프로모션을 요청하여 항상 최신 거래 목록을 새로고침할 수 있도록 하는 것이 좋습니다. 또한, 매일 프로모션 API를 요청하여 숙박 시설에서 제공하는 최신 거래 목록을 새로고침하는 것이 좋습니다.
destination-based 머천다이징 캠페인 구축에 관심이 있는 경우, 빠른 지리 API의 관련 region_id 을 사용하여 region-specific 프로모션 API 요청을 할 수 있습니다. 프로모션 엔드포인트에서 허용하는 유일한 지역 유형은 city 입니다. multi_city_vicinity, point_of_interest, neighbourhood 등과 같은 다른 지역 유형은 빈 응답을 반환합니다.

머신러닝 기반 추천

프로모션 응답에 전달되는 기계 learning-powered 관련성 순위는 각 파트너마다 고유하므로 귀하가 받는 순위는 다른 파트너가 받는 순위와 다를 수 있습니다. 머신 러닝 추천을 사용하여 머천다이징 캠페인에서 홍보할 베스트 딜, 숙박 시설 및 목적지를 식별할 수 있습니다. Higher-scoring 거래, 숙박 시설 및 목적지는 고유한 여행자층 사이에서 전환을 유도할 가능성이 높을 수 있습니다.

현재 각 캠페인의 상위 10,000개 거래에 대한 관련성 순위를 받게 됩니다. 테스트 결과, 이 등급의 가치와 영향력은 처음 1만 건의 거래가 지나면 무시할 수 있는 수준이 되는 것으로 나타났습니다.
사용 사례에 따라 sort_by매개변수를 사용하여 프로모션 응답의 정렬 순서를 정의하고, 머신러닝 모델에 의해 결정된 거래, 숙박 시설 또는 목적지 관련성을 기준으로 정렬하도록 선택하여 여행자의 가시성과 예약 측면에서 머천다이징의 최대 가치를 얻을 수 있도록 할 수 있습니다.
- sort_by = promotion을 통과하면 독자적인 머신러닝 알고리즘에 따라 high-to-low (1~10,000) 순위의 모든 거래 결과를 받게 됩니다. 이 정렬을 사용하여 모델이 더 많이 전환할 것으로 예상하는 상위 추천 거래를 얻을 수 있습니다.
- sort_by = property을 통과하면 독점적인 머신 러닝 알고리즘에 따라 high-to-low 순위가 매겨진 숙박 시설의 모든 거래 결과를 받게 됩니다.
- sort_by = destination을 통과하면 독자적인 머신러닝 알고리즘에 따라 순위가 매겨진 목적지( high-to-low )의 모든 거래 결과를 받게 됩니다.

참고: 머신 러닝 권장 사항도 포털의 마케팅 섹션. 자세한 내용은 계정 관리자에게 문의하세요.

쇼핑 가용성 API 변경 사항

이용 가능 여부, 실시간 가격, 환불 가능성, 수수료 정보 등에 대한 최신 세부 정보를 확인하려면 Rapid 조회 API에 표준 요청을 보내야 합니다. 머천다이징 플로우를 지원하고 머천다이징 API를 최대한 원활하게 통합할 수 있도록 조회 API를 다음과 같이 변경했습니다:

빠른 쇼핑 가능 여부 엔드포인트에서 사용할 수 있는 새로운 deal필터를 사용하여 활성 프로모션이 있는 요금만 받습니다. 이렇게 하면 머천다이징에만 초점을 맞춘 쇼핑 요청을 유연하게 생성하고 반환되는 모든 요금에 deal속성이 포함되도록 할 수 있습니다.

참고: 쇼핑 가능 여부 API에서 한 번에 최대 250개의 숙박 시설에 대한 세부 정보를 요청할 수 있습니다.

예시 응답

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

참고: 머천다이징 API 응답에서 사용할 수 있는 id및 description은 조회 API 응답에서 반환되는 값과 다릅니다. 머천다이징 API에서 반환하는 id및 description을 사용하는 것이 좋습니다.

제안된 최소 할인 금액은 세금 및 수수료를 제외하고 계산된 금액입니다. 광고에 표시되는 할인이 가격 광고 관련 법률을 준수하는지 확인할 책임이 있습니다.

출시 요구 사항

규정 준수 책임

캠페인을 운영할 때 모든 관련 법률 및 마케팅 가이드라인을 준수할 책임은 전적으로 회원님에게 있습니다.

콘텐츠 무결성

API 세부 정보

이 페이지의 merchandising-related 엔드포인트 정의를 살펴본 다음 API Explorer 또는 다른 테스트 소프트웨어를 사용하여 예제와 스키마 정의가 실제 출력과 어떻게 비교되는지 파악하세요.

추가 리소스

모든 Rapid API 엔드포인트를 사용해 보거나 OpenAPI 사양 또는 Postman 컬렉션을 다운로드하려는 경우 다음 사항을 참조해 주세요.