호텔 광고 및 무료 예약 링크에는 사용자가 객실을 예약할 수 있는 방문 페이지 링크가 포함됩니다. 사용자 및 여정에 대한 모든 추가 정보를 포함하도록 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)
&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)
&checkinYear=(CHECKINYEAR)&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> 요소에 정의된 두 자리
월입니다. 예를 들면 다음과 같습니다. 05 |
CHECKINYEAR | Recommended | 호텔 가격 피드의 <Checkin> 요소에 정의된 4자리 연도입니다. 예를 들면 다음과 같습니다. 2023 |
CHECKOUTDAY | Recommended | 호텔 가격 피드의 <Nights> 및 <Checkin> 요소에서 계산된 두 자리 날짜입니다. 예를 들면 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 | 사용자가 일반 호텔 요금 등록정보를 클릭했는지 아니면 객실 패키지 등록정보를 클릭했는지를 나타냅니다. 가능한 값은 다음과 같습니다.
|
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 | 사용자가 기본 날짜를 선택했는지 또는 검색에 제공된 특정 날짜를 선택했는지를 나타냅니다. 가능한 값은 다음과 같습니다.
|
GOOGLE-SITE | Optional | 사용자가 호텔 가격 데이터를 조회한 Google 속성입니다.
가능한 값은 다음과 같습니다.
|
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 프로모션을 사용하는 경우 이 변수의 값은 적용된
요금 규칙을 사용하는 경우 해당하는 요금 규칙이 적용되면 이 변수의 값이 |
RATE-PLAN-ID | Recommended (only applies if you use RoomBundles) | 가격 피드의 <RoomBundle> 블록에 있는 <RatePlanID> 요소에서 정의한 ID입니다. <RatePlanID> 는 객실 및 패키지 데이터 조합의 고유 식별자를 나타냅니다. 자세한 내용은
Room 번들을 참고하세요. |
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 의 값은 다음 중 하나일 수 있습니다.
|
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)&adType=1(ELSE)&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)&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)&checkinYear=(CHECKINYEAR)&nights=(LENGTH)<strong>(IF-DEFAULT-DATE)</strong>&popup_datepicker=true(ELSE)&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)&hotel_campaign=(CAMPAIGN-ID)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>
이 예에서 사용자가 호텔 캠페인 URL을 클릭하면 결과는 다음과 같습니다.
https://www.partner.com?hotelID=123&hotel_campaign=12345678
클릭이 호텔 캠페인 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)&hotel_campaign=(CAMPAIGN-ID)(ELSE)&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)&booking_source=(IF-PAYMENT-ID)(PAYMENT-ID)(ELSE)cpc(ENDIF)</URL>
호텔이 수수료 프로그램에 속한 경우 결과는 다음 URL 중 하나입니다.
- Google에 할당된 IATA 번호가 없는 경우:
https://partner.com?hid=123&booking_source=commissions
- IATA 번호가 Google에 할당된 경우:
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>
이 예에서 사용자가 숙박 시설 프로모션 광고를 선택하면 결과는 다음과 같습니다.
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)&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)&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)&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)&children=(NUM-CHILDREN)(FOR-EACH-CHILD-AGE)&age=(CHILD-INDEX)_(CHILD-AGE)(END-FOR-EACH)&hid=(PARTNER-HOTEL-ID)&</URL>
이 예에서 숙박 일정에 성인 2명과 어린이 2명이 각각 0세와 17세인 경우 결과는 다음과 같습니다.
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을 정의할 때는 다음과 같은 일반 규칙이 적용됩니다.
모든 변수는 여는 괄호와 닫는 괄호로 묶습니다.
쿼리 문자열 매개변수는 URL에서 물음표 ('?') 다음에만 전달할 수 있습니다.
쿼리 문자열 매개변수는 최종 출력에서 앰퍼샌드 ('&')로 구분해야 합니다. 앰퍼샌드는 XML의 특수문자이고 방문 페이지 파일 형식은 XML이기 때문입니다. 따라서 인코딩된 항목 '&'를 대신 사용해야 합니다. 최종 출력은 실제 '&' 문자를 렌더링합니다. 예를 들면 다음과 같습니다.
<!-- 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개의 맞춤 변수를 사용할 수 있습니다.