Variabili e condizioni

Hotel Ads e link di prenotazione gratuiti includono link a pagine di destinazione in cui gli utenti possono prenotare stanze. Puoi definire la modalità con cui Google genera il link affinché includa tutte le informazioni aggiuntive sull'utente e sul suo itinerario. Ad esempio, puoi includere nell'URL informazioni come l'ID dell'hotel, la lingua, i codici valuta e le date di check-in.

Panoramica

Devi definire l'URL pagina di destinazione nel file delle pagine di destinazione. Quando viene visualizzato l'annuncio o il link di prenotazione gratuito, le informazioni dinamiche nell'URL vengono sostituite con i valori effettivi. Per aggiungere valori dinamici agli URL pagina di destinazione, utilizza i campi la seguente sintassi:

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

I seguenti esempi mostrano un URL che utilizza i nomi delle variabili di Google anziché ID e itinerario effettivi dell'hotel:

Esempio 1

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

Esempio 2

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

Quando viene creato il link della pagina di destinazione per la pagina dei risultati di ricerca, Google sostituisce le variabili con i valori effettivi per assicurarsi che l'URL includa le informazioni dinamiche. Ad esempio, se l'utente prenota una stanza per 6 notti a partire dal 23/5/2023 per l'hotel 42. Google esegue il rendering del link precedente come segue:

https://www.partnerdomain.com?hotelID=42&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=6

I valori che Google assegna alle variabili nella stringa di query dipendono dai dati corrispondenti nei tuoi feed prezzo dell'hotel, feed elenco hotel e impostazioni utente.

Ad esempio,il valore della variabile LENGTH viene assegnato all'elemento <Nights> dal feed del prezzo dell'itinerario correlato. Analogamente, il valore La variabile PARTNER-HOTEL-ID è definita nell'elemento <id> dell'elenco di hotel Feed corrispondente ai criteri di ricerca dell'utente.

Alcune variabili sono sottoinsiemi di elementi del feed del prezzo. Ad esempio, Le variabili CHECKINDAY, CHECKINMONTH e CHECKINYEAR vengono estratte dalla singolo elemento <Checkin> nel feed del prezzo. Altre variabili vengono calcolate sulla base delle impostazioni internazionali dell'utente e di altre impostazioni del client.

Per ulteriori informazioni sull'origine dei valori delle variabili, consulta Panoramica dei prezzi e Elenco hotel.

Variabili URL

La seguente tabella descrive le variabili disponibili che puoi utilizzare per crea l'URL pagina di destinazione:

Variabile Consigliata/facoltativa Descrizione
ADVANCE-BOOKING-WINDOW Optional Il numero di giorni per la prenotazione anticipata prima della data del check-in nel fuso orario dell'hotel al momento della prenotazione. Ad esempio, 36.
ALTERNATE-HOTEL-ID Recommended (if you have separate IDs to identify properties versus booking engines) Un identificatore alternativo per la tua proprietà. Questo nome dell'attributo sia specificato nel tuo feed elenco hotel. La presenza di ID separati è utile se hai bisogno di un identificatore di proprietà per le informazioni del feed e di un altro identificatore di proprietà per il motore di prenotazione.
CAMPAIGN-ID Recommended L'ID della campagna Google Ads da associare al URL. Questo campo è vuoto se il clic non è associato a un account Google Ads. campagna.
CHECKINDAY Recommended Il giorno di due cifre definito nell'elemento <Checkin> del feed prezzo dell'hotel. Ad esempio, 20.
CHECKINDAY-OF-WEEK Optional Il giorno della settimana (da Monday a Sunday) in cui avviene il check-in, nel fuso orario dell'hotel. Ad esempio, Tuesday.
CHECKINMONTH Recommended Il mese di due cifre definito in <Checkin> del feed prezzo dell'hotel. Ad esempio, 05.
CHECKINYEAR Recommended L'anno di quattro cifre definito in <Checkin> del feed prezzo dell'hotel. Ad esempio, 2023.
CHECKOUTDAY Recommended Il giorno di due cifre calcolato dagli elementi <Nights> e <Checkin> del feed prezzo dell'hotel. Per ad esempio 26.
CHECKOUTMONTH Recommended Il mese di due cifre calcolato dagli elementi <Nights> e <Checkin> del feed prezzo dell'hotel. Ad esempio, 05.
CHECKOUTYEAR Recommended L'anno a quattro cifre calcolato dagli elementi <Nights> e <Checkin> del feed prezzo dell'hotel. Ad esempio, 2023.
CHILD-AGE Recommended (must be provided for child occupancy pricing) L'età massima di ogni bambino, come specificato nella <Child "age"> del feed del prezzo. Questa variabile deve essere utilizzata insieme a un Blocco condizionale FOR-EACH-CHILD-AGE.
CHILD-INDEX Optional Una variabile di loop con indice 0 che rappresenta un contatore per ogni bambino ed età del bambino specificati nell'itinerario. Sebbene non lo sia obbligatoria, questa variabile può essere utilizzata solo insieme a Blocco condizionale FOR-EACH-CHILD-AGE.
CLICK-TYPE Optional Indica se l'utente ha fatto clic sulla scheda per una tariffa standard dell'hotel o per un pacchetto camera. I valori possibili sono:
  • hotel: l'utente ha fatto clic sulla scheda per una tariffa della camera standard.
  • room: l'utente ha fatto clic sulla scheda di un pacchetto camera.
CLOSE-RATE-RULE-IDS Optional (only applies if you are using conditional or private rates) Un elenco separato da virgole di ID regole tariffarie per le tariffe che sono state non era disponibile, ma avrebbe potuto essere disponibile se l'utente avesse seguito una piccola azione. Tieni presente che gli ID delle regole tariffarie per tariffe private vengono sempre compilati qui quando viene mostrata una variante di interfaccia utente corrispondente all'utente.
CUSTOM[1-5] Optional I valori per i campi personalizzati definiti nella sezione <Result>. con un limite di 200 caratteri per campo personalizzato. Per maggiori informazioni informazioni, fai riferimento Panoramica dei messaggi Transaction. I campi personalizzati non sono disponibili quando si utilizzano ARI.
DATE-TYPE Optional Indica se l'utente ha selezionato la data predefinita o una data specifica data specificata nella ricerca. I valori possibili sono:
  • default: l'utente ha fatto clic su un annuncio per hotel o su un link di prenotazione gratuito in cui erano utilizzate le date predefinite.
  • selected: l'utente ha fatto clic su un annuncio per hotel o su un link di prenotazione gratuito con le date impostate.
GOOGLE-ADS-CLICK-SOURCE Optional Indica che Google Ads è stato l'origine del clic. I valori possibili sono:
  • bl: Link di prenotazione a pagamento
  • tpa: Annunci di promozioni per viaggi
  • tfsa: feed viaggi negli annunci della rete di ricerca
  • pm: Performance Max o Performance Max per gli obiettivi di viaggio Campagne con obiettivi.
  • Nota: se il clic proviene da Ricerca Google anziché Google Ads, questo parametro è vuoto

GOOGLE-SITE Optional La proprietà Google su cui un utente ha visualizzato i dati sui prezzi degli hotel. I valori possibili sono:
  • localuniversal: l'utente ha trovato il link di prenotazione dell'hotel mediante ricerca google.com.
  • mapresults: l'utente ha trovato il link di prenotazione dell'hotel tramitemaps.google.com.
  • verification: Google utilizza questo valore durante l'esecuzione test automatici sulla qualità dei dati sul tuo sito. Non ti viene addebitato alcun costo queste query. Google Analytics può utilizzare questo parametro e il relativo valore per identificare il traffico di verifica automatica di Hotel Ads.
  • unknown: l'utente ha trovato l'annuncio o il link di prenotazione gratuito da una fonte indeterminata.
LENGTH Recommended La durata del soggiorno in termini di numero di notti definito dall'elemento <Nights> nel feed prezzo dell'hotel. Ad esempio, 3.
NUM-ADULTS Recommended (must be used with the NUM-CHILDREN or FOR-EACH-CHILD-AGE condition) Il numero di adulti specificato dall'utente per l'itinerario. Questa variabile deve essere utilizzata insieme a NUM-CHILDREN, FOR-EACH-CHILD-AGE o entrambe.
NUM-CHILDREN Recommended Il numero di bambini (da 0 a 17 anni) specificato nell' itinerario dall'utente. Le variabili NUM-CHILDREN, FOR-EACH-CHILD-AGE o entrambe sono obbligatorie per partecipare correttamente agli itinerari con bambini.
NUM-GUESTS Recommended (if you don't send child occupancy pricing) Il numero totale di persone, adulti e bambini, specificato per l'itinerario dall'utente. Questo valore è la somma dei Valori di NUM-ADULTS e NUM-CHILDREN. Per massimizzare la partecipazione, ti consigliamo vivamente di utilizzare sia NUM-ADULTS che NUM-CHILDREN.
PACKAGE-ID Recommended (applies if you use Room Bundles) L'identificatore univoco del pacchetto nel feed prezzo dell'hotel. Per un pacchetto standard, l'ID pacchetto è il valore dell'elemento <PackageID> all'interno di un blocco <Result>. Per un pacchetto camera, l'ID pacchetto è il valore dell'elemento <PackageID> all'interno dei blocchi <RoomBundle> o <PackageData> del messaggio Transaction.
PARTNER-CURRENCY Optional Il codice valuta di tre lettere definito dal Attributo currency dell'elemento <Baserate> nel feed prezzo dell'hotel. Ad esempio, USD o CAD .
PARTNER-HOTEL-ID Recommended L'identificatore univoco dell'hotel definito dal Elemento <id> nel feed elenco hotel.
PARTNER-ROOM-ID Recommended (applies if you use Room Bundles) L'identificatore univoco della camera nel feed prezzo dell'hotel. Per un camera standard, l'ID della camera è un valore del Elemento <RoomID> all'interno di <Result> bloccare. Per un pacchetto camera, l'ID camera è il valore assegnato all'elemento <RoomID> all'interno dei blocchi <RoomBundle> o <RoomData> nel messaggio Transaction.
PAYMENT-ID Optional (only applies to Ads) Restituisce una stringa predefinita commission o numero IATA assegnato (ad esempio, "01234567"), se utilizzi un account un'agenzia di recupero crediti. Per modificare la formattazione del numero IATA o della stringa predefinita, contatta il Technical Account Manager (TAM).
PRICE-DISPLAYED-TAX (Optional) L'importo dell'imposta mostrato all'utente nella sua valuta locale. Il valore della variabile PRICE-DISPLAYED-TAX è il valore dell'elemento <Tax> nel feed prezzo dell'hotel. Ad esempio, "3,14".
PRICE-DISPLAYED-TOTAL (Optional) Il costo totale della camera che viene mostrato all'utente nella sua valuta locale. Il valore di PRICE-DISPLAYED-TOTAL è somma di <Baserate>, <Tax> e <OtherFees> elementi dal feed prezzo dell'hotel. Ad esempio, "152,13".
PROMO-CODE (Optional)

Se utilizzi ARI promozioni, il valore di questa variabile viene assegnato all'attributo id dell'elemento <Promotion> applicato. Se vengono applicate più promozioni, si tratta di un elenco separato da virgole di ID promozione in ordine arbitrario.

Se utilizzi le regole tariffarie, il valore di questa variabile viene assegnato all'elemento PromoCode se viene applicata la regola tariffaria corrispondente.

RATE-PLAN-ID Recommended (only applies if you use RoomBundles) L'ID come definito dall'elemento <RatePlanID> in una blocco <RoomBundle> del feed del prezzo. L'elemento <RatePlanID> rappresenta l'identificatore univoco di una combinazione di dati di camera e pacchetto. Per ulteriori informazioni, consulta la sezione Pacchetti camera.
RATE-RULE-ID Recommended (only applies if you use conditional rates or private rates) L'ID come definito dall'attributo rate_rule_id in un blocco <Rate> del feed del prezzo. Per ulteriori informazioni, consulta la sezione Tariffe agevolate.

Nota: vengono mostrate solo le tariffe agevolate o private che non sono nascoste.

USER-COUNTRY Recommended Un file di due lettere codice paese che indica la località dell'utente. Questo estratte dalle impostazioni del client dell'utente. Ad esempio, US o FR.
USER-CURRENCY Recommended Un codice valuta di tre lettere che indica la valuta locale dell'utente. valuta. Il valore della variabile USER-CURRENCY viene dedotto dalle impostazioni del client dell'utente. Ad esempio, USD o CAD .
USER-DEVICE Recommended Il tipo di dispositivo dell'utente. Il valore di USER-DEVICE può essere uno dei seguenti:
  • mobile
  • tablet
  • desktop
  • unknown

Il valore della variabile USER-DEVICE viene dedotto dalle impostazioni del client dell'utente.

USER-LANGUAGE Recommended Un codice lingua ISO 639-1 di due lettere che specifica la lingua di visualizzazione dell'annuncio o del link di prenotazione gratuito. Il valore dell'attributo USER-LANGUAGE viene dedotta dalle impostazioni del client dell'utente. Ad esempio: en o fr.
USER-LIST-ID (definita in Google Ads) Optional (only applies if you use Audience Lists in Google Ads) L'ID elenco utenti di Google Ads che contiene l'elenco del segmento di pubblico o l'utente informazioni. Gli elenchi dei segmenti di pubblico vengono utilizzati come base per impostare gli aggiustamenti delle offerte. Se l'utente fa parte di più elenchi dei segmenti di pubblico, viene selezionato l'elenco del segmento di pubblico con l'aggiustamento delle offerte più grande. Parità tra i segmenti di pubblico con l'aggiustamento delle offerte più elevato vengono decisi in modo casuale.
VERIFICATION Optional Un valore booleano che verifica se il link è stato generato da Google per test o convalida automatica. È true se il link è stato generato da Google per i test o la convalida automatica, altrimenti è false.

Logica condizionale negli URL

Puoi utilizzare istruzioni speciali nell'elemento <URL> di un file delle pagine di destinazione per creare endpoint in modo condizionale.

La logica condizionale supporta le seguenti istruzioni:

  • if_statement: se true, vengono utilizzati i valori che seguono vengono inseriti nell'URL, altrimenti i valori che seguono ELSE.

  • for_statement: crea una condizione di loop FOR che esegue l'iterazione in base al numero di valori specificato.

Le istruzioni IF e FOR includono quanto segue:

Condizione Consigliata/facoltativa Descrizione
IF-AD-CLICK (solo Hotel Ads) Optional Restituisce true se il clic dell'utente proviene da un annuncio. Restituisce false se il clic dell'utente ha avuto origine da un link di prenotazione.
IF-CLICK-TYPE-HOTEL Optional Restituisce true se l'utente ha fatto clic su una scheda per un hotel, altrimenti restituisce false.
IF-CLICK-TYPE-ROOM Optional Restituisce true se un utente ha fatto clic su una scheda per Pacchetto camera, altrimenti viene risolto in false.
IF-CLOSE-RATE-RULE-IDS Optional Restituisce true se una o più tariffe agevolate non erano disponibili perché l'utente non era idoneo; altrimenti restituisce false. Per impostazione predefinita, truese tariffa privata All'utente è stato mostrato il trattamento di interfaccia utente.
IF-DEFAULT-RATE Optional Restituisce true se l'utente ha fatto clic sulla scheda di un hotel in cui erano utilizzate date predefinite; altrimenti restituisce false.
IF-HOTEL-CAMPAIGN Optional Restituisce true se il clic dell'utente ha avuto origine da un campagna per hotel, altrimenti si risolve in false. Questo la distinzione è utile per i partner che dispongono di più tipi di campagna. presenti in Google Ads per assegnare l'attribuzione.
IF-PAYMENT-ID (solo Hotel Ads) Recommended (if you use pay-per-stay Google Ads campaigns) Restituisce true per gli hotel che fanno parte del programma di commissioni Pay-Per-Stay (PPS), altrimenti restituisce false.
IF-PROMO-CODE Optional Restituisce true se l'utente ha fatto clic su una tariffa basata su una promozione ARI o su una regola tariffaria con un determinato PromoCode; altrimenti restituisce false.
IF-PROMOTED (solo Hotel Ads) Recommended (if you use Promoted hotels) Restituisce true se l'utente ha fatto clic su un annuncio per la promozione di proprietà; altrimenti restituisce false.
IF-RATE-RULE-ID Optional Restituisce true se l'utente ha selezionato una tariffa agevolata , altrimenti restituisce false.
IF-USER-LIST-ID (definita in Google Ads) Optional Restituisce true se l'utente è membro di un ID elenco clienti Google Ads specificato al momento di impostare i moltiplicatori di offerta per gli elenchi dei segmenti di pubblico; altrimenti restituisce false.
IF-VERIFICATION Optional Restituisce true se il link è stato generato da Google per i test o la convalida automatica, altrimenti restituisce false.
ELSE Recommended (if you use any conditional IF statements) Se la condizione precedente non è soddisfatta, i valori che seguono questa condizione vengono inseriti nell'URL.
END-IF Optional (required if you have any IF conditional statements) Termina il blocco condizionale dell'istruzione IF.
FOR-EACH-CHILD-AGE Optional (required for child occupancy pricing) Viene eseguita una volta per ogni elemento <Child "age"> nel feed del prezzo. Ad esempio, se <OccupancyDetails> include i due elementi <Child age="17"> e <Child age= "17">, l'istruzione viene eseguita due volte.
END-FOR-EACH Optional (required if using FOR-EACH block) Termina il blocco condizionale dell'istruzione FOR-EACH.

Esempio di IF-AD-CLICK

Puoi creare un blocco condizionale per verificare se l'utente ha fatto clic su un annuncio o un link di prenotazione gratuito per eseguire il reindirizzamento alla tua pagina di destinazione.

L'esempio seguente utilizza questa istruzione in un file delle pagine di destinazione:

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

In questo esempio, se l'utente non ha fatto clic su un annuncio, il risultato è il seguente URL:

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

Se l'utente ha fatto clic sull'annuncio, il risultato è il seguente URL:

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

Esempio di IF-CLICK-TYPE-HOTEL

Puoi creare un blocco condizionale per verificare se l'utente ha selezionato un hotel senza un pacchetto camera esplicito. Il valore dell'elemento <RatePlanID> nel <Room Bundle> blocco di un messaggio Transaction sarà impostato sul tipo di attribuzione implicitamente prezzo del pacchetto camera associato selezionato dall'utente.

L'esempio seguente utilizza questa istruzione in un file delle pagine di destinazione:

<URL>https://partner.com/(IF-CLICK-TYPE-HOTEL)landing(ELSE)landing_room(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

In questo esempio, se l'utente ha selezionato un pacchetto camera, il risultato è il seguente URL:

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

Se l'utente non ha selezionato un pacchetto camera, il risultato è il seguente URL:

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

Esempio di IF-CLICK-TYPE-ROOM

Puoi creare un blocco condizionale per verificare se l'utente ha selezionato una stanza Pacchetto.

L'esempio seguente utilizza questa istruzione in un file delle pagine di destinazione:

<URL>https://partner.com/(IF-CLICK-TYPE-ROOM)landing_room(ELSE)landing(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

In questo esempio, se l'utente non ha selezionato un pacchetto camera, il risultato è il seguente URL:

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

Se l'utente ha selezionato un pacchetto camera, il risultato è il seguente URL:

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

Esempio di IF-DEFAULT-DATE

Utilizza l'istruzione condizionale IF-DEFAULT-DATE per impostare un parametro diverso dalla data, che il tuo sito web può poi utilizzare per attivare un comportamento personalizzato se l'utente non ha selezionato una data.

L'esempio seguente verifica se è stata utilizzata la data predefinita:

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

In questo esempio, se l'utente non ha selezionato una data, il risultato potrebbe essere simile al seguente URL che mostra le selezioni di date predefinite:

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

Se l'utente ha selezionato una data, il risultato potrebbe essere simile al seguente URL: a seconda dell'itinerario selezionato:

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

Esempio di IF-HOTEL-CAMPAIGN (clic su annunci per hotel e link di prenotazione gratuiti)

Puoi creare un blocco condizionale per verificare se l'utente ha fatto clic su un annuncio che ha avuto origine da una campagna per hotel.

L'esempio seguente utilizza questa istruzione in un file delle pagine di destinazione:

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

In questo esempio, se l'utente fa clic sull'URL di una campagna per hotel, il risultato è il seguente URL:

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

Se il clic non proviene dall'URL di una campagna per hotel (ad es. una normale campagna sulla rete di ricerca), il risultato è il seguente URL:

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

Ciò è utile quando vuoi distinguere il traffico dei clic sulle campagne per hotel da qualsiasi altro clic.

ID CAMPAIGN vuoti con clic FBL

Se il clic proviene da un link di prenotazione gratuito, IF-HOTEL-CAMPAIGN restituisce Il valore di TRUE e CAMPAIGN-ID è impostato su vuoto come mostrato nell'URL seguente:

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

Puoi utilizzare l'istruzione condizionale IF-AD-CLICK per evitare un ID campagna vuoto, ad esempio come mostrato nell'esempio seguente:

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

Esempio di IF-PAYMENT-ID (solo Hotel Ads)

Utilizza l'istruzione condizionale IF-PAYMENT-ID per variare l'URL a seconda che il clic dell'utente sia o meno un risultato del programma di commissioni PPS. Nell'esempio riportato di seguito controlla se un clic proviene dal programma di commissioni PPS e assegna un valore a il parametro booking_source in base al risultato:

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

Se l'hotel fa parte del programma di commissioni, il risultato è uno dei i seguenti URL:

  • Se a Google non è stato assegnato alcun numero IATA:
    https://partner.com?hid=123&amp;booking_source=commissions
  • Se a Google è stato assegnato un numero IATA:
    https://partner.com?hid=123&amp;booking_source=01234567

In caso contrario, il risultato è il seguente URL:

https://partner.com?hid=123&booking_source=cpc

Esempio di IF-PROMOTED (solo Hotel Ads)

Puoi creare un blocco condizionale per verificare se l'utente ha fatto clic su un annuncio per la promozione di proprietà.

L'esempio seguente utilizza questa istruzione in un file delle pagine di destinazione:

<URL>https://partner.com/(IF-PROMOTED)1(ELSE)0(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

In questo esempio, se l'utente ha selezionato un annuncio per la promozione di proprietà, il risultato è il seguente URL:

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

Se l'utente non ha selezionato un annuncio di promozione della struttura, il risultato è seguente URL:

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

Esempio di IF-RATE-RULE-ID

Puoi creare un blocco condizionale per verificare se l'utente ha selezionato tariffa agevolata e, in questo caso, il valore dell'attributo <RateRuleID> nel blocco <Rate> del messaggio Transaction.

L'esempio seguente utilizza questa istruzione in un file delle pagine di destinazione:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-RATE-RULE-ID)&amp;customerType=42(ELSE)(ENDIF)</URL>

In questo esempio, se l'utente non ha selezionato una tariffa agevolata, il risultato è al seguente URL:

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

Se l'utente ha selezionato una tariffa agevolata, il risultato è il seguente URL:

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

Esempio di IF-USER-LIST-ID (definito in Google Ads)

Se imposti i moltiplicatori di offerta per gli elenchi dei segmenti di pubblico in una campagna per hotel in Google Ads: puoi utilizzare IF-USER-LIST-ID insieme a USER-LIST-ID per impostare un parametro personalizzato sul tuo sito web per un cliente che appartiene a un determinato account Google Ads dell'elenco del segmento di pubblico. Puoi farlo a scopo di monitoraggio o per personalizzare il tuo sito web per i membri degli elenchi dei segmenti di pubblico.

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

In questo esempio, se l'utente non era membro di un elenco del segmento di pubblico, il risultato è il seguente URL:

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

Se l'utente era un membro dell'elenco del segmento di pubblico 12345678, il risultato è al seguente URL:

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

Esempio di IF-VERIFICATION

Se devi verificare se Google ha generato l'URL per i test o per eseguire puoi usare IF-VERIFICATION.

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

In questo esempio, se Google non ha generato l'URL per i test o la convalida, il risultato è il seguente URL:

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

Se Google ha generato l'URL per i test o la convalida, il risultato è seguente URL:

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

Esempio di FOR-EACH-CHILD-AGE

Puoi creare un blocco condizionale che completa il valore dell'età massima di ogni bambino, come specificato nel feed prezzo dell'hotel.

L'esempio seguente utilizza questa istruzione in un file delle pagine di destinazione:

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

In questo esempio, se l'itinerario includeva 2 adulti e 2 bambini di 0 e 17 anni, il risultato è il seguente URL:

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

Se l'itinerario includeva 2 adulti e 0 bambini, il risultato è il seguente URL:

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

Regole generali per la creazione di URL

Tutte le variabili sono facoltative. Non è necessario inserire variabili nel URL pagina di destinazione. Usare le variabili per trasmettere l'itinerario e l'utente le informazioni in genere creano un'esperienza migliore per l'utente e ti aiutano nel in conformità alle norme di Google.

Per la definizione degli URL creati in un file delle pagine di destinazione, si applicano le seguenti regole generali:

  • Tutte le variabili sono racchiuse tra parentesi.

  • Nell'output finale i parametri della stringa di query devono essere separati dalla e commerciale ("&"). Poiché la e commerciale è un carattere speciale in XML e il formato del file delle pagine di destinazione è XML. Pertanto, devi utilizzare l'entità codificata "&amp;" al suo posto. Nell'output finale viene comunque visualizzato il carattere "&". Ad esempio:

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

    Devi inoltre eseguire la codifica URL dei caratteri speciali che potresti includere nel URL pagina di destinazione. Ad esempio:

    • spazio (" "): sostituisci i caratteri di spazio con "%20;" nell'elemento <URL>
    • barra ("/"): sostituisci le barre con "%2F;" nell'elemento <URL>

    Non è necessario codificare per l'URL tutti i caratteri non alfabetici. Ad esempio, non è necessario codificare il trattino ("-") per l'URL. Per un elenco di che devono essere codificati nell'URL, consultare Codifica URL.

  • I valori per un singolo parametro possono essere generati da più variabili. La nell'esempio seguente crea un singolo parametro, checkinDate, dalla Variabili CHECKINDAY, CHECKINMONTH e CHECKINYEAR:

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

    In questo esempio si ottiene un URL che potrebbe essere simile al seguente:

    https://www.partnerdomain.com?checkinDate=7/23/1971
    
  • Puoi utilizzare qualsiasi ID per il nome dei parametri della stringa di query. Il tuo server elabora questi valori. Tuttavia, i valori trasmessi sono limitati elenco delle variabili disponibili.

  • Puoi utilizzare fino a cinque variabili personalizzate oltre all'elenco delle variabili disponibili come la codifica one-hot delle variabili categoriche.