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:

Variable Recommandé/Facultatif Description
ADVANCE-BOOKING-WINDOW Optional Le nombre de jours de réservation à l'avance avant la date d'arrivée dans le champ dans le fuseau horaire de l'hôtel au moment de la réservation. Par exemple, 36.
ALTERNATE-HOTEL-ID Recommended (if you have separate IDs to identify properties versus booking engines) Autre identifiant de votre établissement. Ce nom d'attribut est spécifiée dans votre flux Hotel List Feed. Il est utile d'avoir des ID distincts si vous avez besoin d'un identifiant de propriété pour les informations de votre flux et d'un autre identifiant d'établissement pour votre moteur de réservation.
CAMPAIGN-ID Recommended Identifiant de la campagne Google Ads à associer à la URL. Ce champ est vide si le clic n'est pas associé à un compte Google Ads campagne.
CHECKINDAY Recommended Jour à deux chiffres défini dans l'élément <Checkin> du flux Prix de l'hôtel. Exemple :20
CHECKINDAY-OF-WEEK Optional Jour de la semaine (du Monday au Sunday) le moment de l'arrivée, dans le fuseau horaire de l'hôtel. Exemple : Tuesday
CHECKINMONTH Recommended Mois à deux chiffres défini dans l'<Checkin> du flux Prix de l'hôtel. Exemple :05
CHECKINYEAR Recommended Année à quatre chiffres définie dans le <Checkin> du flux Prix de l'hôtel. Exemple :2023
CHECKOUTDAY Recommended Jour à deux chiffres calculé à partir de <Nights> et <Checkin> du flux Prix de l'hôtel. Par exemple, 26.
CHECKOUTMONTH Recommended Mois à deux chiffres calculé à partir du <Nights> et <Checkin> du flux Prix de l'hôtel. Par exemple, 05.
CHECKOUTYEAR Recommended Année à quatre chiffres calculée à partir du <Nights> et <Checkin> du flux Prix de l'hôtel. Par exemple, 2023.
CHILD-AGE Recommended (must be provided for child occupancy pricing) Âge maximal de chaque enfant, tel que spécifié dans les <ph type="x-smartling-placeholder"></ph> <Child "age"> du flux des prix. Cette variable doit être utilisée conjointement avec Bloc conditionnel FOR-EACH-CHILD-AGE.
CHILD-INDEX Optional Une variable de boucle indexée sur 0 représentant un compteur pour chaque enfant le nombre de personnes et l'âge de l'enfant spécifiés dans l'itinéraire. Bien que ce ne soit pas le cas obligatoire, cette variable ne peut être utilisée qu'en association avec un Bloc conditionnel FOR-EACH-CHILD-AGE.
CLICK-TYPE Optional Indique si l'utilisateur a cliqué sur la fiche d'un hôtel standard un tarif ou une offre de chambres. Les valeurs possibles du champ sont les suivantes :
  • hotel: l'utilisateur a cliqué sur la fiche d'une fiche prix de la chambre.
  • room: l'utilisateur a cliqué sur la fiche d'une chambre Groupe.
CLOSE-RATE-RULE-IDS Optional (only applies if you are using conditional or private rates) Liste des identifiants de règles d'offres séparés par une virgule pour les tarifs qui ont été indisponible, mais il aurait pu l'être si l'utilisateur avait pris une action mineure. Notez que les identifiants des règles d'offres tarifs préférentiels sont toujours renseignés ici lorsqu'un traitement d'interface utilisateur correspondant est affiché. pour l'utilisateur.
CUSTOM[1-5] Optional Les valeurs des champs personnalisés définis dans l'<Result> avec une limite de 200 caractères par champ personnalisé. Pour plus consultez Présentation des messages Transaction. Les champs personnalisés ne sont pas disponibles lorsque vous utilisez ARI
DATE-TYPE Optional Indique si l'utilisateur a sélectionné la date par défaut ou une la date indiquée dans la recherche. Les valeurs possibles du champ sont les suivantes :
  • default: l'utilisateur a cliqué sur une annonce d'hôtel ou sur une annonce sans frais lien de réservation où les dates par défaut étaient utilisées.
  • selected: l'utilisateur a cliqué sur une annonce d'hôtel ou sur une annonce sans frais un lien de réservation avec les dates définies.
GOOGLE-SITE Optional Site Google sur lequel l'utilisateur a consulté les données tarifaires de votre hôtel. Les valeurs possibles du champ sont les suivantes :
  • localuniversal: l'utilisateur a trouvé le lien de réservation d'hôtel dans la recherche google.com.
  • mapresults: l'utilisateur a trouvé le lien de réservation d'hôtel à maps.google.com.
  • verification: Google utilise cette valeur des tests automatisés de la qualité des données sur votre site. Ces requêtes ne vous sont pas facturées. Google Analytics peut utiliser ce paramètre et sa valeur pour identifier Trafic lié à la validation automatique des annonces Hotel Ads.
  • unknown: l'utilisateur a vu l'annonce ou le lien de réservation gratuit par le biais d'une source indéterminée.
LENGTH Recommended Durée du séjour exprimée en nombre de nuits définie par le <Nights> dans le flux Prix de l'hôtel. Par exemple, 3.
NUM-ADULTS Recommended (must be used with the NUM-CHILDREN or FOR-EACH-CHILD-AGE condition) Nombre d'adultes que l'utilisateur a indiqué pour le séjour. Cette variable doit être utilisée conjointement avec NUM-CHILDREN, FOR-EACH-CHILD-AGE ou les deux.
NUM-CHILDREN Recommended Nombre d'enfants (0 à 17 ans) spécifié dans le du voyage de l'utilisateur. NUM-CHILDREN, FOR-EACH-CHILD-AGE ou les deux sont requis pour réussir participer aux séjours avec des enfants.
NUM-GUESTS Recommended (if you don't send child occupancy pricing) Nombre total de personnes, adultes et enfants, spécifié pour le séjour par l'utilisateur. Cette valeur est la somme des Valeurs NUM-ADULTS et NUM-CHILDREN. À pour maximiser la participation, nous vous recommandons vivement d'utiliser à la fois NUM-ADULTS et NUM-CHILDREN à la place.
PACKAGE-ID Recommended (applies if you use Room Bundles) Identifiant unique du séjour organisé dans le flux Prix de l'hôtel. Pour une package standard, l'identifiant du package correspond à la valeur Élément <PackageID> dans un élément <Result> . Pour une offre de chambres, l'identifiant de la formule correspond à la valeur Élément <PackageID> dans Blocs <RoomBundle> ou <PackageData> du message Transaction.
PARTNER-CURRENCY Optional Code de devise à trois lettres défini par la valeur Attribut currency de l'élément <Baserate> dans le flux Prix de l'hôtel. Par exemple, USD ou CAD .
PARTNER-HOTEL-ID Recommended Identifiant unique de l'hôtel défini par le <id> dans le flux Hotel List Feed.
PARTNER-ROOM-ID Recommended (applies if you use Room Bundles) Identifiant unique de la chambre défini dans le flux Prix de l'hôtel. Pour une "chambre standard", l'identifiant de la chambre correspond à la valeur de l'attribut Élément <RoomID> dans <Result> . Pour une offre de chambres, l'identifiant de chambre est la valeur attribuée Élément <RoomID> dans Blocs <RoomBundle> ou <RoomData> dans le message Transaction.
PAYMENT-ID Optional (only applies to Ads) Renvoie une chaîne prédéfinie commission, ou la méthode numéro IATA attribué (par exemple, "01234567"), si vous utilisez une commission l'agence de recouvrement. Pour modifier le format de votre numéro IATA ou chaîne prédéfinie, contactez votre responsable de compte technique (TAM).
PRICE-DISPLAYED-TAX (Optional) Montant des taxes présenté à l'utilisateur dans sa devise locale. La valeur de PRICE-DISPLAYED-TAX correspond à la valeur de <Tax> dans le flux Prix de l'hôtel. Par exemple : "3,14".
PRICE-DISPLAYED-TOTAL (Optional) Coût total de la chambre présenté à l'utilisateur dans la devise locale. La valeur de PRICE-DISPLAYED-TOTAL est la somme des éléments <Baserate>, <Tax> et <OtherFees> du flux Prix de l'hôtel. Exemple : "152.13".
PROMO-CODE (Optional)

Si vous utilisez ARI promotions, la valeur de cette variable est attribuée à l'attribut id de l'élément <Promotion> appliqué. Si plusieurs promotions sont appliquées, il s'agit d'une liste identifiant promotion dans un ordre arbitraire.

Si vous utilisez règles d'offres, la valeur de cette variable est attribuée à l'élément PromoCode si la règle d'offres correspondante est appliquée.

RATE-PLAN-ID Recommended (only applies if you use RoomBundles) ID tel que défini par l'élément <RatePlanID> dans un le bloc <RoomBundle> du flux des prix. La <RatePlanID> représente l'identifiant unique. pour une combinaison de données de chambre et de formule. Pour plus plus d'informations, voir Offres de chambres.
RATE-RULE-ID Recommended (only applies if you use conditional rates or private rates) L'identifiant défini par l'attribut rate_rule_id dans une le bloc <Rate> du flux des prix. Pour plus d'informations, reportez-vous à Tarifs sous conditions.

Remarque:Seuls les tarifs sous conditions ou préférentiels sont acceptés. qui ne sont pas masquées s'affichent.

USER-COUNTRY Recommended Un texte de deux lettres code pays qui indique la zone géographique de l'utilisateur. Ce sont extraites des paramètres client de l'utilisateur. Pour Exemple : US ou FR.
USER-CURRENCY Recommended Code de devise à trois lettres correspondant à la devise locale de l'utilisateur devise. La valeur de la variable USER-CURRENCY est à partir des paramètres client de l'utilisateur. Exemple : USD ou CAD .
USER-DEVICE Recommended Type d'appareil de l'utilisateur. La valeur de USER-DEVICE peut être l'une des suivantes: <ph type="x-smartling-placeholder">
    </ph>
  • mobile
  • tablet
  • desktop
  • unknown

La valeur de la variable USER-DEVICE est déduite de la les paramètres client de l'utilisateur.

USER-LANGUAGE Recommended Un texte de deux lettres Code de langue ISO 639-1 qui spécifie la langue d'affichage du ou un lien de réservation gratuit. La valeur de USER-LANGUAGE est déduite des paramètres client de l'utilisateur. Par exemple : en ou fr.
USER-LIST-ID (défini dans Google Ads) Optional (only applies if you use Audience Lists in Google Ads) ID de la liste d'utilisateurs Google Ads contenant la liste d'audience ou l'utilisateur des informations. Les listes d'audience servent de base définition des enchères des ajustements. Si l'utilisateur figure sur plusieurs listes d'audience, la liste d'audience avec l'ajustement d'enchères le plus élevé est sélectionné. Est égal(e) à les audiences pour lesquelles l'ajustement des enchères est le plus élevé sont définis au hasard.
VERIFICATION Optional Valeur booléenne qui vérifie si le lien a été généré par Google pour les tests ou la validation automatisée. Cette valeur est true si le lien a été généré par Google à des fins de test ou de validation automatisée. Sinon, il s'agit de false.

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:

Condition Recommandé/Facultatif Description
IF-AD-CLICK (Hotel Ads uniquement) Optional Renvoie true si le clic de l'utilisateur provient d'une annonce. Renvoie false si le clic de l'utilisateur provient d'un utilisateur sans frais lien de réservation.
IF-CLICK-TYPE-HOTEL Optional Renvoie true si l'utilisateur a cliqué sur une fiche pour une hôtel. Sinon, renvoie false.
IF-CLICK-TYPE-ROOM Optional Renvoie true si le paramètre utilisateur a cliqué sur une fiche pour un Offre de chambres. Sinon, renvoie false.
IF-CLOSE-RATE-RULE-IDS Optional Renvoie true si un ou plusieurs tarifs sous conditions étaient indisponible, car l'utilisateur n'était pas éligible. Sinon, renvoie vers false Par défaut, cette valeur est true si tarif préférentiel Le traitement dans l'interface utilisateur a été présenté à l'utilisateur.
IF-DEFAULT-RATE Optional Renvoie true si l'utilisateur a cliqué sur la fiche d'un hôtel. où des dates par défaut ont été utilisées. Sinon, renvoie false.
IF-HOTEL-CAMPAIGN Optional Renvoie true si le clic de l'utilisateur provient d'un campagne d'hôtel. Sinon, renvoie false. Ce La distinction est utile pour les partenaires qui gèrent plusieurs types de campagnes. présentes dans Google Ads pour attribuer l'attribution.
IF-PAYMENT-ID (Hotel Ads uniquement) Recommended (if you use pay-per-stay Google Ads campaigns) Renvoie true pour les hôtels utilisant le paiement par séjour (PPS) programme de commissions de conversion est associé à false.
IF-PROMO-CODE Optional Renvoie true si l'utilisateur a cliqué sur un tarif qui est en fonction d'une promotion ARI ou d'une règle d'offres avec un PromoCode donné ; Sinon, renvoie false.
IF-PROMOTED (Hotel Ads uniquement) Recommended (if you use Promoted hotels) Renvoie true si l'utilisateur a cliqué sur une propriété. Annonce promotionnelle. Sinon, renvoie false.
IF-RATE-RULE-ID Optional Renvoie true si l'utilisateur a sélectionné une tarif sous conditions . Sinon, renvoie false.
IF-USER-LIST-ID (défini dans Google Ads) Optional Renvoie true si l'utilisateur est membre d'une communauté Google Ads. ID de la liste de clients que vous avez spécifié lors de la définition des multiplicateurs d'enchères pour l'audience . Sinon, renvoie false.
IF-VERIFICATION Optional Renvoie true si le lien a été généré par Google pour les tests ou la validation automatisée, sinon renvoie false.
ELSE Recommended (if you use any conditional IF statements) Si la condition précédente n'est pas remplie, alors les valeurs qui suivent sont insérées dans l'URL.
END-IF Optional (required if you have any IF conditional statements) Termine le bloc conditionnel de l'instruction IF.
FOR-EACH-CHILD-AGE Optional (required for child occupancy pricing) S'exécute une fois pour chaque <ph type="x-smartling-placeholder"></ph> <Child "age"> dans le flux des prix. Pour Par exemple, si <OccupancyDetails> inclut les deux <Child age="17"> et <Child age= "17">, la directive s'exécute deux fois.
END-FOR-EACH Optional (required if using FOR-EACH block) Termine le bloc conditionnel de l'instruction FOR-EACH.

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&amp;booking_source=commissions
  • Si un numéro IATA a été attribué à Google:
    https://partner.com?hid=123&amp;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 "&amp;" à sa place. La sortie finale affiche un véritable "&" . 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 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.