Variables et conditions

Les annonces pour les hôtels et les liens de réservation gratuits incluent des liens qui redirigent les utilisateurs vers des pages de destination où ils peuvent réserver des chambres. Vous pouvez définir la façon dont Google construit le lien afin qu'il inclue toutes les informations supplémentaires sur l'utilisateur et son séjour. Par exemple, vous pouvez inclure des informations telles que l'identifiant de l'hôtel, la langue, les codes de 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>

Les exemples suivants montrent une URL qui utilise des noms de variables Google au lieu de l'identifiant de l'hôtel et du séjour 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éé à partir de la page des résultats de recherche, notre système remplace les variables par les valeurs réelles afin que l'URL inclue les informations dynamiques. Par exemple, si l'utilisateur réserve une chambre à l'hôtel 42 pour six nuits à partir du 23/05/2023, notre système transforme le lien précédent de la manière suivante:

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

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

Par exemple,la valeur de la variable LENGTH est attribuée à l'élément <Nights> spécifié dans le flux des prix du séjour concerné. 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'unique élément <Checkin> dans le flux des prix. D'autres variables sont calculées en fonction des paramètres régionaux de l'utilisateur et d'autres paramètres du client.

Pour en savoir plus sur les sources des valeurs des variables, consultez les pages sur la présentation des tarifs et la liste d'hôtels.

Variables URL

Le tableau suivant décrit les variables 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 fonctionne avec les instructions suivantes:

• if_statement: si elle est définie sur true, alors les valeurs qui suivent cette condition sont insérées dans l'URL. Dans le cas contraire, les valeurs suivant la directive ELSE sont intégrées.

• for_statement: crée une condition de boucle FOR qui effectue une itération en fonction du 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 sur un lien de réservation gratuit avant d'accéder à votre page de destination.

Dans l'exemple suivant, 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 de chambres explicite. La valeur de l'élément <RatePlanID> du bloc <Room Bundle> d'un message de transaction sera définie sur le prix de l'offre de chambres implicitement associée que l'utilisateur a sélectionné.

Dans l'exemple suivant, 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 a sélectionné une offre de chambres, l'URL suivante est générée:

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

Si l'utilisateur n'a pas sélectionné d'offre de chambres, l'URL suivante est générée:

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

Exemple de condition IF-CLICK-TYPE-ROOM

Vous pouvez créer un bloc conditionnel qui vérifie si l'utilisateur a sélectionné une offre de chambres.

Dans l'exemple suivant, 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é d'offre de chambres, l'URL ci-dessous est générée:

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

S'il a sélectionné une offre de chambres, l'URL suivante est créée:

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

Exemple de condition IF-DEFAULT-DATE

À l'aide de l'instruction conditionnelle IF-DEFAULT-DATE, définissez un paramètre sans date dont votre site Web peut ensuite se servir pour déclencher un comportement personnalisé si l'utilisateur n'a pas sélectionné de date.

L'exemple suivant permet de vérifier 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)<strong>(IF-DEFAULT-DATE)</strong>&amp;popup_datepicker=true(ELSE)&amp;popup_datepicker=false(ENDIF)</URL>

Dans cet exemple, si l'utilisateur n'a pas sélectionné de date, l'URL générée peut ressembler à ce qui suit (avec des dates sélectionnées par défaut) :

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

S'il a sélectionné une date, l'URL générée peut ressembler à ce qui suit, en fonction du séjour qu'il a sélectionné:

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ôtel 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 suivant, 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 l'utilisateur clique sur l'URL d'une campagne d'hôtel, l'URL ci-dessous est générée:

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

Si le clic ne provient pas de l'URL d'une 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

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 définie sur 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 éviter que l'ID de la campagne soit 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>

Exemple de condition IF-PAYMENT-ID (Hotel Ads uniquement)

Utilisez l'instruction conditionnelle IF-PAYMENT-ID pour modifier l'URL suivant que le clic provient d'un programme de commissions de PPS ou non. L'exemple ci-dessous vérifie si un clic provient du programme de commissions de PPS et attribue une valeur au paramètre booking_source en fonction du résultat:

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

Si l'hôtel participe au programme de commissions, l'une des URL suivantes est générée:

• Si aucun numéro IATA n'a été attribué à Google:

  https://partner.com?hid=123&booking_source=commissions

• Si un numéro IATA a été attribué à Google:

  https://partner.com?hid=123&booking_source=01234567

Sinon, l'URL suivante est générée:

https://partner.com?hid=123&booking_source=cpc

Exemple de condition IF-PROMOTED (Hotel Ads uniquement)

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

Dans l'exemple suivant, 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 a sélectionné une annonce de promotion d'un établissement, l'URL ci-dessous est générée:

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

S'il n'a pas sélectionné ce type d'annonce, l'URL suivante est générée:

https://partner.com/0?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> du bloc <Rate> du message de transaction est utilisée.

Dans l'exemple suivant, 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;customerType=42(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

S'il a sélectionné un tarif sous conditions, l'URL suivante est générée:

https://www.partner.com?hid=123&customerType=42

Exemple de condition IF-USER-LIST-ID (définie dans Google Ads)

Si vous définissez des multiplicateurs d'enchères pour des listes d'audience dans une campagne Hôtel de Google Ads, vous pouvez utiliser IF-USER-LIST-ID conjointement avec USER-LIST-ID afin de définir un paramètre sur votre site Web pour un client qui fait partie d'une certaine liste d'audience Google Ads. Cela peut être utile à des fins de suivi ou pour personnaliser votre site en fonction des membres de 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'appartient pas à une liste d'audience, l'URL ci-dessous est générée:

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

S'il faisait partie de la liste d'audience 12345678, l'URL suivante est générée:

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

Exemple de condition IF-VERIFICATION

Si vous devez vérifier si Google a généré l'URL pour les tests ou la validation automatique, 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 à des fins de test ou de validation, l'URL ci-dessous est générée:

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

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

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

Exemple de condition FOR-EACH-CHILD-AGE

Vous pouvez créer un bloc conditionnel qui renseigne l'âge maximal de chaque enfant, conformément aux informations spécifiées dans le flux Prix de l'hôtel.

Dans l'exemple suivant, 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 le séjour inclut deux adultes et deux enfants 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 le séjour inclut deux adultes et zéro enfant, l'URL suivante est générée:

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'en inclure dans l'URL de votre page de destination. Toutefois, le fait d'utiliser des variables pour transmettre des informations sur le séjour et sur l'utilisateur permet généralement d'améliorer son expérience et de respecter les règles de Google.

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

• Toutes les variables sont présentées entre parenthèses.

• Les paramètres de chaîne de requête doivent être séparés par une esperluette ("&") dans l'URL finale. Étant donné que l'esperluette est un caractère spécial en langage XML et que le fichier des pages de destination est au format XML. Vous devez donc utiliser la forme encodée "&" à la place. Dans l'URL finale, l'esperluette s'affichera sous sa vraie forme ("&"). 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 les caractères spéciaux que vous souhaitez 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>

  Les caractères non alphabétiques n'ont pas tous besoin d'être encodés dans l'URL. Par exemple, il est inutile d'encoder les traits d'union ("-"). Pour connaître la liste des caractères courants devant être encodés dans l'URL, consultez la section Encodage d'URL.

• Les valeurs d'un seul paramètre peuvent être créées à partir de plusieurs variables. Dans l'exemple suivant, un seul paramètre, checkinDate,est créé à partir des variables CHECKINDAY, CHECKINMONTH et CHECKINYEAR:

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

  L'URL créée dans l'exemple précédent doit apparaître comme suit:

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

• Vous pouvez utiliser n'importe quel identifiant pour le nom des paramètres de chaîne de requête. Votre serveur traitera ces valeurs. Cependant, les valeurs que vous pouvez transmettre se limitent à la liste des variables disponibles.

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