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