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 dla 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 o listach 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. Ten nazwa atrybutu jest określony 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 o cenach 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 zestawie pokoi. 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 Omówienie wiadomości transakcyjnych. Pola niestandardowe są niedostępne, gdy używasz ARI.
Zmienne CUSTOM są wymienione tylko wtedy, gdy wysyłasz ceny w wiadomości o transakcji.
Ważne: jeśli chcesz używać zmiennych |
|
| 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 postaci liczby nocy określonej przez element <Nights> w pliku danych o cenach hoteli. Na przykład: 3. |
| MODIFICATION-IDS | Optional | Jeśli używasz ARI
Modyfikacje stawek, 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 planu podróży.
Tej zmiennej należy używać w połączeniu z elementem 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 oba te dokumenty, są wymagane, aby wziąć udział w wycieczkach 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ć liczbę uczestników, 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 standardowego pakietu 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-FEES | (Optional) | Kwota opłat uwzględnionych w łącznej kwocie podatków i opłat wyświetlonej użytkownikowi w jego walucie lokalnej.
Wartość PRICE-DISPLAYED-FEES to wartość elementu <Fee> w wiadomości o transakcji. W przypadku ARI jest to obliczona kwota opłaty na podstawie wiadomości TaxFeeInfo. np. „60.14”. |
| 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ł dotyczących 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. Znak <RatePlanID> reprezentuje unikalny identyfikator kombinacji danych pokoju i pakietu. Aby uzyskać optymalną wydajność, powinien mieć maksymalnie 50 znaków. Więcej informacji znajdziesz w sekcji
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 z 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ść true, jeśli link został wygenerowany przez Google na potrzeby testowania lub automatycznej weryfikacji, w przeciwnym razie 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 | Przyjmuje wartość true, jeśli użytkownik kliknął wizytówkę
zestawu pokoi, w przeciwnym razie przyjmuje wartość 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-DATE | 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ż umożliwia im przypisywanie atrybucji. |
| IF-MODIFICATION-IDS | Optional | Przyjmuje wartość true, jeśli użytkownik kliknął stawkę, która została zmodyfikowana przez modyfikację stawki ARI; w przeciwnym razie przyjmuje wartość false. |
| (tylko reklamy hoteli) | Recommended (if you use pay-per-stay Google Ads campaigns) | Wycofano: ma wartość true w przypadku hoteli uczestniczących w programie prowizji Płatność za pobyt; 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 stawki z określonym 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 kliknie reklamy, wynikiem będzie 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 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-CLICK-TYPE-ROOM
Możesz utworzyć blok warunkowy, który sprawdza, czy użytkownik wybrał RoomBundle.
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-CLOSE-RATE-RULE-IDS
Możesz utworzyć blok warunkowy, który sprawdza, czy użytkownik ma specjalne, obniżone ceny lub ceny prywatne dla uczestników programu lojalnościowego.
W tym przykładzie dyrektywa jest używana w pliku stron docelowych:
<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-CLOSE-RATE-RULE-IDS)&rate_rule=(CLOSE-RATE-RULE-ID)(ELSE)(ENDIF)</URL>
W tym przykładzie, jeśli użytkownik nie kwalifikuje się do prywatnej stawki, wynikiem jest ten adres URL:
https://partner.com?hid=123
Jeśli użytkownik jest uczestnikiem programu lojalnościowego i kwalifikuje się do ceny prywatnej, wynikiem jest ten adres URL:
https://partner.com?hid=123&rate_rule=sample_qr
Poniżej znajdziesz przykład logiki ceny warunkowej z datą zameldowania, datą wymeldowania i szczegółami dotyczącymi obłożenia, z zagnieżdżonymi warunkami IF, które sprawdzają, czy użytkownik kwalifikuje się do ceny prywatnej, warunkowej ceny prywatnej czy ceny publicznej:
<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)&checkinYear=(CHECKINYear)&checkoutDay=(CHECKOUTDAY)&checkoutMonth=(CHECKOUTMONTH)&checkoutYear(CHECKOUTYear)&num_adults=(NUM-ADULTS)(IF-CLOSE-RATE-RULE-IDS)&promo_type=member_signup&rate_rule=(CLOSE-RATE-RULE-ID)(ELSE)(IF-RATE-RULE-ID)&promo_type=conditional&rate_rule=(RATE-RULE-ID)(ELSE)promo_type=public(ENDIF)(ENDIF)</URL>
Jeśli użytkownik kwalifikuje się do otrzymania ceny prywatnej, wynikiem jest ten adres URL:
https://partner.com/?hid=123&checkinDay=05&checkinMonth=03&checkinYear=2026&checkoutDay=07&checkoutMonth=03&checkoutYear=2026&num_adults=2&promo_type=member_signup&rate_rule=sample_qr
Jeśli użytkownik kwalifikuje się do warunkowej ceny prywatnej, wynikiem jest ten adres URL:
https://partner.com/?hid=123&checkinDay=05&checkinMonth=03&checkinYear=2026&checkoutDay=07&checkoutMonth=03&checkoutYear=2026&num_adults=2&promo_type=conditional&rate_rule=US_users
Jeśli użytkownik kwalifikuje się do stawki publicznej, wynikiem jest ten adres URL:
https://partner.com/?hid=123&checkinDay=05&checkinMonth=03&checkinYear=2026&checkoutDay=07&checkoutMonth=03&checkoutYear=2026&num_adults=2&promo_type=public
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)(IF-DEFAULT-DATE)&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 wybierze 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 kliknięcie nie nastąpi w przypadku adresu URL kampanii hoteli (np. zwykłej kampanii w sieci wyszukiwania), wynikiem będzie ten adres URL:
https://www.partner.com?hotelID=123&utm_campaign=87654321
Jeśli użytkownik kliknie adres URL kampanii hoteli, wynikiem będzie ten adres URL:
https://www.partner.com?hotelID=123&hotel_campaign=12345678
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
TRUE, a parametr CAMPAIGN-ID ma wartość pustą, 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 wyświetlaniu 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>
IF-MODIFICATIONS-IDS
Możesz utworzyć blok warunkowy, który sprawdzi, czy użytkownik zaktualizował wiadomość Zmiany stawek ARI.
W tym przykładzie dyrektywa jest używana w pliku strony docelowej:
<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-MODIFICATION-IDS)&promo_applied=true&mod_ids=(MODIFICATION-IDS)(ENDIF)</URL>
W tym przykładzie, jeśli użytkownik nie zmodyfikował wiadomości o zmianach stawki ARI, wynikiem będzie ten adres URL:
https://partner.com?hid=123
Jeśli użytkownik zaktualizował wiadomość o modyfikacjach stawek ARI, wynikiem będzie ten adres URL:
https://partner.com?hid=123&promo_applied=true&mod_ids=7
IF-PROMO-CODE
Możesz utworzyć blok warunkowy, który sprawdza, czy kod promocyjny rabatu jest powiązany ze stawką dla określonego użytkownika skonfigurowaną za pomocą komunikatów ARI Promotions lub Rate rules.
W tym przykładzie dyrektywa jest używana w pliku stron docelowych:
<URL>https://partner.com/booking?hid=(PARTNER-HOTEL-ID)(IF-PROMO-CODE)&promotion_code=(PROMO-CODE)&discount_applied=true(ENDIF)</URL>
Jeśli w tym przykładzie kod promocyjny jest nieprawidłowy, wynikiem jest ten adres URL:
https://partner.com?hid=123
Jeśli użytkownik ma ważny kod promocyjny i kwalifikuje się do otrzymania rabatu, wynikiem jest ten adres URL:
https://partner.com?hid=123&promotion_code=123_abc&discount_applied=true
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 nie wybrał reklamy typu „promowanie obiektu”, wynikiem jest ten adres URL:
https://partner.com/0?hid=123
Jeśli użytkownik kliknie reklamę typu „promowanie obiektu”, wynikiem będzie ten adres URL:
https://partner.com/1?hid=123
Przykład warunku IF-RATE-RULE-ID
Możesz utworzyć blok warunkowy, który sprawdzi, czy użytkownik wybrał stawkę warunkową. Jeśli tak, użyta zostanie wartość elementu <RateRuleID> w bloku <Rate> wiadomości o transakcji.
Więcej informacji
W tym przykładzie dyrektywa jest używana w pliku stron docelowych:
<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-RATE-RULE-ID)&rate_rule=(RATE-RULE-ID)(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&rate_rule=(RATE-RULE-ID)
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:
https://www.partner.com?hid=123&isgoogle=true
Przykład FOR-EACH-CHILD-AGE
Możesz utworzyć blok warunkowy, który będzie zawierać maksymalny wiek każdego dziecka, zgodnie z informacjami 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 w adresie 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 niealfabetyczne 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.