게재 모드는 호텔 및 숙박 일정 조합에 대한 가격 업데이트를 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은 호텔 목록에 정의된 모든 숙박 시설에 대한 쿼리 메시지를 전송합니다. 이는 가격 재산정 프로세스 중에 여러 Query 메시지를 수신해야 함을 의미합니다.
Google에서 서버로 전송하는 가격 책정 쿼리 메시지에는 다음과 같은 특징이 있습니다.
- 루트 요소는
<Query>
입니다. - 초기 구성 중에 정의된 엔드포인트로 전송됩니다. 자세한 내용은 기술계정 관리자 (TAM)에게 문의하세요.
- HTTP
POST
메서드를 사용합니다. (HTTPS를 사용하는 경우 공식 인증 기관에서 도메인에 서명해야 합니다.) Content-Type
헤더가application/xml
로 설정됩니다.- 각 메시지에는 Google에서 가격 및 재고 데이터를 요청하는 최대 100개의 숙박 시설이 포함됩니다.
User-Agent
헤더가Google-HotelAdsPrices
로 설정됩니다.
2단계: 거래 메시지
서버가 쿼리 메시지를 수신하면 요청된 여정의 가격 정보가 포함된 트랜잭션 메시지로 응답해야 합니다.
거래 메시지의 루트 요소는 <Transaction>
입니다. 자세한 내용은 트랜잭션 메시지 및 가격 업데이트를 참고하세요.
룸 및 패키지 메타데이터 업데이트
Pull을 사용하여 가격 데이터를 업데이트하는 것 외에도 트랜잭션 메시지를 사용하여 객실 및 패키지 메타데이터를 업데이트할 수 있습니다. 자세한 내용은 회의실 및 패키지 메타데이터 정의를 참고하세요.
변동된 요금 게재 모드
변경된 가격은 가격 업데이트를 위한 쿼리 및 거래 메시지의 크기와 수량을 줄이는 데 도움이 됩니다. 변동된 가격을 사용하는 경우 가격이 업데이트된 숙박 시설 목록을 Google에 전송합니다. Google은 해당 속성의 가격만 요청하는 Query 메시지로 응답합니다.
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 메시지의 루트 요소는 <Query>
입니다.
변경된 가격으로 가격을 요청할 호텔 ID를 결정할 때 Google에서는 호텔 목록 피드의 콘텐츠를 무시합니다. 이렇게 하면 Google에서 수신하는 쿼리 메시지의 크기와 응답의 트랜잭션 메시지 크기가 크게 줄어듭니다.
4단계: 거래 메시지
Google의 쿼리 메시지에 대한 응답으로 가격 업데이트가 포함된 트랜잭션 메시지를 전송합니다. 트랜잭션 메시지의 루트 요소는 <Transaction>
입니다. 자세한 내용은 풀 전송 모드를 참고하세요.