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 in che modo Google genera il link per includere tutti informazioni aggiuntive sull'utente e sul suo itinerario. Ad esempio: puoi includere informazioni quali ID hotel, lingua, codici valuta, e le date del check-in nell'URL.

Panoramica

Devi definire l'URL pagina di destinazione nel file delle pagine di destinazione. Quando l'annuncio o link di prenotazione, le informazioni dinamiche nell'URL vengono sostituite con 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>

Nell'esempio seguente viene mostrato un URL che utilizza i nomi delle variabili di Google anziché ID hotel e itinerario effettivi:

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

Quando viene creato il link alla pagina di destinazione per la pagina dei risultati di ricerca, Google sostituisce le variabili con i valori effettivi per garantire che l'URL includa i 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 i dati corrispondenti nel feed prezzo dell'hotel, nel feed elenco hotel e nelle 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. Vengono calcolate altre variabili in base alle impostazioni internazionali dell'utente e ad 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:

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

Le istruzioni IF e FOR includono quanto segue:

Esempio di IF-AD-CLICK

Puoi creare un blocco condizionale per verificare se l'utente ha fatto clic su un annuncio link di prenotazione gratuito per reindirizzare 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 è al 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 non data che il tuo sito web può quindi 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 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 è 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-ID 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 si tratti di: il clic è il risultato o meno del programma sulle 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&booking_source=commissions

• Se a Google è stato assegnato un numero IATA:

  https://partner.com?hid=123&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 di promozione della struttura.

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 di promozione della struttura, 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 eseguire questa operazione per scopi di monitoraggio o per personalizzare 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 è al 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 per compilare l'età massima di ogni per i bambini, 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 comprendeva 2 adulti e 2 bambini di 0 e 17 anni il risultato sarà rispettivamente 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 itinerario e 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 una pagina di destinazione, si applicano le seguenti regole generali file di pagine:

• Tutte le variabili sono racchiuse tra parentesi di apertura e chiusura.

• I parametri della stringa di query possono essere passati solo dopo il punto interrogativo ("?") nell'URL.

• I parametri della stringa di query devono essere separati dalla e commerciale ("&") nella l'output finale. Poiché la e commerciale è un carattere speciale in XML e del file delle pagine di destinazione è XML. Pertanto, devi utilizzare l'entità codificata "&" al suo posto. L'output finale restituisce un "&" effettivo . Ad esempio:

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

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

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

  Non tutti i caratteri non alfabetici devono essere codificati nell'URL. Ad esempio: Non è necessario che i trattini ("-") siano codificati nell'URL. Per un elenco di caratteri che devono essere codificati nell'URL, consultare Tabella di codifica degli URL.

• I valori di un singolo parametro possono essere creati a partire 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 viene creato un URL 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.