변수 및 조건

호텔 광고 및 무료 예약 링크에는 사용자가 객실을 예약할 수 있는 방문 페이지 링크가 포함됩니다. 사용자 및 여행 일정에 대한 모든 추가 정보를 포함하도록 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에 동적 정보가 포함되도록 합니다. 예를 들어 사용자가 2023년 5월 23일부터 6박 동안 호텔 42번의 객실을 예약하는 경우 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

사용자가 Room Bundle을 선택하지 않은 경우 다음 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

사용자가 Room Bundle을 선택한 경우 결과는 다음 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-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개의 맞춤 변수를 사용할 수 있습니다.