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ć połączenie, aby uwzględnić 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. 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 przedstawia 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>
Podczas tworzenia linku do strony docelowej dla strony wyników wyszukiwania Google zastępuje zmienne rzeczywistymi wartościami, by mieć pewność, że adres URL zawiera informacje dynamiczne. Jeśli na przykład użytkownik zarezerwuje pokój na 6 nocy dla hotelu nr 42 od 23 maja 2023 r., Google wyrenderuje poprzedni link w taki 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 z cenami hoteli, pliku danych z listą hoteli i ustawieniach użytkownika.
Na przykład wartość zmiennej LENGTH jest przypisana do elementu <Nights> z pliku danych z cenami powiązanego planu podróży. Podobnie wartość zmiennej PARTNER-HOTEL-ID jest zdefiniowana w elemencie <id> z 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 pojedynczego 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 artykułach Omówienie cen i Lista hoteli.
Zmienne adresów URL
W tabeli poniżej znajdziesz dostępne zmienne, których możesz używać do tworzenia adresu URL strony docelowej:
| Zmienna | Zalecane/opcjonalne | Opis |
|---|---|---|
| ADVANCE-BOOKING-WINDOW | Optional | Liczba dni przed datą zameldowania w strefie czasowej hotelu w chwili 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, jeśli potrzebujesz jednego identyfikatora usługi do informacji z pliku danych i drugiego identyfikatora usługi 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 hotelu. Na przykład: 20. |
| CHECKINDAY-OF-WEEK | Optional | Dzień tygodnia – od Monday do Sunday, w którym odbywa się zameldowanie, w strefie czasowej hotelu. Na przykład: Tuesday. |
| CHECKINMONTH | Recommended | Dwucyfrowy miesiąc zdefiniowany w elemencie <Checkin> w pliku danych z cenami hotelu. Na przykład: 05. |
| CHECKINYEAR | Recommended | Czterocyfrowy rok zdefiniowany w elemencie <Checkin> w pliku danych z cenami hotelu. Na przykład: 2023. |
| CHECKOUTDAY | Recommended | Dwucyfrowy dzień obliczany na podstawie elementów <Nights> i <Checkin> w pliku danych z cenami w hotelu. Przykład: 26. |
| CHECKOUTMONTH | Recommended | Dwucyfrowy miesiąc obliczony na podstawie elementów <Nights> i <Checkin> w pliku danych z cenami hotelu. Przykład: 05. |
| CHECKOUTYEAR | Recommended | Czterocyfrowy rok obliczony na podstawie elementów <Nights> i <Checkin> w pliku danych z cenami w hotelu. 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 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 indeksem 0 reprezentująca licznik dla każdego dziecka 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ął ofertę z prośbą o standardową stawkę hotelową czy o pakiet pokojów. 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, które były niedostępne, ale mogły być dostępne, jeśli użytkownik wykonał drobne działanie. Pamiętaj, że identyfikatory reguł dotyczących stawek dla cen prywatnych są zawsze wypełniane, gdy użytkownik zobaczy odpowiednie polecenie w interfejsie. |
| 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 omówieniu komunikatów transakcji. Pola niestandardowe są niedostępne, gdy używasz ARI. |
| 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 jako liczba nocy zdefiniowana przez element <Nights> w pliku danych z cenami hotelu. Przykład: 3. |
| NUM-ADULTS | Recommended (must be used with the
NUM-CHILDREN or FOR-EACH-CHILD-AGE condition)
|
Liczba dorosłych pasażerów podana w planie podróży przez użytkownika.
Tej zmiennej należy używać w połączeniu z właściwościami NUM-CHILDREN, FOR-EACH-CHILD-AGE lub z obydwoma. |
| NUM-CHILDREN | Recommended | Liczba dzieci (w wieku 0–17 lat) podana w planie podróży przez użytkownika. Aby można było uczestniczyć w planach podróży z osobami z dziećmi, wymagane jest podanie tych uprawnień: NUM-CHILDREN, FOR-EACH-CHILD-AGE lub oba. |
| 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ć udział w wydarzeniu, zdecydowanie zalecamy używanie zamiast niego zarówno NUM-ADULTS, jak i NUM-CHILDREN. |
| PACKAGE-ID | Recommended (applies if you use Room Bundles) | Unikalny identyfikator pakietu w pliku danych z cenami hotelu. W przypadku pakietu standardowego identyfikator pakietu to wartość elementu <PackageID> w bloku <Result>. W przypadku pakietu pokojów 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 z cenami 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 z cenami hotelu. W przypadku pokoju standardowego identyfikator pokoju jest wartością 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 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, skontaktuj się z technicznym menedżerem konta (TAM). |
| PRICE-DISPLAYED-TAX | (Optional) | Kwota podatku wyświetlana użytkownikowi w jego lokalnej walucie.
Wartość PRICE-DISPLAYED-TAX to wartość elementu <Tax> w pliku danych z cenami hotelu. Przykład: „3.14”. |
| PRICE-DISPLAYED-TOTAL | (Optional) | Całkowity koszt pokoju wyświetlany użytkownikowi w jego walucie lokalnej. Wartość PRICE-DISPLAYED-TOTAL to suma elementów <Baserate>, <Tax> i <OtherFees> z pliku danych z cenami hotelu.
Przykład: „152.13”. |
| PROMO-CODE | (Optional) | Jeśli używasz promocji ARI, wartość tej zmiennej jest przypisana 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 z cenami. <RatePlanID> reprezentuje unikalny identyfikator kombinacji danych pomieszczenia i pakietu. Więcej informacji znajdziesz w artykule o
pakietach pokojów. |
| 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 z cenami. Więcej informacji znajdziesz w artykule
Stawki warunkowe.
Uwaga: wyświetlane są tylko ceny warunkowe i ceny 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 wskazujący walutę lokalną użytkownika. Wartość zmiennej USER-CURRENCY jest ustalana na podstawie ustawień klienta użytkownika. 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, który określa język wyświetlania reklamy lub bezpłatnego linku do rezerwacji. Wartość zmiennej USER-LANGUAGE jest ustalana na podstawie ustawień klienta użytkownika. na przykład en lub fr. |
| USER-LIST-ID (zdefiniowany 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żytkowniku. Listy odbiorców służą za podstawę do ustawiania dostosowań stawek. Jeśli użytkownik znajduje się na wielu listach odbiorców, wybierana jest lista z największym dostosowaniem stawek. Grupy odbiorców z największym dostosowaniem stawek są ustalane losowo. |
| VERIFICATION | Optional | Wartość logiczna, która sprawdza, czy połączenie zostało wygenerowane przez Google do testowania lub automatycznej weryfikacji. Wartość true, jeśli link został wygenerowany przez Google do testowania lub automatycznej weryfikacji. W przeciwnym razie ma wartość 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 instrukcje:
if_statement: jeśli
true, do adresu URL są wstawiane wartości zgodne z tym warunkiem. W przeciwnym razie wstawiane są wartości zgodne z dyrektywąELSE.for_statement: tworzy warunek pętli FOR, który powtarza liczbę podanych wartości.
Instrukcje IF i FOR zawierają takie elementy:
| Warunek | Zalecane/opcjonalne | Opis |
|---|---|---|
| IF-AD-CLICK (tylko reklamy hoteli) | Optional | Ma wartość true, jeśli kliknięcie pochodziło z reklamy.
Ma 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ął ofertę dotyczącą hotelu, lub ma wartość false. |
| IF-CLICK-TYPE-ROOM | Optional | Ma wartość true, jeśli użytkownik kliknął ofertę dotyczącą
pakietu pokoi, lub false. |
| IF-CLOSE-RATE-RULE-IDS | Optional | Ma wartość true, jeśli co najmniej 1 cena warunkowa jest niedostępna, ponieważ użytkownik nie spełnia wymagań, lub ma wartość false. Domyślnie jest to wartość true, jeśli podczas wyświetlania użytkownikowi wyświetliła się stawka prywatna
w interfejsie. |
| IF-DEFAULT-RATE | Optional | Ma wartość true, jeśli użytkownik kliknął wizytówkę z informacjami o hotelu, w której podano domyślne daty. W przeciwnym razie ma wartość false. |
| IF-HOTEL-CAMPAIGN | Optional | Ma 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 w przypadku partnerów, którzy mają w Google Ads wiele typów kampanii, aby przypisać atrybucję. |
| IF-PAYMENT-ID (tylko reklamy hoteli) | Recommended (if you use pay-per-stay Google Ads campaigns) | Ma stan true w przypadku hoteli w programie prowizji w ramach płatności za pobyt (PPS), w przeciwnym razie zmienia się na false. |
| IF-PROMO-CODE | Optional | Ma wartość true, jeśli użytkownik kliknął stawkę na podstawie promocji ARI lub reguły ceny z danym PromoCode. W przeciwnym razie zwraca wartość false. |
| IF-PROMOTED (tylko reklamy hoteli) | Recommended (if you use Promoted hotels) | Ma wartość true, jeśli użytkownik kliknął reklamę typu „promowanie obiektu” lub otwiera się jako false. |
| IF-RATE-RULE-ID | Optional | Ma wartość true, jeśli użytkownik wybrał cenę warunkową
, w przeciwnym razie ma wartość false. |
| IF-USER-LIST-ID (zdefiniowany w Google Ads) | Optional | Ma wartość true, jeśli użytkownik jest członkiem listy klientów Google Ads o identyfikatorze określonym przez Ciebie podczas ustawiania mnożników stawek dla list odbiorców. W przeciwnym razie ma wartość false. |
| IF-VERIFICATION | Optional | Ma wartość true, jeśli link został wygenerowany przez Google do testowania lub automatycznej weryfikacji, lub ma wartość false. |
| ELSE | Recommended (if you use any conditional IF statements) | Jeśli poprzedni warunek nie zostanie spełniony, do adresu URL zostaną wstawione wartości, które go spełniają. |
| 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) | Jest wykonywane jeden raz 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 IF-AD-CLICK
Możesz utworzyć blokadę warunkową, która będzie sprawdzać, czy użytkownik kliknął reklamę lub bezpłatny link do rezerwacji, aby przejść na Twoją stronę docelową.
Ten przykład korzysta z 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 użytkownik nie kliknął reklamy w tym przykładzie, wynik będzie wyglądał tak:
https://www.partner.com?hid=123&adType=0
Jeśli użytkownik kliknął reklamę, wynik będzie taki:
https://www.partner.com?hid=123&adType=1
Przykład IF-CLICK-TYPE-HOTEL
Możesz utworzyć blok warunkowy, który będzie sprawdzać, czy użytkownik wybrał hotel bez jawnego pakietu pokoi. Wartość elementu <RatePlanID> w bloku <Room Bundle> wiadomości dotyczącej transakcji zostanie ustawiona na domyślnie powiązaną cenę pakietu pokoi wybraną przez użytkownika.
Ten przykład korzysta z tej dyrektywy w pliku stron docelowych:
<URL>https://partner.com/(IF-CLICK-TYPE-HOTEL)landing(ELSE)landing_room(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>
Jeśli w tym przykładzie użytkownik wybierze pakiet pokoi, wynik będzie wyglądał tak:
https://partner.com/landing_room?hid=123
Jeśli użytkownik nie wybrał pakietu pokoi, wynik będzie taki:
https://partner.com/landing?hid=123
Przykład IF-CLICK-TYPE-ROOM
Możesz utworzyć blok warunkowy, który sprawdza, czy użytkownik wybrał grupę pomieszczeń.
Ten przykład korzysta z tej dyrektywy w pliku stron docelowych:
<URL>https://partner.com/(IF-CLICK-TYPE-ROOM)landing_room(ELSE)landing(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>
Jeśli w tym przykładzie użytkownik nie wybrał pakietu pokoi, wynik będzie taki:
https://partner.com/landing?hid=123
Jeśli użytkownik wybrał pakiet pokoi, wynik będzie wyglądał tak:
https://partner.com/landing_room?hid=123
Przykład IF-DEFAULT-DATE
Użyj instrukcji warunkowej IF-DEFAULT-DATE, aby ustawić parametr niebędący datą, który będzie wykorzystywany w Twojej witrynie do wywoływania niestandardowego zachowania, 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>
W tym przykładzie, jeśli użytkownik nie wybrał daty, wynik może być podobny do tego adresu URL z domyślnymi datami:
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 kampanii 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ę zainicjowaną w ramach kampanii reklam hoteli.
Ten przykład korzysta z 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 taki:
https://www.partner.com?hotelID=123&hotel_campaign=12345678
Jeśli kliknięcie nie dotyczy adresu URL kampanii reklam hoteli (np. w zwykłej kampanii w sieci wyszukiwania), wynik będzie taki:
https://www.partner.com?hotelID=123&utm_campaign=87654321
Jest to przydatne, gdy chcesz odróżniać ruch generowany przez kampanie reklam hoteli od kliknięć 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 ustawiona na pustą, jak w tym adresie URL:
https://www.partner.com?hotelID=123&hotel_campaign=
Aby uniknąć pustego identyfikatora kampanii, możesz użyć instrukcji warunkowej IF-AD-CLICK, 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 IF-PAYMENT-ID (tylko reklamy hoteli)
Użyj instrukcji warunkowej IF-PAYMENT-ID, aby zmieniać adres URL w zależności od tego, czy kliknięcie pochodzi z programu prowizji od PPS. Poniższy przykład pokazuje, czy kliknięcie pochodzi z programu prowizji od 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 jest częścią programu Prowizje, wynik będzie miał jeden z tych adresów URL:
- Jeśli do 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”.
Ten przykład korzysta z 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 wybierze reklamę typu „promowanie obiektu”, wynik będzie taki:
https://partner.com/1?hid=123
Jeśli użytkownik nie wybrał reklamy typu „promowanie obiektu”, wynik będzie wyglądał tak:
https://partner.com/0?hid=123
Przykład IF-RATE-RULE-ID
Możesz utworzyć blok warunkowy, który sprawdza, czy użytkownik wybrał cenę warunkową. Jeśli tak jest, używana jest wartość elementu <RateRuleID> z bloku <Rate> komunikatu transakcji.
Ten przykład korzysta z tej dyrektywy 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ł ceny warunkowej, wynik będzie taki:
https://www.partner.com?hid=123
Jeśli użytkownik wybrał cenę warunkową, wynik będzie taki:
https://www.partner.com?hid=123&customerType=42
Przykład 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ć właściwości IF-USER-LIST-ID w połączeniu z parametrem USER-LIST-ID, aby ustawić parametr w swojej witrynie dla klienta, który należy do określonej listy odbiorców Google Ads. Możesz to robić na potrzeby śledzenia lub do dostosowywania witryny 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>
Jeśli użytkownik nie był na liście odbiorców, w tym przykładzie wynik będzie taki:
https://www.partner.com?hid=123
Jeśli użytkownik był na liście odbiorców 12345678, wynik będzie taki:
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 testowania lub automatycznej weryfikacji, możesz użyć właściwości IF-VERIFICATION.
<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-VERIFICATION)&isgoogle=true(ENDIF)</URL>
Jeśli w tym przykładzie wyszukiwarka Google nie wygeneruje adresu URL do testowania lub weryfikacji, wynik będzie taki:
https://www.partner.com?hid=123
Jeśli adres URL został wygenerowany przez Google do testowania lub weryfikacji, wynik będzie taki:
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 wszystkich dzieci, zgodnie z informacjami w pliku danych o cenach hoteli.
Ten przykład korzysta z 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 obejmuje odpowiednio 2 osoby dorosłe i 2 dzieci w wieku od 0 do 17 lat, wynik będzie taki:
https://www.partner.com?adults=2&children=2&age=0_0age=1_17&hid=123
Jeśli plan podróży obejmuje 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 do adresu URL strony docelowej. Używanie zmiennych do przekazywania planu podróży i informacji o użytkownikach zasadniczo zwiększa jednak wygodę użytkowników i pomaga zachować zgodność z zasadami Google.
Podczas definiowania utworzonych adresów URL w pliku stron docelowych obowiązują te ogólne reguły:
Wszystkie zmienne są otoczone nawiasami otwierającymi i zamykającymi.
Parametry ciągu zapytania można przekazywać tylko po znaku zapytania („?”) w adresie URL.
Parametry ciągu zapytania w końcowych danych wyjściowych muszą być rozdzielone znakiem „&”. Ponieważ ampersand jest znakiem specjalnym w języku XML, a format pliku stron docelowych to XML. Musisz więc użyć zamiast niego zakodowanej encji „&". Końcowy wynik wyrenderuje 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ć znaki specjalne, które możesz umieścić w adresie URL strony docelowej. Na przykład:
- spacja („ ”): w elemencie
<URL>zastąp znaki spacji na „%20;” - ukośnik prawy („/”): zastąp ukośniki w elemencie
<URL>„%2F;”
Nie wszystkie znaki niealfabetyczne muszą być zakodowane w adresie URL. Na przykład łączniki („-”) nie muszą być zakodowane w adresie URL. Listę typowych znaków, które trzeba zakodować w adresach URL, znajdziesz w tabeli kodowania adresów URL.
- spacja („ ”): w elemencie
Wartości pojedynczego parametru mogą być tworzone na podstawie wielu zmiennych. Ten przykład tworzy pojedynczy parametr (
checkinDate) na podstawie zmiennychCHECKINDAY,CHECKINMONTHiCHECKINYEAR:<URL>https://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>W tym przykładzie możemy uzyskać 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żywać maksymalnie pięciu zmiennych niestandardowych.