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

लैंडिंग पेजों की फ़ाइल का रूट एलिमेंट <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> एलिमेंट के ज़रिए बताई गई है.

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

  <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 से होटल के बुकिंग लिंक मिला.
  • 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 के स्कीमा पढ़ें