Variables et conditions

Les annonces d'hôtels et les liens de réservation gratuits incluent des liens vers des pages de destination où les utilisateurs peuvent réserver des chambres. Vous pouvez définir la façon dont Google construit le lien de sorte qu'il intègre toutes les informations supplémentaires spécifiques à l'utilisateur et à son séjour. Par exemple, vous pouvez inclure des informations telles que l'ID de l'hôtel, la langue, les codes de la devise et les dates d'arrivée dans l'URL.

Présentation

Vous définissez l'URL de la page de destination dans le fichier des pages de destination. Lorsque l'annonce ou le lien de réservation gratuit s'affiche, les informations dynamiques de l'URL sont remplacées par des valeurs réelles. Pour ajouter des valeurs dynamiques aux URL de vos pages de destination, utilisez la syntaxe suivante :

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

L'exemple suivant montre une URL qui utilise les noms de variables de Google au lieu de l'ID d'hôtel et de l'itinéraire réels :

Exemple 1

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

Exemple 2

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

Lorsque le lien de la page de destination est créé pour la page des résultats de recherche, Google remplace les variables par les valeurs réelles pour s'assurer que l'URL inclut les informations dynamiques. Par exemple, si l'utilisateur réserve une chambre pour six nuits à partir du 23/05/2023 pour l'hôtel 42, Google affiche le lien précédent comme suit :

https://www.partnerdomain.com?hotelID=42&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=6

Les valeurs que Google attribue aux variables de la chaîne de requête dépendent des données correspondantes dans votre flux Prix de l'hôtel, votre flux Hotel List Feed et les paramètres utilisateur.

Par exemple,la valeur de la variable LENGTH est attribuée à l'élément <Nights> du flux de prix de l'itinéraire associé. De même, la valeur de la variable PARTNER-HOTEL-ID est définie dans l'élément <id> du flux Hotel List Feed qui correspond aux critères de recherche de l'utilisateur.

Certaines variables sont des sous-ensembles des éléments du flux de prix. Par exemple, les variables CHECKINDAY, CHECKINMONTH et CHECKINYEAR sont extraites de l'élément <Checkin> unique du flux de prix. Les autres variables sont calculées en fonction des paramètres régionaux de l'utilisateur et d'autres paramètres client.

Pour en savoir plus sur les sources des valeurs des variables, consultez Présentation de la tarification et Liste d'hôtels.

Variables URL

Le tableau suivant décrit les variables disponibles que vous pouvez utiliser pour créer l'URL de votre page de destination :

Logique conditionnelle dans les URL

Vous pouvez utiliser des directives spéciales dans l'élément <URL> d'un fichier de pages de destination pour créer des points de terminaison de manière conditionnelle.

La logique conditionnelle accepte les instructions suivantes :

• if_statement : si la valeur est true, les valeurs qui suivent cette condition sont insérées dans l'URL. Sinon, les valeurs qui suivent l'instruction ELSE sont insérées.

• for_statement : crée une condition de boucle FOR qui effectue une itération sur le nombre de valeurs fournies.

Les instructions IF et FOR incluent les éléments suivants :

Exemple de condition IF-AD-CLICK

Vous pouvez créer un bloc conditionnel qui vérifie si l'utilisateur a cliqué sur une annonce ou un lien de réservation gratuit pour être redirigé vers votre page de destination.

Dans l'exemple ci-dessous, cette directive est utilisée dans un fichier de page de destination.

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-AD-CLICK)&amp;adType=1(ELSE)&amp;adType=0(ENDIF)</URL>

Dans cet exemple, si l'utilisateur n'a pas cliqué sur une annonce, l'URL suivante est générée :

https://www.partner.com?hid=123&adType=0

Si l'utilisateur a cliqué sur l'annonce, l'URL suivante est générée :

https://www.partner.com?hid=123&adType=1

Exemple de condition IF-CLICK-TYPE-HOTEL

Vous pouvez créer un bloc conditionnel qui vérifie si l'utilisateur a sélectionné un hôtel sans offre groupée de chambres explicite. La valeur de l'élément <RatePlanID> dans le bloc <Room Bundle> d'un message de transaction sera définie sur le prix de l'offre groupée de chambres implicitement associé que l'utilisateur a sélectionné.

Dans l'exemple ci-dessous, cette directive est utilisée dans un fichier de pages de destination.

<URL>https://partner.com/(IF-CLICK-TYPE-HOTEL)landing(ELSE)landing_room(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

Dans cet exemple, si l'utilisateur n'a pas sélectionné de Room Bundle, l'URL ci-dessous est générée :

https://partner.com/landing?hid=123

Si l'utilisateur a sélectionné une offre de chambre, l'URL ci-dessous est générée :

https://partner.com/landing_room?hid=123

Exemple IF-CLICK-TYPE-ROOM

Vous pouvez créer un bloc conditionnel qui vérifie si l'utilisateur a sélectionné un RoomBundle.

Dans l'exemple ci-dessous, cette directive est utilisée dans un fichier de pages de destination.

<URL>https://partner.com/(IF-CLICK-TYPE-ROOM)landing_room(ELSE)landing(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

Dans cet exemple, si l'utilisateur n'a pas sélectionné de RoomBundle, l'URL ci-dessous est générée :

https://partner.com/landing?hid=123

Si l'utilisateur a sélectionné une offre de chambres, l'URL ci-dessous est générée :

https://partner.com/landing_room?hid=123

Exemple de condition IF-CLOSE-RATE-RULE-IDS

Vous pouvez créer un bloc conditionnel qui vérifie si l'utilisateur bénéficie d'un tarif réduit spécial ou de tarifs préférentiels pour les membres d'un programme de fidélité.

Dans l'exemple ci-dessous, cette directive est utilisée dans un fichier de pages de destination.

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-CLOSE-RATE-RULE-IDS)&amp;rate_rule=(CLOSE-RATE-RULE-ID)(ELSE)(ENDIF)</URL>

Dans cet exemple, si l'utilisateur n'est pas éligible au tarif privé, l'URL ci-dessous est générée :

https://partner.com?hid=123

Si l'utilisateur est membre d'un programme de fidélité et qu'il est éligible à un tarif préférentiel, l'URL suivante est renvoyée :

https://partner.com?hid=123&rate_rule=sample_qr

L'exemple suivant est une logique de tarif sous conditions avec la date d'arrivée, la date de départ et les détails d'occupation, avec des conditions IF imbriquées pour vérifier si l'utilisateur est éligible à un tarif privé, à un tarif privé sous conditions ou à un tarif public :

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYear)&amp;checkoutDay=(CHECKOUTDAY)&amp;checkoutMonth=(CHECKOUTMONTH)&amp;checkoutYear(CHECKOUTYear)&amp;num_adults=(NUM-ADULTS)(IF-CLOSE-RATE-RULE-IDS)&amp;promo_type=member_signup&amp;rate_rule=(CLOSE-RATE-RULE-ID)(ELSE)(IF-RATE-RULE-ID)&amp;promo_type=conditional&amp;rate_rule=(RATE-RULE-ID)(ELSE)promo_type=public(ENDIF)(ENDIF)</URL>

Si l'utilisateur est éligible à un tarif privé, l'URL ci-dessous est générée :

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

Si l'utilisateur est éligible à un tarif préférentiel sous conditions, l'URL ci-dessous est générée :

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

Si l'utilisateur est éligible à un tarif public, l'URL ci-dessous est générée :

https://partner.com/?hid=123&checkinDay=05&checkinMonth=03&checkinYear=2026&checkoutDay=07&checkoutMonth=03&checkoutYear=2026&num_adults=2&promo_type=public

Exemple de condition IF-DEFAULT-DATE

Utilisez l'instruction conditionnelle IF-DEFAULT-DATE pour définir un paramètre autre qu'une date, que votre site Web pourra ensuite utiliser pour déclencher un comportement personnalisé si l'utilisateur n'a pas sélectionné de date.

L'exemple suivant vérifie si la date par défaut a été utilisée :

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)(IF-DEFAULT-DATE)&amp;popup_datepicker=true(ELSE)&amp;popup_datepicker=false(ENDIF)</URL>

Dans cet exemple, si l'utilisateur n'a pas sélectionné de date, le résultat peut être semblable à l'URL suivante, qui affiche les sélections de dates par défaut :

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=1&popup_datepicker=true

Si l'utilisateur a sélectionné une date, le résultat peut ressembler à l'URL suivante, en fonction de l'itinéraire qu'il a choisi :

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=2&popup_datepicker=false

Exemple de condition IF-HOTEL-CAMPAIGN (clics sur les annonces d'hôtels et les liens de réservation gratuits)

Vous pouvez créer un bloc conditionnel qui vérifie si l'utilisateur a cliqué sur une annonce provenant d'une campagne d'hôtel.

Dans l'exemple ci-dessous, cette directive est utilisée dans un fichier de page de destination.

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

Dans cet exemple, si le clic ne provient pas d'une URL de campagne d'hôtel (par exemple, une campagne sur le Réseau de Recherche standard), l'URL suivante est générée :

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

Si l'utilisateur clique sur l'URL d'une campagne d'hôtel, l'URL suivante est générée :

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

Cela est utile lorsque vous souhaitez distinguer le trafic des clics sur les campagnes d'hôtels de tout autre clic.

ID de campagne vides avec des clics sur des liens de réservation gratuits

Si le clic provient d'un lien de réservation gratuit, IF-HOTEL-CAMPAIGN renvoie TRUE et la valeur CAMPAIGN-ID est vide, comme indiqué dans l'URL suivante :

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

Vous pouvez utiliser l'instruction conditionnelle IF-AD-CLICK pour empêcher l'ID de campagne d'être vide, comme illustré dans l'exemple suivant :

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

IF-MODIFICATIONS-IDS

Vous pouvez créer un bloc conditionnel qui vérifie si l'utilisateur a mis à jour le message Modifications des tarifs ARI.

Dans l'exemple ci-dessous, cette directive est utilisée dans un fichier de page de destination.

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-MODIFICATION-IDS)&amp;promo_applied=true&amp;mod_ids=(MODIFICATION-IDS)(ENDIF)</URL>

Dans cet exemple, si l'utilisateur n'a pas modifié le message de modification des tarifs ARI, l'URL ci-dessous est générée :

https://partner.com?hid=123

Si l'utilisateur a mis à jour le message de modification des tarifs ARI, l'URL suivante est obtenue :

https://partner.com?hid=123&promo_applied=true&mod_ids=7

IF-PROMO-CODE

Vous pouvez créer un bloc conditionnel qui vérifie si le code promotionnel de remise est associé au tarif de l'utilisateur spécifié, qui est configuré via des messages de promotions ARI ou de règles de tarification.

Dans l'exemple ci-dessous, cette directive est utilisée dans un fichier de pages de destination.

<URL>https://partner.com/booking?hid=(PARTNER-HOTEL-ID)(IF-PROMO-CODE)&amp;promotion_code=(PROMO-CODE)&amp;discount_applied=true(ENDIF)</URL>

Dans cet exemple, si le code promotionnel n'est pas valide, l'URL suivante est générée :

https://partner.com?hid=123

Si l'utilisateur dispose d'un code promotionnel valide et qu'il est éligible à une remise, le résultat est l'URL suivante :

https://partner.com?hid=123&promotion_code=123_abc&discount_applied=true

Exemple de condition IF-PROMOTED (annonces d'hôtel uniquement)

Vous pouvez créer un bloc conditionnel qui vérifie si l'utilisateur a cliqué sur une annonce de promotion d'établissement.

Dans l'exemple ci-dessous, cette directive est utilisée dans un fichier de pages de destination.

<URL>https://partner.com/(IF-PROMOTED)1(ELSE)0(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

Dans cet exemple, si l'utilisateur n'a pas sélectionné d'annonce de promotion d'établissement, l'URL suivante est générée :

https://partner.com/0?hid=123

Si l'utilisateur a sélectionné une annonce de promotion d'un établissement, l'URL suivante est générée :

https://partner.com/1?hid=123

Exemple de condition IF-RATE-RULE-ID

Vous pouvez créer un bloc conditionnel qui vérifie si l'utilisateur a sélectionné un tarif sous conditions. Si c'est le cas, la valeur de l'élément <RateRuleID> dans le bloc <Rate> du message de transaction est utilisée. En savoir plus

Dans l'exemple ci-dessous, cette directive est utilisée dans un fichier de pages de destination.

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-RATE-RULE-ID)&amp;rate_rule=(RATE-RULE-ID)(ELSE)(ENDIF)</URL>

Dans cet exemple, si l'utilisateur n'a pas sélectionné de tarif sous conditions, l'URL ci-dessous est générée :

https://www.partner.com?hid=123

Si l'utilisateur a choisi un tarif sous conditions, l'URL ci-dessous est générée :

https://www.partner.com?hid=123&rate_rule=(RATE-RULE-ID)

Exemple IF-USER-LIST-ID (défini dans Google Ads)

Si vous définissez des multiplicateurs d'enchères pour les listes d'audience d'une campagne d'hôtel dans Google Ads, vous pouvez utiliser IF-USER-LIST-ID avec USER-LIST-ID pour définir un paramètre sur votre site Web pour un client appartenant à une liste d'audience Google Ads spécifique. Vous pouvez le faire à des fins de suivi ou pour personnaliser votre site Web pour les membres des listes d'audience.

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-USER-LIST-ID)&amp;audience_list=(USER-LIST-ID)(ELSE)(ENDIF)</URL>

Dans cet exemple, si l'utilisateur n'était pas membre d'une liste d'audience, l'URL ci-dessous est générée :

https://www.partner.com?hid=123

Si l'utilisateur était membre de la liste d'audience 12345678, l'URL ci-dessous est générée :

https://www.partner.com?hid=123&audience_list=12345678

Exemple IF-VERIFICATION

Si vous devez vérifier si Google a généré l'URL à des fins de test ou de validation, vous pouvez utiliser IF-VERIFICATION.

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-VERIFICATION)&amp;isgoogle=true(ENDIF)</URL>

Dans cet exemple, si Google n'a pas généré l'URL pour les tests ou la validation, le résultat est l'URL suivante :

https://www.partner.com?hid=123

Si Google a généré l'URL à des fins de test ou de validation, le résultat est l'URL suivante :

https://www.partner.com?hid=123&isgoogle=true

Exemple de FOR-EACH-CHILD-AGE

Vous pouvez créer un bloc conditionnel qui indique l'âge maximal de chaque enfant occupant, comme spécifié dans le flux Prix de l'hôtel.

Dans l'exemple ci-dessous, cette directive est utilisée dans un fichier de pages de destination.

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

Dans cet exemple, si l'itinéraire comprend deux adultes et deux enfants âgés de 0 et 17 ans respectivement, l'URL ci-dessous est générée :

https://www.partner.com?adults=2&children=2&age=0_0age=1_17&hid=123

Si l'itinéraire comprend deux adultes et zéro enfant, l'URL obtenue est la suivante :

https://www.partner.com?adults=2&children=0&hid=123

Règles générales pour créer des URL

Toutes les variables sont facultatives. Vous n'êtes pas obligé d'insérer des variables dans l'URL de votre page de destination. Toutefois, l'utilisation de variables pour transmettre des informations sur l'itinéraire et l'utilisateur permet généralement d'améliorer l'expérience utilisateur et de respecter les règles de Google.

Les règles générales suivantes s'appliquent lorsque vous définissez des URL construites dans un fichier de pages de destination :

• Toutes les variables sont entourées de parenthèses ouvrantes et fermantes.

• Les paramètres de la chaîne de requête doivent être séparés par une esperluette ("&") dans le résultat final. En effet, l'esperluette est un caractère spécial en XML, et le format de fichier des pages de destination est XML. Par conséquent, vous devez utiliser l'entité encodée "&" à la place. Le résultat final affiche un véritable caractère "&". Exemple :

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

  Vous devez également encoder au format URL les caractères spéciaux que vous pouvez inclure dans l'URL de la page de destination. Exemple :

  • Espace (" ") : remplacez les espaces par "%20;" dans l'élément <URL>.
  • Barre oblique ("/") : remplacez les barres obliques par "%2F;" dans l'élément <URL>.

  Tous les caractères non alphabétiques ne doivent pas être encodés au format URL. Par exemple, les traits d'union ("-") n'ont pas besoin d'être encodés au format URL. Pour obtenir la liste des caractères courants qui doivent être encodés au format URL, consultez Encodage au format URL.

• Les valeurs d'un même paramètre peuvent être construites à partir de plusieurs variables. L'exemple suivant construit un seul paramètre, checkinDate, à partir des variables CHECKINDAY, CHECKINMONTH et CHECKINYEAR :

  <URL>https://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>
  

  Cet exemple génère une URL qui peut ressembler à ceci :

  https://www.partnerdomain.com?checkinDate=7/23/1971
  

• Vous pouvez utiliser n'importe quel ID pour le nom des paramètres de chaîne de requête. Votre serveur traite ces valeurs. Toutefois, les valeurs que vous transmettez sont limitées à la liste des variables disponibles.

• Vous pouvez utiliser jusqu'à cinq variables personnalisées en plus de la liste des variables disponibles.