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 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.

Omówienie

Adres URL strony docelowej definiujesz w pliku stron docelowych. Gdy wyświetla się reklama lub bezpłatny link 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>

W tych przykładach podano adres URL, który używa nazw zmiennych Google zamiast rzeczywistego identyfikatora hotelu i planu podróży:

Przykład 1

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

Przykład 2

<URL>https://www.partnerdomain.com/hotel/(PARTNER-HOTEL-ID)
  &amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)
  &amp;checkinYear=(CHECKINYEAR)&amp;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 zmiennym w sformułowaniu zapytania, zależą od odpowiednich danych w pliku danych o cenach hoteli, pliku danych o ofercie hoteli i ustawień 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 momencie rezerwacji. Na przykład: 36.
ALTERNATE-HOTEL-ID Recommended (if you have separate IDs to identify properties versus booking engines) Alternatywny identyfikator miejsca zakwaterowania. Ta nazwa atrybutu jest określona w pliku danych z listą hoteli. Oddzielne identyfikatory są przydatne, jeśli potrzebujesz jednego identyfikatora miejsca zakwaterowania do informacji w pliku danych, a drugiego do systemu rezerwacji online.
CAMPAIGN-ID Recommended Identyfikator kampanii Google Ads, którą chcesz powiązać z adresem URL. Ta kolumna jest pusta, 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 –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. Na przykład: 26.
CHECKOUTMONTH Recommended Dwucyfrowy numer miesiąca obliczony na podstawie elementów <Nights> i <Checkin> w pliku danych o cenach hoteli. Przykład: 05.
CHECKOUTYEAR Recommended Czterocyfrowy 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 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 pasażera-dziecka i wieku dziecka określonego w planie podróży. Chociaż nie jest to wymagane, zmiennej tej można używać tylko w połączeniu z blokiem warunkowym FOR-EACH-CHILD-AGE.
CLICK-TYPE Optional Wskazuje, czy użytkownik kliknął ofertę standardowego hotelu czy też pakietu z pokojem. Możliwe wartości:
  • hotel: użytkownik kliknął informacje o standardowej stawce za pokój.
  • room: użytkownik kliknął ofertę zestawu pokoi.
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:
  • default: użytkownik kliknął reklamę hotelu lub bezpłatny link do rezerwacji, w którym zostały użyte domyślne daty.
  • selected: użytkownik kliknął reklamę hotelu lub bezpłatny link do rezerwacji z ustawionymi datami.
GOOGLE-ADS-CLICK-SOURCE Optional Wskazuje, że źródłem kliknięcia była usługa Google Ads. Możliwe wartości:
  • bl: płatne linki do rezerwacji
  • tpa: Reklamy promujące podróże
  • tfsa: pliki danych o podróżach w reklamach w wyszukiwarce
  • pm: kampanie Performance Max lub Performance Max do celów związanych z podróżami.

    • 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:
  • localuniversal: użytkownik znalazł link do rezerwacji hotelu przez wyszukiwanie w usłudze google.com.
  • mapresults: użytkownik znalazł link do rezerwacji hotelu w usłudze maps.google.com.
  • verification: Google używa tej wartości do przeprowadzania w Twojej witrynie automatycznych testów jakości danych. Za te zapytania nie są naliczane opłaty. Google Analytics może wykorzystać ten parametr i jego wartość do identyfikowania ruchu związanego z automatyczną weryfikacją w Reklamach hoteli.
  • unknown: użytkownik znalazł reklamę lub bezpłatny link do rezerwacji w nieokreślonym źródle.
LENGTH Recommended Długość pobytu podana w liczbie nocy zdefiniowanej 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 pasażerów określona przez użytkownika w ramach planu podróży. Zmienne te muszą być używane razem z parametrami NUM-CHILDREN lub FOR-EACH-CHILD-AGE albo z obu naraz.
NUM-CHILDREN Recommended Liczba dzieci (w wieku 0–17 lat) podana w planie podróży przez użytkownika. Aby móc korzystać z planu podróży z dziećmi, wymagane jest posiadanie NUM-CHILDREN lub FOR-EACH-CHILD-AGE.
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ł, zalecamy używanie zasad NUM-ADULTS i NUM-CHILDREN.
PACKAGE-ID Recommended (applies if you use Room Bundles) Unikalny identyfikator pakietu w pliku danych z cenami hoteli. 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 to wartość elementu <RoomID> w bloku <Result>. W przypadku pakietu pokoi identyfikator pokoju to wartość przypisana do elementu <RoomID> w bloku <RoomBundle> lub <RoomData> w wiadomości o transakcji.
PAYMENT-ID Optional (only applies to Ads) zawiera 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 walucie lokalnej. Wartość atrybutu PRICE-DISPLAYED-TAX to wartość elementu <Tax> w pliku danych o cenach hoteli. Na przykład: „3.14”.
PRICE-DISPLAYED-TOTAL (Optional) Całkowity koszt pokoju wyświetlany użytkownikowi w jego walucie lokalnej. Wartość elementu PRICE-DISPLAYED-TOTAL to suma elementów <Baserate>, <Tax> i <OtherFees> z pliku danych z cenami hoteli. Przykład: „152.13”.
PROMO-CODE (Optional)

Jeśli używasz promocji ARI, wartość tej zmiennej jest przypisana do atrybutu id zastosowanego elementu <Promotion>. Jeśli masz wiele promocji, podaj listę identyfikatorów promocji rozdzielonych przecinkami w dowolnej kolejności.

Jeśli używasz reguł dotyczących stawek, wartość tej zmiennej jest przypisywana do elementu PromoCode po zastosowaniu odpowiedniej reguły dotyczącej ceny.
RATE-PLAN-ID Recommended (only applies if you use RoomBundles) Identyfikator zdefiniowany przez element <RatePlanID> w bloku <RoomBundle> pliku danych z cenami. Wartość<RatePlanID> to niepowtarzalny identyfikator kombinacji danych dotyczących pokoju i pakietu. Więcej informacji znajdziesz w artykule Pakiet sal.
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 artykule Stawki warunkowe.

Uwaga: wyświetlane są tylko stawki warunkowe i 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 lokalną walutę użytkownika. Wartość zmiennej USER-CURRENCY jest określana 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:
  • mobile
  • tablet
  • desktop
  • unknown

Wartość zmiennej USER-DEVICE jest ustalana na podstawie ustawień klienta użytkownika.
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 określana 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żytkownikach. Listy odbiorców służą do ustalania dostosowania stawek. Jeśli użytkownik znajduje się na wielu listach odbiorców, wybierana jest lista z największym dostosowaniem stawek. W przypadku identycznych wartości dostosowania stawek za odbiorców wybór jest dokonywany losowo.
VERIFICATION Optional Wartość logiczna, która potwierdza, czy link został wygenerowany przez Google na potrzeby 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

Aby warunkowo tworzyć punkty końcowe, możesz użyć specjalnych dyrektyw w elemencie <URL> pliku strony docelowej.

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 iteruje na podstawie liczby 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 Wartość true, jeśli co najmniej 1 stawka warunkowa była niedostępna, ponieważ użytkownik nie spełniał wymagań. W przeciwnym razie wartość to false. Domyślnie jest to true, jeśli użytkownikowi zostało wyświetlone UI dotyczące prywatnych stawek.
IF-DEFAULT-RATE Optional Wartość true, jeśli użytkownik kliknął stronę hotelu, w której podano domyślne daty, a w przeciwnym razie 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 dla partnerów, którzy mają w Google Ads wiele typów kampanii, aby przypisywać udział w konwersji.
IF-PAYMENT-ID (tylko reklamy hoteli) Recommended (if you use pay-per-stay Google Ads campaigns) Ma wartość true w przypadku hoteli uczestniczących w programie Prowizje (płatność za pobyt), a w pozostałych przypadkach ma wartość false.
IF-PROMO-CODE Optional Wartość true, jeśli użytkownik kliknął stawkę, która jest oparta na promocji ARI lub na regule dotyczącej stawki z danym PromoCode. W przeciwnym razie wartość to false.
IF-PROMOTED (dotyczy tylko reklam 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 Wartość true, jeśli użytkownik wybrał taryfę warunkową, w przeciwnym razie 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 Wartość true, jeśli link został wygenerowany przez Google na potrzeby testowania lub automatycznej weryfikacji. W przeciwnym razie 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 instrukcji warunkowej 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. element <OccupancyDetails> zawiera 2 elementy <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 sprawdza, czy użytkownik kliknął reklamę lub bezpłatny link do rezerwacji, aby przekierować go 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 wyglądał tak:

https://www.partner.com?hid=123&adType=0

Jeśli użytkownik kliknął reklamę, uzyskasz ten adres URL:

https://www.partner.com?hid=123&adType=1

Przykład warunku IF-CLICK-TYPE-HOTEL

Możesz utworzyć blok warunkowy, który sprawdza, czy użytkownik wybrał hotel bez wyraźnego pakietu pokoi. Wartość elementu <RatePlanID> w bloku <Room Bundle> wiadomości o transakcji zostanie ustawiona na wartość powiązanej z pakietem pokoju ceny, którą użytkownik wybrał w sposób domyślny.

Ten przykład wykorzystuje tę dyrektywę 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 wybrał zestaw pokoi, wynik będzie wyglądał tak: 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 warunku IF-CLICK-TYPE-ROOM

Możesz utworzyć blok warunkowy, który będzie sprawdzać, czy użytkownik wybrał grupę pomieszczeń.

Ten przykład wykorzystuje tę dyrektywę 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órego Twoja witryna może użyć do wywołania działania niestandardowego, jeśli użytkownik nie wybierze daty.

W tym przykładzie sprawdzamy, czy użyto daty domyślnej:

<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>

W tym przykładzie, jeśli użytkownik nie wybierze daty, wynik może być podobny do tego adresu URL, który zawiera domyślne daty:

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=1&popup_datepicker=true

Jeśli użytkownik wybrał datę, wynik może być podobny do tego adresu URL w zależności od wybranego planu podróży:

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=2&popup_datepicker=false

Przykład 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.

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:

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

Jeśli kliknięcie nie dotyczy adresu URL kampanii reklam hoteli (np. standardowej kampanii w sieci wyszukiwania), otrzymasz ten adres URL:

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

Jest to przydatne, gdy chcesz odróżnić ruch pochodzący z kampanii reklam hoteli od kliknięć innych rodzajów 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=

Możesz użyć instrukcji IF-AD-CLICK, aby zapobiec pustemu identyfikatorowi kampanii, jak 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 zmienić adres URL w zależności od tego, czy kliknięcie nastąpiło w ramach programu prowizji PPS. Przykład poniżej sprawdza, czy kliknięcie pochodzi z programu PPS, i na podstawie wyniku przypisuje wartość parametrowi booking_source:

<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, wynik będzie miał jeden z tych adresów URL:

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

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 kliknie reklamę typu „promowanie obiektu”, otrzyma ten adres URL:

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

Jeśli użytkownik nie wybrał reklamy typu „promowanie obiektu”, otrzymasz ten adres URL:

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)&amp;customerType=42(ELSE)(ENDIF)</URL>

W tym przykładzie, jeśli użytkownik nie wybrał stawki warunkowej, otrzyma ten adres URL:

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

Jeśli użytkownik wybrał stawkę warunkową, wynik będzie miał postać tego adresu URL:

https://www.partner.com?hid=123&customerType=42

Przykład IF-USER-LIST-ID (zdefiniowany 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 należącego 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)&amp;audience_list=(USER-LIST-ID)(ELSE)(ENDIF)</URL>

W tym przykładzie, jeśli użytkownik nie był członkiem listy odbiorców, otrzymasz ten adres URL:

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

Jeśli użytkownik należał do listy odbiorców 12345678, otrzymasz ten adres URL:

https://www.partner.com?hid=123&audience_list=12345678

Przykład instrukcji IF-VERIFICATION

Jeśli chcesz sprawdzić, czy Google wygenerował adres URL do testowania lub automatycznej walidacji, możesz użyć IF-VERIFICATION.

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

W tym przykładzie, jeśli Google nie wygeneruje adresu URL do testowania ani sprawdzania poprawności, otrzymasz ten adres URL:

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.

W tym przykładzie dyrektywa jest używana 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 w planie podróży są 2 osoby dorosłe i 2 dzieci w odpowiednio 0 i 17 roku życia, wynik to 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ło 2 osoby dorosłe i 0 dzieci, wynik to ten adres URL:

https://www.partner.com?adults=2&children=0&hid=123

Ogólne reguły tworzenia adresów URL

Wszystkie zmienne są opcjonalne. Nie musisz wstawiać żadnych zmiennych do adresu URL strony docelowej. Używanie zmiennych do przekazywania informacji o planie 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 zasady:

  • Wszystkie zmienne są otoczone nawiasami otwierającymi i zamykającymi.

  • Parametry ciągu zapytania w końcowych danych wyjściowych muszą być rozdzielone znakiem „&”. Ponieważ znak „&” jest znakiem specjalnym w XML, a format pliku stron docelowych to XML. Dlatego zamiast tego należy użyć zakodowanego elementu „&amp;”. Na wyjściu pojawi się rzeczywisty znak „&”. Na przykład:

    <!-- Do this: -->
<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&amp;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 („"”): zastąp spacje w elemencie <URL> znakiem „%20”.
    • ukośnik prawy („/”): w elemencie <URL> zastąp ukośniki prawe przez „%2F;”

    Nie wszystkie znaki niealfabetyczne muszą być zakodowane w formacie URL. Na przykład łączników (znaku „-”) nie trzeba kodować na potrzeby adresu URL. Listę typowych znaków, które muszą być zakodowane w formacie adresu URL, znajdziesz w sekcji Kodowanie adresów URL.

  • Wartości dla pojedynczego parametru można tworzyć z wielu zmiennych. W tym przykładzie tworzymy parametr checkinDate z użyciem zmiennych CHECKINDAY, CHECKINMONTH i CHECKINYEAR:

    <URL>https://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>

    W tym przykładzie adres URL może wyglądać tak:

    https://www.partnerdomain.com?checkinDate=7/23/1971

  • Nazwa parametrów ciągu zapytania może mieć dowolny identyfikator. 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.