Gli annunci per hotel e i link di prenotazione senza costi 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 hotel, la lingua, i codici valuta e le date del check-in.
Panoramica
L'URL pagina di destinazione viene definito nel file delle pagine di destinazione. Quando l'annuncio o il link di prenotazione gratuito viene visualizzato, 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>
I seguenti esempi 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 garantire 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 n. 42, Google visualizza 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 nel feed prezzo dell'hotel, nel feed di schede di hotel e nelle impostazioni utente.
Ad esempio,il valore della variabile LENGTH viene assegnato all'elemento <Nights> dal feed dei prezzi dell'itinerario correlato. Analogamente, il valore della variabile PARTNER-HOTEL-ID è definito nell'elemento <id> del feed di schede di hotel che corrisponde ai criteri di ricerca dell'utente.
Alcune variabili sono sottoinsiemi degli elementi del feed dei prezzi. 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 internazionali dell'utente e ad altre impostazioni del client.
Per ulteriori informazioni sulle origini dei valori delle variabili, consulta la panoramica dei prezzi e l'elenco degli hotel.
Variabili URL
La tabella seguente descrive le variabili disponibili che puoi utilizzare per creare l'URL pagina di destinazione:
| Variabile | Consigliati/facoltativi | Descrizione |
|---|---|---|
| ADVANCE-BOOKING-WINDOW | Optional | Il numero di giorni di 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 è specificato nel feed di schede di hotel. La presenza di ID separati è utile se hai bisogno di un identificatore di proprietà per le informazioni dei feed e di un altro identificatore di proprietà per il sistema di prenotazione. |
| CAMPAIGN-ID | Recommended | L'ID della campagna Google Ads che vuoi associare all'URL. Questo campo è vuoto se il clic non è associato a una campagna Google Ads. |
| CHECKINDAY | Recommended | Il giorno a 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 viene effettuato il check-in, nel fuso orario dell'hotel. Ad esempio, Tuesday. |
| CHECKINMONTH | Recommended | Il mese a due cifre definito nell'elemento <Checkin> del feed prezzo dell'hotel. Ad esempio, 05. |
| CHECKINYEAR | Recommended | L'anno a 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 ogni bambino, come specificato 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 indicizzata a partire da 0 che rappresenta un contatore per ogni bambino e l'età del bambino specificata nell'itinerario. Anche se non è obbligatoria, questa variabile può essere utilizzata solo in combinazione con un blocco condizionale FOR-EACH-CHILD-AGE.
|
| CLICK-TYPE | Optional | Indica se l'utente ha fatto clic sulla scheda per una tariffa dell'hotel standard 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 regola tariffaria per le tariffe che non erano disponibili, ma che avrebbero potuto esserlo se l'utente avesse eseguito un'azione minore. Tieni presente che gli ID regola tariffaria per le tariffe private vengono sempre compilati qui quando all'utente viene mostrata un'opzione di interfaccia utente corrispondente. |
| Optional | Ritirato: i valori dei campi personalizzati definiti nell'elemento <Result> con un limite di 200 caratteri per campo personalizzato. Per saperne di più, consulta la panoramica dei messaggi Transaction. I campi personalizzati non sono disponibili quando utilizzi
ARI.
Le variabili CUSTOM vengono elencate solo quando invii i prezzi nel messaggio Transaction.
|
|
| 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 Google Ads è l'origine del clic. I valori possibili sono:
Nota:se il clic ha avuto origine dalla Ricerca Google anziché da Google Ads, questo parametro è vuoto. |
| GOOGLE-SITE | Optional | La proprietà di Google in cui un utente ha visualizzato i dati sui prezzi del tuo hotel.
I valori possibili sono:
|
| LENGTH | Recommended | La durata del soggiorno in termini di numero di notti definite dall'elemento <Nights> nel feed prezzo dell'hotel. Ad esempio: 3. |
| MODIFICATION-IDS | Optional | Se utilizzi le modifiche tariffarie ARI, il valore di questa variabile è l'attributo |
| NUM-ADULTS | Recommended (must be used with the
NUM-CHILDREN or FOR-EACH-CHILD-AGE condition)
|
Il numero di occupanti adulti specificato per l'itinerario dall'utente.
Questa variabile deve essere utilizzata insieme a NUM-CHILDREN, FOR-EACH-CHILD-AGE o entrambe. |
| NUM-CHILDREN | Recommended | Il numero di bambini (0-17 anni) specificato nell'itinerario dall'utente. NUM-CHILDREN,
FOR-EACH-CHILD-AGE o entrambi sono necessari per partecipare
correttamente agli itinerari con bambini. |
| NUM-GUESTS | Recommended (if you don't send child occupancy pricing) | Il numero totale di occupanti, sia adulti che 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 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 di schede di 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. |
| Optional (only applies to Ads) | Ritirato: restituisce una stringa predefinita
commission o il numero IATA assegnato da Google, ad esempio
"01234567", se utilizzi un'agenzia di riscossione delle commissioni. Per modificare la formattazione del numero IATA o della stringa predefinita, contatta il Technical Account Manager (TAM). |
|
| PRICE-DISPLAYED-FEES | (Optional) | L'importo delle commissioni incluse nel totale di tasse e commissioni, mostrato all'utente nella sua valuta locale.
Il valore di PRICE-DISPLAYED-FEES è il valore dell'elemento <Fee> nel messaggio Transaction. Per ARI,
questo è l'importo della commissione calcolato in base al
messaggio TaxFeeInfo. Ad esempio, "60.14". |
| PRICE-DISPLAYED-TAX | (Optional) | L'importo delle tasse mostrato all'utente nella sua valuta locale.
Il valore di 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 è la somma degli elementi <Baserate>, <Tax> e <OtherFees> del feed prezzo dell'hotel.
Ad esempio, "152.13". |
| PROMO-CODE | (Optional) | Se utilizzi le 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 definito dall'elemento <RatePlanID> nel blocco <RoomBundle> di un feed del prezzo. <RatePlanID> rappresenta l'identificatore univoco per una combinazione di dati di camera e pacchetto e deve contenere al massimo 50 caratteri per un rendimento ottimale. Per saperne di più, consulta
Pacchetti di stanze. |
| RATE-RULE-ID | Recommended (only applies if you use conditional rates or private rates) | L'ID definito dall'attributo rate_rule_id all'interno del blocco <Rate> di un feed del prezzo. Per saperne di più, consulta
Tariffe agevolate.
Nota:vengono mostrate solo le tariffe agevolate o private non nascoste. |
| USER-COUNTRY | Recommended | Un codice paese di due lettere che indica la località 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 senza costi. Il valore della variabile USER-LANGUAGE viene dedotto dalle impostazioni del client dell'utente. Ad esempio, en o fr. |
| USER-LIST-ID (definito in Google Ads) | Optional (only applies if you use Audience Lists in Google Ads) | L'ID elenco di utenti Google Ads che contiene l'elenco del segmento di pubblico o le informazioni sugli utenti. 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 più elevato. I pareggi 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. È true se il link è stato generato da Google per test o convalida, 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, 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 sul numero di valori forniti.
Le istruzioni IF e FOR includono quanto segue:
| Condizione | Consigliati/facoltativi | Descrizione |
|---|---|---|
| IF-AD-CLICK (solo annunci per hotel) | Optional | Viene risolto in true se il clic dell'utente ha avuto origine da un annuncio.
Si risolve in false se il clic dell'utente ha avuto origine 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 | Viene risolto in true se l'utente ha fatto clic su una scheda per un
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, è true se all'utente è stata mostrata un'opzione di interfaccia utente per le tariffe private
. |
| IF-DEFAULT-DATE | Optional | Si risolve in true se l'utente ha fatto clic su una scheda di un hotel in cui sono state utilizzate le date predefinite, altrimenti si risolve in false. |
| IF-HOTEL-CAMPAIGN | Optional | Viene risolto in true se il clic dell'utente ha avuto origine da una campagna per hotel, altrimenti viene risolto in false. Questa distinzione è utile per i partner che hanno più tipi di campagne presenti in Google Ads per assegnare l'attribuzione. |
| IF-MODIFICATION-IDS | Optional | Si risolve in true se l'utente ha fatto clic su una tariffa modificata da una modifica della tariffa ARI; in caso contrario, si risolve in false. |
| (solo annunci per hotel) | Recommended (if you use pay-per-stay Google Ads campaigns) | Ritirato: restituisce true per gli hotel
che fanno parte del programma sulle commissioni Pay-Per-Stay (PPS), altrimenti restituisce
false. |
| IF-PROMO-CODE | Optional | Viene risolto in 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 viene risolto in false. |
| IF-PROMOTED (solo annunci per hotel) | Recommended (if you use Promoted hotels) | Si risolve in true se l'utente ha fatto clic su un annuncio di promozione della struttura, altrimenti si risolve in false. |
| IF-RATE-RULE-ID | Optional | Restituisce true se l'utente ha selezionato una
tariffa agevolata
, altrimenti restituisce false. |
| IF-USER-LIST-ID (definito in Google Ads) | Optional | Restituisce true se l'utente è un membro di un ID elenco di clienti Google Ads che hai specificato quando hai impostato i moltiplicatori di offerta per gli elenchi dei segmenti di pubblico, altrimenti restituisce false. |
| IF-VERIFICATION | Optional | Risolve in true se il link è stato generato da Google per test o convalida, altrimenti risolve in 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 eseguito una volta per ogni elemento
<Child "age"> nel feed dei prezzi. Ad esempio, se <OccupancyDetails> include i due elementi <Child age="17"> e <Child age=
"17">, la direttiva 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 senza costi per reindirizzarlo alla tua pagina di destinazione.
L'esempio seguente utilizza questa istruzione in un file delle pagina 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 di camere esplicito. Il valore dell'elemento <RatePlanID> nel blocco <Room Bundle> di un messaggio Transaction verrà impostato sul prezzo del pacchetto di camere 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 non ha selezionato un pacchetto di camere, 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-CLICK-TYPE-ROOM
Puoi creare un blocco condizionale per verificare se l'utente ha selezionato un RoomBundle.
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 di camere, 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-CLOSE-RATE-RULE-IDS
Puoi creare un blocco condizionale per verificare se l'utente ha prezzi ridotti speciali o tariffe private per i membri di un programma fedeltà.
L'esempio seguente utilizza questa istruzione nel file delle pagine di destinazione:
<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-CLOSE-RATE-RULE-IDS)&rate_rule=(CLOSE-RATE-RULE-ID)(ELSE)(ENDIF)</URL>
In questo esempio, se l'utente non è idoneo per la tariffa privata, il risultato è il seguente URL:
https://partner.com?hid=123
Se l'utente è membro di un programma fedeltà e ha diritto alla tariffa privata, il risultato è il seguente URL:
https://partner.com?hid=123&rate_rule=sample_qr
Il seguente esempio è una logica di tariffa agevolata con data del check-in, data del check-out e dettagli sull'occupazione con condizioni IF nidificate per verificare se l'utente è idoneo per una tariffa privata, una tariffa privata agevolata o una tariffa pubblica:
<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)&checkinYear=(CHECKINYear)&checkoutDay=(CHECKOUTDAY)&checkoutMonth=(CHECKOUTMONTH)&checkoutYear(CHECKOUTYear)&num_adults=(NUM-ADULTS)(IF-CLOSE-RATE-RULE-IDS)&promo_type=member_signup&rate_rule=(CLOSE-RATE-RULE-ID)(ELSE)(IF-RATE-RULE-ID)&promo_type=conditional&rate_rule=(RATE-RULE-ID)(ELSE)promo_type=public(ENDIF)(ENDIF)</URL>
Se l'utente è idoneo per una tariffa privata, il risultato è il seguente URL:
https://partner.com/?hid=123&checkinDay=05&checkinMonth=03&checkinYear=2026&checkoutDay=07&checkoutMonth=03&checkoutYear=2026&num_adults=2&promo_type=member_signup&rate_rule=sample_qr
Se l'utente è idoneo per una tariffa privata condizionale, il risultato è il seguente URL:
https://partner.com/?hid=123&checkinDay=05&checkinMonth=03&checkinYear=2026&checkoutDay=07&checkoutMonth=03&checkoutYear=2026&num_adults=2&promo_type=conditional&rate_rule=US_users
Se l'utente è idoneo per una tariffa pubblica, il risultato è il seguente URL:
https://partner.com/?hid=123&checkinDay=05&checkinMonth=03&checkinYear=2026&checkoutDay=07&checkoutMonth=03&checkoutYear=2026&num_adults=2&promo_type=public
Esempio di IF-DEFAULT-DATE
Utilizza l'istruzione condizionale IF-DEFAULT-DATE per impostare un parametro non relativo alla data che il tuo sito web può 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)&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)&checkinYear=(CHECKINYEAR)&nights=(LENGTH)(IF-DEFAULT-DATE)&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 senza costi)
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)&hotel_campaign=(CAMPAIGN-ID)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>
In questo esempio, se il clic non è stato eseguito sull'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
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
Questa funzionalità è utile quando vuoi distinguere il traffico dei clic sulle campagne per hotel da qualsiasi altro clic.
CAMPAIGN-ID vuoti con clic sui link di prenotazione gratuiti
Se il clic proviene da un link di prenotazione senza costi, 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>
IF-MODIFICATIONS-IDS
Puoi creare un blocco condizionale per verificare se l'utente ha aggiornato il messaggio Modifiche alle tariffe ARI.
L'esempio seguente utilizza questa istruzione in un file delle pagina di destinazione:
<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-MODIFICATION-IDS)&promo_applied=true&mod_ids=(MODIFICATION-IDS)(ENDIF)</URL>
In questo esempio, se l'utente non ha modificato il messaggio ARI Rate modifications, il risultato è il seguente URL:
https://partner.com?hid=123
Se l'utente ha aggiornato il messaggio ARI Rate modifications, il risultato è il seguente URL:
https://partner.com?hid=123&promo_applied=true&mod_ids=7
IF-PROMO-CODE
Puoi creare un blocco condizionale per verificare se il codice promozionale per lo sconto è collegato alla tariffa per l'utente specificato, configurata tramite i messaggi ARI Promotions o Regole tariffarie.
L'esempio seguente utilizza questa istruzione in un file delle pagine di destinazione:
<URL>https://partner.com/booking?hid=(PARTNER-HOTEL-ID)(IF-PROMO-CODE)&promotion_code=(PROMO-CODE)&discount_applied=true(ENDIF)</URL>
In questo esempio, se il codice promozionale non è valido, il risultato è il seguente URL:
https://partner.com?hid=123
Se l'utente ha un codice promozionale valido ed è idoneo allo sconto, il risultato è il seguente URL:
https://partner.com?hid=123&promotion_code=123_abc&discount_applied=true
Esempio di IF-PROMOTED (solo annunci per hotel)
Puoi creare un blocco condizionale per verificare se l'utente ha fatto clic su un annuncio per promuovere una 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 non ha selezionato un annuncio di promozione della struttura, il risultato è il seguente URL:
https://partner.com/0?hid=123
Se l'utente ha selezionato un annuncio di promozione della struttura, il risultato è il seguente URL:
https://partner.com/1?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 Transaction.
Scopri di più.
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)&rate_rule=(RATE-RULE-ID)(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&rate_rule=(RATE-RULE-ID)
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 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 di Google Ads. Potresti volerlo fare per scopi 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 un 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 è 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, 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 il test o la convalida, il risultato è il seguente URL:
https://www.partner.com?hid=123
Se Google ha generato l'URL per il 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 compila l'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 prevede 2 adulti e 2 bambini di età rispettivamente pari a 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 prevede 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 pagina di destinazione. Tuttavia, l'utilizzo di variabili per trasmettere informazioni sull'itinerario e sull'utente in genere crea un'esperienza migliore per l'utente e ti aiuta a rispettare le norme di Google.
Quando definisci gli URL costruiti in un file di pagine di destinazione, si applicano le seguenti regole generali:
Tutte le variabili sono racchiuse tra parentesi aperte e chiuse.
I parametri della stringa di query devono essere separati da una e commerciale ("&") nell'output finale. Perché la e commerciale è un carattere speciale in XML e il formato file delle pagine di destinazione è XML. Pertanto, devi utilizzare l'entità codificata "&" al suo posto. 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 anche codificare nell'URL i caratteri speciali che potresti includere nell'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 tutti i caratteri non alfabetici devono essere codificati nell'URL. Ad esempio, i trattini ("-") non devono essere codificati nell'URL. Per un elenco di caratteri comuni che devono essere codificati come URL, consulta Codifica URL.
- Spazio (" "): sostituisci i caratteri di spazio con "%20;" nell'elemento
I valori di un singolo parametro possono essere costruiti a partire da più variabili. L'esempio seguente crea un singolo parametro,
checkinDate, dalle variabiliCHECKINDAY,CHECKINMONTHeCHECKINYEAR:<URL>https://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>Questo esempio genera un URL simile al seguente:
https://www.partnerdomain.com?checkinDate=7/23/1971Puoi utilizzare qualsiasi ID per il nome dei parametri della stringa di query. Il tuo server elabora questi valori. Tuttavia, i valori che passi sono limitati all'elenco delle variabili disponibili.
Puoi utilizzare fino a cinque variabili personalizzate oltre all'elenco di variabili disponibili.