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)
&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)
&checkinYear=(CHECKINYEAR)&nights=(LENGTH)
</URL>
Exemple 2
<URL>https://www.partnerdomain.com/hotel/(PARTNER-HOTEL-ID)
&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)
&checkinYear=(CHECKINYEAR)&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 :
| Variable | Recommandé/Facultatif | Description |
|---|---|---|
| ADVANCE-BOOKING-WINDOW | Optional | Nombre de jours avant la date d'arrivée de la réservation 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 (Monday à Sunday) correspondant à 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é à l'aide des éléments <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 éléments <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 cela 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 d'un hôtel standard
un tarif ou une offre de chambres. Les valeurs possibles du champ sont les suivantes :
|
| 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 des 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 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 le <Result>
avec une limite de 200 caractères par champ personnalisé. Pour en savoir plus, consultez la section Présentation des messages de 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 :
|
| GOOGLE-ADS-CLICK-SOURCE | Optional | Indique que le clic est généré par Google Ads. Les valeurs possibles du champ sont les suivantes :
Remarque : Si le clic provient de la recherche Google plutôt que de Google Ads, ce paramètre est vide. |
| 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 :
|
| 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) que l'utilisateur a indiqué dans le séjour. 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, que l'utilisateur a indiqué pour le séjour. 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 package 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 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 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) | Correspond à une chaîne commission prédéfinie ou au numéro IATA attribué à Google (par exemple, "01234567") si vous faites appel à une agence de collecte des commissions. Pour modifier le format 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 PRICE-DISPLAYED-TAX correspond à la valeur de l'élément <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 des promotions ARI, la valeur de cette variable est attribuée à l'attribut Si vous utilisez des règles d'offres, la valeur de cette variable est attribuée à l'élément |
| RATE-PLAN-ID | Recommended (only applies if you use RoomBundles) | L'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 chambres et de formules. Pour plus
plus d'informations, voir
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 un bloc <Rate> du flux des prix. Pour en savoir plus, consultez 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. Cette information est extraite des paramètres client de l'utilisateur. Pour
Exemple : 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
à partir des paramètres client de l'utilisateur. Par exemple, USD ou CAD . |
| USER-DEVICE | Recommended | Type d'appareil de l'utilisateur. La valeur de USER-DEVICE peut être l'une des valeurs suivantes :
La valeur de la variable |
| USER-LANGUAGE | Recommended | Code de langue ISO 639-1 à deux lettres spécifiant la langue d'affichage de l'annonce ou du 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 les informations sur l'utilisateur. Les listes d'audience servent de base pour définir les 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. Si la valeur de cet ajustement est identique pour plusieurs audiences, la sélection se fait de manière aléatoire. |
| VERIFICATION | Optional | Valeur booléenne qui vérifie si le lien a été généré par Google pour
des tests ou de la validation automatisée. Il s'agit de true si le lien a été généré par Google à des fins de test ou de validation automatique, sinon il s'agit de false.
|
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 directiveELSEsont 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:
| 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 la fiche d'un 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 indisponibles, car l'utilisateur n'était pas éligible. Sinon, renvoie false. Par défaut, la valeur est true si un traitement dans l'UI de tarif préférentiel s'est affiché pour 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 appliqué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. Cette distinction est utile pour les partenaires qui déterminent l'attribution à l'aide de plusieurs types de campagnes dans Google Ads. |
| 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 annonce de promotion d'un établissement. 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 (condition définie 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 à 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, alors les valeurs qui suivent cette condition 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
<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 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)&adType=1(ELSE)&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)&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)&checkinYear=(CHECKINYEAR)&nights=(LENGTH)<strong>(IF-DEFAULT-DATE)</strong>&popup_datepicker=true(ELSE)&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)&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)&hotel_campaign=(CAMPAIGN-ID)(ELSE)&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)&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)&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)&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)&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)&children=(NUM-CHILDREN)(FOR-EACH-CHILD-AGE)&age=(CHILD-INDEX)_(CHILD-AGE)(END-FOR-EACH)&hid=(PARTNER-HOTEL-ID)&</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)&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.
- Espace (" ") : remplacez les espaces par "%20;" dans l'élément
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 VariablesCHECKINDAY,CHECKINMONTHetCHECKINYEAR:<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/1971Vous 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.