Reklamy hoteli i bezpłatne linki do rezerwacji zawierają linki do stron docelowych, na których użytkownicy mogą rezerwować pokoje. Możesz określić, jak Google ma tworzyć link, aby zawierał wszystkie dodatkowe informacje o użytkowniku i jego planie podróży. Możesz na przykład uwzględnić w adresie URL takie informacje jak identyfikator hotelu, język, kody walut i daty zameldowania.
Przegląd
Adres URL strony docelowej określasz w pliku stron docelowych. Gdy wyświetla się reklama lub bezpłatny link do rezerwacji, dynamiczne informacje w adresie URL są zastępowane rzeczywistymi wartościami. Aby dodać do adresów URL stron docelowych wartości dynamiczne, użyj tej składni:
<URL>https://partner_url?param_id=(variable_name)</URL>
Poniższy przykład pokazuje adres URL, który zamiast rzeczywistego identyfikatora hotelu i planu podróży używa nazw zmiennych Google:
Przykład 1
<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)
&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)
&checkinYear=(CHECKINYEAR)&nights=(LENGTH)
</URL>
Przykład 2
<URL>https://www.partnerdomain.com/hotel/(PARTNER-HOTEL-ID)
&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)
&checkinYear=(CHECKINYEAR)&nights=(LENGTH)
</URL>
Gdy link do strony docelowej jest tworzony na potrzeby strony wyników wyszukiwania, Google zastępuje zmienne rzeczywistymi wartościami, aby mieć pewność, że URL zawiera informacje dynamiczne. Jeśli np. użytkownik zarezerwuje pokój na 6 nocy od 23 maja 2023 r. w hotelu nr 42, Google wyrenderuje poprzedni link w ten sposób:
https://www.partnerdomain.com?hotelID=42&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=6
Wartości, które Google przypisuje do zmiennych w ciągu zapytania, zależą od odpowiednich danych w pliku danych o cenach hoteli, pliku danych z listą hoteli i ustawieniach użytkownika.
Na przykład wartość zmiennej LENGTH jest przypisywana do elementu <Nights> z powiązanego pliku danych o cenach planu podróży. Podobnie wartość zmiennej
PARTNER-HOTEL-ID jest zdefiniowana w elemencie <id> z pliku danych Lista hoteli, który pasuje do kryteriów wyszukiwania użytkownika.
Niektóre zmienne są podzbiorami elementów pliku danych o cenach. Na przykład zmienne CHECKINDAY, CHECKINMONTH i CHECKINYEAR są wyodrębniane z pojedynczego elementu <Checkin> w pliku danych o cenach. Pozostałe zmienne są obliczane na podstawie ustawień regionalnych użytkownika i innych ustawień klienta.
Więcej informacji o źródłach wartości zmiennych znajdziesz w artykułach Omówienie cen i Lista hoteli.
Zmienne adresu URL
W tabeli poniżej znajdziesz opis dostępnych zmiennych, których możesz używać do tworzenia adresu URL strony docelowej:
| Zmienna | Zalecane/opcjonalne | Opis |
|---|---|---|
| ADVANCE-BOOKING-WINDOW | Optional | Liczba dni rezerwacji z wyprzedzeniem przed datą zameldowania w strefie czasowej hotelu w momencie rezerwacji. Na przykład: 36. |
| ALTERNATE-HOTEL-ID | Recommended (if you have separate IDs to identify properties versus booking engines) | Alternatywny identyfikator miejsca zakwaterowania. Ta nazwa atrybutu jest określona w pliku danych z listą hoteli. Oddzielne identyfikatory są przydatne, jeśli potrzebujesz jednego identyfikatora miejsca zakwaterowania do pliku danych i innego identyfikatora miejsca zakwaterowania do systemu rezerwacji online. |
| CAMPAIGN-ID | Recommended | Identyfikator kampanii Google Ads, którą chcesz powiązać z adresem URL. Jeśli kliknięcie nie jest powiązane z kampanią Google Ads, to pole jest puste. |
| CHECKINDAY | Recommended | Dwucyfrowy dzień zdefiniowany w elemencie <Checkin> w pliku danych o cenach hoteli. Na przykład: 20. |
| CHECKINDAY-OF-WEEK | Optional | Dzień tygodnia – od Monday do Sunday, w którym następuje zameldowanie, w strefie czasowej hotelu. Na przykład: Tuesday. |
| CHECKINMONTH | Recommended | Dwucyfrowy miesiąc zdefiniowany w elemencie <Checkin> pliku danych z cenami hoteli. Na przykład: 05. |
| CHECKINYEAR | Recommended | Czterocyfrowy rok zdefiniowany w elemencie <Checkin>
w pliku danych o cenach hoteli. Na przykład: 2023. |
| CHECKOUTDAY | Recommended | Dwucyfrowy dzień obliczony na podstawie elementów <Nights> i <Checkin> w pliku danych o cenach hoteli. Na przykład: 26. |
| CHECKOUTMONTH | Recommended | Dwucyfrowy miesiąc obliczony na podstawie elementów <Nights> i <Checkin> w pliku danych o cenach hoteli. Na przykład: 05. |
| CHECKOUTYEAR | Recommended | 4-cyfrowy rok obliczony na podstawie elementów <Nights> i <Checkin> w pliku danych o cenach hoteli. Na przykład: 2023. |
| CHILD-AGE | Recommended (must be provided for child occupancy pricing) | Maksymalny wiek każdego dziecka określony w elementach
<Child "age"> pliku danych o cenach.
Tej zmiennej należy używać w połączeniu z blokiem warunkowym FOR-EACH-CHILD-AGE. |
| CHILD-INDEX | Optional | Zmienna pętli indeksowana od 0, która reprezentuje licznik dla każdego dziecka i jego wieku określonego w planie podróży. Chociaż nie jest to obowiązkowe, tej zmiennej można używać tylko w połączeniu z FOR-EACH-CHILD-AGE blokiem warunkowym.
|
| CLICK-TYPE | Optional | Wskazuje, czy użytkownik kliknął informację o standardowej cenie hotelu czy o pakiecie z pokojem. Możliwe wartości:
|
| CLOSE-RATE-RULE-IDS | Optional (only applies if you are using conditional or private rates) | Lista identyfikatorów reguł cenowych dla cen, które były niedostępne, ale mogłyby być dostępne, gdyby użytkownik wykonał niewielkie działanie. Pamiętaj, że identyfikatory reguł stawek dla stawek prywatnych są zawsze wypełniane w tym miejscu, gdy użytkownikowi wyświetla się odpowiedni element interfejsu. |
| Optional | Wycofane: wartości pól niestandardowych zdefiniowanych w elemencie <Result>, przy czym każde pole niestandardowe może zawierać maksymalnie 200 znaków. Więcej informacji znajdziesz w artykule na temat wiadomości transakcyjnych. Pola niestandardowe są niedostępne, gdy używasz ARI.
Uwaga: zmienne |
|
| DATE-TYPE | Optional | Wskazuje, czy użytkownik wybrał domyślną datę, czy konkretną datę podaną w wyszukiwaniu. Możliwe wartości:
|
| GOOGLE-ADS-CLICK-SOURCE | Optional | Wskazuje, że źródłem kliknięcia była usługa Google Ads. Możliwe wartości:
Uwaga: jeśli kliknięcie pochodzi z wyszukiwarki Google, a nie z Google Ads, ten parametr jest pusty. |
| GOOGLE-SITE | Optional | Usługa Google, w której użytkownik wyświetlił dane o cenach Twojego hotelu.
Możliwe wartości:
|
| LENGTH | Recommended | Długość pobytu w liczbie nocy określona przez element <Nights> w pliku danych o cenach hoteli. Na przykład: 3. |
| MODIFICATION-IDS | Optional | Jeśli używasz ARI
Modyfikacje cen, wartością tej zmiennej jest atrybut |
| NUM-ADULTS | Recommended (must be used with the
NUM-CHILDREN or FOR-EACH-CHILD-AGE condition)
|
Liczba dorosłych pasażerów określona przez użytkownika w przypadku trasy.
Tej zmiennej należy używać w połączeniu z elementami NUM-CHILDREN, FOR-EACH-CHILD-AGE lub z obydwoma. |
| NUM-CHILDREN | Recommended | Liczba dzieci (w wieku 0–17 lat) określona przez użytkownika w planie podróży. NUM-CHILDREN lub FOR-EACH-CHILD-AGE, a w niektórych przypadkach obie te wartości, są wymagane, aby można było wziąć udział w planach podróży z dziećmi. |
| NUM-GUESTS | Recommended (if you don't send child occupancy pricing) | Łączna liczba osób, zarówno dorosłych, jak i dzieci, określona przez użytkownika w planie podróży. Ta wartość jest sumą wartości NUM-ADULTS i NUM-CHILDREN. Aby zmaksymalizować udział, zdecydowanie zalecamy korzystanie z zasad NUM-ADULTS i NUM-CHILDREN. |
| PACKAGE-ID | Recommended (applies if you use Room Bundles) | Unikalny identyfikator pakietu w pliku danych o cenach hoteli. W przypadku pakietu standardowego identyfikator pakietu to wartość elementu <PackageID> w bloku <Result>. W przypadku pakietu pokoi identyfikator pakietu to wartość elementu
<PackageID> w blokach
<RoomBundle> lub <PackageData> wiadomości o transakcji. |
| PARTNER-CURRENCY | Optional | Trzyliterowy kod waluty zdefiniowany przez atrybut currency elementu <Baserate> w pliku danych o cenach hoteli. Na przykład USD lub CAD
. |
| PARTNER-HOTEL-ID | Recommended | Unikalny identyfikator hotelu zdefiniowany przez element <id> w pliku danych z listą hoteli. |
| PARTNER-ROOM-ID | Recommended (applies if you use Room Bundles) | Unikalny identyfikator pokoju w pliku danych o cenach hoteli. W przypadku pokoju standardowego identyfikator pokoju to wartość elementu <RoomID> w bloku <Result>. W przypadku pakietu pokoju identyfikator pokoju to wartość przypisana do elementu <RoomID> w blokach <RoomBundle> lub <RoomData> w wiadomości o transakcji. |
| Optional (only applies to Ads) | Wycofany: zawiera wstępnie zdefiniowany ciąg znakówcommission lub przypisany przez Google numer IATA (np. „01234567”), jeśli korzystasz z usług agencji pośredniczącej. Aby zmienić formatowanie numeru IATA lub wstępnie zdefiniowanego ciągu znaków, skontaktuj się z technicznym menedżerem konta. |
|
| PRICE-DISPLAYED-TAX | (Optional) | Kwota podatku wyświetlona użytkownikowi w jego walucie lokalnej.
Wartość PRICE-DISPLAYED-TAX to wartość elementu <Tax> w pliku danych o cenach hoteli. np. „3.14”. |
| PRICE-DISPLAYED-TOTAL | (Optional) | Całkowity koszt pokoju wyświetlony użytkownikowi w jego walucie lokalnej. Wartość PRICE-DISPLAYED-TOTAL to suma elementów <Baserate>, <Tax> i <OtherFees> z pliku danych z cenami hoteli.
np. „152.13”. |
| PROMO-CODE | (Optional) | Jeśli używasz promocji ARI, wartość tej zmiennej jest przypisywana do atrybutu Jeśli używasz
reguł stawek, wartość tej zmiennej jest przypisywana do elementu |
| RATE-PLAN-ID | Recommended (only applies if you use RoomBundles) | Identyfikator zdefiniowany przez element <RatePlanID> w bloku <RoomBundle> pliku danych o cenach. Symbol<RatePlanID> oznacza unikalny identyfikator kombinacji danych o pokoju i pakiecie. Więcej informacji znajdziesz w artykule
Pakiety pokoi. |
| RATE-RULE-ID | Recommended (only applies if you use conditional rates or private rates) | Identyfikator zdefiniowany przez atrybut rate_rule_id w bloku <Rate> pliku danych o cenach. Więcej informacji znajdziesz w sekcji
Ceny warunkowe.
Uwaga: wyświetlane są tylko ceny warunkowe lub prywatne, które nie są ukryte. |
| USER-COUNTRY | Recommended | Dwuliterowy kod kraju wskazujący lokalizację użytkownika. Te informacje są wyodrębniane z ustawień klienta użytkownika. Na przykład US lub FR. |
| USER-CURRENCY | Recommended | Trzyliterowy kod waluty, który wskazuje walutę lokalną użytkownika. Wartość zmiennej USER-CURRENCY jest wywnioskowana na podstawie ustawień klienta użytkownika. Na przykład USD lub CAD . |
| USER-DEVICE | Recommended | Typ urządzenia użytkownika. Wartość USER-DEVICE może być jedną z tych wartości:
Wartość zmiennej |
| USER-LANGUAGE | Recommended | Dwuliterowy kod języka w standardzie ISO 639-1 określający język wyświetlania reklamy lub bezpłatnego linku do rezerwacji. Wartość zmiennej USER-LANGUAGE jest wywnioskowana na podstawie ustawień klienta użytkownika. Na przykład en lub fr. |
| USER-LIST-ID (zdefiniowane w Google Ads) | Optional (only applies if you use Audience Lists in Google Ads) | Identyfikator listy użytkowników Google Ads, która zawiera listę odbiorców lub informacje o użytkownikach. Listy odbiorców służą jako podstawa ustawiania dostosowań stawek. Jeśli użytkownik znajduje się na kilku listach odbiorców, wybierana jest lista odbiorców z największym dostosowaniem stawki. W przypadku grup odbiorców z największym dostosowaniem stawek o kolejności decyduje los. |
| VERIFICATION | Optional | Wartość logiczna, która sprawdza, czy link został wygenerowany przez Google na potrzeby testowania lub automatycznej weryfikacji. Wartość to true, jeśli link został wygenerowany przez Google na potrzeby testowania lub automatycznej weryfikacji, w przeciwnym razie jest to false.
|
Logika warunkowa w adresach URL
W elemencie <URL> pliku stron docelowych możesz używać specjalnych dyrektyw, aby warunkowo tworzyć punkty końcowe.
Logika warunkowa obsługuje te stwierdzenia:
if_statement: jeśli
true, do adresu URL są wstawiane wartości spełniające ten warunek. W przeciwnym razie wstawiane są wartości spełniające dyrektywęELSE.for_statement: Tworzy warunek pętli FOR, która wykonuje iterację określoną liczbę razy.
Instrukcje IF i FOR obejmują te elementy:
| Warunek | Zalecane/opcjonalne | Opis |
|---|---|---|
| IF-AD-CLICK (tylko reklamy hoteli) | Optional | Przyjmuje wartość true, jeśli kliknięcie użytkownika pochodzi z reklamy.
Przyjmuje wartość false, jeśli kliknięcie użytkownika pochodzi z bezpłatnego linku do rezerwacji. |
| IF-CLICK-TYPE-HOTEL | Optional | Ma wartość true, jeśli użytkownik kliknął wizytówkę hotelu, w przeciwnym razie ma wartość false. |
| IF-CLICK-TYPE-ROOM | Optional | Wartość true, jeśli użytkownik kliknął wizytówkę
zestawu pokoi, w przeciwnym razie false. |
| IF-CLOSE-RATE-RULE-IDS | Optional | Przyjmuje wartość true, jeśli co najmniej jedna stawka warunkowa była niedostępna, ponieważ użytkownik nie spełniał wymagań. W przeciwnym razie przyjmuje wartość false. Domyślnie jest to true, jeśli użytkownikowi wyświetlono interfejs ceny prywatnej
. |
| IF-DEFAULT-RATE | Optional | Przyjmuje wartość true, jeśli użytkownik kliknął reklamę hotelu, w której użyto domyślnych dat, w przeciwnym razie przyjmuje wartość false. |
| IF-HOTEL-CAMPAIGN | Optional | Przyjmuje wartość true, jeśli kliknięcie użytkownika pochodzi z kampanii reklam hoteli, w przeciwnym razie przyjmuje wartość false. To rozróżnienie jest przydatne dla partnerów, którzy w Google Ads mają kilka typów kampanii, ponieważ pozwala im przypisywać atrybucję. |
| IF-MODIFICATION-IDS | Optional | Przyjmuje wartość true, jeśli użytkownik kliknął cenę, która została zmodyfikowana przez modyfikację ceny ARI; w przeciwnym razie przyjmuje wartość false. |
| (tylko reklamy hoteli) | Recommended (if you use pay-per-stay Google Ads campaigns) | Wycofany: ma wartość true w przypadku hoteli uczestniczących w programie prowizji za pobyt, a w przeciwnym razie ma wartość false. |
| IF-PROMO-CODE | Optional | Przyjmuje wartość true, jeśli użytkownik kliknął stawkę opartą na promocji ARI lub regule ceny z danym parametrem PromoCode; w przeciwnym razie przyjmuje wartość false. |
| IF-PROMOTED (tylko reklamy hoteli) | Recommended (if you use Promoted hotels) | Przyjmuje wartość true, jeśli użytkownik kliknął reklamę typu „promowanie obiektu”, a w przeciwnym razie – false. |
| IF-RATE-RULE-ID | Optional | Przyjmuje wartość true, jeśli użytkownik wybrał stawkę warunkową
, w przeciwnym razie przyjmuje wartość false. |
| IF-USER-LIST-ID (zdefiniowane w Google Ads) | Optional | Przyjmuje wartość true, jeśli użytkownik znajduje się na liście klientów Google Ads o identyfikatorze podanym podczas ustawiania mnożników stawek za listy odbiorców, w przeciwnym razie przyjmuje wartość false. |
| IF-VERIFICATION | Optional | Jeśli link został wygenerowany przez Google na potrzeby testowania lub automatycznej weryfikacji, zwraca wartość true, w przeciwnym razie zwraca wartość false. |
| ELSE | Recommended (if you use any conditional IF statements) | Jeśli poprzedni warunek nie jest spełniony, do adresu URL są wstawiane wartości spełniające ten warunek. |
| END-IF | Optional (required if you have any IF conditional statements) | Kończy blok warunkowy instrukcji IF. |
| FOR-EACH-CHILD-AGE | Optional (required for child occupancy pricing) | Wykonuje się raz dla każdego elementu
<Child "age"> w pliku danych o cenach. Jeśli na przykład <OccupancyDetails> zawiera 2 elementy <Child age="17"> i <Child age=
"17">, dyrektywa zostanie wykonana 2 razy. |
| END-FOR-EACH | Optional (required if using FOR-EACH block) | Kończy blok warunkowy instrukcji FOR-EACH. |
Przykład warunku IF-AD-CLICK
Możesz utworzyć blok warunkowy, który sprawdzi, czy użytkownik kliknął reklamę lub bezpłatny link do rezerwacji, aby przekierować go na stronę docelową.
W tym przykładzie dyrektywa jest używana w pliku strony docelowej:
<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-AD-CLICK)&adType=1(ELSE)&adType=0(ENDIF)</URL>
W tym przykładzie, jeśli użytkownik nie kliknął reklamy, wynikiem jest ten adres URL:
https://www.partner.com?hid=123&adType=0
Jeśli użytkownik kliknie reklamę, wynikiem będzie ten adres URL:
https://www.partner.com?hid=123&adType=1
Przykład dotyczący warunku IF-CLICK-TYPE-HOTEL
Możesz utworzyć blok warunkowy, który sprawdza, czy użytkownik wybrał hotel bez wyraźnego pakietu pokoju. Wartość elementu <RatePlanID> w bloku <Room Bundle> wiadomości o transakcji zostanie ustawiona na cenę pakietu pokoju, która jest niejawnie powiązana z wybraną przez użytkownika.
W tym przykładzie dyrektywa jest używana w pliku stron docelowych:
<URL>https://partner.com/(IF-CLICK-TYPE-HOTEL)landing(ELSE)landing_room(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>
W tym przykładzie, jeśli użytkownik wybierze pakiet z pokojem, wynikiem będzie ten adres URL:
https://partner.com/landing_room?hid=123
Jeśli użytkownik nie wybrał pakietu Room Bundle, wynikiem jest ten adres URL:
https://partner.com/landing?hid=123
Przykład warunku IF-CLICK-TYPE-ROOM
Możesz utworzyć blok warunkowy, który sprawdza, czy użytkownik wybrał pakiet pokoju.
W tym przykładzie dyrektywa jest używana w pliku stron docelowych:
<URL>https://partner.com/(IF-CLICK-TYPE-ROOM)landing_room(ELSE)landing(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>
W tym przykładzie, jeśli użytkownik nie wybierze pakietu Room Bundle, wynikiem będzie ten adres URL:
https://partner.com/landing?hid=123
Jeśli użytkownik wybrał zestaw pokoi, wynikiem jest ten adres URL:
https://partner.com/landing_room?hid=123
Przykład warunku IF-DEFAULT-DATE
Użyj instrukcji warunkowej IF-DEFAULT-DATE, aby ustawić parametr inny niż data, który Twoja witryna może następnie wykorzystać do uruchomienia niestandardowego działania, jeśli użytkownik nie wybrał daty.
W tym przykładzie sprawdzamy, czy użyto domyślnej daty:
<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>
Jeśli w tym przykładzie użytkownik nie wybierze daty, wynik może być podobny do tego adresu URL, który pokazuje domyślne daty:
https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=1&popup_datepicker=true
Jeśli użytkownik wybrał datę, wynik może być podobny do tego adresu URL (w zależności od wybranego planu podróży):
https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=2&popup_datepicker=false
Przykład dotyczący warunku IF-HOTEL-CAMPAIGN (kliknięcia reklam hoteli i bezpłatnych linków do rezerwacji)
Możesz utworzyć blok warunkowy, który sprawdza, czy użytkownik kliknął reklamę pochodzącą z kampanii reklam hoteli.
W tym przykładzie dyrektywa jest używana w pliku strony docelowej:
<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)&hotel_campaign=(CAMPAIGN-ID)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>
W tym przykładzie, jeśli użytkownik kliknie adres URL kampanii hotelowej, wynikiem będzie ten adres URL:
https://www.partner.com?hotelID=123&hotel_campaign=12345678
Jeśli kliknięcie nie pochodzi z adresu URL kampanii reklam hoteli (np. ze zwykłej kampanii w sieci wyszukiwania), wynikiem jest ten adres URL:
https://www.partner.com?hotelID=123&utm_campaign=87654321
Jest to przydatne, gdy chcesz odróżnić ruch pochodzący z kliknięć w kampanii hotelowej od innych kliknięć.
Puste identyfikatory kampanii z kliknięciami bezpłatnych linków do rezerwacji
Jeśli kliknięcie pochodzi z bezpłatnego linku do rezerwacji, parametr IF-HOTEL-CAMPAIGN zwraca wartość
TRUE, a parametr CAMPAIGN-ID jest pusty, jak pokazano w tym adresie URL:
https://www.partner.com?hotelID=123&hotel_campaign=
Możesz użyć IF-AD-CLICK instrukcji warunkowej, aby zapobiec pojawianiu się pustego identyfikatora kampanii, jak pokazano w tym przykładzie:
<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>
Przykład dotyczący warunku IF-PROMOTED (tylko w przypadku reklam hoteli)
Możesz utworzyć blok warunkowy, który sprawdza, czy użytkownik kliknął reklamę promującą nieruchomość.
W tym przykładzie dyrektywa jest używana w pliku stron docelowych:
<URL>https://partner.com/(IF-PROMOTED)1(ELSE)0(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>
W tym przykładzie, jeśli użytkownik wybierze reklamę typu „promowanie obiektu”, wynikiem będzie ten adres URL:
https://partner.com/1?hid=123
Jeśli użytkownik nie wybrał reklamy typu „promowanie obiektu”, wynikiem jest ten adres URL:
https://partner.com/0?hid=123
Przykład warunku IF-RATE-RULE-ID
Możesz utworzyć blok warunkowy, który sprawdza, czy użytkownik wybrał stawkę warunkową. Jeśli tak, używana jest wartość elementu <RateRuleID> w bloku <Rate> wiadomości o transakcji.
W tym przykładzie dyrektywa jest używana w pliku stron docelowych:
<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-RATE-RULE-ID)&customerType=42(ELSE)(ENDIF)</URL>
W tym przykładzie, jeśli użytkownik nie wybrał stawki warunkowej, wynikiem jest ten adres URL:
https://www.partner.com?hid=123
Jeśli użytkownik wybrał stawkę warunkową, wynikiem jest ten adres URL:
https://www.partner.com?hid=123&customerType=42
Przykład warunku IF-USER-LIST-ID (zdefiniowanego w Google Ads)
Jeśli w kampanii reklam hoteli w Google Ads ustawisz mnożniki stawek dla list odbiorców, możesz użyć parametru IF-USER-LIST-ID w połączeniu z parametrem USER-LIST-ID, aby ustawić w swojej witrynie parametr dla klienta, który należy do określonej listy odbiorców Google Ads. Możesz to zrobić w celu śledzenia lub dostosowania witryny do członków list odbiorców.
<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-USER-LIST-ID)&audience_list=(USER-LIST-ID)(ELSE)(ENDIF)</URL>
W tym przykładzie, jeśli użytkownik nie należał do listy odbiorców, wynikiem będzie ten adres URL:
https://www.partner.com?hid=123
Jeśli użytkownik był członkiem listy odbiorców 12345678, wynikiem jest ten adres URL:
https://www.partner.com?hid=123&audience_list=12345678
Przykład funkcji IF-VERIFICATION
Jeśli chcesz sprawdzić, czy Google wygenerowało adres URL na potrzeby testowania lub automatycznej weryfikacji, możesz użyć IF-VERIFICATION.
<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-VERIFICATION)&isgoogle=true(ENDIF)</URL>
W tym przykładzie, jeśli Google nie wygeneruje adresu URL na potrzeby testowania lub weryfikacji, wynikiem będzie ten adres URL:
https://www.partner.com?hid=123
Jeśli Google wygenerowało adres URL na potrzeby testowania lub weryfikacji, wynikiem jest ten adres URL:
https://www.partner.com?hid=123&isgoogle=true
Przykład użycia elementu FOR-EACH-CHILD-AGE
Możesz utworzyć blok warunkowy, który wypełnia maksymalny wiek każdego dziecka, zgodnie z informacjami podanymi w pliku danych o cenach hoteli.
W tym przykładzie dyrektywa jest używana w pliku stron docelowych:
<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>
W tym przykładzie, jeśli plan podróży obejmował 2 osoby dorosłe i 2 dzieci w wieku 0 lat i 17 lat, wynikiem będzie ten adres URL:
https://www.partner.com?adults=2&children=2&age=0_0age=1_17&hid=123
Jeśli w planie podróży były 2 osoby dorosłe i 0 dzieci, wynik będzie następujący:
https://www.partner.com?adults=2&children=0&hid=123
Ogólne reguły tworzenia adresów URL
Wszystkie zmienne są opcjonalne. Nie musisz wstawiać żadnych zmiennych do adresu URL strony docelowej. Jednak używanie zmiennych do przekazywania informacji o planie podróży i użytkowniku zwykle zapewnia użytkownikowi większą wygodę i pomaga w przestrzeganiu zasad Google.
Podczas definiowania skonstruowanych adresów URL w pliku stron docelowych obowiązują te zasady ogólne:
Wszystkie zmienne są ujęte w nawiasy otwierające i zamykające.
Parametry ciągu zapytania muszą być oddzielone znakiem ampersand („&”) w danych wyjściowych. Ponieważ ampersand jest znakiem specjalnym w XML, a format pliku stron docelowych to XML. Dlatego musisz użyć zakodowanego elementu „&”. W wyniku końcowym pojawi się znak „&”. Na przykład:
<!-- 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>Musisz też zakodować znaki specjalne, które mogą się pojawić w adresie URL strony docelowej. Na przykład:
- spacja („ ”): w elemencie
<URL>zastąp znaki spacji ciągiem znaków „%20;” - ukośnik prawy („/”): zastąp ukośniki prawe ciągiem znaków „%2F;” w elemencie
<URL>;
Nie wszystkie znaki inne niż litery muszą być zakodowane w formacie URL. Na przykład myślników („-”) nie trzeba kodować w adresie URL. Listę najczęstszych znaków, które muszą być zakodowane, znajdziesz w sekcji Kodowanie adresów URL.
- spacja („ ”): w elemencie
Wartości pojedynczego parametru można tworzyć z wielu zmiennych. W tym przykładzie tworzymy jeden parametr,
checkinDate, z zmiennychCHECKINDAY,CHECKINMONTHiCHECKINYEAR:<URL>https://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>W tym przykładzie otrzymasz adres URL, który może wyglądać tak:
https://www.partnerdomain.com?checkinDate=7/23/1971W przypadku nazw parametrów ciągu zapytania możesz użyć dowolnego identyfikatora. Serwer przetwarza te wartości. Przekazywane wartości są jednak ograniczone do listy dostępnych zmiennych.
Oprócz listy dostępnych zmiennych możesz używać maksymalnie 5 zmiennych niestandardowych.