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é 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 la seguente sintassi:
<URL>https://partner_url ?param_id =(variable_name )</URL>
Gli esempi seguenti mostrano un URL che utilizza i nomi delle variabili di Google anziché l'ID hotel e l'itinerario effettivi:
Esempio 1
<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)
&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)
&checkinYear=(CHECKINYEAR)&nights=(LENGTH)
</URL>
Esempio 2
<URL>https://www.partnerdomain.com/hotel/(PARTNER-HOTEL-ID)
&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)
&checkinYear=(CHECKINYEAR)&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 camera per 6 notti a partire dal 23/05/2023 per l'hotel 42, Google mostra 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, feed elenco hotel e 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 viene definito nell'elemento <id> del feed elenco hotel che corrispondeva ai criteri di ricerca dell'utente.
Alcune variabili sono sottoinsiemi degli elementi del feed del prezzo. Ad esempio, le variabili CHECKINDAY, CHECKINMONTH e CHECKINYEAR vengono estratte dal 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 sulle origini dei valori delle variabili, consulta la sezione Panoramica dei prezzi e Elenco hotel.
Variabili URL
La tabella seguente descrive le variabili disponibili per creare l'URL pagina di destinazione:
| Variabile | Consigliata/facoltativa | Descrizione |
|---|---|---|
| ADVANCE-BOOKING-WINDOW | Optional | Il numero di giorni di prenotazione anticipata prima della data di 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 è specificato nel 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 che vuoi associare all'URL. Il valore è vuoto se il clic non è associato a una campagna Google Ads. |
| 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 nell'elemento <Checkin>
del feed prezzo dell'hotel. Ad esempio, 05. |
| CHECKINYEAR | Recommended | L'anno di quattro cifre definito nell'elemento <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. 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 ciascun bambino specificata negli elementi
<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 sia obbligatoria, questa variabile può essere utilizzata solo insieme a
un 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:
|
| 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 non erano disponibili, ma che sarebbero state disponibili se l'utente avesse eseguito un'azione leggermente diversa. Tieni presente che gli ID regola tariffaria per le tariffe private vengono sempre compilati qui quando all'utente viene mostrato un trattamento della UI corrispondente. |
| CUSTOM[1-5] | Optional | I valori per i campi personalizzati definiti nell'elemento <Result>
con un limite di 200 caratteri per campo personalizzato. Per ulteriori informazioni, consulta la sezione Panoramica dei messaggi Transaction. I campi personalizzati non sono disponibili quando si utilizza
ARI.
Nota: le variabili |
| DATE-TYPE | Optional | Indica se l'utente ha selezionato la data predefinita o una data specifica fornita nella ricerca. I valori possibili sono:
|
| GOOGLE-ADS-CLICK-SOURCE | Optional | Indica che l'origine del clic è Google Ads. I valori possibili sono:
Nota:se il clic proviene dalla Ricerca Google anziché da Google Ads, questo parametro è vuoto |
| GOOGLE-SITE | Optional | La proprietà di Google in cui un utente ha visualizzato i tuoi dati sui prezzi degli hotel.
I valori possibili sono:
|
| 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
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 del 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 dall'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 dall'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 una
camera standard, l'ID camera è un valore dell'elemento
<RoomID> all'interno del blocco <Result>. 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) | Se utilizzi un'agenzia di riscossione delle commissioni, restituisce una stringa commission predefinita o il numero IATA assegnato da Google (ad esempio, "01234567"). Per modificare la formattazione del numero IATA o della stringa predefinita, contatta il tuo Technical Account Manager (TAM). |
| PRICE-DISPLAYED-TAX | (Optional) | L'importo delle tasse 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 della variabile PRICE-DISPLAYED-TOTAL è la
somma degli elementi <Baserate>, <Tax> e
<OtherFees> del feed prezzo dell'hotel.
Ad esempio, "152,13". |
| PROMO-CODE | (Optional) | Se utilizzi
promozioni ARI, il valore di questa variabile viene assegnato all'attributo Se utilizzi le
regole tariffarie, il valore di questa variabile viene assegnato all'elemento |
| RATE-PLAN-ID | Recommended (only applies if you use RoomBundles) | L'ID come definito dall'elemento <RatePlanID> nel
blocco <RoomBundle> di un 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 all'interno di un
blocco <Rate> di un 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 codice paese di due lettere che indica la posizione dell'utente. Queste
informazioni vengono 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. 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:
Il valore della variabile |
| 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 della variabile USER-LANGUAGE viene dedotto 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 Google Ads contenente l'elenco del segmento di pubblico o le informazioni sull'utente. 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 con l'aggiustamento delle offerte massimo. I legami tra i segmenti di pubblico con l'aggiustamento delle offerte massimo vengono stabiliti in modo casuale. |
| VERIFICATION | Optional | Un valore booleano che verifica se il link è stato generato da Google per i test o la 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 il valore è
true, i valori che seguono questa condizione vengono inseriti nell'URL. Altrimenti, vengono inseriti i valori che seguono l'istruzioneELSE.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 proviene da un link di prenotazione gratuito. |
| IF-CLICK-TYPE-HOTEL | Optional | Restituisce true se l'utente ha fatto clic sulla scheda di un
hotel, altrimenti restituisce false. |
| IF-CLICK-TYPE-ROOM | Optional | Restituisce true se
l'utente ha fatto clic su una scheda per un
Pacchetto camera, altrimenti restituisce 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, è true se all'utente viene mostrato un trattamento della UI con tariffa privata
. |
| 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 proviene da una
campagna per hotel, altrimenti restituisce false. Questa
distinzione è utile per i partner con più tipi di campagna
presenti in Google Ads per stabilire
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 su 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)&adType=1(ELSE)&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 sarà impostato sul prezzo del pacchetto camera implicitamente 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 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 diverso dalla data, che il tuo sito web può poi utilizzare per attivare un comportamento personalizzato 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)&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)&checkinYear=(CHECKINYEAR)&nights=(LENGTH)<strong>(IF-DEFAULT-DATE)</strong>&popup_datepicker=true(ELSE)&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 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)&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 operazione è 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 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 che l'ID campagna sia vuoto, come mostrato nell'esempio seguente:
<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)(IF-AD-CLICK)&hotel_campaign=(CAMPAIGN-ID)(ELSE)&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. L'esempio seguente controlla se un clic proviene dal programma di commissioni PPS e assegna un valore al parametro booking_source in base al risultato:
<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)&booking_source=(IF-PAYMENT-ID)(PAYMENT-ID)(ELSE)cpc(ENDIF)</URL>
Se l'hotel fa parte del programma di commissioni, il risultato è uno dei 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
Altrimenti, il risultato sarà 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 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 questo caso, viene utilizzato il valore dell'elemento <RateRuleID>
nel blocco <Rate> del messaggio di transazione.
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)&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 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 sul tuo sito web per un cliente che appartiene a un determinato elenco del segmento
di pubblico 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)&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)&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)&children=(NUM-CHILDREN)(FOR-EACH-CHILD-AGE)&age=(CHILD-INDEX)_(CHILD-AGE)(END-FOR-EACH)&hid=(PARTNER-HOTEL-ID)&</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 nell'URL della pagina di destinazione. Tuttavia, l'utilizzo delle variabili per trasmettere informazioni su itinerario e 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 "&". L'output finale mostra un carattere "&" 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 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 la sezione Codifica URL.
- spazio (" "): sostituisci i caratteri di spazio con "%20;" nell'elemento
I valori per un singolo parametro possono essere generati da più variabili. L'esempio seguente crea un unico parametro,
checkinDate, dalle variabiliCHECKINDAY,CHECKINMONTHeCHECKINYEAR:<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/1971Puoi 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.