Syntaxe du fichier de pages de destination

L'élément racine du fichier de pages de destination est <PointsOfSale>,qui accepte un élément enfant <PointOfSale> et n'a aucun attribut. Un fichier de pages de destination peut comporter plusieurs éléments enfants <PointOfSale>.

Chaque page de destination que vous définissez dans le fichier de pages de destination est incluse dans un élément <PointOfSale>. Cet élément comporte un seul attribut, id, qui définit un identifiant unique pour une page de destination. Vous pouvez utiliser la valeur id afin de filtrer les pages de destination éligibles pour un hôtel correspondant. Pour ce faire, utilisez l'élément <AllowablePointsOfSale> dans <Transaction>.

Syntaxe

<?xml version="1.0" encoding="UTF-8"?>
<PointsOfSale>
  <PointOfSale id="landing_page_id">
    <DisplayNames display_text="landing_page_display_name" display_language="language_code"/>
    <Match status="[yes|never]"
      country="country_code"
      language="language_code"
      brand="booking_engine or brand"
      currency="currency_code"
      sitetype="[localuniversal|mapresults]"
      device="[desktop|mobile|tablet]"/>
    <!-- The dynamic landing page URL -->
    <URL>landing_page_url</URL>
  </PointOfSale>
</PointsOfSale>

Le tableau suivant décrit les éléments enfants de l'élément <PointOfSale>:

Élément Obligatoire Description
<DisplayNames> Optional

Contient le texte à afficher pour les agences de voyages en ligne. Cet élément comporte les attributs suivants:

  • display_text: contient le texte affiché dans une annonce ou un lien de réservation sans frais. Il doit s'agir du nom du partenaire.
  • display_language: code de langue à deux lettres indiquant la langue d'affichage de l'annonce ou du lien de réservation sans frais. La valeur de cet attribut doit correspondre à une langue acceptée spécifiée par l'élément <Match>.

L'exemple suivant présente un nom à afficher pour une agence de voyages en ligne française:

  <DisplayNames
    display_text="TravelAgency.com.fr"
    display_language="fr"
  />

Exclure l'élément <DisplayNames> pour les fournisseurs de centrales de réservation, également appelés "partenaires d'intégration", et pour les fournisseurs directs tels que les propriétaires ou les chaînes d'hôtels. Pour ces types de partenaires, le texte de l'annonce et du lien de réservation sans frais est issu de l'élément <Name> de l'hôtel dans la liste d'hôtels.

Remarque:Pour les agences de voyages en ligne, ce champ est facultatif si vous avez configuré un nom à afficher par défaut auprès de l'assistance Google. Sinon, les agences de voyages en ligne doivent fournir <DisplayNames>.

<Match> Required

Définit les filtres permettant d'afficher ou non vos annonces et liens de réservation gratuits en fonction de diverses caractéristiques de l'utilisateur ou de l'hôtel. Par exemple, vous pouvez indiquer qu'une annonce ou un lien de réservation sans frais ne s'affiche qu'auprès des utilisateurs d'un pays donné.

Cet élément comporte les attributs suivants:

  • status: détermine si une correspondance doit inclure ou exclure les résultats pour le critère spécifié. Les valeurs valides sont yes (doit correspondre) ou never (ne doit pas correspondre).
  • country: établit la correspondance sur le domaine Google associé à l'utilisateur et à l'hôtel. La valeur de cet attribut doit être un code pays à deux lettres. Par exemple, US ou FR.
  • language: établit la correspondance en fonction de la langue de l'utilisateur et de l'hôtel. La valeur de cet attribut doit être un code de langue à deux lettres. Par exemple : en ou fr.
  • brand: établit la correspondance en fonction de la valeur de l'attribut hotel_brand spécifié dans votre liste d'hôtels. Ce filtre peut être utile si vous avez des URL différentes pour vos moteurs de réservation ou différentes marques.
  • currency: établit la correspondance sur la devise du pays de l'utilisateur ou de l'hôtel. La valeur de cet attribut doit être un code de devise à trois lettres. Exemples : USD ou EUR.
  • sitetype: établit la correspondance avec le site Google sur lequel l'utilisateur a consulté les données tarifaires de votre hôtel. Les valeurs possibles pour cet attribut sont les suivantes :
    • localuniversal: l'utilisateur a vu l'annonce ou le lien de réservation sans frais en effectuant une recherche, généralement sur google.com.
    • mapresults: l'utilisateur a trouvé le lien de réservation d'hôtel sur maps.google.com.
  • device: établit la correspondance sur le type d'appareil que l'utilisateur utilise pour effectuer sa recherche. La valeur de cet attribut est mobile, desktop ou tablet.

    REMARQUE:Vous ne pouvez pas définir status sur never si device est défini sur tablet.

Exemple :

<PointOfSale id="test1">
  <Match status="yes" country="US"/>
  <Match status="yes" currency="USD"/>
  <Match status="yes" device="mobile"/>
  <Match status="yes" language="en"/>
  <URL>www.google.com</URL>
</PointOfSale>

Vous pouvez combiner les attributs de l'élément <Match> pour simplifier vos règles de correspondance, comme le montre l'exemple suivant:

<PointOfSale id="test1">
  <Match
    status="yes"
    country="US"
    language="en"
    currency="USD"
    device="mobile"/>
  <URL>www.google.com</URL>
</PointOfSale>

Pour en savoir plus, consultez les Règles de correspondance des pages de destination.

<URL> Required Définit un lien vers votre site sur lequel l'utilisateur peut réserver une chambre. Vous pouvez insérer des informations dynamiques sur l'utilisateur et son séjour en tant que paramètres de chaîne de requête. Par exemple, vous pouvez inclure l'identifiant de l'hôtel en utilisant la variable PARTNER-HOTEL-ID dans l'URL :
http://partner.com/landing?hid=(PARTNER-HOTEL-ID)

Lorsque ce lien est créé et présenté à l'utilisateur, Google remplace la variable PARTNER-HOTEL-ID par l'identifiant d'hôtel approprié. Lorsque l'utilisateur clique pour accéder à votre site, celui-ci peut extraire et traiter les valeurs de tous les paramètres de la chaîne de requête afin de créer une expérience utilisateur fluide. Pour obtenir la liste complète des variables autorisées dans l'URL de page de destination, consultez Utiliser des variables et des conditions.

Lorsque vous utilisez le suivi, spécifiez l'URL complète, y compris les composants nécessaires au suivi. Exemple :

https://example.tracker.com?campaign_id=(CAMPAIGN-ID)&amp;t_url=
http://partner.com/landing%3Fhid%3D(PARTNER-HOTEL-ID)

Impossible d'utiliser des paramètres ValueTrack dans <URL>.

Vous ne pouvez définir qu'un seul élément <URL> par page de destination.

<LPURL> Optional

Utilisé pour permettre le suivi dynamique dans l'URL de la page de destination. Spécifie le segment hors suivi de l'URL définie dans l'élément <URL>. Les segments de suivi de l'URL de la page de destination doivent être spécifiés à l'aide des modèles de suivi Google Ads disponibles dans votre compte Google Ads et du suffixe de l'URL finale. Si les URL de suivi ne sont pas présentes dans Google Ads, l'élément <LPURL> est ignoré.

Il n'est pas nécessaire d'échapper la valeur <LPURL>. Une configuration ValueTrack correcte dans Google Ads échappe automatiquement l'attribut. Exemple :

http://partner.com/landing?hid=(PARTNER-HOTEL-ID)

Impossible d'utiliser des paramètres ValueTrack dans <LPURL>. Pour en savoir plus, consultez Configurer le suivi dynamique pour une campagne d'hôtel.

Le schéma du fichier de pages de destination définit la structure et les contraintes de ce fichier. Pour en savoir plus, consultez Schémas Hotel Ads.