بنية ملف الصفحات المقصودة

العنصر الجذر لملف الصفحات المقصودة هو <PointsOfSale> الذي يتضمّن عنصرًا فرعيًا واحدًا، وهو <PointOfSale>، ولا يحتوي على أي سمات. يمكن أن يحتوي ملف الصفحات المقصودة على عناصر <PointOfSale> ثانوية متعددة.

يتم تضمين كل صفحة مقصودة تحدّدها في ملف الصفحات المقصودة ضمن عنصر <PointOfSale>. يأخذ هذا العنصر سمة واحدة، وهي id التي تحدّد معرّفًا فريدًا لصفحة مقصودة. يمكنك استخدام قيمة id لفلترة الصفحات المقصودة المؤهَّلة لفندق مطابق. يمكنك إجراء ذلك باستخدام العنصر <AllowablePointsOfSale> في <Transaction>.

البنية

<?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> لمورّدي نظام الحجز المركزي (CRS)، المعروفين أيضًا باسم "شركاء التكامل"، والمورّدين المباشرين، مثل مالكي الفنادق أو سلاسل الفنادق. بالنسبة إلى هذا النوع من الشركاء، يتم استخراج نص الإعلان ونص رابط الحجز المجاني من العنصر <Name> الخاص بالفندق في قائمة الفنادق.

ملاحظة: بالنسبة إلى وكالات السفر على الإنترنت، إذا كنت قد أعددت اسم عرض تلقائيًا مع فريق دعم Google، يصبح هذا الحقل اختياريًا. وفي الحالات الأخرى، يجب أن تقدّم وكالات السفر على الإنترنت السمة <DisplayNames>.
<Match> Required

تحدّد هذه السمة الفلاتر التي تحدّد ما إذا كان سيتم عرض إعلاناتك وروابط الحجز المجانية استنادًا إلى خصائص مختلفة للمستخدم أو الفندق. على سبيل المثال، يمكنك تحديد عرض إعلان أو رابط حجز مجاني للمستخدمين في بلد معيّن فقط.

يأخذ هذا العنصر السمات التالية:

  • ‫status: تحدّد هذه السمة ما إذا كانت المطابقة تتضمّن نتائج المعيار المحدّد أو تستبعدها. القيم الصالحة هي yes (يجب أن تتطابق) أو never (يجب ألا تتطابق).
  • country: تطابق مع نطاق Google المرتبط بالمستخدم والفندق. تتلقّى هذه السمة رمز بلد مكوّنًا من حرفَين. على سبيل المثال، US أو FR.
  • language: تطابق لغة المستخدم ولغة الفندق تتلقّى هذه السمة رمز لغة مكوّنًا من حرفَين. على سبيل المثال، en أو fr.
  • ‫brand: تطابق مع قيمة السمة hotel_brand المحدّدة في قائمة الفنادق. يمكن أن تكون هذه الفلتر مفيدة إذا كان لديك عناوين URL مختلفة لمحركات الحجز أو علامات تجارية مختلفة.
  • ‫currency: تطابق العملة مع عملة المستخدم أو البلد الذي يقع فيه الفندق تتلقّى هذه السمة رمز عملة مكوّنًا من ثلاثة أحرف. على سبيل المثال، USD أو EUR.
  • sitetype: عدد المطابقات على خدمة Google التي اطّلع فيها المستخدم على بيانات أسعار الفندق تتلقّى هذه السمة القيم التالية:
    • localuniversal: عثر المستخدم على الإعلان أو رابط الحجز المجاني من خلال البحث، وعادةً ما يكون ذلك من خلال البحث على google.com.
    • mapresults: عثر المستخدِم على رابط الحجز في الفندق من خلال maps.google.com.

      • ملاحظة: لا يُسمح بضبط جميع أنواع المواقع على never. سيؤدي ذلك إلى تجاهل sitetype.

  • device: تطابُق حسب نوع الجهاز الذي يستخدمه المستخدِم في البحث. تأخذ هذه السمة القيمة mobile أو desktop أو tablet.

    ملاحظة: لا يمكنك ضبط status على never إذا تم ضبط device على tablet.

على سبيل المثال:

<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 في عنوان URL: 
http://partner.com/landing?hid=(PARTNER-HOTEL-ID)

عند إنشاء هذا الرابط وعرضه للمستخدم، تستبدل Google المتغيّر PARTNER-HOTEL-ID بمعرّف الفندق المناسب. عندما ينقر المستخدِم على موقعك الإلكتروني، يمكن لموقعك الإلكتروني استخراج قيم جميع مَعلمات سلسلة طلب البحث ومعالجتها لتقديم تجربة سلسة للمستخدِم. للاطّلاع على القائمة الكاملة بالمتغيرات المسموح بها في عنوان URL الخاص بالصفحة المقصودة، يُرجى الاطّلاع على استخدام المتغيرات والشروط.

عند استخدام التتبّع، حدِّد عنوان URL الكامل بما في ذلك المكوّنات اللازمة للتتبّع. على سبيل المثال:

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

لا يمكن استخدام مَعلمات ValueTrack في <URL>.

يمكنك تحديد عنصر <URL> واحد فقط لكل صفحة مقصودة.
<LPURL> Optional

تُستخدَم لدعم التتبُّع الديناميكي في عنوان URL الخاص بالصفحة المقصودة. تحدّد هذه السمة الجزء غير المتتبّع من عنوان URL المحدّد في العنصر <URL>. يجب تحديد شرائح التتبُّع الخاصة بعنوان URL للصفحة المقصودة باستخدام نماذج التتبُّع في &quot;إعلانات Google&quot; المتوفّرة في حسابك على &quot;إعلانات Google&quot; ولاحقة رابط عنوان URL النهائي. في حال عدم توفّر عناوين URL للتتبّع في &quot;إعلانات Google&quot;، سيتم تجاهل العنصر <LPURL>.

ليس من الضروري إلغاء تسلسل قيمة <LPURL>. وبما أنّ عنصر LPURL هو الصفحة المقصودة النهائية، لا حاجة إلى تخطّيه مرة أخرى. كما أنّ إعدادات ValueTrack الصحيحة في "إعلانات Google" ستتخطاه تلقائيًا. على سبيل المثال:

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

لا يمكن استخدام مَعلمات ValueTrack في <LPURL>. لمزيد من المعلومات، اطّلِع على إعداد ميزة التتبُّع الديناميكي في "حملة فندق".

يحدّد مخطط ملفات الصفحات المقصودة بنية وقيود ملفات الصفحات المقصودة. لمزيد من المعلومات، اطّلِع على مخططات إعلانات الفنادق.