개요

새로운 머천다이징 API를 활용하여 거래를 더 쉽게 식별하고 머신 러닝 기술의 이점을 누리세요.

머신러닝을 활용하여 방대한 글로벌 프로모션 인벤토리( Expedia Group's )에서 여행객에게 가장 관련성 높은 거래와 할인을 찾아낼 수 있습니다. 머천다이징 API를 사용하면 다양한 캠페인 콘텐츠와 거래 데이터에 액세스하여 성공적인 year-long 전략과 프로모션 이메일, 앱 위젯, 웹사이트 배너, 캐러셀 경험 등의 traveler-facing 경험을 구축할 수 있습니다.

또한 파트너 포털에 머천다이징 전략을 수립하고 캠페인을 계획, 실행 및 추적하는 데 사용할 수 있는 새로운 앱이 추가되었습니다. 이 앱은 포털 마케팅 허브라는 새로운 섹션에 있습니다. 자세한 내용은 계정 관리자에게 문의하세요.

캠페인 콘텐츠 엔드포인트

• 캠페인 ID, 예약 및 숙박 시작일과 종료일, 숙박 시설 참여자 수 등 예정된 캠페인 세부 정보를 제공합니다.
• 캠페인 주제 이미지, 목적지 이미지, 추천 카피 등과 같은 Expedia-curated 캠페인 자산에 직접 액세스할 수 있습니다.
• 향후 6개월 이내에 예약 기간이 있는 기간 한정 혜택(LTO) 캠페인과 연중 내내 이용 가능한 상시 캠페인에 대한 정보를 받아보세요.

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

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

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

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

기타 세부 정보

캠페인 콘텐츠 엔드포인트는 Expedia-curated 에셋을 활용하여 프로모션 이메일, 앱 위젯, 웹사이트 배너 등과 같은 traveler-facing 머천다이징 경험을 만드는 데 도움이 될 수 있습니다.

캠페인 콘텐츠 응답의 property_count필드를 사용하여 가장 많은 up-to-date 참여 숙박 시설 수를 확인할 수 있습니다. #상품화 캠페인 참여는 유동적이므로 캠페인 시작 약 4~6주 전에 property_count를 확인하여 캠페인의 일환으로 얼마나 많은 숙박 시설가 거래를 제공할지 보다 정확하게 파악하는 것이 좋습니다.

프로모션 엔드포인트에서 허용하는 유일한 지역 유형은 city. multi_city_vicinity, point_of_interest, neighbourhood등과 같은 다른 지역 유형은 빈 응답을 반환합니다.

프로모션 엔드포인트

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

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

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

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

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

기타 세부 정보

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

프로모션 엔드포인트에서 include요청 매개변수를 사용하여 수신하는 응답의 크기를 사용자 지정할 수 있습니다. 따라서 모든 응답 필드를 수신하는 대신 몇 개의 필드만 반환해야 하는 경우 include매개변수에 특정 필드 이름을 추가할 수 있습니다.

캠페인 콘텐츠 응답의 property_count필드를 사용하여 가장 많은 up-to-date 참여 숙박 시설 수를 확인할 수 있습니다. #상품화 캠페인 참여는 유동적이므로 캠페인 시작 약 4~6주 전에 property_count에서 캠페인의 일환으로 얼마나 많은 숙박 시설가 거래를 제공할지 정확하게 파악하는 것이 좋습니다.

캠페인 콘텐츠 안내와 마찬가지로, 최대한 많은 up-to-date 거래를 확보하려면 캠페인 예약 가능 시작일에 최대한 가까운 시점에 프로모션 요청을 하는 것이 좋습니다.

destination-based 머천다이징 캠페인 구축에 관심이 있는 경우, 빠른 지리 API의 관련 region_id을 사용하여 region-specific 프로모션 API 요청을 할 수 있습니다.

머신러닝 기반 추천

프로모션 응답에서 제공되는 기계 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를 최대한 원활하게 통합하기 위해 숙박 시설 다음과 같은 변경 사항을 적용했습니다:

• 빠른 쇼핑 가능 여부 엔드포인트에서 사용할 수 있는 새로운 deal필터를 사용하여 활성 프로모션이 있는 요금만 받습니다. 이렇게 하면 머천다이징에만 초점을 맞춘 쇼핑 요청을 유연하게 생성하고 반환되는 모든 요금에 deal속성이 포함되도록 할 수 있습니다.
• Rapid의 쇼핑 가용성 엔드포인트에서 Campaign-Id 이라는 새로운 요청 헤더를 사용하여 특정 쇼핑 가용성 API 호출이 일반 호출이 아니며 실제로는 머천다이징 프로모션 활동으로 인한 것임을 표시할 수 있습니다(즉, 이는 여행자가 캠페인 프로모션으로 인해 쇼핑 경험에 들어갔을 때 쇼핑 가용성 API 요청이 이루어졌음을 의미합니다). 조회 API 호출당 하나의 캠페인 ID만 허용됩니다. 이 캠페인 ID는 캠페인 성과를 추적하고 더 나은 머신러닝 모델과 API 개선 사항을 설계하는 데 도움이 됩니다.
• 포털 마케팅 허브에서 캠페인 실적을 확인하려면 조회 API 호출에 캠페인 ID 매개변수를 전달해야 합니다. 궁금한 점이 있으면 계정 관리자에게 문의하세요.

참고: 쇼핑 가능 여부 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 컬렉션을 다운로드하려는 경우 다음 사항을 참조해 주세요.

API Explorer로 이동