변수 및 조건

호텔 광고 및 무료 예약 링크에는 사용자가 객실을 예약할 수 있는 방문 페이지 링크가 포함됩니다. 사용자 및 여행 일정에 대한 모든 추가 정보를 포함하도록 Google에서 링크를 구성하는 방법을 정의할 수 있습니다. 예를 들어 호텔 ID, 언어, 통화 코드, 체크인 날짜와 같은 정보를 URL에 포함할 수 있습니다.

개요

방문 페이지 파일에서 방문 페이지 URL을 정의합니다. 광고 또는 무료 예약 링크가 표시되면 URL의 동적 정보가 실제 값으로 대체됩니다. 방문 페이지 URL에 동적 값을 추가하려면 다음 구문을 사용합니다.

<URL>https://partner_url?param_id=(variable_name)</URL>

다음 예는 실제 호텔 ID 및 여행 일정 대신 Google의 변수 이름을 사용하는 URL을 보여줍니다.

<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)
  &amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)
  &amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)
</URL>

검색결과 페이지에 대한 방문 페이지 링크가 구성되면 Google에서는 URL에 동적 정보가 포함되도록 변수를 실제 값으로 바꿉니다. 예를 들어 사용자가 호텔 #42에 대해 2023년 5월 23일부터 6박 객실을 예약하면 Google에서는 이전 링크를 다음과 같이 렌더링합니다.

https://www.partnerdomain.com?hotelID=42&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=6

Google이 쿼리 문자열의 변수에 할당하는 값은 호텔 가격 피드, 호텔 목록 피드, 사용자 설정의 해당 데이터에 따라 다릅니다.

예를 들어 LENGTH 변수의 값은 관련 숙박 일정의 가격 피드에서 <Nights> 요소에 할당됩니다. 마찬가지로 PARTNER-HOTEL-ID 변수의 값은 사용자의 검색 기준과 일치하는 호텔 목록 피드의 <id> 요소에 정의됩니다.

일부 변수는 가격 피드 요소의 하위 집합입니다. 예를 들어 CHECKINDAY, CHECKINMONTH, CHECKINYEAR 변수는 가격 피드의 단일 <Checkin> 요소에서 추출됩니다. 다른 변수는 사용자의 언어 및 기타 클라이언트 설정을 기반으로 계산됩니다.

변수 값의 소스에 대한 자세한 내용은 가격 책정 개요 및 호텔 목록을 참고하세요.

URL 변수

다음 표에서는 방문 페이지 URL을 구성하는 데 사용할 수 있는 변수를 설명합니다.

변수 권장/선택사항 설명
ADVANCE-BOOKING-WINDOW Optional 예약 시점의 호텔 시간대를 기준으로 체크인 날짜 전 사전 예약 일수입니다. 예를 들면 다음과 같습니다. 36
ALTERNATE-HOTEL-ID Recommended (if you have separate IDs to identify properties versus booking engines) 숙박 시설의 대체 식별자입니다. 이 속성 이름은 호텔 목록 피드에 지정됩니다. 별도의 ID가 있으면 피드 정보에 하나의 숙박 시설 식별자가, 예약 엔진에 다른 숙박 시설 식별자가 필요한 경우 유용합니다.
CAMPAIGN-ID Recommended URL과 연결할 Google Ads 캠페인의 ID입니다. 클릭이 Google Ads 캠페인과 연결되어 있지 않은 경우 비어 있습니다.
CHECKINDAY Recommended 호텔 가격 피드의 <Checkin> 요소에 정의된 두 자리 숫자 날짜입니다. 예를 들면 다음과 같습니다. 20
CHECKINDAY-OF-WEEK Optional 요일 중 Monday~Sunday(호텔 시간대 기준)로 체크인이 이루어집니다. 예를 들면 Tuesday입니다.
CHECKINMONTH Recommended 호텔 가격 피드의 <Checkin> 요소에 정의된 두 자리 숫자 월입니다. 예를 들면 다음과 같습니다. 05
CHECKINYEAR Recommended 호텔 가격 피드의 <Checkin> 요소에 정의된 4자리 연도입니다. 예를 들면 다음과 같습니다. 2023
CHECKOUTDAY Recommended 호텔 가격 피드의 <Nights> 및 <Checkin> 요소에서 계산된 두 자리 숫자 날짜입니다. 예를 들면 26입니다.
CHECKOUTMONTH Recommended 호텔 가격 피드의 <Nights> 및 <Checkin> 요소에서 계산한 2자리 월입니다. 예: 05
CHECKOUTYEAR Recommended 호텔 가격 피드의 <Nights> 및 <Checkin> 요소에서 계산된 4자리 연도입니다. 예: 2023
CHILD-AGE Recommended (must be provided for child occupancy pricing) 가격 피드의 <Child "age"> 요소에 지정된 각 하위 요소의 최대 연령입니다. 이 변수는 FOR-EACH-CHILD-AGE 조건부 블록과 함께 사용해야 합니다.
CHILD-INDEX Optional 숙박 일정에 지정된 각 어린이 탑승자와 어린이 연령의 카운터를 나타내는 0으로 색인이 생성된 루프 변수입니다. 필수는 아니지만 이 변수는 FOR-EACH-CHILD-AGE 조건부 블록과 함께만 사용할 수 있습니다.
CLICK-TYPE Optional 사용자가 표준 호텔 요금의 비즈니스 정보를 클릭했는지 또는 객실 패키지를 클릭했는지 나타냅니다. 가능한 값은 다음과 같습니다.
  • hotel: 사용자가 표준 객실 요금의 등록정보를 클릭했습니다.
  • room: 사용자가 객실 패키지 등록정보를 클릭했습니다.
CLOSE-RATE-RULE-IDS Optional (only applies if you are using conditional or private rates) 사용할 수 없지만 사용자가 사소한 작업을 수행한 경우 사용 가능했을 수 있었던 요금의 쉼표로 구분된 요금 규칙 ID 목록입니다. 특별 요금의 요금 규칙 ID는 해당하는 UI 처리가 사용자에게 표시될 때 항상 여기에 채워집니다.
CUSTOM[1-5] Optional <Result> 요소에 정의된 맞춤 입력란 값입니다. 맞춤 입력란당 글자 수 제한은 200자(영문 기준)입니다. 자세한 내용은 트랜잭션 메시지 개요를 참고하세요. ARI를 사용하는 경우 맞춤 필드를 사용할 수 없습니다.
DATE-TYPE Optional 사용자가 기본 날짜를 선택했는지 또는 검색에 제공된 특정 날짜를 선택했는지를 나타냅니다. 가능한 값은 다음과 같습니다.
  • default: 사용자가 기본 날짜가 사용된 호텔 광고 또는 무료 예약 링크를 클릭했습니다.
  • selected: 사용자가 날짜가 설정된 호텔 광고 또는 무료 예약 링크를 클릭했습니다.
GOOGLE-SITE Optional 사용자가 호텔 가격 데이터를 본 Google 숙박 시설입니다. 가능한 값은 다음과 같습니다.
  • localuniversal: 사용자가 google.com 검색을 통해 호텔 예약 링크를 찾았습니다.
  • mapresults: 사용자가 maps.google.com를 통해 호텔 예약 링크를 찾았습니다.
  • verification: Google은 사이트에서 자동화된 데이터 품질 테스트를 실행할 때 이 값을 사용합니다. 이러한 쿼리에는 요금이 청구되지 않습니다. Google 애널리틱스에서는 이 매개변수와 해당 값을 사용하여 호텔 광고 자동 인증 트래픽을 식별할 수 있습니다.
  • unknown: 사용자가 확인되지 않은 소스를 통해 광고 또는 무료 예약 링크를 찾았습니다.
LENGTH Recommended 호텔 가격 피드의 <Nights> 요소에 의해 정의된 숙박 일수를 기준으로 한 숙박 기간입니다. 예를 들면 3입니다.
NUM-ADULTS Recommended (must be used with the NUM-CHILDREN or FOR-EACH-CHILD-AGE condition) 사용자가 숙박 일정에 지정한 성인 숙박 인원입니다. 이 변수는 NUM-CHILDREN, FOR-EACH-CHILD-AGE 또는 둘 다와 함께 사용해야 합니다.
NUM-CHILDREN Recommended 사용자가 여행 일정에 지정한 어린이 숙박 인원 (만 0~17세) 수입니다. 어린이 탑승자와 함께 운항 일정에 참여하려면 NUM-CHILDREN, FOR-EACH-CHILD-AGE 또는 둘 다 필요합니다.
NUM-GUESTS Recommended (if you don't send child occupancy pricing) 사용자가 여행 일정에 지정한 총 탑승자 수(성인과 어린이 모두)입니다. 이 값은 NUM-ADULTS 값과 NUM-CHILDREN 값의 합계입니다. 참여를 최대화하려면 NUM-ADULTS 및 NUM-CHILDREN를 모두 활용하는 것이 좋습니다.
PACKAGE-ID Recommended (applies if you use Room Bundles) 호텔 가격 피드에 있는 패키지의 고유 식별자입니다. 표준 패키지의 경우 패키지 ID는 <Result> 블록 내에 있는 <PackageID> 요소의 값입니다. Room 번들의 경우 패키지 ID는 트랜잭션 메시지의 <RoomBundle> 또는 <PackageData> 블록 내에 있는 <PackageID> 요소의 값입니다.
PARTNER-CURRENCY Optional 호텔 가격 피드에 있는 <Baserate> 요소의 currency 속성으로 정의된 3자리 통화 코드입니다. 예를 들면 USD 또는 CAD 입니다.
PARTNER-HOTEL-ID Recommended 호텔 목록 피드의 <id> 요소로 정의되는 호텔의 고유 식별자입니다.
PARTNER-ROOM-ID Recommended (applies if you use Room Bundles) 호텔 가격 피드에 있는 객실의 고유 식별자입니다. 스탠다드룸의 경우 객실 ID는 <Result> 블록 내에 있는 <RoomID> 요소의 값입니다. Room 번들의 경우 객실 ID는 트랜잭션 메시지의 <RoomBundle> 또는 <RoomData> 블록 내에서 <RoomID> 요소에 할당된 값입니다.
PAYMENT-ID Optional (only applies to Ads) 수수료 징수 대행사를 사용하는 경우 사전 정의된 문자열 commission 또는 Google에서 할당한 IATA 번호 (예: '01234567')를 사용합니다. IATA 번호 또는 사전 정의된 문자열의 형식을 변경하려면 기술계정 관리자 (TAM)에게 문의하세요.
PRICE-DISPLAYED-TAX (Optional) 사용자의 현지 통화로 사용자에게 표시되는 세액입니다. PRICE-DISPLAYED-TAX 값은 호텔 가격 피드에 있는 <Tax> 요소의 값입니다. 예: '3.14'
PRICE-DISPLAYED-TOTAL (Optional) 사용자의 현지 통화로 사용자에게 표시되는 총 객실 비용입니다. PRICE-DISPLAYED-TOTAL 값은 호텔 가격 피드의 <Baserate>, <Tax>, <OtherFees> 요소의 합계입니다. 예: '152.13'
PROMO-CODE (Optional)

ARI 프로모션을 사용하는 경우 이 변수의 값이 적용된 <Promotion>의 id 속성에 할당됩니다. 여러 프로모션이 적용되는 경우 임의의 순서로 표시된 쉼표로 구분된 프로모션 ID 목록입니다.

요금 규칙을 사용하는 경우 해당 요금 규칙이 적용되면 이 변수의 값이 PromoCode 요소에 할당됩니다.
RATE-PLAN-ID Recommended (only applies if you use RoomBundles) 가격 피드의 <RoomBundle> 블록에 있는 <RatePlanID> 요소가 정의한 ID입니다. <RatePlanID>는 객실 및 패키지 데이터 조합의 고유 식별자를 나타냅니다. 자세한 내용은 객실 패키지를 참고하세요.
RATE-RULE-ID Recommended (only applies if you use conditional rates or private rates) 가격 피드의 <Rate> 블록 내에 rate_rule_id 속성이 정의한 ID입니다. 자세한 내용은 조건부 요금을 참조하세요.
USER-COUNTRY Recommended 사용자 위치를 나타내는 2자리 국가 코드. 이 정보는 사용자의 클라이언트 설정에서 추출됩니다. 예를 들면 US 또는 FR입니다.
USER-CURRENCY Recommended 사용자의 현지 통화를 나타내는 3자리 통화 코드 USER-CURRENCY 변수의 값은 사용자의 클라이언트 설정에서 추론됩니다. 예를 들면 USD 또는 CAD 입니다.
USER-DEVICE Recommended 사용자의 기기 유형입니다. USER-DEVICE의 값은 다음 중 하나일 수 있습니다.
  • mobile
  • tablet
  • desktop
  • unknown

USER-DEVICE 변수의 값은 사용자의 클라이언트 설정에서 추론됩니다.
USER-LANGUAGE Recommended 광고 또는 무료 예약 링크의 표시 언어를 지정하는 두 글자로 된 ISO 639-1 언어 코드입니다. USER-LANGUAGE 변수의 값은 사용자의 클라이언트 설정에서 추론됩니다. 예를 들면 en 또는 fr입니다.
USER-LIST-ID (Google Ads에 정의됨) Optional (only applies if you use Audience Lists in Google Ads) 잠재고객 목록 또는 사용자 정보가 포함된 Google Ads 사용자 목록 ID입니다. 잠재고객 목록은 입찰가 조정 설정의 기준으로 사용됩니다. 사용자가 여러 잠재고객 목록에 포함되어 있는 경우 입찰가 조정이 가장 큰 잠재고객 목록이 선택됩니다. 입찰가 조정이 가장 큰 잠재고객 간의 연관성은 무작위로 결정됩니다.
VERIFICATION Optional 링크가 테스트 또는 자동 유효성 검사를 위해 Google에서 생성되었는지 확인하는 불리언입니다. Google에서 테스트 또는 자동 검증을 위해 생성한 링크는 true이고 그렇지 않은 경우에는 false입니다.

URL의 조건부 로직

방문 페이지 파일의 <URL> 요소에서 특수 지시어를 사용하여 조건부로 엔드포인트를 빌드할 수 있습니다.

조건부 로직은 다음 문을 지원합니다.

  • if_statement: true인 경우 이 조건을 따르는 값이 URL에 삽입되고, 그렇지 않으면 ELSE 지시어 다음의 값이 삽입됩니다.

  • for_statement: 제공된 값의 수를 반복하는 FOR 루프 조건을 만듭니다.

IF 및 FOR 문에는 다음이 포함됩니다.

상태 권장/선택사항 설명
IF-AD-CLICK (호텔 광고만) Optional 사용자 클릭이 광고에서 발생한 경우 true로 확인됩니다. 사용자 클릭이 무료 예약 링크에서 발생한 경우 false로 확인됩니다.
IF-CLICK-TYPE-HOTEL Optional 사용자가 호텔 등록정보를 클릭하면 true로 리졸브되고 그렇지 않으면 false로 확인됩니다.
IF-CLICK-TYPE-ROOM Optional 사용자가 객실 패키지 등록정보를 클릭하면 true로 리졸브되고 그렇지 않으면 false로 확인됩니다.
IF-CLOSE-RATE-RULE-IDS Optional 사용자가 요건을 충족하지 않아 하나 이상의 조건부 요금을 사용할 수 없는 경우 true로 리졸브되고, 그렇지 않은 경우 false로 확인됩니다. 기본적으로 특별 요금 UI 처리가 사용자에게 표시된 경우 true입니다.
IF-DEFAULT-RATE Optional 사용자가 기본 날짜가 사용된 호텔 등록정보를 클릭하면 true로 리졸브되고 그렇지 않으면 false로 확인됩니다.
IF-HOTEL-CAMPAIGN Optional 사용자 클릭이 호텔 캠페인에서 발생한 경우 true로 리졸브되고 그렇지 않으면 false로 확인됩니다. 이러한 구분은 Google Ads에 여러 캠페인 유형이 있는 파트너가 기여 분석을 할당하는 데 유용합니다.
IF-PAYMENT-ID (호텔 광고만) Recommended (if you use pay-per-stay Google Ads campaigns) 숙박 건당 지불 (PPS) 수수료 프로그램에 참여하는 호텔의 경우 true로 해결합니다. 그러지 않으면 false로 확인됩니다.
IF-PROMO-CODE Optional 사용자가 ARI 프로모션 또는 주어진 PromoCode의 요금 규칙을 기반으로 하는 요금을 클릭한 경우 true로 해결되고, 그렇지 않은 경우 false로 확인됩니다.
IF-PROMOTED (호텔 광고만) Recommended (if you use Promoted hotels) 사용자가 숙박 시설 프로모션 광고를 클릭하면 true로 리졸브되고 그렇지 않으면 false로 확인됩니다.
IF-RATE-RULE-ID Optional 사용자가 조건부 요금 을 선택한 경우 true로 리졸브되고 그렇지 않으면 false로 확인됩니다.
IF-USER-LIST-ID (Google Ads에 정의됨) Optional 사용자가 잠재고객 목록에 입찰 배율을 설정할 때 지정한 Google Ads 고객 목록 ID의 구성원인 경우 true, 그렇지 않으면 false로 확인됩니다.
IF-VERIFICATION Optional Google에서 테스트 또는 자동 검증을 위해 링크를 생성한 경우 true로 리졸브되고 그렇지 않으면 false로 확인됩니다.
ELSE Recommended (if you use any conditional IF statements) 이전 조건이 충족되지 않으면 이 조건을 따르는 값이 URL에 삽입됩니다.
END-IF Optional (required if you have any IF conditional statements) IF 문 조건부 블록을 종료합니다.
FOR-EACH-CHILD-AGE Optional (required for child occupancy pricing) 가격 피드의 각 <Child "age"> 요소에 대해 한 번씩 실행됩니다. 예를 들어 <OccupancyDetails>에 두 요소 <Child age="17">와 <Child age= "17">가 포함되어 있으면 지시어가 두 번 실행됩니다.
END-FOR-EACH Optional (required if using FOR-EACH block) FOR-EACH 문 조건부 블록을 종료합니다.

IF-AD-클릭 예

사용자가 방문 페이지로 리디렉션하기 위해 광고 또는 무료 예약 링크를 클릭했는지 확인하는 조건부 블록을 만들 수 있습니다.

다음 예에서는 방문 페이지 파일에서 이 지시어를 사용합니다.

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-AD-CLICK)&amp;adType=1(ELSE)&amp;adType=0(ENDIF)</URL>

이 예에서는 사용자가 광고를 클릭하지 않은 경우 다음 URL이 발생합니다.

https://www.partner.com?hid=123&adType=0

사용자가 광고를 클릭한 경우 다음 URL이 표시됩니다.

https://www.partner.com?hid=123&adType=1

IF-Click-TYPE-HOTEL 예

사용자가 명시적인 객실 번들 없이 호텔을 선택했는지 확인하는 조건부 블록을 구성할 수 있습니다. 거래 메시지의 <Room Bundle> 블록에 있는 <RatePlanID> 요소 값은 사용자가 선택한 암시적으로 연결된 객실 번들 가격으로 설정됩니다.

다음 예에서는 방문 페이지 파일에서 이 지시어를 사용합니다.

<URL>https://partner.com/(IF-CLICK-TYPE-HOTEL)landing(ELSE)landing_room(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

이 예에서 사용자가 객실 번들을 선택하면 결과는 다음 URL이 됩니다.

https://partner.com/landing_room?hid=123

사용자가 객실 번들을 선택하지 않았다면 다음 URL이 표시됩니다.

https://partner.com/landing?hid=123

IF-CLICK-TYPE-ROOM 예

사용자가 Room 번들을 선택했는지 확인하는 조건부 블록을 생성할 수 있습니다.

다음 예에서는 방문 페이지 파일에서 이 지시어를 사용합니다.

<URL>https://partner.com/(IF-CLICK-TYPE-ROOM)landing_room(ELSE)landing(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

이 예에서 사용자가 객실 번들을 선택하지 않은 경우 결과는 다음 URL이 됩니다.

https://partner.com/landing?hid=123

사용자가 객실 패키지를 선택한 경우 다음 URL이 표시됩니다.

https://partner.com/landing_room?hid=123

IF-DEFAULT-DATE 예

IF-DEFAULT-DATE 조건문을 사용하여 사용자가 날짜를 선택하지 않은 경우 웹사이트에서 맞춤 동작을 트리거하는 데 사용할 수 있는 날짜가 아닌 매개변수를 설정합니다.

다음 예에서는 기본 날짜가 사용되었는지 확인합니다.

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)<strong>(IF-DEFAULT-DATE)</strong>&amp;popup_datepicker=true(ELSE)&amp;popup_datepicker=false(ENDIF)</URL>

이 예에서 사용자가 날짜를 선택하지 않은 경우 결과는 기본 날짜 선택을 보여주는 다음 URL과 유사할 수 있습니다.

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=1&popup_datepicker=true

사용자가 날짜를 선택한 경우 선택한 일정에 따라 다음 URL과 결과가 비슷할 수 있습니다.

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=2&popup_datepicker=false

IF-HOTEL-CAMPAIGN 예 (호텔 광고 및 무료 예약 링크 클릭수)

사용자가 호텔 캠페인에서 발생한 광고를 클릭했는지 확인하는 조건부 블록을 만들 수 있습니다.

다음 예에서는 방문 페이지 파일에서 이 지시어를 사용합니다.

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

이 예에서 사용자가 호텔 캠페인 URL을 클릭하면 결과는 다음 URL이 됩니다.

https://www.partner.com?hotelID=123&hotel_campaign=12345678

호텔 캠페인 URL (예: 일반 검색 캠페인)에서 클릭이 발생하지 않은 경우 다음과 같은 URL이 결과로 반환됩니다.

https://www.partner.com?hotelID=123&utm_campaign=87654321

이는 호텔 캠페인 클릭의 트래픽을 다른 클릭과 구분하고 싶을 때 유용합니다.

FBL 클릭수가 있는 빈 CAMPAIGN-ID

클릭이 무료 예약 링크에서 발생한 경우 다음 URL과 같이 IF-HOTEL-CAMPAIGN는 TRUE를 반환하고 CAMPAIGN-ID 값은 공백으로 설정됩니다.

https://www.partner.com?hotelID=123&hotel_campaign=

다음 예와 같이 IF-AD-CLICK 조건문을 사용하여 캠페인 ID가 비어 있지 않도록 할 수 있습니다.

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)(IF-AD-CLICK)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)&amp;FreeBookingLink(ENDIF)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

IF-PAYMENT-ID 예 (호텔 광고만 해당)

IF-PAYMENT-ID 조건문을 사용하여 클릭이 PPS 수수료 프로그램에서 발생한 것인지 여부에 따라 URL을 변경합니다. 아래 예에서는 클릭이 PPS 수수료 프로그램에서 발생했는지 확인하고 결과에 따라 booking_source 매개변수에 값을 할당합니다.

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)&amp;booking_source=(IF-PAYMENT-ID)(PAYMENT-ID)(ELSE)cpc(ENDIF)</URL>

호텔이 수수료 프로그램에 참여하는 경우 결과는 다음 URL 중 하나가 됩니다.

  • Google에 IATA 번호가 할당되지 않은 경우:
    https://partner.com?hid=123&amp;booking_source=commissions
  • IATA 번호가 Google에 할당된 경우:
    https://partner.com?hid=123&amp;booking_source=01234567

그렇지 않은 경우 다음 URL이 표시됩니다.

https://partner.com?hid=123&booking_source=cpc

IF-PROMOTED 예 (호텔 광고만 해당)

사용자가 숙박 시설 프로모션 광고를 클릭했는지 확인하는 조건부 블록을 생성할 수 있습니다.

다음 예에서는 방문 페이지 파일에서 이 지시어를 사용합니다.

<URL>https://partner.com/(IF-PROMOTED)1(ELSE)0(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

이 예에서 사용자가 숙박 시설 프로모션 광고를 선택하면 결과는 다음 URL이 됩니다.

https://partner.com/1?hid=123

사용자가 숙박 시설 프로모션 광고를 선택하지 않은 경우 다음 URL이 표시됩니다.

https://partner.com/0?hid=123

IF-RATE-RULE-ID 예

사용자가 조건부 요금을 선택했는지 확인하는 조건부 블록을 구성할 수 있습니다. 이 경우 트랜잭션 메시지의 <Rate> 블록에 있는 <RateRuleID> 요소의 값이 사용됩니다.

다음 예에서는 방문 페이지 파일에서 이 지시어를 사용합니다.

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-RATE-RULE-ID)&amp;customerType=42(ELSE)(ENDIF)</URL>

이 예에서 사용자가 조건부 요금을 선택하지 않은 경우 결과는 다음 URL이 됩니다.

https://www.partner.com?hid=123

사용자가 조건부 요금을 선택한 경우 결과는 다음 URL입니다.

https://www.partner.com?hid=123&customerType=42

IF-USER-LIST-ID 예 (Google Ads에서 정의됨)

Google Ads 호텔 캠페인에서 잠재고객 목록에 입찰 배율을 설정하면 USER-LIST-ID와 함께 IF-USER-LIST-ID를 사용하여 특정 Google Ads 잠재고객 목록에 속한 고객의 웹사이트 매개변수를 설정할 수 있습니다. 이렇게 하면 추적을 사용하거나 잠재고객 목록의 구성원을 위해 웹사이트를 맞춤설정할 수 있습니다.

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-USER-LIST-ID)&amp;audience_list=(USER-LIST-ID)(ELSE)(ENDIF)</URL>

이 예에서 사용자가 잠재고객 목록의 구성원이 아닌 경우 결과는 다음 URL입니다.

https://www.partner.com?hid=123

사용자가 잠재고객 목록 12345678의 구성원인 경우 결과는 다음 URL입니다.

https://www.partner.com?hid=123&audience_list=12345678

IF-VERIFICATION 예

Google이 테스트 또는 자동 검증을 위해 URL을 생성했는지 확인해야 한다면 IF-VERIFICATION를 사용하면 됩니다.

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-VERIFICATION)&amp;isgoogle=true(ENDIF)</URL>

이 예에서 Google이 테스트 또는 유효성 검사를 위해 URL을 생성하지 않았다면 다음 URL이 생성됩니다.

https://www.partner.com?hid=123

Google에서 테스트 또는 유효성 검사를 위해 URL을 생성한 경우 결과는 다음 URL입니다.

https://www.partner.com?hid=123&isgoogle=true

FOR-EACH-CHILD-AGE 예

호텔 요금 피드에 지정된 대로 각 어린이 숙박 인원의 최대 연령을 채우는 조건부 블록을 구성할 수 있습니다.

다음 예에서는 방문 페이지 파일에서 이 지시어를 사용합니다.

<URL>https://partner.com?adults=(NUM-ADULTS)&amp;children=(NUM-CHILDREN)(FOR-EACH-CHILD-AGE)&amp;age=(CHILD-INDEX)_(CHILD-AGE)(END-FOR-EACH)&amp;hid=(PARTNER-HOTEL-ID)&amp;</URL>

이 예에서 숙박 일정에 성인 2명과 어린이 2명이 각각 0세와 17세인 경우 결과는 다음 URL입니다.

https://www.partner.com?adults=2&children=2&age=0_0age=1_17&hid=123

숙박 일정에 성인 2명과 어린이가 0명인 경우 결과는 다음 URL입니다.

https://www.partner.com?adults=2&children=0&hid=123

URL 작성 시 일반적인 규칙

모든 변수는 선택사항입니다. 방문 페이지 URL에는 변수를 삽입할 필요가 없습니다. 그러나 변수를 사용하여 여행 일정과 사용자 정보를 전달하면 일반적으로 사용자 환경이 개선되고 Google 정책을 준수하는 데 도움이 됩니다.

방문 페이지 파일에서 생성된 URL을 정의할 때는 다음과 같은 일반 규칙이 적용됩니다.

  • 모든 변수는 여는 괄호와 닫는 괄호로 묶입니다.

  • 쿼리 문자열 매개변수는 URL에서 물음표 ('?') 다음에만 전달할 수 있습니다.

  • 쿼리 문자열 매개변수는 최종 출력에서 앰퍼샌드 ('&')로 구분해야 합니다. 앰퍼샌드는 XML의 특수문자이며 방문 페이지 파일 형식은 XML입니다. 따라서 인코딩된 엔터티 '&amp;를 대신 사용해야 합니다. 최종 출력은 실제 '&' 문자를 렌더링합니다. 예를 들면 다음과 같습니다.

    <!-- Do this: -->
<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&nights=(LENGTH)</URL>

<!-- Do NOT do this: -->
<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&nights=(LENGTH)</URL>

    또한 방문 페이지 URL에 포함할 수 있는 특수문자를 URL 인코딩해야 합니다. 예를 들면 다음과 같습니다.

    • 공백 (' '): <URL> 요소에서 공백 문자를 '%20;'으로 바꿉니다.
    • 슬래시 ('/'): <URL> 요소에서 슬래시를 '%2F;'로 바꿉니다.

    알파벳이 아닌 모든 문자를 URL 인코딩해야 하는 것은 아닙니다. 예를 들어 하이픈 ('-')은 URL로 인코딩하지 않아도 됩니다. URL 인코딩이 필요한 일반 문자 목록은 URL 인코딩 표를 참조하세요.

  • 단일 매개변수의 값은 여러 변수로 구성할 수 있습니다. 다음 예에서는 CHECKINDAY, CHECKINMONTH, CHECKINYEAR 변수에서 단일 매개변수 checkinDate를 생성합니다.

    <URL>https://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>

    이 예에서는 다음과 같은 URL이 생성됩니다.

    https://www.partnerdomain.com?checkinDate=7/23/1971

  • 쿼리 문자열 매개변수의 이름에 ID를 사용할 수 있습니다. 서버는 이러한 값을 처리합니다. 그러나 전달하는 값은 사용 가능한 변수 목록으로 제한됩니다.

  • 사용 가능한 변수 목록 외에도 최대 5개의 맞춤 변수를 사용할 수 있습니다.