변수 및 조건

호텔 광고 및 무료 예약 링크에는 사용자가 객실을 예약할 수 있는 방문 페이지 링크가 포함됩니다. 사용자 및 여정에 대한 모든 추가 정보를 포함하도록 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일부터 호텔 #42에 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> 요소에 정의된 2자리 월입니다. 예를 들면 05입니다.
CHECKINYEAR Recommended 호텔 요금 피드의 <Checkin> 요소에 정의된 4자리 연도입니다. 예를 들면 2023입니다.
CHECKOUTDAY Recommended 호텔 가격 피드의 <Nights> 및 <Checkin> 요소에서 계산된 2자리 날짜입니다. 예를 들면 26입니다.
CHECKOUTMONTH Recommended 호텔 가격 피드의 <Nights> 및 <Checkin> 요소에서 계산된 두 자리 월입니다. 예: 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를 쉼표로 구분한 목록입니다. 해당하는 UI 처리가 사용자에게 표시될 때 특별 요금의 요금 규칙 ID가 항상 여기에 채워집니다.
CUSTOM[1-5] Optional <Result> 요소에 정의된 맞춤 입력란의 값으로, 맞춤 입력란당 200자(영문 기준)로 제한됩니다. 자세한 내용은 트랜잭션 메시지 개요를 참조하세요. ARI를 사용할 때는 맞춤 필드를 사용할 수 없습니다.
DATE-TYPE Optional 사용자가 기본 날짜를 선택했는지 또는 검색에 제공된 특정 날짜를 선택했는지를 나타냅니다. 가능한 값은 다음과 같습니다.
  • default: 사용자가 기본 날짜가 사용된 호텔 광고 또는 무료 예약 링크를 클릭했습니다.
  • selected: 사용자가 날짜가 설정된 호텔 광고 또는 무료 예약 링크를 클릭했습니다.
GOOGLE-ADS-CLICK-SOURCE Optional Google Ads가 클릭의 소스임을 나타냅니다. 가능한 값은 다음과 같습니다.
  • bl: 유료 예약 링크
  • tpa: 여행 프로모션 광고
  • tfsa: 검색 광고의 여행 피드
  • pm: 실적 최대화 캠페인 또는 여행 목표 달성을 위한 실적 최대화 캠페인

    • 참고: 클릭이 Google Ads가 아닌 Google 검색에서 발생한 경우 이 매개변수는 비어 있습니다.
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> 요소의 값입니다. 객실 번들의 경우 패키지 ID는 트랜잭션 메시지의 <RoomBundle> 또는 <PackageData> 블록 내에 있는 <PackageID> 요소의 값입니다.
PARTNER-CURRENCY Optional 호텔 가격 피드에서 <Baserate> 요소의 currency 속성으로 정의된 세 글자로 된 통화 코드입니다. 예를 들면 USD 또는 CAD 입니다.
PARTNER-HOTEL-ID Recommended 호텔 목록 피드의 <id> 요소로 정의된 호텔의 고유 식별자입니다.
PARTNER-ROOM-ID Recommended (applies if you use Room Bundles) 호텔 가격 피드의 객실 고유 식별자입니다. 표준 객실의 경우 객실 ID는 <Result> 블록 내 <RoomID> 요소의 값입니다. 객실 번들의 경우 객실 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 사용자 위치를 나타내는 두 글자 국가 코드입니다. 이 정보는 사용자의 클라이언트 설정에서 추출됩니다. 예를 들면 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 사용자가 Room Bundle의 등록정보를 클릭한 경우 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>

이 예에서 사용자가 광고를 클릭하지 않은 경우 결과는 다음과 같습니다.

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 Bundle을 선택했는지 확인하는 조건부 블록을 구성할 수 있습니다.

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

<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을 클릭하면 결과는 다음과 같습니다.

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&amp;booking_source=commissions
  • Google에 IATA 번호가 할당된 경우:
    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>

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

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 잠재고객 목록에 속한 고객의 웹사이트에 매개변수를 설정할 수 있습니다. 추적 목적으로 또는 잠재고객 목록의 구성원에게 맞게 웹사이트를 맞춤설정하기 위해 ID를 수집할 수 있습니다.

<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명이 있는 경우 결과는 다음과 같습니다.

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

URL을 빌드할 때의 일반적인 규칙

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

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

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

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

    <!-- 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개의 맞춤 변수를 사용할 수 있습니다.