변수 및 조건

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

개요

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

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

다음 예는 실제 호텔 ID 및 숙박 일정:

예 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인 경우 이 삽입되지 않으면 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 예

사용자가 명시적인 객실 패키지 없이 호텔을 선택했는지 확인하는 조건부 블록을 생성할 수 있습니다. 다음에서 <RatePlanID> 요소의 값은 거래 메시지의 <Room Bundle> 블록이 암시적으로 사용자가 선택한 관련 객실 패키지 가격입니다.

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

<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 (예: 일반 검색 캠페인)에서 발생하지 않은 경우 결과는 다음과 같습니다.

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

• 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>

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

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

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

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

IF-RATE-RULE-ID 예

사용자가 이 경우 <RateRuleID>의 값 요소가 사용됩니다.<Rate>

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

<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을 생성했는지 아니면 자동으로 URL을 생성했는지 확인해야 하는 경우 IF-VERIFICATION를 사용하면 됩니다.

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

이 예에서 Google이 테스트 또는 검증을 위한 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입니다. 예를 들면 다음과 같습니다.

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

  영문자가 아닌 문자 중 일부는 URL 인코딩되지 않아도 됩니다. 예를 들어 하이픈('-')은 URL 인코딩할 필요가 없습니다. Cloud Shell의 자세한 내용은 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개의 맞춤 변수를 사용할 수 있습니다. 변수로 사용할 수 있습니다.