이 페이지는 Cloud Translation API를 통해 번역되었습니다.

프로모션 메시지

개요

프로모션 메시지에서는 다음을 사용하여 요금 할인 규칙을 정의합니다. OTA_HotelRateAmountNotifRQ 요율별로 정의된 프로모션은 평가되며 허용되는 가장 큰 할인이 있습니다. 이 메시지 유형은 선택사항이며 요율 할인을 적용하기 위해 시스템에서 사용되는 경우

프로모션을 결합하여 다양한 사용자 속성에 적용할 수 있습니다. 기기 유형 (모바일, 태블릿, 데스크톱) 및 국가 코드 등입니다.

다양한 프로모션 관련 시나리오의 예는 다음을 참조하세요. 사용 방법

다음 섹션에서는 일반 가이드라인, 기본 예 및 방법을 설명합니다. 프로모션 추가 및 업데이트를 시작하는 방법을 설명합니다.

가이드라인

이 섹션에서는 프로모션 설정에 관한 일반적인 가이드라인과 특별 안내를 다룹니다.

프로모션과 관련해 다음 가이드라인을 사용하세요.

작업

삭제: <Promotion> 요소에서 delete 작업을 사용하여 단일 항목 삭제 프로모션의 ID로 지정할 수 있습니다.
오버레이: <HotelPromotions> 요소에서 overlay 작업을 사용하여 모든 프로모션을 표시합니다
델타: 작업을 지정하지 않으면 모든 프로모션이 지정됩니다. <HotelPromotions> 내에서 추가되거나 대체됩니다. 해당 ID를 사용하는 프로모션이 추가된 적이 없거나 삭제된 적이 없는 경우 프로모션이 추가됩니다. 만약 해당 ID가 있는 프로모션이 있으면 새 정의로 덮어씁니다.

일반

속성마다 프로모션이 하나일 수도 있고 여러 개일 수도 있으며, 각 프로모션에는 조건이 있습니다. 해당 프로모션은 확인할 수 있습니다
프로모션을 특정 날짜, 객실 유형 또는 요금제에만 적용하려면 해당 프로모션의 조건에 이를 지정합니다. 만약 특정 날짜, 객실 유형 또는 요금제에 적용되지 않는 경우 직접 설정할 필요가 없습니다
각 프로모션은 특정 숙박 시설에 연결됩니다. 여러 숙박 시설에 동일한 프로모션을 사용하는 경우 숙박 시설별로 별도로 전송해야 합니다. 받는사람 속성 식별자를 지정하려면 속성의 hotel_id 속성을 사용합니다. <HotelPromotions> 요소
프로모션은 최대 99개까지 포함할 수 있습니다. 필요한 경우 Google TAM에 문의하세요. 이보다 더 많이 포함시키세요.
<Stacking> 요소를 사용하여 프로모션을 결합할 수 있는 방법을 지정합니다. 기준 Google에서는 기본적으로 base 스태킹 유형을 사용하므로 기본 프로모션이 먼저 선택되어 적용된 후에 다른 프로모션보다 먼저 적용됩니다. 참고 base는 second 또는 any하고만 결합할 수 있으며 결합할 수 없음 다른 base 또는 none로 바꿉니다.
함께 적용할 수 있는 프로모션이 여러 개 있는 경우에도 해당 스택은 실제로 다른 스택이 있는 경우 더 많은 할인을 제공하는 단일 프로모션 또는 프로모션 스택을 선택합니다. 이 가장 큰 할인이 적용된 프로모션 (조합)이 예약에 적용됩니다. 여러 프로모션의 조합을 사용할 수 있는 경우
영향을 미치는 변경사항이 발생할 때마다 프로모션 메일 업데이트를 전송합니다. 프로모션에 대해 자세히 알아보세요.

핵심사항: 프로모션은 속성당 500개로 제한됩니다. 이 <Promotions> 메시지를 사용하여 속성에서 프로모션을 삭제할 수 있습니다.

최적의 프로모션 (또는 프로모션 스택)이 AmountAfterTax에 적용됩니다. 있습니다. AmountBeforeTax만 지정하면 프로모션이 AmountBeforeTax에 적용되었습니다.

예

이 섹션에서는 필수 항목을 사용하는 프로모션 메시지의 기본 예시를 제공합니다. 및 선택 요소를 포함할 수 있습니다. 파일이 준비되면 다음을 통해 Google에 전송합니다. 이 엔드포인트에 POST 메시지를 전송합니다.

https://www.google.com/travel/hotels/uploads/promotions

메시지를 푸시/POST하는 방법에 대한 자세한 내용은 다음을 참조하세요. 메시지 푸시.

<HotelPromotions>의 hotel_id 속성에는 고유한 호텔 ID를 사용하세요. 시스템 내에서 속성을 식별하는 데 사용한 URL입니다. 이 값은 일치해야 합니다. <listing>에서 <id>을(를) 사용하여 지정된 호텔 ID 요소와 일치하지 않는 경우 발생합니다. 시스템의 일관성은 Google이 데이터를 올바르게 표시하는지 확인

UserCountry은 (는) 사용할 수 있는 사용자 위치를 나열하는 데 사용됩니다. 을 입력합니다. 지정하면 나열된 국가의 사용자만 할인율을 제공합니다

이 예시에서는 장기 숙박에 15% 할인을 설정하는 방법을 보여줍니다. :

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123_abc"
            timestamp="2022-05-30T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="15"/>
      <UserCountries>
        <Country code="US"/>
        <Country code="IT"/>
      </UserCountries>
    </Promotion>
  </HotelPromotions>
</Promotions>

더 많은 예는 다음을 참고하세요. 프로모션 예

방법

이 섹션에서는 설정 중에 발생할 수 있는 시나리오에 대한 솔루션을 제공합니다. 프로모션입니다.

시나리오 1: 장기 투숙 시 할인 프로모션을 추가하는 방법

설명

장기 투숙 중 특정 요일에 숙박 요금을 할인받고자 하는 경우

솔루션

FreeNights 설정을 사용하여 다음에 따라 적용되는 할인 유형을 맞춤설정하세요. 숙박 일수에 따라 달라집니다.

샘플

이 샘플은 7박마다 2박에 20% 할인을 추가하는 방법을 보여줍니다. 지정된 예약 날짜 범위 동안 숙박했습니다. 15박 여행의 경우 총 4박 숙박에 20% 할인이 적용됩니다.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-05T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-02-01" end="2022-06-30"/>
      </BookingDates>
      <Discount>
        <FreeNights stay_nights="7"
                    discount_nights="2"
                    discount_percentage="20"
                    night_selection="cheapest"
                    repeats="true"/>
      </Discount>
    </Promotion>
  </HotelPromotions>
</Promotions>

시나리오 2: 기기 유형 설정 방법

devices를 설정하여 프로모션 지정하면 나열된 기기의 사용자에게만 제공됩니다. 할인율입니다.

설명

프로모션 대상 사용자 기기 유형을 지정하려고 합니다.

솔루션

기기 유형을 desktop, tablet, 값 중 하나 이상으로 설정합니다. 또는 mobile.

샘플

다음 샘플은 모바일 광고에 25% 할인을 지정하고 태블릿 사용자:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="25"/>
        <Devices>
          <Device type="mobile"/>
          <Device type="tablet"/>
        </Devices>
    </Promotion>
  </HotelPromotions>
</Promotions>

시나리오 3: 기존 프로모션을 새 프로모션으로 교체하는 방법

설명

숙박 시설에 대한 현재 프로모션이 오래되었거나 부정확하여 필요합니다. 완전히 새로운 세트로 대체될 것입니다.

솔루션

overlay 작업을 사용하여 프로모션을 교체합니다.

샘플

다음 샘플은 원래 할인 가격인 20% 와 30% 입니다.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-06-01" end="2022-07-31"/>
      </BookingDates>
      <Discount percentage="20"/>
    </Promotion>
    <Promotion id="2">
      <BookingDates>
        <DateRange start="2022-08-01" end="2022-08-31"/>
      </BookingDates>
      <Discount percentage="30"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

이 샘플은 overlay를 사용하여 기존 숙박 시설에 대해 15% 할인이라는 단일 프로모션이 포함된 프로모션 2개입니다.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-25T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1" action="overlay">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-06-01" end="2022-07-31"/>
      </BookingDates>
      <Discount percentage="15"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

시나리오 4: 하나 또는 모든 프로모션을 삭제하는 방법

설명

다음과 같은 이유로 교체 없이 하나 또는 모든 프로모션을 삭제하려고 합니다. 속성에서 새 프로모션을 설정하지 않고 모든 프로모션을 삭제함 오류가 발생했으며 수정해야 합니다

솔루션

특정 개인만 삭제하려면 delete 작업을 사용하세요. 숙박 시설 프로모션을 사용하고 overlay (delete 아님) 작업을 사용하여 교체 없이 기존 프로모션을 모두 교체합니다.

overlay를 사용하여 프로모션을 교체하는 방법에 관한 자세한 내용은 다음을 참고하세요. 시나리오 3.

샘플

다음 샘플은 숙박 시설에 대해 하나의 프로모션만 삭제하는 방법을 보여줍니다.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1" action="delete"/>
  </HotelPromotions>
</Promotions>

이 샘플은 교체 없이 모든 프로모션을 삭제하는 방법을 보여줍니다. 속성:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1" action="overlay"/>
</Promotions>

시나리오 5: 프로모션을 겹치는 방법

스택은 프로모션을 결합할 수 있는 방법을 지정합니다. 지정하지 않으면 type base로 가정됩니다. 즉, 요건을 충족하는 기본 프로모션은 다른 프로모션보다 먼저 선택하여 적용할 수 있습니다. type 속성이 Stacking이(가) any인 경우 다른 프로모션과 함께 사용할 수 있습니다.

설명

사용자에게 여러 프로모션을 동시에 사용할 수 있는 옵션을 제공하려는 경우 동일한 속성에 대한 시간을 반환합니다.

솔루션

누적 할인을 사용하여 숙박 시설당 여러 할인을 설정할 수 있습니다. 하나의 스택은 최대 하나의 base 및 하나의 second, any는 무제한 및 any의 권한: none를 제외한 다른 유형과 결합되어야 합니다.

샘플

이 샘플은 base, second, any 스태킹 유형을 쌓는 방법을 보여줍니다. 15%, 25%, 10%의 할인을 합산하면 100달러 가격이 총 57.38달러(100 × .85 × .75 × .9)가 됩니다.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="15"/>
      <Stacking type="base"/>
    </Promotion>
    <Promotion id="2">
      <Discount percentage="25"/>
      <Stacking type="second"/>
    </Promotion>
    <Promotion id="3">
      <Discount percentage="10"/>
      <Stacking type="any"/>
    </Promotion>
    <Promotion id="4">
      <Discount percentage="40"/>
      <Stacking type="none"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

참고: 프로모션 1~3번 중첩에 대한 총 할인율은 다음과 같습니다. 더 높다는 것을 알 수 있습니다. 프로모션 4는 다른 프로모션으로 인해 발생했습니다 (none). 프로모션 4에 43% 이상이면 프로모션 1부터 3까지