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 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 la date 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 présente une URL qui utilise les noms de variables Google au lieu de l'ID de l'hôtel et du séjour réels:
<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)
&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)
&checkinYear=(CHECKINYEAR)&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 à l'hôtel 42 pour six nuits à partir du 23/05/2023, 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 dans la chaîne de requête dépendent des données correspondantes de votre flux Prix de l'hôtel et de votre flux Hotel List Feed, ainsi que 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 qui correspond 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 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é/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 peut s'avérer 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 , date d'arrivée, 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é à partir 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 d'enfant spécifiés dans le séjour. Bien que ce 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 :
|
CLOSE-RATE-RULE-IDS | Optional (only applies if you are using conditional or private rates) | Liste des ID de règles d'offres séparés par une virgule correspondant aux tarifs qui n'étaient pas disponibles, mais qui auraient pu l'être si l'utilisateur avait effectué une action mineure. Notez que les identifiants des règles d'offres des tarifs préférentiels sont toujours renseignés ici lorsqu'un traitement correspondant dans l'interface utilisateur est présenté à l'utilisateur. |
CUSTOM[1-5] | Optional | Valeurs des champs personnalisés définis 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 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 :
|
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 dans 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 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 ou FOR-EACH-CHILD-AGE (ou les deux) sont obligatoires pour participer correctement 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 . |
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 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) | Renvoie une chaîne prédéfinie commission ou le 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 la 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 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 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) | Identifiant défini par l'élément <RatePlanID> dans le bloc <RoomBundle> du flux des prix. <RatePlanID> représente l'identifiant unique d'une combinaison de données de chambre et de formule. 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> du flux des prix. Pour en savoir plus, consultez la section
Tarifs sous conditions.
Remarque:Seuls les tarifs sous conditions ou préférentiels qui ne sont pas masqués sont affichés. |
USER-COUNTRY | Recommended | Code pays à deux lettres indiquant la zone géographique 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 déduite 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 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 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é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 utilisateur. 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. Les audiences à égalité parmi les audiences dont l'ajustement des enchères est le plus important sont déterminées 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 le lien a été généré par Google à des fins de test ou de validation automatisée. Sinon, la 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 suivant l'instructionELSE
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é/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 une fiche pour une
offre de chambres. Sinon, renvoie false . |
IF-CLOSE-RATE-RULE-IDS | Optional | Renvoie true si un ou plusieurs tarifs sous conditions sont indisponibles parce que l'utilisateur n'est pas éligible. Sinon, renvoie false . Par défaut, la valeur est true si un tarif préférentiel
a été présenté à l'utilisateur dans l'interface utilisateur. |
IF-DEFAULT-RATE | Optional | Renvoie true si l'utilisateur a cliqué sur une fiche d'hôtel utilisant des dates par défaut. 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 disposent de plusieurs types de campagnes 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 participant au programme de commissions de paiement par séjour (PPS) renvoie false . |
IF-PROMO-CODE | Optional | Renvoie true si l'utilisateur a cliqué sur un tarif basé sur une promotion ARI ou sur une règle d'offres associée à 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éfini dans Google Ads) | Optional | Renvoie true si l'utilisateur fait partie d'un ID de liste de clients Google Ads que vous avez spécifié lors de la définition de 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 automatisée. 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) | 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 élément
<Child "age"> du flux des prix. Par exemple, si <OccupancyDetails> inclut les deux éléments <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 un lien de réservation sans frais pour le rediriger 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éfinie sur le prix de l'offre de chambres implicitement associé que l'utilisateur a sélectionné.
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, 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.
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, 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 qui n'est pas une date, que votre site Web peut ensuite 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)&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, le résultat peut être semblable à 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 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.
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 suivante est générée:
https://www.partner.com?hotelID=123&hotel_campaign=12345678
Si le clic ne provient pas d'une URL de 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 des autres clics.
ID de campagne CAMPAIGN-ID vides avec des 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 l'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)&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 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)&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.
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, 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 tel est le cas, la valeur de l'élément <RateRuleID>
dans le bloc <Rate>
du message Transaction est utilisée.
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 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 certaine liste d'audience Google Ads. Cela peut être utile à des fins de suivi ou pour personnaliser votre site Web pour les 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'est 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)&isgoogle=true(ENDIF)</URL>
Dans cet exemple, si Google n'a pas 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
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 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)&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 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 comprend 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 les informations sur le séjour et l'utilisateur améliore généralement l'expérience de l'utilisateur et vous aide à respecter les règles de Google.
Les règles générales suivantes s'appliquent lorsque vous définissez des URL créées 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 la sortie finale. Comme l'esperluette est un caractère spécial en XML et que le format du fichier des pages de destination est XML. Par conséquent, vous devez utiliser l'entité encodée "&" à la place. Le résultat final 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 êtes susceptible d'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 dans l'URL. Par exemple, il n'est pas nécessaire d'encoder les traits d'union ("-") dans l'URL. Pour obtenir la liste des caractères courants devant être encodés dans l'URL, consultez le tableau d'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. L'exemple suivant construit un seul paramètre,
checkinDate
, à partir des variablesCHECKINDAY
,CHECKINMONTH
etCHECKINYEAR
:<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 à la liste des variables disponibles.
Vous pouvez utiliser jusqu'à cinq variables personnalisées en plus de la liste des variables disponibles.