लैंडिंग पेज फ़ाइल सिंटैक्स

लैंडिंग पेजों की फ़ाइल का रूट एलिमेंट <PointsOfSale> है. इसमें एक चाइल्ड एलिमेंट <PointOfSale> होता है और कोई एट्रिब्यूट नहीं होता. लैंडिंग पेज की फ़ाइल में कई <PointOfSale> चाइल्ड एलिमेंट हो सकते हैं.

लैंडिंग पेजों की फ़ाइल में तय किया गया हर लैंडिंग पेज, <PointOfSale> एलिमेंट में शामिल होता है. यह एलिमेंट, सिर्फ़ एक एट्रिब्यूट id लेता है. यह एट्रिब्यूट, लैंडिंग पेज के लिए यूनीक आइडेंटिफ़ायर तय करता है. id की वैल्यू का इस्तेमाल करके, मैच करने वाले होटल के लिए ज़रूरी शर्तें पूरी करने वाले लैंडिंग पेजों को फ़िल्टर किया जा सकता है. इसके लिए, <Transaction> में <AllowablePointsOfSale> एलिमेंट का इस्तेमाल करें.

सिंटैक्स

<?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>

यहां दी गई टेबल में, <PointOfSale> एलिमेंट के चाइल्ड एलिमेंट के बारे में बताया गया है:

एलिमेंट ज़रूरी है ब्यौरा
<DisplayNames> Optional

इसमें ऑनलाइन ट्रैवल एजेंसियों (ओटीए) के लिए डिसप्ले टेक्स्ट होता है. इस एलिमेंट में ये एट्रिब्यूट इस्तेमाल किए जाते हैं:

  • display_text: इसमें वह टेक्स्ट होता है जो किसी विज्ञापन या मुफ़्त बुकिंग लिंक में दिखता है. यह पार्टनर का नाम होना चाहिए.
  • display_language: दो अक्षरों वाला भाषा कोड, विज्ञापन या मुफ़्त बुकिंग लिंक की डिसप्ले भाषा के बारे में बताता है. इस एट्रिब्यूट की वैल्यू, <Match> एलिमेंट में बताई गई भाषा से मेल खानी चाहिए.

यहां दिए गए उदाहरण में, फ़्रेंच ओटीए के लिए डिसप्ले नेम दिखाया गया है:

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

सेंट्रल रिज़र्वेशन सिस्टम (सीआरएस) सप्लायर के लिए <DisplayNames> एलिमेंट को शामिल न करें. इन्हें "इंटिग्रेशन पार्टनर" भी कहा जाता है. साथ ही, होटल के मालिकों या चेन जैसे डायरेक्ट सप्लायर के लिए भी इसे शामिल न करें. इस तरह के पार्टनर के लिए, विज्ञापन और मुफ़्त बुकिंग लिंक का टेक्स्ट, होटल की सूची में मौजूद होटल के <Name> एलिमेंट से लिया जाता है.

ध्यान दें: अगर आपने Google की सहायता टीम के साथ मिलकर, ओटीए के लिए डिफ़ॉल्ट डिसप्ले नेम कॉन्फ़िगर किया है, तो यह फ़ील्ड भरना ज़रूरी नहीं है. इसके अलावा, ओटीए को <DisplayNames> की वैल्यू देनी होगी.
<Match> Required

यह फ़िल्टर तय करता है कि आपके विज्ञापन और मुफ़्त बुकिंग लिंक, उपयोगकर्ता या होटल की अलग-अलग विशेषताओं के आधार पर दिखाए जाएं या नहीं. उदाहरण के लिए, यह तय किया जा सकता है कि कोई विज्ञापन या मुफ़्त बुकिंग लिंक सिर्फ़ किसी देश के उपयोगकर्ताओं को दिखाया जाए.

इस एलिमेंट में ये एट्रिब्यूट इस्तेमाल किए जाते हैं:

  • status: इससे यह तय होता है कि किसी मैच में, तय किए गए मानदंड के नतीजे शामिल किए जाएंगे या नहीं. मान्य वैल्यू yes (मेल खाना चाहिए) या never (मेल नहीं खाना चाहिए) हैं.
  • country: उपयोगकर्ता और होटल से जुड़े Google डोमेन पर मैच करता है. इस एट्रिब्यूट की वैल्यू के तौर पर दो अक्षरों वाला देश कोड इस्तेमाल किया जाता है. उदाहरण के लिए, US या FR.
  • language: उपयोगकर्ता और होटल की भाषा से मेल खाता हो. इस एट्रिब्यूट की वैल्यू के तौर पर, दो अक्षरों वाला भाषा कोड दिया जाता है. उदाहरण के लिए, en या fr.
  • brand: यह आपके होटल की सूची में दिए गए hotel_brand एट्रिब्यूट की वैल्यू से मेल खाता है. अगर आपके बुकिंग इंजन या अलग-अलग ब्रैंड के लिए अलग-अलग यूआरएल हैं, तो यह फ़िल्टर आपके काम आ सकता है.
  • currency: उपयोगकर्ता या होटल के देश की मुद्रा से मेल खाता हो. इस एट्रिब्यूट की वैल्यू के तौर पर, तीन अक्षरों वाला मुद्रा कोड इस्तेमाल किया जाता है. उदाहरण के लिए, USD या EUR.
  • sitetype: Google की उस प्रॉपर्टी पर मैच करता है जिस पर किसी उपयोगकर्ता ने आपके होटल के किराये का डेटा देखा था. इस एट्रिब्यूट के लिए, यहां दी गई वैल्यू इस्तेमाल की जा सकती हैं:
    • localuniversal: उपयोगकर्ता को विज्ञापन या बिना शुल्क बुकिंग का लिंक, खोज के ज़रिए मिला. आम तौर पर, ऐसा google.com पर खोज करने से होता है.
    • mapresults: उपयोगकर्ता को होटल का बुकिंग लिंक, maps.google.com के ज़रिए मिला.

      • ध्यान दें: सभी साइट टाइप को never पर सेट करने की अनुमति नहीं है. इस वजह से, sitetype को अनदेखा कर दिया जाएगा.

  • device: यह उस डिवाइस के टाइप से मैच करता है जिसका इस्तेमाल उपयोगकर्ता खोज के लिए करता है. इस एट्रिब्यूट की वैल्यू mobile, desktop या tablet होती है.

    ध्यान दें: अगर device को tablet पर सेट किया गया है, तो status को never पर सेट नहीं किया जा सकता.

उदाहरण के लिए:

<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>

<Match> एलिमेंट के एट्रिब्यूट को एक साथ इस्तेमाल किया जा सकता है, ताकि मैचिंग के नियमों को आसान बनाया जा सके. उदाहरण के लिए, यहां दिया गया तरीका अपनाएं:

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

ज़्यादा जानकारी के लिए, लैंडिंग पेजों से जुड़े मैचिंग के नियम देखें.
<URL> Required इससे आपकी साइट का वह लिंक तय होता है जहां उपयोगकर्ता कमरा बुक कर सकता है. क्वेरी स्ट्रिंग पैरामीटर के तौर पर, उपयोगकर्ता और उसकी यात्रा की योजना के बारे में डाइनैमिक जानकारी डाली जा सकती है. उदाहरण के लिए, यूआरएल में PARTNER-HOTEL-ID वैरिएबल का इस्तेमाल करके, होटल आईडी शामिल किया जा सकता है: 
http://partner.com/landing?hid=(PARTNER-HOTEL-ID)

जब इस लिंक को बनाया जाता है और उपयोगकर्ता को दिखाया जाता है, तब Google PARTNER-HOTEL-ID वैरिएबल को सही होटल आईडी से बदल देता है. जब उपयोगकर्ता आपकी साइट पर क्लिक करता है, तो आपकी साइट सभी क्वेरी स्ट्रिंग पैरामीटर की वैल्यू को निकाल सकती है और उन्हें प्रोसेस कर सकती है. इससे उपयोगकर्ता को बेहतर अनुभव मिलता है. लैंडिंग पेज के यूआरएल में इस्तेमाल किए जा सकने वाले वैरिएबल की पूरी सूची देखने के लिए, वैरिएबल और शर्तों का इस्तेमाल करना लेख पढ़ें.

ट्रैकिंग का इस्तेमाल करते समय, पूरा यूआरएल डालें. इसमें ट्रैकिंग के लिए ज़रूरी कॉम्पोनेंट भी शामिल होने चाहिए. उदाहरण के लिए:

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

<URL> में, ValueTrack पैरामीटर का इस्तेमाल नहीं किया जा सकता.

हर लैंडिंग पेज के लिए, सिर्फ़ एक <URL> एलिमेंट तय किया जा सकता है.
<LPURL> Optional

इस कुकी का इस्तेमाल, लैंडिंग पेज के यूआरएल में डाइनैमिक ट्रैकिंग की सुविधा देने के लिए किया जाता है. <URL> एलिमेंट में तय किए गए यूआरएल के नॉन-ट्रैकिंग सेगमेंट के बारे में बताता है. लैंडिंग पेज यूआरएल के ट्रैकिंग सेगमेंट को Google Ads ट्रैकिंग टेंप्लेट का इस्तेमाल करके तय किया जाना चाहिए. यह आपके Google Ads खाते और फ़ाइनल यूआरएल सफ़िक्स में उपलब्ध होता है. अगर Google Ads में ट्रैकिंग यूआरएल मौजूद नहीं हैं, तो <LPURL> एलिमेंट को अनदेखा कर दिया जाता है.

<LPURL> वैल्यू को एस्केप करने की ज़रूरत नहीं है. Google Ads में सही ValueTrack कॉन्फ़िगरेशन होने पर, यह अपने-आप हट जाता है. उदाहरण के लिए:

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

<LPURL> में, ValueTrack पैरामीटर का इस्तेमाल नहीं किया जा सकता. ज़्यादा जानकारी के लिए, होटल कैंपेन के लिए डाइनैमिक ट्रैकिंग सेट अप करना लेख पढ़ें.

लैंडिंग पेज फ़ाइल स्कीमा, लैंडिंग पेज फ़ाइल के स्ट्रक्चर और सीमाओं के बारे में बताता है. ज़्यादा जानकारी के लिए, Hotel Ads स्कीमा पढ़ें