변수 및 조건

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

개요

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

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

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

예 1

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

예 2

<URL>https://www.partnerdomain.com/hotel/(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을 구성하는 데 사용할 수 있는 변수를 설명합니다.

URL의 조건부 로직

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

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

• if_statement: true이면 이 조건 다음에 오는 값이 URL에 삽입되고, 그렇지 않으면 ELSE 디렉티브 다음에 오는 값이 삽입됩니다.

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

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

IF-AD-CLICK 예시

사용자가 광고 또는 무료 예약 링크를 클릭하여 방문 페이지로 리디렉션되었는지 확인하는 조건부 블록을 생성할 수 있습니다.

다음은 방문 페이지 파일에 이 지시어를 사용하는 예입니다.

<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 예시

사용자가 객실 패키지를 선택했는지 확인하는 조건부 블록을 생성할 수 있습니다.

다음은 방문 페이지 파일에 이 지시어를 사용하는 예입니다.

<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

무료 예약 링크에서 클릭한 경우 IF-HOTEL-CAMPAIGN는 TRUE를 반환하고 CAMPAIGN-ID 값은 다음 URL과 같이 비워집니다.

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&booking_source=commissions

• Google에 IATA 번호가 할당된 경우:

  https://partner.com?hid=123&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의 호텔 캠페인에서 잠재고객 목록에 대한 입찰가 배수를 설정하는 경우 IF-USER-LIST-ID를 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명과 각각 연령이 0세와 17세인 어린이 2명이 있는 경우 다음 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을 정의할 때는 다음과 같은 일반 규칙이 적용됩니다.

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

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

  <!-- Do this: -->
  <URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&amp;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개의 맞춤 변수를 사용할 수 있습니다.