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

العنصر الجذر في ملف الصفحات المقصودة هو <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

تحتوي على نص معروض لوكالات السفر على الإنترنت (OTA). يأخذ هذا العنصر السمات التالية:

  • 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.
  • 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 للصفحة المقصودة باستخدام نماذج تتبّع "إعلانات Google" المتوفرة في حسابك على "إعلانات Google" ولاحقة رابط عنوان URL النهائي. في حال عدم توفّر عناوين URL للتتبّع في "إعلانات Google"، يتم تجاهل العنصر <LPURL>.

لا يلزم تخطي قيمة <LPURL>. ويؤدي إعداد ValueTrack الصحيح في "إعلانات Google" إلى تجنّبه تلقائيًا. مثلاً:

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

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

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