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

게재 모드 가격 책정

게재 모드에 따라 호텔 및 여행 일정 조합에 대한 가격 업데이트를 Google에 전송하는 방법이 결정됩니다. 초기 구성 단계에서 개발자와 기술계정 관리자 (TAM)가 함께 협력하여 제공 모드를 설정합니다.

게재 모드 개요

기본적으로 객실 이용 가능 여부 최대 330일 전부터 최대 30박 숙박 날짜까지 호텔을 쿼리할 수 있지만, 최대 숙박 일정 수 (체크인 날짜 및 숙박 기간 조합)를 결정할 수 있습니다.

지원하는 여행 일정이 많을수록 더 많은 입찰에 참여하게 됩니다. 하지만 지원하는 여행 일정이 많을수록 가격 데이터의 정확성을 유지하기 위해 Google에 더 많은 데이터를 전송해야 합니다.

가격을 업데이트하는 일반적인 방법은 다음 중 한 가지 방법으로 거래 메시지를 사용합니다.

ARI (푸시): 요금제, 예약 가능 여부, 호텔 메타데이터를 활용하여 숙박 시설에 사전 정의된 가격 책정 전략을 설정하는 가격 제공 피드입니다. 가져오기 및 변동된 가격과 달리 ARI 피드는 특정 가격이나 여행 일정을 쿼리하지 않습니다. 대신 다양한 요금 세부정보, 제한사항, 예약 가능 여부를 기반으로 숙박 시설의 가격 책정 모델을 나타내는 정보 하위 집합이 포함된 메시지를 푸시합니다. ARI 피드는 OTA XML 사양(OTA_HotelRateAmountNotifRQ 및 OTA_HotelAvailNotifRQ)을 사용하여 이용 가능 여부 및 가격을 정의합니다. ARI 전송 모드에 관해 자세히 알아보고 이 피드 유형이 내 계정에 가장 적합한지 확인하려면 계정 관리자에게 문의하세요. 자세한 내용은 ARI 사용을 참고하세요.
가져오기: Google이 정기적으로 서비스를 쿼리하여 가격 및 가용성 데이터 캐시를 새로고침합니다. 이 모델에서는 Google이 서버에 요청을 보내면 서버가 업데이트된 데이터로 응답합니다. 가격 책정 정보가 언제 변경되는지 정확히 모르거나 가격 정보가 하루 동안 불규칙적으로 변경되는 경우 이 모델이 가장 적합합니다. 가격은 Google 알고리즘에서 파트너별 이전 가격 변경 내역을 기반으로 가격이 오래되었다고 판단할 때까지 캐시에 유지됩니다. 자세한 내용은 가져오기 전송 모드 사용을 참고하세요.
변동된 가격 (이전 명칭: Pull with Hints): Google이 모든 속성이 아니라 속성의 하위 집합에 대한 데이터만 요청한다는 점을 제외하면 가져오기와 유사합니다. 이 모드를 사용하면 숙박 시설의 가격과 이용 가능 여부를 업데이트할 때 네트워크 트래픽의 양을 크게 줄일 수 있습니다. 가격은 업데이트할 때까지 캐시에 무기한 유지됩니다. 자세한 내용은 변경된 가격 책정 사용을 참조하세요.

가격을 업데이트하는 것 외에도 거래 메시지를 사용하여 인벤토리에서 속성을 삭제할 수 있습니다. 자세한 내용은 인벤토리 삭제를 참조하세요.

거래 메시지 예시를 포함하여 가격 업데이트 제공에 관한 자세한 내용은 가격 업데이트를 참고하세요.

실시간 가격 쿼리

Google은 실시간 가격 쿼리를 사용하여 입찰 시점에 일부 가격 업데이트를 요청할 수도 있습니다. 실시간 가격 쿼리는 현재 입찰에 대한 Google의 가격 요청입니다. 지정된 기간 내에 응답하면 광고가 입찰에 참여합니다.

Google은 다른 거래 메시지와 마찬가지로 실시간 가격 쿼리에 대한 응답을 저장합니다. 따라서 Google은 향후 다른 실시간 가격 쿼리를 전송하는 대신 캐시에서 가격을 제공할 수 있습니다.

자세한 내용은 실시간 가격 쿼리를 참조하세요.

ARI 푸시 전송 모드

ARI 푸시 전송 모드를 사용하면 야간 요금, 예약 가능 여부, 인벤토리 수 또는 기타 제한사항이 변경될 때마다 Google에 증분 업데이트를 전송합니다. 가져오기 또는 변동된 가격과 달리 ARI 푸시를 사용하면 다른 가격 책정 모델을 사용하여 다양한 가격 책정 정보 구성요소를 Google에 효율적으로 업데이트할 수 있습니다.

다음 다이어그램은 ARI 푸시 전송 모드의 요청 및 응답 흐름을 보여줍니다.

fig1

1단계: Google에 ARI 푸시 메시지 보내기

ARI 푸시로 데이터를 업데이트하려면 데이터가 변경될 때마다 ARI 요청 메시지를 전송하세요. ARI 푸시 전송 모드는 다양한 메시지 유형과 가격 책정 전략을 지원합니다. 메시지 푸시에 관한 자세한 내용은 ARI 사용을 참고하세요.

가격은 Google을 통해 게시되어야 하며 메시지 수신 후 15~20분 이내에 사용자에게 표시되어야 합니다.

2단계: Google에서 데이터가 성공적으로 캐시되었는지 확인하기

수신된 ARI 푸시 메시지마다 Google에서 HTTP 연결 상태와 ARI 처리 결과를 응답으로 반환합니다. 서버 연결이 성공하면 Google은 HTTP 200 OK로 응답합니다. 또한 업데이트가 성공적으로 적용되었는지 또는 전송 모드 경고 또는 오류가 발생했는지를 나타내는 응답 메시지가 있는 본문도 포함되어 있습니다.

IP 주소 허용 목록

ARI 메시지를 Google에 푸시하는 데 사용하는 IP 주소를 허용 목록에 추가하려면 Hotel Center ARI 가격 설정 페이지를 사용하세요. Hotel Center에서 가격 설정을 업데이트하는 방법 알아보기

ARI 푸시로 Room 및 패키지 메타데이터 업데이트

거래(숙박 시설 데이터) 메시지 유형을 사용하여 각 숙박 시설의 활성 객실 유형과 요금제 (패키지)를 정의합니다. 객실 유형 또는 요금제가 추가, 삭제, 수정될 때마다 업데이트를 푸시해야 합니다. 이 경우 <RoomData> 및 <PackageData> 요소에 새 정보가 포함된 XML 메시지를 보냅니다. 이러한 요소는 <PropertyDataSet> 요소의 하위 요소입니다.

연결 또는 콘텐츠 오류

XML의 형식이 잘못되었거나 잘못되어 전송 모드 오류가 발생하는 경우 피드 상태 오류 메시지에서 권장 해결 방법을 확인하세요.

Google에 ARI 메시지를 보낼 때 HTTP 연결 오류가 발생하면 1, 5, 20분 간격으로 요청을 다시 시도하세요. 3번의 재시도 후에도 문제가 지속되면 메시지 전송을 중지하고 Google 지원팀에 문의하세요.

가져오기 게재 모드

가져오기 전송 모드를 사용하면 Google이 정기적으로 서버에 쿼리 메시지를 보내 가격 업데이트를 요청합니다. 서버는 업데이트된 가격 및 이용 가능 여부 데이터가 포함된 트랜잭션 메시지로 이러한 메시지에 응답합니다.

다음 다이어그램은 pull의 요청/응답 흐름을 보여줍니다.

fig2

가격 업데이트를 받은 후 Google은 일반적으로 약 5분 이내에 새 가격 및 이용 가능 여부 데이터를 처리합니다.

다음 섹션에서는 이러한 각 단계를 자세히 설명합니다.

1단계: 메시지 쿼리

기본적으로 Google은 호텔 목록에 정의된 모든 숙박 시설에 대한 쿼리 메시지를 전송합니다. 즉, 가격 재조정 프로세스 중에 여러 쿼리 메시지를 수신해야 할 수 있습니다.

Google이 서버에 전송하는 가격 쿼리 메시지에는 다음과 같은 특성이 있습니다.

루트 요소는 <Query>입니다.
초기 구성 중에 정의된 엔드포인트로 전송됩니다. 자세한 내용은 기술계정 관리자 (TAM)에게 문의하세요.
HTTP POST 메서드를 사용합니다. HTTPS를 사용하는 경우 공식 인증 기관에서 서명한 도메인을 가져와야 합니다.
Content-Type 헤더가 application/xml로 설정되어 있습니다.
각 메시지에는 Google에서 가격 및 이용 가능 여부 데이터를 요청하는 최대 100개의 숙박 시설이 포함됩니다.
User-Agent 헤더가 Google-HotelAdsPrices로 설정되어 있습니다.

2단계: 거래 메시지

서버가 쿼리 메시지를 수신하면 요청된 여행 일정의 가격 정보가 포함된 트랜잭션 메시지로 응답해야 합니다.

트랜잭션 메시지의 루트 요소는 <Transaction>입니다. 자세한 내용은 트랜잭션 메시지 및 가격 업데이트를 참고하세요.

Room 및 패키지 메타데이터 업데이트

가져오기를 통해 가격 데이터를 업데이트하는 것 외에 트랜잭션 메시지를 사용하여 객실 및 패키지 메타데이터를 업데이트할 수도 있습니다. 자세한 내용은 룸 및 패키지 메타데이터 정의를 참고하세요.

변경된 가격 게재 모드

변동된 가격을 사용하면 가격 업데이트를 위한 쿼리 및 트랜잭션 메시지의 크기와 수량을 줄일 수 있습니다. 변동된 가격을 사용하면 가격이 업데이트된 숙박 시설 목록을 Google에 전송합니다. Google은 해당 숙박 시설의 가격만 요청하는 쿼리 메시지로 응답합니다.

Google이 힌트 요청 메시지를 보내는 엔드포인트를 구성하려면 기술계정 관리자 (TAM)에게 문의하세요. 초기 구성 시 이를 설정해 놓았을 것입니다.

다음 다이어그램은 변동된 가격의 요청 및 응답 흐름을 보여줍니다.

fig3

다음 섹션에서는 이 흐름의 각 단계를 설명합니다.

1단계: 힌트 요청 메시지

Google이 서버에 전송하는 힌트 요청 메시지에는 다음과 같은 특성이 있습니다.

루트 요소가 <HintRequest>입니다.
초기 구성 중에 정의된 엔드포인트로 전송됩니다. 자세한 내용은 기술계정 관리자 (TAM)에게 문의하세요.
HTTP POST 메서드를 사용합니다. HTTPS를 사용하는 경우 공식 인증 기관에서 서명한 도메인을 가져와야 합니다.
Content-Type 헤더가 application/xml로 설정되어 있습니다.
지정된 빈도로 Google은 힌트 요청 메시지에 마지막으로 응답한 시간을 정의하는 타임스탬프를 서버에 전송합니다.
User-Agent 헤더가 Google-HotelAdsPrices로 설정되어 있습니다.

실행 빈도를 5분으로 설정하는 것이 좋습니다. 힌트 요청 메시지의 빈도를 설정하거나 수정하려면 Google에 문의하세요.

Google에서 힌트 요청 메시지를 수신하면 해당 타임스탬프 이후 업데이트된 모든 가격으로 응답합니다. 자세한 내용은 힌트 요청 메시지를 참고하세요.

2단계: 힌트 응답 메시지

서버가 힌트 요청 메시지에 힌트 응답 메시지로 응답합니다. 이 메시지에는 마지막으로 힌트 요청 메시지를 수신하고 응답한 이후 가격이 변경된 숙박 시설의 호텔 ID 및 여행 일정이 포함됩니다.

힌트 응답 메시지의 루트 요소는 <Hint>입니다. 자세한 내용은 힌트 응답 메시지를 참고하세요.

3단계: 메시지 쿼리

Google은 표준 가져오기 모드에서와 마찬가지로 힌트 응답 메시지를 수신하고 쿼리 메시지로 응답합니다. 차이점은 이제 쿼리 메시지에 힌트 응답 메시지에 지정한 속성의 호텔 ID와 여행 일정만 포함된다는 것입니다. 쿼리 메시지의 루트 요소는 <Query>입니다.

변동된 가격을 사용하여 가격을 요청할 호텔 ID를 결정할 때 Google은 호텔 목록 피드의 콘텐츠를 무시합니다. 이렇게 하면 Google에서 수신하는 쿼리 메시지 크기와 응답의 트랜잭션 메시지 크기가 크게 줄어듭니다.

4단계: 거래 메시지

Google의 쿼리 메시지에 대한 응답으로 가격 업데이트가 포함된 트랜잭션 메시지를 보냅니다. 트랜잭션 메시지의 루트 요소는 <Transaction>입니다. 자세한 내용은 가져오기 전송 모드를 참조하세요.