변수 및 조건

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

개요

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

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

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

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

검색 결과 페이지에 대해 방문 페이지 링크가 구성되면 는 변수를 실제 값으로 대체하여 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인 경우 이 삽입되지 않으면 ELSE 지시어가 삽입되었습니다.

• for_statement: 반복되는 FOR 루프 조건을 만듭니다. 계산될 수 있습니다

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

IF-AD-클릭 예

사용자가 광고를 클릭했는지 아니면 방문 페이지로 리디렉션할 수 있는 무료 예약 링크입니다.

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

<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> 요소의 값은 거래 메시지의 <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 수수료 프로그램의 결과인지 여부 아래 예 클릭이 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 계정에 속한 고객에 대한 웹사이트 매개변수 잠재고객 목록을 찾습니다. 추적용으로 사용하거나 캠페인 실적을 맞춤설정하실 수 있습니다 웹사이트도 활용할 수 있습니다.

<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명과 어린이 2명(만 0~17세)이 있는 경우 각각 결과는 다음과 같은 URL입니다.

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

숙박 일정에 성인 2명과 어린이가 없는 경우 결과는 다음과 같습니다. 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)&nights=(LENGTH)</URL>
  
  <!-- Do NOT do this: -->
  <URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&nights=(LENGTH)</URL>
  

  또한 방문 페이지 URL입니다. 예를 들면 다음과 같습니다.

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

  알파벳이 아닌 모든 문자를 URL 인코딩해야 하는 것은 아닙니다. 예를 들어 하이픈('-')은 URL로 인코딩하지 않아도 됩니다. Cloud Shell의 자세한 내용은 URL 인코딩 테이블.

• 단일 매개변수의 값은 여러 변수로부터 생성될 수 있습니다. 이 다음 예는checkinDate CHECKINDAY,CHECKINMONTH, CHECKINYEAR 변수:

  <URL>https://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>
  

  이 예에서는 다음과 같은 URL이 생성됩니다.

  https://www.partnerdomain.com?checkinDate=7/23/1971
  

• 쿼리 문자열 매개변수의 이름으로 모든 ID를 사용할 수 있습니다. 내 서버 이 값을 처리합니다 하지만 전달하는 값은 사용 가능한 변수 목록을 참조하세요.

• 사용 가능한 목록 외에 최대 5개의 맞춤 변수를 사용할 수 있습니다. 변수로 사용할 수 있습니다.