Variables et conditions

Les annonces d'hôtels et les liens de réservation gratuits incluent des liens vers les pages de destination sur lesquelles les utilisateurs peuvent réserver des salles. 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 comme 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 les données correspondantes dans votre flux Prix de l'hôtel, votre flux Hotel List Feed et vos paramètres utilisateur.

Par exemple,la valeur de la variable LENGTH est attribuée à l'élément <Nights>. issues du flux des prix du séjour 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 correspondant aux critères de recherche de l'utilisateur.

Certaines variables sont des sous-ensembles des éléments du flux des 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 Présentation de la tarification 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 accepte 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 lien de réservation gratuit pour rediriger les utilisateurs vers 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> dans Le bloc <Room Bundle> d'un message Transaction sera défini sur le paramètre implicitement prix de l'offre de chambres que l'utilisateur a choisi.

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, le résultat est le suivant : URL:

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 salle Groupe.

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, le résultat est l'URL suivante:

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

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

Exemple de condition IF-DEFAULT-DATE

Utilisez l'instruction conditionnelle IF-DEFAULT-DATE pour définir un paramètre autre qu'une date qui votre site Web peut ensuite utiliser pour déclencher un comportement personnalisé si l'utilisateur n'a pas sélectionné une 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)<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

Si l'utilisateur a sélectionné une date, le résultat peut être semblable à celui-ci : en fonction du séjour 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 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 s'avère utile lorsque vous souhaitez distinguer le trafic généré par les clics des campagnes d'hôtels. contre d'autres clics.

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 est renvoyé Les valeurs TRUE et CAMPAIGN-ID sont vides, comme illustré 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 selon que le clic résulte ou non du programme de commissions des PPS. L'exemple ci-dessous vérifie si un clic provient du programme de commissions PPS et affecte une valeur au le 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 fait partie du programme Commissions, le résultat est l'un des URL suivantes:

• 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 un 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, le résultat est l'URL suivante:

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

Si l'utilisateur n'a pas sélectionné d'annonce de promotion d'un établissement, URL suivante:

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é tarif sous conditions. Si tel est le cas, la valeur du paramètre <RateRuleID> dans le bloc <Rate> du message Transaction est utilisé.

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

Si l'utilisateur 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

Vous pouvez utiliser IF-VERIFICATION pour vérifier si Google a généré l'URL à des fins de test ou de validation automatique.

<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é d'URL à des fins de test ou de validation, l'URL suivante 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, le résultat est le URL suivante:

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

Exemple de définition de 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 âgés de 0 à 17 ans respectivement, l'URL suivante est générée:

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

Si le séjour comprend deux adultes et aucun enfant, le résultat est le suivant : URL:

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

Règles générales pour la création d'URL

Toutes les variables sont facultatives. Vous n'êtes pas obligé d'en inclure dans l'URL de votre page de destination. En revanche, si vous utilisez des variables pour transmettre permet généralement d'améliorer l'expérience de l'utilisateur et vous aide à conformes aux 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 entourées de parenthèses d'ouverture et de fermeture.

• Les paramètres de chaîne de requête doivent être séparés par une esperluette ("&") dans le résultat final. É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 sa 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 en URL les caractères spéciaux que vous pouvez inclure dans le l'URL de la page de destination. Exemple :

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

  Les caractères non alphabétiques ne doivent pas tous être encodés dans l'URL. Par exemple : les traits d'union ("-") ne doivent pas nécessairement être encodés en URL. 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. La l'exemple suivant construit un seul paramètre, checkinDate, à partir du 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. Toutefois, les valeurs que vous transmettez sont limitées liste des variables disponibles

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