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 des 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 la sans frais s'affiche, les informations dynamiques de l'URL sont remplacées par les valeurs réelles. Pour ajouter des valeurs dynamiques à vos URL de page de destination, utilisez le la syntaxe suivante:

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

L'exemple suivant présente une URL qui utilise les noms de variables Google au lieu de ID de l'hôtel et séjour:

<URL>https://www.partnerdomain.com?hotelID=(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 de résultats de recherche, Google remplace les variables par les valeurs réelles pour garantir que l'URL inclut le des 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 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 La variable PARTNER-HOTEL-ID est définie dans l'élément <id> de la liste d'hôtels. Flux 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 du un seul élément <Checkin> dans le flux des prix. Les autres variables sont calculées selon les 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éez l'URL de votre page de destination:

Logique conditionnelle dans les URL

Vous pouvez utiliser des instructions 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 true, les valeurs qui suivent condition est insérée dans l'URL. Sinon, les valeurs qui suivent la balise ELSE sont inséré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 qui redirige 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, le résultat est le suivant : URL:

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, le résultat peut être similaire. à l'URL suivante, qui affiche les 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 ressembler à l'URL suivante : 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 des annonces d'hôtel et des liens de réservation gratuits)

Vous pouvez créer un bloc conditionnel qui vérifie si l'utilisateur a cliqué sur une annonce provient 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, URL suivante:

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 standard sur le Réseau de Recherche), le résultat est l'URL suivante:

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 CAMPAIGN-ID vides avec des clics FBL

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 une instruction conditionnelle IF-AD-CLICK pour éviter que l'ID de campagne soit vide. 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 de 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, le résultat est le suivant : l'URL suivante:

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 d'hôtel dans Google Ads, vous pouvez utiliser IF-USER-LIST-ID conjointement avec USER-LIST-ID pour définir une sur votre site Web pour les clients qui appartiennent à une certaine campagne Google Ads liste d'audience. Vous pouvez effectuer cette opération à des fins de suivi ou pour personnaliser votre pour les 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'est pas membre d'une liste d'audience, le résultat est le suivant : l'URL suivante:

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

Si l'utilisateur était membre de la liste d'audience 12345678, le résultat est l'URL suivante:

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 à des fins de test ou automatisée 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é 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, comme indiqué 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. Il n'est pas obligatoire d'insérer des variables dans votre l'URL de la 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 créées dans une page de destination. fichier de pages:

• Toutes les variables sont entourées de parenthèses d'ouverture et de fermeture.

• Les paramètres de chaîne de requête ne peuvent être transmis qu'après le point d'interrogation ("?") dans l'URL.

• Les paramètres de chaîne de requête doivent être séparés par une esperluette ("&") dans le résultat final. Comme l'esperluette est un caractère spécial en XML et le format de fichier des pages de destination est XML. Vous devez donc utiliser l'entité encodée "&" à sa place. La sortie finale affiche un véritable "&" . Exemple :

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

  Vous devez également encoder en URL les caractères spéciaux que vous pouvez inclure dans le paramètre 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 <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 obtenir une liste des caractères devant être encodés en URL, consultez Tableau d'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 générée dans cet exemple peut se présenter comme suit:

  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 liste des variables disponibles

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