Zmienne i warunki

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 utworzyć link, aby uwzględniać wszystkie dodatkowe informacje o użytkowniku i jego planie podróży. Przykład: Można podać takie informacje jak identyfikator hotelu, język, kody walut, i daty zameldowania w URL-u.

Omówienie

Adres URL strony docelowej określasz w pliku stron docelowych. Gdy reklama lub bezpłatne wyświetlany jest link do rezerwacji, informacje dynamiczne w adresie URL są zastępowane wartości rzeczywiste. Aby dodać wartości dynamiczne do adresów URL stron docelowych, użyj parametru ta składnia:

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

Poniższy przykład pokazuje adres URL z nazwami zmiennych Google zamiast rzeczywisty identyfikator hotelu i plan podróży:

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

Gdy tworzysz link do strony docelowej dla strony wyników wyszukiwania, Google zastępuje zmienne rzeczywistymi wartościami, by mieć pewność, że w adresie URL znajduje się parametr dynamiczne informacje. Jeśli na przykład użytkownik zarezerwuje salę na 6 nocy od 23 maja 2023 r. w przypadku hotelu nr 42 – Google renderuje poprzedni link w następujący 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 parametru odpowiednie dane 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 w powiązanym planie podróży. Podobnie wartość Zmienna PARTNER-HOTEL-ID jest zdefiniowana w elemencie <id> na liście hoteli Plik danych spełniający kryteria wyszukiwania użytkownika.

Niektóre zmienne są podzbiorami elementów pliku danych z cenami. Na przykład parametr Zmienne CHECKINDAY, CHECKINMONTH i CHECKINYEAR są wyodrębniane z metody pojedynczy element <Checkin> w pliku danych z cenami. Obliczane są inne zmienne na podstawie języka użytkownika i innych ustawień klienta.

Więcej informacji o źródłach wartości zmiennych znajdziesz tutaj: Cennik oraz Lista hoteli.

Zmienne adresów URL

W tabeli poniżej opisujemy dostępne zmienne, których możesz używać do utwórz URL strony docelowej:

Zmienna Zalecane/opcjonalne Opis
ADVANCE-BOOKING-WINDOW Optional Liczba dni przed datą zameldowania w 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. Nazwa atrybutu jest określone w pliku danych z listą hoteli. Posiadanie osobnych identyfikatorów jest przydatne, jeśli Potrzebny jest jeden identyfikator usługi dla informacji z pliku danych i drugi identyfikator usługi. identyfikatora usługi rezerwacji.
CAMPAIGN-ID Recommended Identyfikator kampanii Google Ads, którą chcesz powiązać z kampanią Adres URL. To pole jest puste, jeśli kliknięcie nie jest powiązane z Google Ads kampanii.
CHECKINDAY Recommended Dwucyfrowy dzień zdefiniowany w elemencie <Checkin> w pliku danych z cenami w hotelach. Na przykład: 20.
CHECKINDAY-OF-WEEK Optional Dzień tygodnia – od Monday do Sunday, w strefie czasowej hotelu. Przykład: Tuesday
CHECKINMONTH Recommended Dwucyfrowy miesiąc zdefiniowany w <Checkin> w pliku danych z cenami w hotelu. Na przykład: 05.
CHECKINYEAR Recommended Czterocyfrowy rok określony w <Checkin> w pliku danych z cenami w hotelu. Na przykład: 2023.
CHECKOUTDAY Recommended Dwucyfrowy dzień obliczony na podstawie <Nights> i Elementy <Checkin> w pliku danych z cenami hotelu. Dla: przykład: 26.
CHECKOUTMONTH Recommended Dwucyfrowy miesiąc obliczony na podstawie <Nights> i <Checkin> w pliku danych z cenami hotelu. Dla: przykład: 05.
CHECKOUTYEAR Recommended Czterocyfrowy rok obliczony na podstawie <Nights> i <Checkin> w pliku danych z cenami hotelu. Dla: przykład: 2023.
CHILD-AGE Recommended (must be provided for child occupancy pricing) Maksymalny wiek każdego dziecka określony w <Child "age"> pliku danych z cenami. Tej zmiennej należy używać w połączeniu z funkcją FOR-EACH-CHILD-AGE blok warunkowy.
CHILD-INDEX Optional zmienną pętli z indeksem 0 reprezentującą licznik dla każdego elementu podrzędnego. wiek użytkownika i dziecka określony w planie podróży. Nie jest obowiązkowe, tej zmiennej można używać tylko w połączeniu z funkcją FOR-EACH-CHILD-AGE blok warunkowy.
CLICK-TYPE Optional Wskazuje, czy użytkownik kliknął wizytówkę dotyczącą standardowego hotelu stawki lub pakietu pokojów. Możliwe wartości to:
  • hotel: użytkownik kliknął stronę aplikacji ze standardowym stawki za pokój.
  • room: użytkownik kliknął wizytówkę dotyczącą pokoju Pakiet.
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 zostały niedostępne, ale mogły być dostępne, gdyby użytkownik drobnych działań. Pamiętaj, że identyfikatory reguł dotyczących stawek dla ceny prywatne są zawsze wypełnione, gdy wyświetlane jest odpowiednie zdarzenie UI po stronie użytkownika.
CUSTOM[1-5] Optional Wartości pól niestandardowych zdefiniowanych w tabeli <Result> z limitem 200 znaków na pole niestandardowe. Więcej informacje można znaleźć w artykule Omówienie wiadomości o transakcjach. Pola niestandardowe są niedostępne, gdy używasz ARI
DATE-TYPE Optional Wskazuje, czy użytkownik wybrał datę domyślną czy określoną daty podanej w wyszukiwaniu. Możliwe wartości to:
  • default: użytkownik kliknął reklamę hotelu lub bezpłatny linku do rezerwacji, w którym wykorzystano domyślne daty.
  • selected: użytkownik kliknął reklamę hotelu lub bezpłatny link do rezerwacji z ustawionymi datami.
GOOGLE-SITE Optional Usługa Google, w której użytkownik wyświetlił dane o cenach Twoich hoteli. Możliwe wartości to:
  • localuniversal: użytkownik znalazł link do rezerwacji hotelu za pomocą wyszukiwania google.com.
  • mapresults: użytkownik znalazł link do rezerwacji hotelu do maps.google.com.
  • verification: Google używa tej wartości podczas wykonywania automatycznych testów jakości danych w witrynie. Za te zapytania nie są pobierane opłaty. Google Analytics może wykorzystać ten parametr i jego wartość do identyfikacji Reklamy hoteli – ruch w ramach automatycznej weryfikacji.
  • unknown: użytkownik znalazł reklamę lub bezpłatny link do rezerwacji. z nieokreślonego źródła.
LENGTH Recommended Długość pobytu w kontekście liczby nocy określonej przez Element <Nights> w pliku danych z cenami hotelu. Dla: 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 funkcją NUM-CHILDREN, FOR-EACH-CHILD-AGE lub oba.
NUM-CHILDREN Recommended Liczba dzieci (w wieku 0–17 lat) określona w plan podróży. NUM-CHILDREN, Aby wykonać tę czynność, wymagane jest pole FOR-EACH-CHILD-AGE lub oba uczestniczyć 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 dla plan podróży. Ta wartość to suma wartości NUM-ADULTS i NUM-CHILDREN. Do aby zmaksymalizować uczestnictwo, zdecydowanie zalecamy korzystanie z obu typów NUM-ADULTS i NUM-CHILDREN.
PACKAGE-ID Recommended (applies if you use Room Bundles) Unikalny identyfikator pakietu w pliku danych z cenami hotelu. Dla pakietu standardowego, to identyfikator pakietu to wartość atrybutu <PackageID> element w elemencie <Result> blokować. W przypadku pakietu pokojów identyfikatorem pakietu jest wartość atrybutu <PackageID> element w parametrze <RoomBundle> lub <PackageData> blokady komunikatu dotyczącego transakcji.
PARTNER-CURRENCY Optional Trzyliterowy kod waluty zdefiniowany przez Atrybut currency elementu <Baserate> w pliku danych z cenami w hotelu. 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. Dla standardowy, identyfikator pokoju jest wartością atrybutu <RoomID> element w elemencie <Result> blokować. W przypadku pakietu pokojów identyfikatorem pokoju jest wartość przypisana do <RoomID> element w parametrze <RoomBundle> lub <RoomData> blokady w komunikacie „Transakcja”.
PAYMENT-ID Optional (only applies to Ads) Przyjmuje wartość do wstępnie zdefiniowanego ciągu commission lub ciągu znaków Google przypisany numer IATA (np. „01234567”), jeśli korzystasz ze strategii Prowizje. agencji windykacyjnej. Aby zmienić formatowanie numeru IATA lub wstępnie zdefiniowanym ciągiem znaków, 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 jest wartością parametru <Tax> w pliku danych z cenami hotelu. Przykład: „3,14”.
PRICE-DISPLAYED-TOTAL (Optional) Łączny koszt pokoju wyświetlanej użytkownikowi w walucie lokalnej. Wartość PRICE-DISPLAYED-TOTAL to suma <Baserate>, <Tax> i <OtherFees> elementów z pliku danych z cenami hotelu. Przykład: „152.13”.
PROMO-CODE (Optional)

Jeśli używasz ARI promocje, wartość tej zmiennej jest przypisana do atrybutu id zastosowanego elementu <Promotion>. Jeśli jeśli zastosowano wiele promocji, powstaje lista rozdzielonych przecinkami identyfikatory promocji w dowolnej kolejności.

Jeśli używasz reguł dotyczących ceny, wartość tej zmiennej jest przypisywana do elementu PromoCode, jeśli zastosowano odpowiednią regułę dotyczącą ceny.

RATE-PLAN-ID Recommended (only applies if you use RoomBundles) Identyfikator określony przez element <RatePlanID> w Blokada <RoomBundle> pliku danych z cenami. <RatePlanID> to unikalny identyfikator dla kombinacji danych pokoju i pakietu. Więcej Więcej informacji można znaleźć w sekcji Pakiety pokojów.
RATE-RULE-ID Recommended (only applies if you use conditional rates or private rates) Identyfikator określony przez atrybut rate_rule_id w Blokada <Rate> pliku danych z cenami. Aby dowiedzieć się więcej, zapoznaj się z artykułem Ceny warunkowe.

Uwaga: tylko ceny warunkowe i prywatne które nie są ukryte.

USER-COUNTRY Recommended Dwuliterowy kodu kraju, który wskazuje lokalizację użytkownika. Ten informacje są pobierane z ustawień klienta. Dla: np. US lub FR.
USER-CURRENCY Recommended Trzyliterowy kod waluty, który wskazuje lokalną walutę użytkownika . Wartość zmiennej USER-CURRENCY to uzyskanych na podstawie ustawień klienta. Na przykład: USD lub CAD .
USER-DEVICE Recommended Typ urządzenia użytkownika. Wartość USER-DEVICE może mogą być następujące:
  • mobile
  • tablet
  • desktop
  • unknown

Wartość zmiennej USER-DEVICE jest ustalana na podstawie ustawienia klienta.

USER-LANGUAGE Recommended Dwuliterowy Kod języka ISO 639-1, który określa język wyświetlania reklama lub bezpłatny link do rezerwacji. Wartość atrybutu USER-LANGUAGE jest określana na podstawie ustawień klienta. 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 użytkownika. i informacjami o nich. Listy odbiorców są wykorzystywane jako podstawa ustalanie stawki . Jeśli użytkownik znajduje się na wielu listach odbiorców, parametr wybierana jest lista odbiorców z największym dostosowaniem stawek. Liczba równości odbiorcy z największym dostosowaniem stawek są wybierane losowo.
VERIFICATION Optional Wartość logiczna, która sprawdza, czy połączenie zostało wygenerowane przez Google dla witryny lub automatyczną weryfikację. Jeśli link został wygenerowany, ma wartość true. przez Google do testowania lub automatycznej weryfikacji. W przeciwnym razie jest to false.

Logika warunkowa w adresach URL

W elemencie <URL> pliku stron docelowych można używać specjalnych dyrektyw, aby: warunkowo kompilować punkty końcowe.

Logika warunkowa obsługuje te instrukcje:

  • if_statement: jeśli true, to wartości następujące po nim w adresie URL są wstawiane do adresu URL, w przeciwnym razie wartości następujące po parze Wstawiono dyrektywę ELSE.

  • for_statement: tworzy powtarzający się warunek pętli FOR na podstawie podanej liczby 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łatnej przez link do rezerwacji.
IF-CLICK-TYPE-HOTEL Optional Ma wartość true, jeśli użytkownik kliknął wizytówkę dotyczącą hotel, w przeciwnym razie ma postać false.
IF-CLICK-TYPE-ROOM Optional Ma wartość true, jeśli użytkownik kliknął wizytówkę dotyczącą Pakiet pokojów; w przeciwnym razie ma wartość false.
IF-CLOSE-RATE-RULE-IDS Optional Ma wartość true, jeśli co najmniej jedna cena warunkowa została niedostępny, ponieważ użytkownik nie spełniał warunków, w przeciwnym razie nazywa się false Domyślnie wartość true, jeśli cena prywatna Użytkownikowi wyświetliła się interfejs.
IF-DEFAULT-RATE Optional Ma wartość true, jeśli użytkownik kliknął wizytówkę hotelu. z używaną datą domyślną. W przeciwnym razie ma wartość false.
IF-HOTEL-CAMPAIGN Optional Ma wartość true, jeśli kliknięcie użytkownika pochodzi ze strony kampania reklam hoteli, w przeciwnym razie ma wartość false. Ten co jest przydatne w przypadku partnerów, którzy prowadzą wiele typów kampanii dostępnych w Google Ads, aby przypisać atrybucję.
IF-PAYMENT-ID (tylko reklamy hoteli) Recommended (if you use pay-per-stay Google Ads campaigns) Przechodzi na true w przypadku hoteli w modelu płatności za pobyt w innym przypadku program prowizji zmieni się na false.
IF-PROMO-CODE Optional Ma wartość true, jeśli użytkownik kliknął cenę, która jest na podstawie promocji ARI lub reguły dotyczącej ceny z określoną wartością PromoCode; w przeciwnym razie zmienia się na false.
IF-PROMOTED (tylko reklamy hoteli) Recommended (if you use Promoted hotels) Ma wartość true, jeśli użytkownik kliknął usługę Reklama promocyjna, w przeciwnym razie ma adres false.
IF-RATE-RULE-ID Optional Ma wartość true, jeśli użytkownik wybrał cena warunkowa , w przeciwnym razie zmieni się na false.
IF-USER-LIST-ID (zdefiniowany w Google Ads) Optional Ma wartość true, jeśli użytkownik jest członkiem Google Ads identyfikator listy klientów podany podczas ustawiania mnożników stawek dla odbiorców listy, w przeciwnym razie ma postać false.
IF-VERIFICATION Optional Ma wartość true, jeśli link został wygenerowany przez Google dla witryny lub automatyczną weryfikację. W przeciwnym razie wynik zmieni się na false.
ELSE Recommended (if you use any conditional IF statements) Jeśli poprzedni warunek nie zostanie spełniony, wartości następujące po nim są wstawiane do adresu URL.
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 raz dla każdego <Child "age"> w pliku danych z cenami. Dla: jeśli na przykład <OccupancyDetails> zawierają 2 elementy elementów <Child age="17"> i <Child age= "17">, dyrektywa jest wykonywana 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ć blok warunkowy, który będzie sprawdzać, czy użytkownik kliknął reklamę bezpłatny link do rezerwacji przekierowujący na stronę docelową.

Ten przykład korzysta z tej dyrektywy w pliku strony docelowej:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-AD-CLICK)&amp;adType=1(ELSE)&amp;adType=0(ENDIF)</URL>

Jeśli użytkownik nie kliknął reklamy, w tym przykładzie wynik będzie taki: Adres URL:

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 sprawdza, czy użytkownik wybrał hotel bez jasno określonego zestawu pokoi. Wartość elementu <RatePlanID> w parametrze Blok <Room Bundle> komunikatu transakcji zostanie ustawiony na domyślnie powiązanej ceny pakietu pokoi wybranej 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 wybrał pakiet pokoi, wynik będzie taki: Adres URL:

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 będzie sprawdzać, czy użytkownik wybrał pokój Pakiet.

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: ten adres URL:

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 inny niż data, który może zostać użyta do wywołania niestandardowego zachowania, jeśli użytkownik datę.

Ten przykład pozwala sprawdzić, czy została użyta data domyślna:

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)<strong>(IF-DEFAULT-DATE)</strong>&amp;popup_datepicker=true(ELSE)&amp;popup_datepicker=false(ENDIF)</URL>

Jeśli użytkownik nie wybrał daty w tym przykładzie, wynik może być podobny. pod następujący adres URL, który zawiera domyślne opcje 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 kampanii IF-HOTEL-CAMPAIGN (kliknięcia reklam hoteli i bezpłatnych linków do rezerwacji)

Możesz utworzyć blok warunkowy, który będzie sprawdzać, czy użytkownik kliknął reklamę pochodzi z 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)&amp;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, następujący adres URL:

https://www.partner.com?hotelID=123&hotel_campaign=12345678

Jeśli kliknięcie nie pochodzi z adresu URL kampanii reklam hoteli (np. w zwykłej kampanii w sieci wyszukiwania), wynik to następujący URL:

https://www.partner.com?hotelID=123&utm_campaign=87654321

Jest to przydatne, gdy chcesz rozróżniać ruch generowany przez kliknięcia z kampanii reklam hoteli przed innymi kliknięciami.

Puste identyfikatory CAMPAIGN-ID z kliknięciami FBL

Jeśli kliknięcie pochodzi z bezpłatnego linku do rezerwacji, IF-HOTEL-CAMPAIGN zwraca Wartości TRUE i CAMPAIGN-ID są ustawione jako puste, 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 w tym przykładzie:

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)(IF-AD-CLICK)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)&amp;FreeBookingLink(ENDIF)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

Przykład IF-PAYMENT-ID (tylko reklamy hoteli)

Użyj instrukcji warunkowej IF-PAYMENT-ID, aby zmieniać adresy URL w zależności od tego, czy kliknięcie ma związek z programem prowizji od PPS. Przykład poniżej sprawdza, czy kliknięcie pochodzi z programu prowizji PPS, i przypisuje wartość do parametr booking_source na podstawie wyniku:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)&amp;booking_source=(IF-PAYMENT-ID)(PAYMENT-ID)(ELSE)cpc(ENDIF)</URL>

Jeśli hotel jest częścią programu Prowizje, w wynikach wyszukiwania pojawi się jedna z następujące adresy URL:

  • Jeśli do Google nie ma przypisanego numeru IATA:
    https://partner.com?hid=123&amp;booking_source=commissions
  • Jeśli numer IATA został przypisany do Google:
    https://partner.com?hid=123&amp;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 będzie sprawdzać, czy użytkownik kliknął Reklama 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>

Jeśli użytkownik wybierze reklamę typu „promowanie obiektu” to następujący adres URL:

https://partner.com/1?hid=123

Jeśli użytkownik nie wybrał reklamy typu „promowanie obiektu”, w wynikach wyszukiwania pojawi się następujący adres URL:

https://partner.com/0?hid=123

Przykład IF-RATE-RULE-ID

Możesz utworzyć blok warunkowy, który będzie sprawdzać, czy użytkownik wybrał stopa warunkowa, a jeśli tak jest, wartość <RateRuleID> jest używany element w 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)&amp;customerType=42(ELSE)(ENDIF)</URL>

Jeśli użytkownik nie wybrał ceny warunkowej w tym przykładzie, wynik będzie taki: ten adres URL:

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ć IF-USER-LIST-ID w połączeniu z USER-LIST-ID, aby ustawić w witrynie w przypadku klienta należącego do określonego konta Google Ads listę odbiorców. Można to zrobić dla celów śledzenia lub w celu dostosowania wśród osób z list odbiorców.

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-USER-LIST-ID)&amp;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: ten adres URL:

https://www.partner.com?hid=123

Jeśli użytkownik był na liście odbiorców 12345678, wynik będzie taki: ten adres URL:

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 automatycznego możesz użyć funkcji IF-VERIFICATION.

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-VERIFICATION)&amp;isgoogle=true(ENDIF)</URL>

Jeśli w tym przykładzie Google nie wygeneruje adresu URL do testowania lub walidacji, wynik będzie taki:

https://www.partner.com?hid=123

Jeśli adres URL został wygenerowany przez Google do testowania lub weryfikacji, wynikiem jest następujący adres URL:

https://www.partner.com?hid=123&isgoogle=true

Przykład FOR-EACH-CHILD-AGE

Możesz utworzyć blok warunkowy, który wypełnia maksymalny wiek każdego dzieci, zgodnie z danymi w pliku danych z cenami hoteli.

Ten przykład korzysta z tej dyrektywy w pliku stron docelowych:

<URL>https://partner.com?adults=(NUM-ADULTS)&amp;children=(NUM-CHILDREN)(FOR-EACH-CHILD-AGE)&amp;age=(CHILD-INDEX)_(CHILD-AGE)(END-FOR-EACH)&amp;hid=(PARTNER-HOTEL-ID)&amp;</URL>

W tym przykładzie, jeśli plan podróży obejmuje 2 osoby dorosłe i 2 dzieci w wieku 0 i 17 lat wynik będzie wyglądać tak:

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 jest taki: Adres URL:

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. Jednak korzystanie ze zmiennych w celu przesyłania planu podróży i użytkownika zawarte w nich informacje zwiększają wygodę użytkownika i pomagają zgodność z zasadami Google.

Podczas definiowania utworzonych adresów URL na stronie docelowej obowiązują te ogólne reguły. plik z adresami stron docelowych:

  • 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 muszą być rozdzielone znakiem „&” w tagu efekt końcowy. Ponieważ ampersand jest znakiem specjalnym w kodzie XML, a makro format pliku stron docelowych to XML. Musisz więc użyć zakodowanego elementu „&amp;” . Końcowy wynik wyrenderuje rzeczywisty znak „&” znaku. 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>
    

    W adresie URL musisz też zakodować znaki specjalne, które można umieścić w adresu URL strony docelowej. Na przykład:

    • spacja (" "): zastąp znaki spacji na „%20;”. w elemencie <URL>
    • ukośnik prawy („/”): zastąp ukośniki „%2F”; <URL> element

    Nie wszystkie znaki niealfabetyczne muszą być zakodowane w adresie URL. Przykład: łączniki („-”) nie muszą być zakodowane na potrzeby adresu URL. Lista popularnych muszą być zakodowane w adresie URL. Tabela kodowania URL.

  • Wartości pojedynczego parametru mogą być tworzone na podstawie wielu zmiennych. tego przykładu tworzy się pojedynczy parametr, checkinDate, na podstawie Zmienne CHECKINDAY, CHECKINMONTH i CHECKINYEAR:

    <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/1971
    
  • Jako nazwy parametrów ciągu zapytania możesz użyć dowolnego identyfikatora. Twój serwer przetwarza te wartości. Przekazywane wartości są jednak ograniczone do listę dostępnych zmiennych.

  • Oprócz listy dostępnych zmiennych możesz używać maksymalnie pięciu zmiennych niestandardowych. zmiennych.