게재 모드는 호텔 및 여행 일정 조합의 가격 업데이트를 Google에 전송하는 방법을 결정합니다. 초기 구성 중에 사용자와 기술계정 관리자 (TAM)가 협력하여 전송 모드를 설정합니다.
전송 모드 개요
기본적으로 호텔을 이용할 수 있게 되기 최대 330일 전, 최대 30박까지 호텔을 쿼리할 수 있지만, 최대 숙박 일정 수 (체크인 날짜와 숙박 기간의 조합)를 결정할 수 있습니다.
지원하는 운항 일정이 많을수록 더 많은 입찰에 참여할 수 있습니다. 하지만 지원하는 운항 일정이 많을수록 가격 책정 데이터를 정확하게 유지하기 위해 더 많은 데이터를 Google에 전송해야 합니다.
가격을 업데이트하는 일반적인 방법은 다음 방법 중 하나로 Transaction 메시지를 사용합니다.
ARI (푸시): 요금제, 예약 가능 여부, 호텔 메타데이터를 활용하여 숙박 시설에 사전 정의된 가격 책정 전략을 설정하는 가격 제공 피드입니다. 가져오기 및 변동된 가격과 달리 ARI 피드는 특정 가격이나 일정을 쿼리하지 않습니다. 대신 다양한 요금 세부정보, 제한사항, 예약 가능 여부에 따라 숙박 시설의 가격 모델을 나타내는 일부 정보가 포함된 메시지를 푸시합니다. ARI 피드는 OTA XML 사양(
OTA_HotelRateAmountNotifRQ및OTA_HotelAvailNotifRQ)을 사용하여 이용 가능 여부 및 가격을 정의합니다. ARI 전송 모드에 대해 자세히 알아보고 이 피드 유형이 내 계정에 가장 적합한지 확인하려면 계정 관리자에게 문의하세요. 자세한 내용은 ARI 사용을 참고하세요.가져오기: Google이 정기적으로 서비스를 쿼리하여 가격 및 재고 데이터 캐시를 새로고침합니다. 이 모델에서 Google은 서버에 요청을 보내면 서버는 업데이트된 데이터로 응답합니다. 이 모델은 가격 정보가 언제 변경되는지 정확히 모르거나 가격 정보가 하루 종일 비정기적으로 변경되는 경우에 가장 적합합니다. 가격은 Google 알고리즘이 파트너별 이전 가격 변경 내역을 기반으로 오래되었다고 판단할 때까지 캐시에 남아 있습니다. 자세한 내용은 가져오기 전송 모드 사용을 참조하세요.
변동된 가격 책정 (이전 명칭: Pull with Hints): Google에서 모든 속성이 아닌 일부 속성에 대한 데이터만 요청한다는 점을 제외하면 가져오기와 비슷합니다. 이 모드를 사용하면 숙박 시설의 가격 및 이용 가능 여부를 업데이트할 때 네트워크 트래픽 양을 크게 줄일 수 있습니다. 가격은 업데이트될 때까지 캐시에 무기한 유지됩니다. 자세한 내용은 변경된 가격 책정 사용을 참조하세요.
가격을 업데이트하는 것 외에도 거래 메시지를 사용하여 인벤토리에서 숙박 시설을 삭제할 수 있습니다. 자세한 내용은 인벤토리 삭제를 참조하세요.
거래 메시지 예시를 포함하여 가격 업데이트 제공에 대한 자세한 내용은 가격 업데이트를 참고하세요.
실시간 가격 쿼리
Google은 실시간 가격 쿼리를 사용하여 입찰 시 일부 가격 업데이트를 요청할 수도 있습니다. 실시간 가격 쿼리는 현재 입찰에 대한 Google의 가격 요청입니다. 지정된 기간 내에 응답하면 광고가 입찰에 참여하게 됩니다.
Google은 다른 거래 메시지와 마찬가지로 실시간 가격 쿼리에 대한 응답을 저장합니다. 따라서 Google은 향후 다른 실시간 가격 쿼리를 전송하는 대신 캐시에서 가격을 제공할 수 있습니다.
자세한 내용은 실시간 가격 쿼리를 참조하세요.
컨텍스트
가져오기 및 변동된 가격 쿼리는 일반적으로 사용자에 대한 정보를 지정하지 않습니다. Google에서 다양한 사용자에게 서비스를 제공하는 데 사용할 수 있는 캐시를 채우기 위해 응답을 사용하기 때문입니다.
가능한 사용자 컨텍스트의 전체 집합에 해당하는 가격을 반환하는 데 비용이 많이 들 수 있으므로 인기 사용자 컨텍스트가 쿼리의 일부로 지정되는 기능을 테스트하는 중입니다. 사용자 컨텍스트는 가격을 표시할 수 있었던 사용자 요청을 기반으로 하며 대부분의 사용자 요청을 포함하도록 계산됩니다. 매우 인기 있는 숙박 시설이나 여행 일정에 대한 사용자 컨텍스트가 많이 표시될 수 있지만 평균 사용자 컨텍스트 수는 10개 미만이어야 합니다. 추가 가격을 반환하거나 지정된 사용자 컨텍스트를 무시할 수 있습니다. 주어진 쿼리에 대해 어떤 가격을 반환할지는 개발자가 결정합니다. 하지만 추천된 사용자 컨텍스트를 무시하면 트래픽이 낮아질 수 있습니다.
ARI 푸시 전송 모드
ARI 푸시 전송 모드를 사용하면 야간 요금, 예약 가능 여부, 인벤토리 수 또는 기타 제한사항이 변경될 때마다 Google에 증분 업데이트를 전송할 수 있습니다. 가져오기 또는 변동된 가격과 달리 ARI 푸시를 사용하면 다양한 가격 책정 모델을 사용하여 가격 정보의 다양한 구성요소를 Google에 효율적으로 업데이트할 수 있습니다.
다음 다이어그램은 ARI 푸시 전송 모드의 요청 및 응답 흐름을 보여줍니다.
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의 요청/응답 흐름을 보여줍니다.
가격 업데이트를 받은 후 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)에게 문의하세요. 초기 구성 중에 이를 설정해야 합니다.
다음 다이어그램은 변동된 가격의 요청 및 응답 흐름을 보여줍니다.
다음 섹션에서는 이 흐름의 각 단계를 설명합니다.
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>입니다. 자세한 내용은 가져오기 전송 모드를 참고하세요.