Variabili e condizioni

Gli annunci per hotel e i link di prenotazione gratuiti includono link alle pagine di destinazione in cui gli utenti possono prenotare le camere. Puoi definire la modalità con cui Google genera il link affinché quest'ultimo includa tutte le informazioni aggiuntive sull'utente e sul suo itinerario. Ad esempio, nell'URL puoi includere informazioni come l'ID dell'hotel, i codici di lingua e 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 la seguente sintassi:

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

L'esempio seguente mostra un URL che utilizza i nomi delle variabili di Google al posto dell'ID hotel e dell'itinerario effettivi:

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 il link della pagina di destinazione viene creato per la pagina dei risultati di ricerca, Google sostituisce le variabili con i valori effettivi per garantire che l'URL includa le informazioni dinamiche. Ad esempio, se l'utente prenota una camera per 6 notti a partire dal 23/5/2023 per l'hotel n. 42, Google trasforma il 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 ed elenco hotel, nonché dalle impostazioni utente.

Ad esempio,il valore della variabile LENGTH viene assegnato all'elemento <Nights> nel feed del prezzo del relativo itinerario. Analogamente, il valore della variabile PARTNER-HOTEL-ID è definito nell'elemento <id> del feed elenco hotel che corrispondeva ai criteri di ricerca dell'utente.

Alcune variabili sono sottoinsiemi degli elementi del feed prezzo. Ad esempio, le variabili CHECKINDAY, CHECKINMONTH e CHECKINYEAR vengono estratte dal singolo elemento <Checkin> nel feed del prezzo. Altre variabili vengono calcolate in base alle impostazioni locali dell'utente e ad altre impostazioni del client.

Per ulteriori informazioni sulle origini dei valori delle variabili, consulta le sezioni relative alla panoramica dei prezzi e all'elenco hotel.

Variabili URL

La tabella seguente descrive le variabili disponibili per creare 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 il valore è true, i valori che seguono questa condizione vengono inseriti nell'URL, altrimenti vengono inseriti i valori che seguono l'istruzione ELSE.

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

Sono disponibili le istruzioni IF e FOR seguenti:

Esempio di IF-AD-CLICK

Puoi creare un blocco condizionale per verificare se l'utente è stato reindirizzato alla tua pagina di destinazione dopo un clic su un annuncio o su un link di prenotazione gratuito.

L'esempio seguente utilizza questa istruzione in un file delle pagina 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 blocco <Room Bundle> di un messaggio Transaction verrà impostato sul prezzo del pacchetto camera associato implicitamente che l'utente aveva selezionato.

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 un pacchetto camera.

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 per la mancata selezione della data, che il tuo sito web può poi utilizzare per attivare la risposta personalizzata se l'utente non ha selezionato una data.

Il seguente esempio 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 delle 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 sugli annunci per hotel e sui 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 pagina 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 è stato eseguito su un URL di una campagna per hotel (ad es. una campagna sulla rete di ricerca standard), il risultato è il seguente URL:

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

Questa funzionalità è utile quando vuoi distinguere il traffico dei clic delle campagne per hotel da qualsiasi altro clic.

ID campagna vuoti con clic FBL

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

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

Puoi utilizzare l'istruzione condizionale IF-AD-CLICK per evitare l'ID campagna vuoto, 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-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 per la promozione di proprietà, il risultato è il 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 una tariffa agevolata e, in caso affermativo, viene utilizzato il valore dell'elemento <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 è il 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 moltiplicatori di offerta per gli elenchi dei segmenti di pubblico in una campagna per hotel in Google Ads, puoi utilizzare IF-USER-LIST-ID in combinazione con USER-LIST-ID per impostare un parametro sul tuo sito web per un cliente che appartiene a un determinato elenco di segmenti di pubblico di Google Ads. 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 sarà il 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 la convalida automatica, puoi utilizzare 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 è il 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 rispettivamente, 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 le variabili nell'URL della pagina di destinazione. Tuttavia, l'utilizzo delle variabili per trasmettere informazioni sull'itinerario e sull'utente in genere ti consente di ottimizzare l'esperienza dell'utente e di aderire meglio 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, al suo posto devi utilizzare l'entità codificata "&". 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 codificare i caratteri speciali che potresti includere nell'URL della 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 dei caratteri comuni da codificare per l'URL, consulta Codifica URL.

• I valori per un singolo parametro possono essere generati da più variabili. L'esempio seguente crea un unico parametro, checkinDate, dalle 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. Questi valori vengono elaborati dal tuo server. Tuttavia, i valori trasmessi si limitano all'elenco di variabili disponibili.

• Puoi utilizzare fino a cinque variabili personalizzate oltre all'elenco di variabili disponibili.