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 tworzy link, aby zawierał wszystkie dodatkowe informacje o użytkowniku i jego planie podróży. Do adresu URL możesz dodać np. identyfikator hotelu, język, kody walut i daty zameldowania.
Przegląd
Adres URL strony docelowej określasz w pliku stron docelowych. Po wyświetleniu reklamy lub bezpłatnego linku do rezerwacji informacje dynamiczne w adresie URL są zastępowane rzeczywistymi wartościami. Aby dodać wartości dynamiczne do adresów URL stron docelowych, użyj tej składni:
<URL>https://partner_url?param_id=(variable_name)</URL>
Ten przykład pokazuje adres URL, który używa nazw zmiennych Google zamiast rzeczywistego identyfikatora hotelu i planu podróży:
<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)
&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)
&checkinYear=(CHECKINYEAR)&nights=(LENGTH)
</URL>
Po utworzeniu linku do strony docelowej dla strony wyników wyszukiwania Google zastępuje zmienne rzeczywistymi wartościami, aby adres URL zawierał informacje dynamiczne. Jeśli np. użytkownik zarezerwuje pokój na 6 nocy w hotelu nr 42 od 23 maja 2023 r., Google renderuje poprzedni link w ten sposób:
https://www.partnerdomain.com?hotelID=42&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=6
Wartości przypisane przez Google do zmiennych w ciągu zapytania zależą od danych w pliku danych z cenami hoteli, pliku danych z listą hoteli i ustawieniach użytkownika.
Na przykład wartość zmiennej LENGTH jest przypisywana do elementu <Nights> z pliku danych z cenami powiązanego planu podróży. Podobnie wartość zmiennej PARTNER-HOTEL-ID jest zdefiniowana w elemencie <id> pliku danych z listą hoteli, który pasuje do kryteriów wyszukiwania użytkownika.
Niektóre zmienne są podzbiorami elementów pliku danych z cenami. Na przykład zmienne CHECKINDAY, CHECKINMONTH i CHECKINYEAR są wyodrębniane z jednego elementu <Checkin> w pliku danych z cenami. Inne zmienne są obliczane na podstawie języka użytkownika i innych ustawień klienta.
Więcej informacji o źródłach wartości zmiennych znajdziesz w sekcjach Informacje o cenach i Lista hoteli.
Zmienne adresów URL
W tabeli poniżej znajdziesz dostępne zmienne, których możesz użyć do utworzenia 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. Osobne identyfikatory są przydatne, gdy potrzebujesz jednego identyfikatora usługi dla informacji w pliku danych i drugiego identyfikatora usługi dla systemu rezerwacji. |
| CAMPAIGN-ID | Recommended | Identyfikator kampanii Google Ads, którą chcesz powiązać z adresem URL. To pole jest puste, jeśli kliknięcie nie jest powiązane z kampanią Google Ads. |
| CHECKINDAY | Recommended | Dwucyfrowy dzień zdefiniowany w elemencie <Checkin> w pliku danych z cenami hoteli. Na przykład: 20. |
| CHECKINDAY-OF-WEEK | Optional | Dzień tygodnia – od Monday do Sunday, kiedy odbywa się zameldowanie, zgodnie ze strefą czasową hotelu. Przykład: Tuesday. |
| CHECKINMONTH | Recommended | Dwucyfrowy miesiąc zdefiniowany w elemencie <Checkin> w pliku danych z cenami hoteli. Na przykład: 05. |
| CHECKINYEAR | Recommended | Rok składający się z 4 cyfr zdefiniowany w elemencie <Checkin> w pliku danych z cenami hoteli. Na przykład: 2023. |
| CHECKOUTDAY | Recommended | Dwucyfrowy dzień obliczony na podstawie elementów <Nights> i <Checkin> w pliku danych z cenami hoteli. Na przykład: 26. |
| CHECKOUTMONTH | Recommended | Dwucyfrowy miesiąc obliczany na podstawie elementów <Nights> i <Checkin> w pliku danych z cenami hoteli. Na przykład: 05. |
| CHECKOUTYEAR | Recommended | Rok składający się z 4 cyfr obliczany na podstawie elementów <Nights> i <Checkin> w pliku danych z cenami 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"> w pliku danych z cenami.
Tej zmiennej należy używać w połączeniu z blokiem warunkowym FOR-EACH-CHILD-AGE. |
| CHILD-INDEX | Optional | Zmienna pętli z indeksowaniem o wartości 0 reprezentująca licznik dla każdego uczestnika podróży i wieku dziecka określonego w planie podróży. Chociaż nie jest to obowiązkowe, tej zmiennej można używać tylko w połączeniu z blokiem warunkowym FOR-EACH-CHILD-AGE.
|
| CLICK-TYPE | Optional | Wskazuje, czy użytkownik kliknął informacje o standardowej cenie za hotel, czy na pakiet pokoi. Możliwe wartości:
|
| CLOSE-RATE-RULE-IDS | Optional (only applies if you are using conditional or private rates) | Rozdzielona przecinkami lista identyfikatorów reguł dotyczących stawek dla stawek, które były niedostępne, ale mogły być dostępne, gdyby użytkownik wykonał drobne działania. Pamiętaj, że identyfikatory reguł dotyczących cen prywatnych są zawsze tutaj wypełniane, gdy użytkownik zobaczy odpowiedni interfejs użytkownika. |
| CUSTOM[1-5] | Optional | Wartości pól niestandardowych zdefiniowanych w elemencie <Result> z limitem 200 znaków na pole niestandardowe. Więcej informacji znajdziesz w artykule Omówienie komunikatów o transakcjach. Gdy używasz ARI, pola niestandardowe są niedostępne. |
| DATE-TYPE | Optional | Wskazuje, czy użytkownik wybrał domyślną datę czy konkretną datę podaną w wyszukiwaniu. Możliwe wartości:
|
| GOOGLE-SITE | Optional | Usługa Google, w której użytkownik wyświetlił dane o cenach Twoich hoteli.
Możliwe wartości:
|
| LENGTH | Recommended | Długość pobytu podana jako liczba nocy określona przez element <Nights> w pliku danych z cenami hoteli. Na przykład: 3. |
| NUM-ADULTS | Recommended (must be used with the
NUM-CHILDREN or FOR-EACH-CHILD-AGE condition)
|
Liczba dorosłych osób w planie podróży określona przez użytkownika.
Tej zmiennej należy używać w połączeniu z właściwością NUM-CHILDREN, FOR-EACH-CHILD-AGE lub z obydwiema. |
| NUM-CHILDREN | Recommended | Liczba dzieci (do 17 lat) podana w planie podróży przez użytkownika. Aby można było wziąć udział w planach podróży z nieletnimi, wymagane jest: NUM-CHILDREN, FOR-EACH-CHILD-AGE lub oba te warunki. |
| NUM-GUESTS | Recommended (if you don't send child occupancy pricing) | Łączna liczba osób, zarówno dorosłych, jak i dzieci, określona w planie podróży przez użytkownika. Ta wartość jest sumą wartości NUM-ADULTS i NUM-CHILDREN. Aby zmaksymalizować uczestnictwo, zdecydowanie zalecamy korzystanie zarówno z elementów NUM-ADULTS, jak i NUM-CHILDREN. |
| PACKAGE-ID | Recommended (applies if you use Room Bundles) | Unikalny identyfikator pakietu w pliku danych z cenami w hotelu. W przypadku pakietu standardowego identyfikator pakietu to wartość elementu <PackageID> w bloku <Result>. W przypadku zestawu pokoi identyfikator pakietu to wartość elementu <PackageID> w bloku <RoomBundle> lub <PackageData> wiadomości o transakcji. |
| PARTNER-CURRENCY | Optional | Trzyliterowy kod waluty zdefiniowany przez atrybut currency elementu <Baserate> w pliku danych z cenami hoteli. np. 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 z cenami w hotelu. W przypadku pokoju standardowego identyfikator ma wartość elementu <RoomID> w bloku <Result>. W przypadku pakietu pokoi identyfikator pokoju to wartość przypisana do elementu <RoomID> w blokach <RoomBundle> lub <RoomData> w wiadomości o transakcji. |
| PAYMENT-ID | Optional (only applies to Ads) | Przyjmuje wstępnie zdefiniowany ciąg znaków commission 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 (TAM). |
| PRICE-DISPLAYED-TAX | (Optional) | Kwota podatku wyświetlana użytkownikowi w jego walucie lokalnej.
Wartość PRICE-DISPLAYED-TAX to wartość elementu <Tax> w pliku danych z cenami dla hoteli. Na przykład: „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ł związanych z cenami, wartość tej zmiennej jest przypisywana do elementu |
| RATE-PLAN-ID | Recommended (only applies if you use RoomBundles) | Identyfikator określony przez element <RatePlanID> w bloku <RoomBundle> pliku danych z cenami. <RatePlanID> reprezentuje unikalny identyfikator kombinacji danych dotyczących sali i pakietu. Więcej informacji znajdziesz w artykule
Pakiety pokoi. |
| RATE-RULE-ID | Recommended (only applies if you use conditional rates or private rates) | Identyfikator określony przez atrybut rate_rule_id w bloku <Rate> pliku danych z cenami. Więcej informacji znajdziesz w artykule
Ceny warunkowe. |
| 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 wskazujący walutę lokalną użytkownika. Wartość zmiennej USER-CURRENCY jest ustalana na podstawie ustawień klienta. Na przykład USD lub CAD . |
| USER-DEVICE | Recommended | Typ urządzenia użytkownika. USER-DEVICE może mieć jedną z tych wartości:
Wartość zmiennej |
| USER-LANGUAGE | Recommended | Dwuliterowy kod języka w formacie ISO 639-1 określający język wyświetlania reklamy lub bezpłatnego linku do rezerwacji. Wartość zmiennej USER-LANGUAGE jest ustalana na podstawie ustawień klienta. np. en lub fr. |
| USER-LIST-ID (definicja w Google Ads) | Optional (only applies if you use Audience Lists in Google Ads) | Identyfikator listy użytkowników Google Ads, który zawiera listę odbiorców lub informacje o użytkowniku. Listy odbiorców służą do ustawiania dostosowań stawek. Jeśli użytkownik znajduje się na kilku listach odbiorców, wybierana jest lista odbiorców z największym dostosowaniem stawki. Powiązania między odbiorcami z największym dostosowaniem stawek są określane losowo. |
| VERIFICATION | Optional | Wartość logiczna sprawdzająca, czy połączenie zostało wygenerowane przez Google na potrzeby testowania lub automatycznej weryfikacji. Wartość true, jeśli link został wygenerowany przez Google do testów lub automatycznej weryfikacji. W przeciwnym razie ma wartość false.
|
Logika warunkowa w adresach URL
Aby warunkowo utworzyć punkty końcowe, możesz używać specjalnych dyrektyw w elemencie <URL> pliku stron docelowych.
Logika warunkowa obsługuje te instrukcje:
if_statement: jeśli jest
true, do adresu URL są wstawiane wartości spełniające ten warunek. W przeciwnym razie wstawiane są wartości zgodne z dyrektywąELSE.for_statement: tworzy warunek pętli FOR, który występuje po określonej liczbie wartości.
Instrukcje IF i FOR zawierają:
| Warunek | Zalecane/opcjonalne | Opis |
|---|---|---|
| IF-AD-CLICK (tylko reklamy hoteli) | Optional | Przyjmuje wartość true, jeśli kliknięcie użytkownika pochodziło z reklamy.
Przyjmuje wartość false, jeśli kliknięcie użytkownika pochodziło z bezpłatnego linku do rezerwacji. |
| IF-CLICK-TYPE-HOTEL | Optional | Przyjmuje wartość true, jeśli użytkownik kliknął informacje o hotelu, a w przeciwnym razie przyjmuje wartość false. |
| IF-CLICK-TYPE-ROOM | Optional | Przyjmuje wartość true, jeśli użytkownik kliknął informacje o
pakiecie pokoi, a w przeciwnym razie przyjmie wartość false. |
| IF-CLOSE-RATE-RULE-IDS | Optional | Przyjmuje wartość true, jeśli co najmniej 1 cena warunkowa była niedostępna, ponieważ użytkownik nie kwalifikował się do skorzystania z oferty. W przeciwnym razie przyjmuje wartość false. Domyślnie jest to true, jeśli użytkownikowi wyświetlił się wskaźnik prywatny
. |
| IF-DEFAULT-RATE | Optional | Przyjmuje wartość true, jeśli użytkownik kliknął informacje o hotelu z użyciem dat domyślnych, a w przeciwnym razie przyjmuje wartość false. |
| IF-HOTEL-CAMPAIGN | Optional | Przyjmuje wartość true, jeśli kliknięcie użytkownika pochodzi z kampanii reklam hoteli, a w przeciwnym razie ma wartość false. To rozróżnienie jest przydatne dla partnerów, którzy mają w Google Ads wiele typów kampanii do przypisywania atrybucji. |
| IF-PAYMENT-ID (tylko reklamy hoteli) | Recommended (if you use pay-per-stay Google Ads campaigns) | Przyjmuje wartość true w przypadku hoteli korzystających z programu prowizji płatnych za pobyt (PPS), w przeciwnym razie ustawia się na false. |
| IF-PROMO-CODE | Optional | Przyjmuje wartość true, jeśli użytkownik kliknął stawkę opartą na promocji ARI lub regule ceny z określonym atrybutem PromoCode. W przeciwnym razie zwraca 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”, w przeciwnym razie przyjmuje wartość false. |
| IF-RATE-RULE-ID | Optional | Przyjmuje wartość true, jeśli użytkownik wybrał cenę warunkową
, w przeciwnym razie przyjmuje wartość false. |
| IF-USER-LIST-ID (definicja w Google Ads) | Optional | Przyjmuje wartość true, jeśli użytkownik należy do identyfikatora listy klientów Google Ads podanego podczas ustawiania mnożników stawek dla list odbiorców, a w przeciwnym razie przyjmuje wartość false. |
| IF-VERIFICATION | Optional | Przyjmuje wartość true, jeśli połączenie zostało wygenerowane przez Google do testowania lub automatycznej weryfikacji. W przeciwnym razie zwraca wartość false. |
| ELSE | Recommended (if you use any conditional IF statements) | Jeśli poprzedni warunek nie zostanie 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 jednorazowo dla każdego elementu
<Child "age"> w pliku danych z cenami. Jeśli np. <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 KLIKNIĘCIA REKLAMY
Możesz utworzyć blok warunkowy, który sprawdza, czy użytkownik kliknął reklamę lub bezpłatny link do rezerwacji, aby przekierować użytkownika na Twoją stronę docelową.
W tym przykładzie użyto tej dyrektywy w pliku strony docelowej:
<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-AD-CLICK)&adType=1(ELSE)&adType=0(ENDIF)</URL>
Jeśli w tym przykładzie użytkownik nie kliknął reklamy, wynik będzie wyglądał tak:
https://www.partner.com?hid=123&adType=0
Jeśli użytkownik kliknie reklamę, efekt będzie taki:
https://www.partner.com?hid=123&adType=1
Przykład elementu IF-click-TYPE-hotel
Możesz utworzyć blok warunkowy, który sprawdza, czy użytkownik wybrał hotel bez jawnego typu pakietu pokoi. Wartość elementu <RatePlanID> w bloku <Room Bundle> komunikatu o transakcji będzie ustawiona na bezpośrednio powiązaną cenę pakietu pokoju wybraną przez użytkownika.
W tym przykładzie użyto tej dyrektywy 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 pokoi, uzyskamy taki adres URL:
https://partner.com/landing_room?hid=123
Jeśli użytkownik nie wybrał pokoju pokoi, adres URL będzie wyglądać tak:
https://partner.com/landing?hid=123
Przykład funkcji IF-KLIKNIJ-TYPE-ROOM
Możesz utworzyć blok warunkowy, który sprawdza, czy użytkownik wybrał grupę pomieszczeń.
W tym przykładzie użyto tej dyrektywy 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 wybrał pakietu pokoju, uzyskamy taki adres URL:
https://partner.com/landing?hid=123
Jeśli użytkownik wybierze pakiet pokoi, uzyskamy taki adres URL:
https://partner.com/landing_room?hid=123
Przykład atrybutu IF-DEFAULT-DATE
Użyj instrukcji warunkowej IF-DEFAULT-DATE, aby ustawić parametr inny niż data, którego Twoja witryna może następnie użyć do wywołania niestandardowego działania, jeśli użytkownik nie wybierze daty.
Ten przykład pozwala sprawdzić, czy została użyta data domyślna:
<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 wybrał daty, wynik może być podobny do tego adresu URL z domyślnymi ustawieniami dat:
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 reklamy 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 użyto tej dyrektywy 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 reklam hoteli, wynik będzie wyglądał tak:
https://www.partner.com?hotelID=123&hotel_campaign=12345678
Jeśli kliknięcie nie dotyczy adresu URL kampanii reklam hoteli (np. zwykłej kampanii w sieci wyszukiwania), wynik wygląda tak:
https://www.partner.com?hotelID=123&utm_campaign=87654321
Jest to przydatne, gdy chcesz odróżniać ruch z kliknięć z kampanii reklam hoteli od innych kliknięć.
Puste identyfikatory CAMPAIGN-ID z kliknięciami FBL
Jeśli kliknięcie pochodzi z bezpłatnego linku do rezerwacji, IF-HOTEL-CAMPAIGN zwraca wartość TRUE, a wartość CAMPAIGN-ID jest pusta, jak pokazano na tym adresie URL:
https://www.partner.com?hotelID=123&hotel_campaign=
Za pomocą instrukcji warunkowej IF-AD-CLICK możesz uniknąć pustego identyfikatora kampanii, jak 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 identyfikatora IF-PAYMENT-ID (tylko Reklamy hoteli)
Użyj wyrażenia warunkowego IF-PAYMENT-ID, aby zmieniać adres URL w zależności od tego, czy kliknięcie jest wynikiem programu prowizji PPS. Poniższy przykład pozwala sprawdzić, czy kliknięcie pochodzi z programu prowizji PPS, i na podstawie wyniku przypisuje wartość do parametru booking_source:
<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)&booking_source=(IF-PAYMENT-ID)(PAYMENT-ID)(ELSE)cpc(ENDIF)</URL>
Jeśli hotel bierze udział w programie prowizje, wyświetli się jeden z tych adresów URL:
- Jeśli Google nie ma przypisanego numeru IATA:
https://partner.com?hid=123&booking_source=commissions
- Jeśli numer IATA został przypisany do Google:
https://partner.com?hid=123&booking_source=01234567
W przeciwnym razie wynik będzie wyglądał tak:
https://partner.com?hid=123&booking_source=cpc
Przykład IF-PROMOTED (tylko reklamy hoteli)
Możesz utworzyć blok warunkowy, który sprawdza, czy użytkownik kliknął reklamę typu „promowanie obiektu”.
W tym przykładzie użyto tej dyrektywy 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 wybrał reklamę typu „promowanie obiektu”, adres URL wygląda tak:
https://partner.com/1?hid=123
Jeśli użytkownik nie wybrał reklamy typu „promowanie obiektu”, adres URL wygląda tak:
https://partner.com/0?hid=123
Przykład identyfikatora IF-RATE-RULE-ID
Możesz utworzyć blok warunkowy, który sprawdza, czy użytkownik wybrał stawkę warunkową. Jeśli tak jest, używana jest wartość elementu <RateRuleID> z bloku <Rate> komunikatu o transakcji.
W tym przykładzie użyto tej dyrektywy w pliku stron docelowych:
<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-RATE-RULE-ID)&customerType=42(ELSE)(ENDIF)</URL>
Jeśli w tym przykładzie użytkownik nie wybrał ceny warunkowej, wynik będzie wyglądał tak:
https://www.partner.com?hid=123
Jeśli użytkownik wybierze cenę warunkową, wynik będzie taki:
https://www.partner.com?hid=123&customerType=42
Przykładowy identyfikator IF-USER-LIST-ID (zdefiniowany w Google Ads)
Jeśli ustawisz mnożniki stawek dla list odbiorców w kampanii reklam hoteli w Google Ads, możesz użyć funkcji IF-USER-LIST-ID w połączeniu z atrybutem USER-LIST-ID, aby ustawić w witrynie parametr dla klienta, który należy do określonej listy odbiorców Google Ads. Możesz to zrobić na potrzeby śledzenia lub aby dostosować witrynę do potrzeb osób z 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 był na liście odbiorców, wynik będzie taki:
https://www.partner.com?hid=123
Jeśli użytkownik należał do listy odbiorców 12345678, wynik wygląda tak:
https://www.partner.com?hid=123&audience_list=12345678
Przykład IF-VERIFICATION
Jeśli chcesz sprawdzić, czy adres URL został wygenerowany przez Google do testów czy do automatycznej weryfikacji, możesz użyć funkcji IF-VERIFICATION.
<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-VERIFICATION)&isgoogle=true(ENDIF)</URL>
Jeśli w tym przykładzie adres URL nie został wygenerowany przez Google do testowania ani weryfikacji, adres będzie taki:
https://www.partner.com?hid=123
Jeśli robot Google wygenerował adres URL do testowania lub weryfikacji, otrzymuje taki adres URL:
https://www.partner.com?hid=123&isgoogle=true
Przykład „FOR-EACH-CHILD-AGE”
Możesz utworzyć blok warunkowy, który wypełni maksymalny wiek każdego dziecka, zgodnie z informacjami w pliku danych z cenami w hotelu.
W tym przykładzie użyto tej dyrektywy 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 dorosłych i 2 dzieci w wieku 0 i 17 lat, wynik będzie następujący:
https://www.partner.com?adults=2&children=2&age=0_0age=1_17&hid=123
Jeśli w planie podróży są 2 osoby dorosłe i 0 dzieci, wynik będzie taki:
https://www.partner.com?adults=2&children=0&hid=123
Ogólne zasady tworzenia adresów URL
Wszystkie zmienne są opcjonalne. Nie musisz wstawiać żadnych zmiennych w adresie URL strony docelowej. Jednak używanie zmiennych do przekazywania planu podróży i informacji o użytkowniku zwiększa zwykle wygodę użytkowników i ułatwia zachowanie zgodności z zasadami Google.
Podczas definiowania utworzonych adresów URL w pliku stron docelowych obowiązują te ogólne reguły:
Wszystkie zmienne są ujęte w nawiasy otwierające i zamykające.
Parametry ciągu zapytania można przekazywać w adresie URL tylko po znaku zapytania („?”).
W ostatecznych danych wyjściowych parametry ciągu zapytania muszą być rozdzielone ampersandem („&”). Ponieważ ampersand to znak specjalny w XML, a format pliku stron docelowych to XML. Dlatego zamiast niego należy używać zakodowanej encji „&”. Ostateczny wynik renderuje rzeczywisty 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ć w adresie URL znaki specjalne, które chcesz umieścić w adresie URL strony docelowej. Na przykład:
- spacja („ ): zastąp spacje znakami „%20;” w elemencie
<URL> - ukośnik prawy („/”): zastąp ukośniki prawe ciągiem „%2F;” w elemencie
<URL>.
Nie wszystkie znaki inne niż alfanumeryczne muszą być zakodowane na potrzeby adresu URL. Na przykład łączników („-”) nie trzeba kodować w adresie URL. Listę typowych znaków, które muszą być zakodowane na potrzeby adresu URL, znajdziesz w tabeli kodowania adresów URL.
- spacja („ ): zastąp spacje znakami „%20;” w elemencie
Wartości pojedynczego parametru można tworzyć na podstawie wielu zmiennych. Ten przykład tworzy pojedynczy parametr –
checkinDate– ze 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/1971Jako nazwy 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żyć maksymalnie 5 zmiennych niestandardowych.