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)
&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)
&checkinYear=(CHECKINYEAR)&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:
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. Avere ID separati è utile se devi avere un identificatore proprietà per le informazioni del feed e un altro identificatore della proprietà per il sistema 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, dal giorno Monday al giorno Sunday ,
al momento del 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 a due cifre calcolato da <Nights> e
Elementi <Checkin> del feed prezzo dell'hotel. Per
ad esempio 26 . |
CHECKOUTMONTH | Recommended | Il mese di due cifre calcolato da <Nights>
e <Checkin> del feed prezzo dell'hotel. Per
ad esempio 05 . |
CHECKOUTYEAR | Recommended | L'anno a quattro cifre calcolato a partire da <Nights>
e <Checkin> del feed prezzo dell'hotel. Per
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 figlio
l'età del passeggero e l'età del bambino specificate 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 di un 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 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 ulteriori 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:
|
GOOGLE-SITE | Optional | La proprietà Google su cui un utente ha visualizzato i dati sui prezzi degli hotel.
I valori possibili sono:
|
LENGTH | Recommended | La durata del soggiorno in termini di numero di notti definito dal
Elemento <Nights> nel feed prezzo dell'hotel. Per
ad esempio 3 . |
NUM-ADULTS | Recommended (must be used with the
NUM-CHILDREN or FOR-EACH-CHILD-AGE condition)
|
Il numero di adulti specificato per l'itinerario dall'utente.
Questa variabile deve essere utilizzata insieme a
NUM-CHILDREN , FOR-EACH-CHILD-AGE o entrambi. |
NUM-CHILDREN | Recommended | Il numero di bambini (da 0 a 17 anni) specificato nella
itinerario da parte dell'utente. NUM-CHILDREN ,
Per completare l'operazione sono richiesti FOR-EACH-CHILD-AGE o entrambi
partecipano a itinerari con bambini. |
NUM-GUESTS | Recommended (if you don't send child occupancy pricing) | Il numero totale di persone, sia adulti che bambini, specificato per
dell'itinerario da parte dell'utente. Questo valore è la somma dei
Valori di NUM-ADULTS e NUM-CHILDREN . A
per massimizzare la partecipazione, consigliamo vivamente di utilizzare
NUM-ADULTS e 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 del
<PackageID> elemento in un <Result>
bloccare. Per un pacchetto camera, l'ID pacchetto è il valore del valore
<PackageID> elemento all'interno di
<RoomBundle> o <PackageData> blocchi
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 al
<RoomID> elemento all'interno di
<RoomBundle> o <RoomData> blocchi
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
stringa predefinita, contatta il tuo Technical Account Manager (TAM). |
PRICE-DISPLAYED-TAX | (Optional) | L'importo dell'imposta mostrato all'utente nella sua valuta locale.
Il valore di PRICE-DISPLAYED-TAX è il valore del parametro
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
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 Se utilizzi
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> in una
blocco <RoomBundle> del feed del prezzo. La
<RatePlanID> rappresenta l'identificatore univoco
per una combinazione di dati di camera e pacchetto. Per ulteriori informazioni
informazioni, consulta
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
Tariffe agevolate.
Nota: solo le tariffe agevolate o private. che non sono nascosti. |
USER-COUNTRY | Recommended | Un file di due lettere
codice paese che indica la località dell'utente. Questo
estratte dalle impostazioni del client dell'utente. Per
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 è
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 file di due lettere
Il codice lingua ISO 639-1 che specifica la lingua di visualizzazione
un annuncio o un 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 sono utilizzati come base per impostazione offerta aggiustamenti. 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 seguonoELSE
.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:
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 sono state
non disponibile perché l'utente non era idoneo, altrimenti restituisce
false . Per impostazione predefinita, true se
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
se sono state utilizzate date predefinite, altrimenti viene risolvere 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 nel servizio di pagamento per soggiorno (PPS)
il programma sulle commissioni corrisponde altrimenti a false . |
IF-PROMO-CODE | Optional | Restituisce true se l'utente ha fatto clic su una tariffa che è
in base a una promozione ARI o a una regola tariffaria con un determinato PromoCode ;
in caso contrario viene risolto in false . |
IF-PROMOTED (solo Hotel Ads) | Recommended (if you use Promoted hotels) | Restituisce true se l'utente ha fatto clic su una proprietà
Annuncio promozionale, altrimenti si risolve in false . |
IF-RATE-RULE-ID | Optional | Restituisce true se l'utente ha selezionato un
tariffa agevolata
, altrimenti viene risolto in false . |
IF-USER-LIST-ID (definita in Google Ads) | Optional | Restituisce true se l'utente è membro di un account Google Ads
ID elenco clienti specificato durante l'impostazione dei moltiplicatori di offerta per il pubblico
altrimenti restituisce false . |
IF-VERIFICATION | Optional | Restituisce true se il link è stato generato da Google per
test o 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 vengono inserite 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
<Child "age"> nel feed del prezzo. Per
Ad esempio, se <OccupancyDetails> include i due
<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 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)&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
<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)&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 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)&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)&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 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)&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)&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)&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)&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)&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 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.
- spazio (" "): sostituisci i caratteri dello spazio con "%20;" nell'elemento
I valori di un singolo parametro possono essere creati a partire da più variabili. La nell'esempio seguente crea un singolo parametro,
checkinDate
, dalla VariabiliCHECKINDAY
,CHECKINMONTH
eCHECKINYEAR
:<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.