Cette page a été traduite par l'API Cloud Translation.

Variables et conditions

Les annonces d'hôtel et les liens de réservation gratuits incluent des liens vers des pages de destination sur lesquelles les utilisateurs peuvent réserver des chambres. Vous pouvez définir la façon dont Google construit le lien pour inclure 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 sans frais s'affiche, les informations dynamiques de l'URL sont remplacées par des valeurs réelles. Pour ajouter des valeurs dynamiques à vos URL de page 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'identifiant et du séjour réels de l'hôtel:

<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 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 à 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 de votre flux Prix de l'hôtel, de votre flux Hotel List Feed et des paramètres utilisateur.

Par exemple,la valeur de la variable LENGTH est attribuée à l'élément <Nights> 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 client.

Pour en savoir plus sur les sources des valeurs de variables, consultez les pages Présentation des tarifs et 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:

Variable	Recommandée/Facultatif	Description
ADVANCE-BOOKING-WINDOW	Optional	Nombre de jours de réservation à l'avance avant la date d'arrivée 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é dans votre flux Hotel List Feed. Il est utile d'avoir des identifiants distincts si vous avez besoin d'un identifiant d'établissement pour les informations de votre flux et d'un autre pour votre moteur de réservation.
CAMPAIGN-ID	Recommended	ID de la campagne Google Ads que vous souhaitez associer à l'URL. Ce champ est vide si le clic n'est pas associé à une campagne Google Ads.
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`, lorsque l'arrivée a lieu, dans le fuseau horaire de l'hôtel). Exemple : `Tuesday`
CHECKINMONTH	Recommended	Mois à deux chiffres défini dans l'élément `<Checkin>` du flux Prix de l'hôtel. Exemple : `05`.
CHECKINYEAR	Recommended	Année à quatre chiffres définie dans l'élément `<Checkin>` du flux Prix de l'hôtel. Exemple : `2023`.
CHECKOUTDAY	Recommended	Jour à deux chiffres calculé à l'aide des éléments `<Nights>` et `<Checkin>` du flux Prix de l'hôtel. Par exemple, `26`.
CHECKOUTMONTH	Recommended	Mois à deux chiffres calculé à l'aide des éléments `<Nights>` et `<Checkin>` du flux Prix de l'hôtel. Par exemple, `05`.
CHECKOUTYEAR	Recommended	Année à quatre chiffres calculée à l'aide des éléments `<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 éléments `<Child "age">` du flux des prix. Cette variable doit être utilisée conjointement avec un bloc conditionnel `FOR-EACH-CHILD-AGE`.
CHILD-INDEX	Optional	Variable de boucle indexée sur 0 représentant un compteur pour chaque enfant et chaque âge de l'enfant spécifié dans le séjour. Bien qu'elle ne soit pas obligatoire, cette variable ne peut être utilisée qu'avec un bloc conditionnel `FOR-EACH-CHILD-AGE`.
CLICK-TYPE	Optional	Indique si l'utilisateur a cliqué sur la fiche pour un tarif d'hôtel standard ou pour une offre de chambres. Les valeurs possibles du champ sont les suivantes : `hotel`: l'utilisateur a cliqué sur la fiche pour obtenir le prix d'une chambre standard. `room`: l'utilisateur a cliqué sur la fiche d'une offre de chambres.
CLOSE-RATE-RULE-IDS	Optional (only applies if you are using conditional or private rates)	Liste d'identifiants de règles d'offres séparés par une virgule pour les tarifs indisponibles, mais qui auraient pu être disponibles si l'utilisateur avait effectué une action mineure. Notez que les identifiants des règles d'offres pour les tarifs préférentiels sont toujours renseignés ici lorsqu'un traitement correspondant dans l'interface utilisateur est proposé à l'utilisateur.
CUSTOM[1-5]	Optional	Valeurs des champs personnalisés définies dans l'élément `<Result>`, avec une limite de 200 caractères par champ personnalisé. Pour en savoir plus, consultez la page Présentation des messages Transaction. Les champs personnalisés ne sont pas disponibles lorsque vous utilisez les flux ARI.
DATE-TYPE	Optional	Indique si l'utilisateur a sélectionné la date par défaut ou une date spécifique fournie dans la recherche. Les valeurs possibles du champ sont les suivantes : `default`: l'utilisateur a cliqué sur une annonce d'hôtel ou un lien de réservation sans frais pour lesquels les dates par défaut étaient utilisées. `selected`: l'utilisateur a cliqué sur une annonce d'hôtel ou un lien de réservation sans frais 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 via une recherche `google.com`. `mapresults`: l'utilisateur a trouvé le lien de réservation d'hôtel sur `maps.google.com`. `verification`: Google utilise cette valeur lorsque des tests automatisés de qualité des données sont effectués sur votre site. Ces requêtes ne vous sont pas facturées. Google Analytics peut utiliser ce paramètre et sa valeur pour identifier le trafic de validation automatique Hotel Ads. `unknown`: l'utilisateur a vu l'annonce ou le lien de réservation sans frais sur une source indéterminée.
LENGTH	Recommended	Durée du séjour exprimée en nombre de nuits définie par l'élément `<Nights>` du 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 de personnes 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 séjour par l'utilisateur. `NUM-CHILDREN`, `FOR-EACH-CHILD-AGE` ou les deux sont obligatoires pour participer aux séjours avec enfants.
NUM-GUESTS	Recommended (if you don't send child occupancy pricing)	Nombre total de personnes, adultes et enfants, que l'utilisateur a indiqué pour le séjour. Cette valeur correspond à 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`.
PACKAGE-ID	Recommended (applies if you use Room Bundles)	Identifiant unique du séjour organisé dans le flux Prix de l'hôtel. Pour un package standard, l'ID de package correspond à la valeur de l'élément `<PackageID>` dans un bloc `<Result>`. Pour une offre de chambres, l'identifiant de la formule correspond à la valeur de l'élément `<PackageID>` dans les blocs `<RoomBundle>` ou `<PackageData>` du message Transaction.
PARTNER-CURRENCY	Optional	Code de devise à trois lettres défini par l'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 l'élément `<id>` du 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 est une valeur de l'élément `<RoomID>` dans le bloc `<Result>`. Pour une offre de chambres, l'identifiant de chambre correspond à la valeur attribuée à l'élément `<RoomID>` dans les blocs `<RoomBundle>` ou `<RoomData>` du message Transaction.
PAYMENT-ID	Optional (only applies to Ads)	Correspond à une chaîne prédéfinie `commission` ou au numéro IATA attribué par Google (par exemple, "01234567"), si vous faites appel à une agence de collecte des commissions. Pour modifier la mise en forme de votre numéro IATA ou de votre chaîne prédéfinie, contactez votre responsable de compte technique (TAM).
PRICE-DISPLAYED-TAX	(Optional)	Montant des taxes affiché dans la devise locale de l'utilisateur. La valeur de l'attribut `PRICE-DISPLAYED-TAX` correspond à celle de l'élément `<Tax>` du flux Prix de l'hôtel. Exemple : "3.14".
PRICE-DISPLAYED-TOTAL	(Optional)	Coût total de la chambre présenté à l'utilisateur, dans sa devise locale. La valeur de `PRICE-DISPLAYED-TOTAL` correspond à 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 des promotions ARI, la valeur de cette variable est attribuée à l'attribut `id` de la `<Promotion>` appliquée. Si plusieurs promotions sont appliquées, il s'agit d'une liste d'identifiants de promotion séparés par une virgule, classés dans un ordre arbitraire. Si vous utilisez des 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)	Identifiant défini par l'élément `<RatePlanID>` dans le bloc `<RoomBundle>` d'un flux des prix. `<RatePlanID>` représente l'identifiant unique d'une combinaison de données de chambre et de séjour organisé. Pour en savoir plus, consultez la section Offres de chambres.
RATE-RULE-ID	Recommended (only applies if you use conditional rates or private rates)	Identifiant défini par l'attribut `rate_rule_id` dans le bloc `<Rate>` d'un flux des prix. Pour en savoir plus, consultez la section Tarifs sous conditions.
USER-COUNTRY	Recommended	Code pays à deux lettres indiquant la position de l'utilisateur. Ces informations sont extraites des paramètres client de l'utilisateur. Exemples : `US` ou `FR`.
USER-CURRENCY	Recommended	Code de devise à trois lettres indiquant la devise locale de l'utilisateur. La valeur de la variable `USER-CURRENCY` est extraite des paramètres client de l'utilisateur. Exemples : `USD` ou `CAD` .
USER-DEVICE	Recommended	Type d'appareil de l'utilisateur. La valeur de `USER-DEVICE` peut être l'une des suivantes : `mobile` `tablet` `desktop` `unknown` La valeur de la variable `USER-DEVICE` est déduite des paramètres client de l'utilisateur.
USER-LANGUAGE	Recommended	Code de langue ISO 639-1 à deux lettres indiquant la langue d'affichage de l'annonce ou du lien de réservation sans frais. La valeur de la variable `USER-LANGUAGE` est déduite des paramètres client de l'utilisateur. Exemples : `en` ou `fr`.
USER-LIST-ID (définie 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 les informations sur les utilisateurs. Les listes d'audience servent de base pour définir des ajustements des enchères. Si l'utilisateur fait partie de plusieurs listes d'audience, celle dont l'ajustement des enchères est le plus élevé est sélectionnée. En cas d'égalité entre les audiences associées à l'ajustement d'enchères le plus élevé, les résultats sont choisis au hasard.
VERIFICATION	Optional	Valeur booléenne qui vérifie si le lien a été généré par Google à des fins de test ou de validation automatique. Cette valeur est `true` si l'association a été générée par Google à des fins de test ou de validation automatisée. Sinon, cette valeur est `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 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:

Condition	Recommandée/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 lien de réservation sans frais.
IF-CLICK-TYPE-HOTEL	Optional	Renvoie `true` si l'utilisateur a cliqué sur la fiche d'un hôtel. Sinon, renvoie `false`.
IF-CLICK-TYPE-ROOM	Optional	Renvoie `true` si l'utilisateur a cliqué sur la fiche d'une offre de chambres. Sinon, renvoie `false`.
IF-CLOSE-RATE-RULE-IDS	Optional	Renvoie `true` si un ou plusieurs tarifs sous conditions étaient indisponibles, car l'utilisateur n'était pas éligible. Sinon, renvoie `false`. Par défaut, cette valeur est `true` si un traitement dans l'interface utilisateur de tarif préférentiel a été présenté à l'utilisateur.
IF-DEFAULT-RATE	Optional	Renvoie `true` si l'utilisateur a cliqué sur une fiche d'hôtel où des dates par défaut étaient utilisées. Sinon, renvoie `false`.
IF-HOTEL-CAMPAIGN	Optional	Renvoie `true` si le clic de l'utilisateur provient d'une campagne d'hôtel. Sinon, renvoie `false`. Cette distinction est utile pour les partenaires qui utilisent plusieurs types de campagnes dans Google Ads afin d'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 participant au programme de commissions de paiement par séjour (PPS). Sinon, renvoie `false`.
IF-PROMO-CODE	Optional	Renvoie `true` si l'utilisateur a cliqué sur un tarif basé sur une promotion ARI ou 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 annonce de promotion d'un établissement. Sinon, renvoie `false`.
IF-RATE-RULE-ID	Optional	Renvoie `true` si l'utilisateur a sélectionné un tarif sous conditions . Sinon, renvoie `false`.
IF-USER-LIST-ID (définie dans Google Ads)	Optional	Renvoie `true` si l'utilisateur est membre d'une liste de clients Google Ads que vous avez spécifiée lors de la définition des multiplicateurs d'enchères pour les listes d'audience. Sinon, renvoie `false`.
IF-VERIFICATION	Optional	Renvoie `true` si le lien a été généré par Google à des fins de test ou de validation automatique. Sinon, renvoie `false`.
ELSE	Recommended (if you use any conditional IF statements)	Si la condition précédente n'est pas remplie, les valeurs qui suivent cette condition sont insérées dans l'URL.
END-IF	Optional (required if you have any IF conditional statements)	Met fin au bloc conditionnel de l'instruction `IF`.
FOR-EACH-CHILD-AGE	Optional (required for child occupancy pricing)	S'exécute une fois pour chaque élément `<Child "age">` du flux des prix. Par exemple, si `<OccupancyDetails>` inclut les deux éléments `<Child age="17">` et `<Child age= "17">`, l'instruction s'exécute deux fois.
END-FOR-EACH	Optional (required if using FOR-EACH block)	Met fin au 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 un lien de réservation sans frais pour le rediriger vers votre page de destination.

L'exemple suivant utilise cette directive 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éfinie sur le prix de l'offre de chambres implicitement associé sélectionné par l'utilisateur.

L'exemple suivant utilise cette directive 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.

L'exemple suivant utilise cette directive 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 suivante est générée:

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. Votre site Web pourra ensuite l'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)<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 ressembler à 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 être semblable à l'URL suivante, 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 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 provenant d'une campagne d'hôtel.

L'exemple suivant utilise cette directive 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 suivante 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 standard sur le Réseau de Recherche), 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 généré par les clics sur des campagnes d'hôtel des autres clics.

CAMPAIGN-ID vides avec clics FBL

Si le clic provient d'un lien de réservation sans frais, 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 une instruction conditionnelle IF-AD-CLICK pour éviter que l'ID de 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 faire varier l'URL selon que le clic provient ou non du programme de commissions PPS. L'exemple ci-dessous vérifie si un clic provient du programme de commissions 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 fait partie du programme "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.

L'exemple suivant utilise cette directive 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 suivante est générée:

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

Si l'utilisateur n'a pas sélectionné d'annonce de promotion d'un établissement, 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> dans le bloc <Rate> du message de transaction est utilisée.

L'exemple suivant utilise cette directive 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 suivante 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 d'hôtel dans 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 appartenant à une liste d'audience Google Ads donnée. Cela peut être utile à des fins de suivi ou pour personnaliser votre site Web 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'était pas membre d'une liste d'audience, l'URL suivante est générée:

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

Si l'utilisateur était membre 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 à des fins de test ou de 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 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, l'URL suivante est générée:

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

Exemple de fonction FOR-EACH-CHILD-AGE

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

L'exemple suivant utilise cette directive 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 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 inclut deux adultes et aucun 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 la création d'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 le séjour et l'utilisateur permet généralement d'améliorer l'expérience de l'utilisateur et de respecter les règles de Google.

Les règles générales suivantes s'appliquent lors de la définition d'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 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. Parce que l'esperluette est un caractère spécial en XML et que le format du fichier des pages de destination est XML. Vous devez donc utiliser l'entité encodée "&". Le résultat final renvoie le véritable caractère "&". Exemple :
```

<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&nights=(LENGTH)</URL>


<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 pourriez 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 ne doivent pas tous être encodés en URL. Par exemple, il n'est pas nécessaire d'encoder les traits d'union ("-"). Pour obtenir la liste des caractères courants devant être encodés en URL, consultez le tableau d'encodage d'URL.
Les valeurs d'un seul paramètre peuvent être créées à 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>
```
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 la chaîne de requête. Votre serveur traite ces valeurs. Cependant, les valeurs que vous transmettez se limitent à la liste des variables disponibles.
Vous pouvez utiliser jusqu'à cinq variables personnalisées en plus de la liste des variables disponibles.