المتغيرات والشروط

تتضمّن إعلانات الفنادق والروابط المجانية للحجز روابط تؤدي إلى الصفحات المقصودة التي يمكن للمستخدمين من خلالها حجز الغرف. يمكنك تحديد كيفية إنشاء Google للرابط لتضمين كل المعلومات الإضافية عن المستخدم وبرنامج رحلته. على سبيل المثال، يمكنك تضمين معلومات مثل معرّف الفندق واللغة ورموز العملة وتواريخ تسجيل الوصول في عنوان URL.

نظرة عامة

حدِّد عنوان URL للصفحة المقصودة في ملف الصفحات المقصودة. عند عرض الإعلان أو رابط الحجز المجاني، يتم استبدال المعلومات الديناميكية في عنوان URL بالقيم الفعلية. لإضافة قيم ديناميكية إلى عناوين URL للصفحات المقصودة، استخدِم البنية التالية:

<URL>https://partner_url?param_id=(variable_name)</URL>

تعرض الأمثلة التالية عنوان URL يستخدم أسماء متغيّرات Google بدلاً من رقم تعريف الفندق وبرنامج الرحلة الفعليَين:

مثال 1

<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)
  &amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)
  &amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)
</URL>

مثال 2

<URL>https://www.partnerdomain.com/hotel/(PARTNER-HOTEL-ID)
  &amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)
  &amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)
</URL>

عند إنشاء رابط الصفحة المقصودة لصفحة نتائج البحث، يحلّ محرّك بحث Google القيم الفعلية محلّ المتغيّرات لضمان أن يتضمّن عنوان URL المعلومات الديناميكية. على سبيل المثال، إذا حجز المستخدم غرفة لمدة 6 ليالٍ بدءًا من 23 أيار (مايو) 2023 في الفندق رقم 42، تعرِض Google الرابط السابق على النحو التالي:

https://www.partnerdomain.com?hotelID=42&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=6

إنّ القيم التي تحدّدها Google للمتغيّرات في سلسلة طلب البحث تعتمد على البيانات المقابلة في "خلاصة أسعار الفنادق" و"خلاصة قائمة الفنادق" وإعدادات المستخدم.

على سبيل المثال، يتم تعيين قيمة المتغير LENGTH للعنصر <Nights> من خلاصة الأسعار لبرنامج الرحلة ذي الصلة. وبالمثل، يتم تحديد قيمة المتغيّر PARTNER-HOTEL-ID في العنصر <id> من خلاصة قائمة الفنادق التي تطابق معايير بحث المستخدم.

بعض المتغيّرات هي مجموعات فرعية من عناصر خلاصة الأسعار. على سبيل المثال، يتم استخراج المتغيّرات CHECKINDAY وCHECKINMONTH وCHECKINYEAR من العنصر <Checkin> الفردي في خلاصة الأسعار. يتم حساب المتغيرات الأخرى بناءً على لغة المستخدم وإعدادات البرنامج الأخرى.

لمزيد من المعلومات عن مصادر قيم المتغيّرات، راجِع نظرة عامة على الأسعار وقائمة الفنادق.

متغيرات عناوين URL

يوضّح الجدول التالي المتغيّرات المتاحة التي يمكنك استخدامها لإنشاء عنوان URL لصفحتك المقصودة:

متغير يُنصح بها/اختيارية الوصف
ADVANCE-BOOKING-WINDOW Optional عدد أيام الحجز المُسبَق قبل تاريخ تسجيل الوصول في المنطقة الزمنية للفندق في وقت الحجز مثلاً: 36
ALTERNATE-HOTEL-ID Recommended (if you have separate IDs to identify properties versus booking engines) معرّف بديل لموقعك. تم تحديد اسم السمة هذا في خلاصة بيانات الفنادق. من المفيد استخدام أرقام تعريف منفصلة إذا كنت بحاجة إلى معرّف موقع واحد لمعلومات خلاصتك ومعرّف موقع آخر لمحرّك الحجز.
CAMPAIGN-ID Recommended رقم تعريف حملة "إعلانات Google" التي تريد ربطها بعنوان URL. يكون هذا الحقل فارغًا إذا لم تكن النقرة مرتبطة بحملة على &quot;إعلانات Google&quot;.
CHECKINDAY Recommended اليوم المكوّن من رقمين والمحدّد في عنصر <Checkin> في خلاصة أسعار الفنادق مثلاً: 20
CHECKINDAY-OF-WEEK Optional اليوم من الأسبوع (من Monday إلى Sunday) الذي يتم فيه تسجيل الوصول حسب المنطقة الزمنية للفندق. على سبيل المثال، Tuesday.
CHECKINMONTH Recommended الشهر المكوّن من رقمَين المحدّد في العنصر <Checkin> في "خلاصة أسعار الفندق". مثلاً: 05
CHECKINYEAR Recommended السنة المكونة من أربعة أرقام والمحدّدة في عنصر <Checkin> في خلاصة أسعار الفنادق. مثلاً: 2023
CHECKOUTDAY Recommended اليوم المكوّن من رقمَين ويتم احتسابه من عنصرَي <Nights> و <Checkin> في خلاصة أسعار الفنادق. على سبيل المثال، 26.
CHECKOUTMONTH Recommended الشهر المكوّن من رقمَين ويتم احتسابه من عنصرَي <Nights> و<Checkin> في خلاصة أسعار الفنادق. على سبيل المثال، 05.
CHECKOUTYEAR Recommended السنة المكوّنة من أربعة أرقام والتي يتم احتسابها من العنصرَين <Nights> و<Checkin> في "خلاصة أسعار الفنادق". على سبيل المثال، 2023.
CHILD-AGE Recommended (must be provided for child occupancy pricing) الحد الأقصى لعمر كل طفل كما هو محدّد في عناصر <Child "age"> لخلاصة الأسعار. يجب استخدام هذا المتغير مع كتلة شرطية FOR-EACH-CHILD-AGE.
CHILD-INDEX Optional متغيّر حلقة مُفهرس بـ 0 يمثّل عدادًا لكل طفل يقيم في الفندق وعمر الطفل المحدّد في برنامج الرحلة ومع أنّ هذا المتغيّر ليس إلزاميًا، لا يمكن استخدامه إلا مع جزء شرطي FOR-EACH-CHILD-AGE.
CLICK-TYPE Optional يشير إلى ما إذا كان المستخدم قد نقر على بيانات الفندق لعرض سعره العادي أو لعرض حزمة غرف. القيم المتاحة:
  • hotel: نقر المستخدم على بطاقة بيانات المتجر الخاصة بسعر عادي للإقامة.
  • room: نقر المستخدم على بطاقة بيانات مجموعة غرف.
CLOSE-RATE-RULE-IDS Optional (only applies if you are using conditional or private rates) قائمة مفصولة بفواصل بأرقام تعريف قواعد الأسعار للأسعار التي كانت غير متاحة، ولكن كان من الممكن أن تكون متاحة إذا اتخذ المستخدم إجراءً بسيطًا. يُرجى العِلم أنّه يتم دائمًا تعبئة معرّفات قواعد الأسعار الخاصة بالأسعار الخاصة هنا عند عرض معالجة واجهة مستخدم مقابلة للمستخدم.
CUSTOM[1-5] Optional قيم الحقول المخصّصة المحدّدة في العنصر <Result> بعدد الأحرف المسموح به 200 حرف لكل حقل مخصّص لمزيد من المعلومات، راجِع القسم نظرة عامة على رسائل المعاملات. لا تتوفّر الحقول المخصّصة عند استخدام ARI.
DATE-TYPE Optional يشير إلى ما إذا كان المستخدم قد اختار التاريخ التلقائي أو تاريخًا معيّنًا تم تقديمه في البحث. القيم المحتمَلة هي:
  • default: نقر المستخدم على إعلان فندق أو رابط مجاني للحجز تم استخدام التواريخ التلقائية فيه.
  • selected: نقر المستخدم على إعلان فندق أو رابط مجاني للحجز مع ضبط التواريخ.
GOOGLE-ADS-CLICK-SOURCE Optional تشير إلى أنّ "إعلانات Google" كانت مصدر النقرة. القيم المتاحة:
  • bl: روابط الحجز المدفوعة
  • tpa: إعلانات الترويج للسفر
  • tfsa: خلاصات السفر في "الإعلانات على شبكة البحث"
  • pm: "حملات الأداء الأفضل" أو "حملات الأداء الأفضل" المستندة إلى أهداف السفر
  • ملاحظة: إذا كانت النقرة مصدرها "بحث Google" بدلاً من "إعلانات Google"، تكون هذه المَعلمة فارغة.

GOOGLE-SITE Optional الموقع الإلكتروني على Google الذي شاهد أحد المستخدمين بيانات أسعار فنادقك عليه. القيم المتاحة:
  • localuniversal: عثر المستخدم على رابط الحجز في الفندق من خلال البحث على google.com.
  • mapresults: عثر المستخدم على رابط الحجز في الفندق من خلال maps.google.com.
  • verification: يستخدم محرّك بحث Google هذه القيمة عند إجراء اختبارات مبرمَجة لجودة البيانات على موقعك الإلكتروني. ولا يتم تحصيل رسوم منك مقابل طلبات البحث هذه. يمكن لخدمة "إحصاءات Google" استخدام هذه المَعلمة وقيمتها لتحديد زيارات عملية إثبات الهوية الآلية في "إعلانات الفنادق".
  • unknown: عثر المستخدم على الإعلان أو رابط الحجز المجاني من خلال مصدر غير محدّد.
LENGTH Recommended مدة الإقامة من حيث عدد الليالي التي يحدّدها العنصر <Nights> في "خلاصة أسعار الفندق". على سبيل المثال، 3.
NUM-ADULTS Recommended (must be used with the NUM-CHILDREN or FOR-EACH-CHILD-AGE condition) عدد الأشخاص البالغين الذين حدّدهم المستخدم في برنامج الرحلة يجب استخدام هذا المتغيّر مع NUM-CHILDREN أو FOR-EACH-CHILD-AGE أو كليهما.
NUM-CHILDREN Recommended عدد النزلاء الأطفال (الذين تتراوح أعمارهم بين 0 و17 عامًا) المحدّد في برنامج الرحلة من قِبل المستخدم. يجب أن يكون الرقم NUM-CHILDREN أو FOR-EACH-CHILD-AGE أو كليهما مطلوبًا للمشاركة بنجاح في برامج الرحلات مع النزلاء الأطفال.
NUM-GUESTS Recommended (if you don't send child occupancy pricing) إجمالي عدد النزلاء، البالغين والأطفال، المحدّد لبرنامج الرحلة من قِبل المستخدم. وهذه القيمة هي مجموع القيمتَين NUM-ADULTS وNUM-CHILDREN. لزيادة المشاركة إلى أقصى حد، ننصحك بشدة باستخدام كل من NUM-ADULTS وNUM-CHILDREN بدلاً من ذلك.
PACKAGE-ID Recommended (applies if you use Room Bundles) المعرّف الفريد للحزمة في "خلاصة أسعار الفندق". وبالنسبة إلى الحزمة العادية، يكون معرِّف الحزمة هو قيمة العنصر <PackageID> داخل كتلة <Result>. بالنسبة إلى حزمة الغرف، يكون معرّف الحزمة هو قيمة العنصر <PackageID> ضمن العنصرين <RoomBundle> أو <PackageData> في رسالة المعاملة.
PARTNER-CURRENCY Optional رمز العملة المكوّن من ثلاثة أحرف والذي تم تحديده من خلال سمة currency في العنصر <Baserate> في خلاصة أسعار الفنادق على سبيل المثال، USD أو CAD .
PARTNER-HOTEL-ID Recommended المعرّف الفريد للفندق الذي يحدّده العنصر <id> في خلاصة قوائم الفنادق
PARTNER-ROOM-ID Recommended (applies if you use Room Bundles) المعرّف الفريد للغرفة في خلاصة أسعار الفنادق بالنسبة إلى الغرفة العادية، يكون رقم تعريف الغرفة هو قيمة العنصر <RoomID> ضمن العنصر<Result> . بالنسبة إلى حزمة الغرف، يكون رقم تعريف الغرفة هو القيمة المحدّدة للعنصر <RoomID> ضمن العنصرين <RoomBundle> أو <RoomData> في رسالة المعاملة.
PAYMENT-ID Optional (only applies to Ads) يتطابق مع سلسلة commission محدّدة مسبقًا أو رقم الاتحاد الدولي للنقل الجوي المحدَّد من Google (مثلاً، "01234567")، إذا كنت تستعين بوكالة تحصيل عمولات. لتغيير تنسيق رقم الاتحاد الدولي للنقل الجوي أو السلسلة المحدَّدة مسبقًا، يُرجى التواصل مع المدير التقني للحسابات (TAM).
PRICE-DISPLAYED-TAX (Optional) مبلغ الضريبة المعروض للمستخدم بعملته المحلية قيمة PRICE-DISPLAYED-TAX هي قيمة العنصر <Tax> في خلاصة أسعار الفنادق. على سبيل المثال، "3.14".
PRICE-DISPLAYED-TOTAL (Optional) تمثّل هذه السمة إجمالي تكلفة الغرفة التي يتم عرضها للمستخدم بالعملة المحلية للمستخدم. وتُمثّل قيمة PRICE-DISPLAYED-TOTAL مجموع العناصر <Baserate> و<Tax> و<OtherFees> من "خلاصة أسعار الفنادق". مثلاً، "152.13".
PROMO-CODE (Optional)

في حال استخدام العروض الترويجية في أسلوب ARI، يتمّ تعيين قيمة هذا المتغيّر إلى سمة id في <Promotion> المُطبَّق. في حال تطبيق عدة عروض ترويجية، ستظهر لك قائمة بمعرّفات العروض الترويجية مفصولة بفواصل وبترتيب عشوائي.

في حال استخدام القواعد المتعلّقة بالأسعار، يتمّ تعيين قيمة هذا المتغيّر إلى العنصر PromoCode في حال تطبيق قاعدة الأسعار المقابلة.

RATE-PLAN-ID Recommended (only applies if you use RoomBundles) تمثّل هذه السمة المعرّف على النحو المحدّد في العنصر <RatePlanID> في مجموعة <RoomBundle> ضمن خلاصة الأسعار. يمثّل الرمز <RatePlanID> المعرّف الفريد لمزيج بيانات الغرفة والحزمة. لمزيد من المعلومات، يُرجى الاطّلاع على حِزم الغرف.
RATE-RULE-ID Recommended (only applies if you use conditional rates or private rates) المعرّف كما هو محدّد من خلال سمة rate_rule_id ضمن ملف بيانات الأسعار في قسم <Rate> لمزيد من المعلومات، راجِع الأسعار المشروطة.

ملاحظة: تظهر فقط الأسعار المشروطة أو الأسعار الخاصة غير المخفية.

USER-COUNTRY Recommended رمز بلد مكوّن من حرفَين يشير إلى الموقع الجغرافي للمستخدم يتم استخراج هذه المعلومات من إعدادات العميل لدى المستخدم. على سبيل المثال، US أو FR.
USER-CURRENCY Recommended رمز عملة مكوّن من ثلاثة أحرف يشير إلى العملة المحلية للمستخدم. يتم استنتاج قيمة المتغيّر USER-CURRENCY من إعدادات العميل لدى المستخدِم. على سبيل المثال، USD أو CAD .
USER-DEVICE Recommended نوع جهاز المستخدم يمكن أن تكون قيمة USER-DEVICE إحدى القيم التالية:
  • mobile
  • tablet
  • desktop
  • unknown

يتم استنتاج قيمة المتغيّر USER-DEVICE من إعدادات البرنامج لدى المستخدم.

USER-LANGUAGE Recommended رمز لغة مكوّن من حرفَين وفقًا لمعيار ISO 639-1 ويحدّد لغة عرض الإعلان أو الرابط المجاني للحجز. يتمّ استنتاج قيمة المتغيّر USER-LANGUAGE من إعدادات العميل لدى المستخدِم. على سبيل المثال، en أو fr.
USER-LIST-ID (معرَّفة في "إعلانات Google") Optional (only applies if you use Audience Lists in Google Ads) رقم تعريف قائمة المستخدِمين في "إعلانات Google" التي تحتوي على قائمة الجمهور أو معلومات المستخدِم . تُستخدم قوائم المستخدمين كأساس لإعداد تعديلات عروض الأسعار. إذا كان المستخدم جزءًا من قوائم مستخدمين متعددة، يتم اختيار قائمة المستخدمين التي تتضمّن أكبر تعديل عرض أسعار. يتمّ تحديد الروابط بين شرائح الجمهور التي لديها أكبر تعديل لعرض الأسعار بشكل عشوائي.
VERIFICATION Optional تمثّل هذه السمة قيمة منطقية تتحقّق مما إذا كان محرّك بحث Google قد أنشأ الرابط للاختبار أو للتحقّق من الصحة بشكل مبرمَج. تكون القيمة true إذا أنشأ محرّك بحث Google الرابط لاختباره أو التحقّق من صحته آليًا، وبخلاف ذلك، يكون الرابط false.

المنطق الشرطي في عناوين URL

يمكنك استخدام توجيهات خاصة في العنصر <URL> لملف الصفحات المقصودة لإنشاء نقاط نهاية بشكل مشروط.

يتيح المنطق الشَرطي العبارات التالية:

  • if_statement: إذا كانت القيمة true، يتم إدراج القيم التي تتبع هذا الشرط في عنوان URL، وإلا يتم إدراج القيم التي تتبع توجيه ELSE.

  • for_statement: تنشئ شرط التكرار FOR الذي يتكرر مع عدد القيم المقدمة.

تتضمن عبارات IF وFOR ما يلي:

الشرط مقترَح/اختياري الوصف
IF-AD-CLICK (إعلانات الفنادق فقط) Optional يحل محله إلى true إذا نشأت نقرة المستخدم من إعلان. يتم التعامل معه إلى false إذا نشأت نقرة المستخدم من رابط حجز مجاني.
IF-CLICK-TYPE-HOTEL Optional يتم التعامل مع هذا الحقل إلى true إذا نقر المستخدم على بيانات فندق، وبخلاف ذلك، يتم التبديل إلى false.
IF-CLICK-TYPE-ROOM Optional يتم الربط مع true إذا نقر المستخدم على بطاقة بيانات حزمة غرف، أو انتقِل إلى false بخلاف ذلك.
IF-CLOSE-RATE-RULE-IDS Optional يتم حل المشكلة إلى true في حال عدم توفّر سعر مشروط واحد أو أكثر لأنّ المستخدم لم يكن مؤهّلًا، أو يتم الانتقال إلى false في الحالات الأخرى. بشكل تلقائي، trueإذا تم عرض معالجة واجهة المستخدم بسعر خاص للمستخدم.
IF-DEFAULT-RATE Optional يتم تحديده إلى true إذا نقر المستخدم على بطاقة بيانات فندق تم فيها استخدام التواريخ التلقائية، وبخلاف ذلك، يتم تغييره إلى false.
IF-HOTEL-CAMPAIGN Optional يتم حلّه إلى true إذا نشأت نقرة المستخدم من حملة فندق، وبخلاف ذلك، تنتقل إلى false. ويُعدّ هذا التمييز مفيدًا للشركاء الذين لديهم أنواع حملات متعددة في "إعلانات Google" لتخصيص عملية تحديد المصدر.
IF-PAYMENT-ID (إعلانات الفنادق فقط) Recommended (if you use pay-per-stay Google Ads campaigns) يتم اتخاذ القرار بشأن true بالنسبة إلى الفنادق المشارِكة في برنامج عمولات الدفع لكل إقامة (PPS) إذا تم إحالته إلى false بخلاف ذلك.
IF-PROMO-CODE Optional يتمّ حلّها على القيمة true إذا نقر المستخدِم على سعر استنادًا إلى عرض ترويجي لأسلوب ARI أو قاعدة أسعار ذات PromoCode معيّنة، أمّا إذا لم يكن الأمر كذلك، فيتمّ حلّها على القيمة false.
IF-PROMOTED (إعلانات الفنادق فقط) Recommended (if you use Promoted hotels) يتم تحديده إلى true إذا نقر المستخدم على "إعلان الترويج لفندق"، وبخلاف ذلك، يتم تغييره إلى false.
IF-RATE-RULE-ID Optional يتم الربط إلى true إذا اختار المستخدم سعرًا مشروطًا ، وبخلاف ذلك يتم ضبطه على false.
IF-USER-LIST-ID (يتم تحديده في "إعلانات Google") Optional يتطابق هذا الإجراء مع true إذا كان المستخدم عضوًا في رقم تعريف قائمة عملاء في "إعلانات Google" حدّدته عند إعداد مضاعفات عروض أسعار لقوائم المستخدمين، أو إذا كان التبديل إلى false.
IF-VERIFICATION Optional يتطابق مع true إذا أنشأ محرّك بحث Google الرابط لاختباره أو التحقّق من صحته آليًا، وبخلاف ذلك، يتم تغييره إلى false.
ELSE Recommended (if you use any conditional IF statements) إذا لم يتم استيفاء الشرط السابق، يتم إدراج القيم التي تتبع هذا الشرط في عنوان URL.
END-IF Optional (required if you have any IF conditional statements) تُنهي مجموعة IF الشرطية.
FOR-EACH-CHILD-AGE Optional (required for child occupancy pricing) يتم تنفيذها مرة واحدة لكل عنصر <Child "age"> في خلاصة الأسعار. على سبيل المثال، إذا كان العنصر <OccupancyDetails> يتضمّن العنصرَين <Child age="17"> و<Child age= "17">، يتم تنفيذ التوجيه مرّتين.
END-FOR-EACH Optional (required if using FOR-EACH block) لإنهاء الكتلة الشرطية لجملة FOR-EACH.

مثال على IF-AD-CLICK

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

يستخدم المثال التالي هذا التوجيه في ملف صفحة مقصودة:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-AD-CLICK)&amp;adType=1(ELSE)&amp;adType=0(ENDIF)</URL>

في هذا المثال، إذا لم ينقر المستخدم على إعلان، تكون النتيجة هي عنوان URL التالي:

https://www.partner.com?hid=123&adType=0

إذا نقر المستخدم على الإعلان، تكون النتيجة عنوان URL التالي:

https://www.partner.com?hid=123&adType=1

مثال على IF-CLICK-TYPE-HOTEL

يمكنك إنشاء مجموعة شرطية تتحقّق مما إذا كان المستخدم قد اختار فندقًا بدون حزمة غرف صريحة. سيتم ضبط قيمة العنصر <RatePlanID> في الجزء <Room Bundle> من رسالة المعاملة على سعر حزمة الغرفة الذي اختاره المستخدم والمرتبط ضمنيًا.

يستخدم المثال التالي هذا التوجيه في ملف الصفحات المقصودة:

<URL>https://partner.com/(IF-CLICK-TYPE-HOTEL)landing(ELSE)landing_room(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

في هذا المثال، إذا اختار المستخدم حزمة غرف، تكون النتيجة هو عنوان URL التالي:

https://partner.com/landing_room?hid=123

إذا لم يختار المستخدم حزمة غرف، تكون النتيجة هي عنوان URL التالي:

https://partner.com/landing?hid=123

مثال على غرفة نوع IF-النقر

يمكنك إنشاء وحدة مشروطة تتحقّق مما إذا كان المستخدم قد اختار "حزمة غرفة".

يستخدم المثال التالي هذا التوجيه في ملف صفحات مقصودة:

<URL>https://partner.com/(IF-CLICK-TYPE-ROOM)landing_room(ELSE)landing(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

في هذا المثال، إذا لم يختار المستخدم حزمة غرف، تكون النتيجة هو عنوان URL التالي:

https://partner.com/landing?hid=123

إذا اختار المستخدم حزمة غرف، ستكون النتيجة هي عنوان URL التالي:

https://partner.com/landing_room?hid=123

مثال على IF-DEFAULT-DATE

استخدِم العبارة الشَرطية IF-DEFAULT-DATE لضبط مَعلمة غير مرتبطة بتاريخ يمكن لموقعك الإلكتروني استخدامها بعد ذلك لتشغيل سلوك مخصّص إذا لم يختار المستخدِم تاريخًا.

يتحقّق المثال التالي من استخدام التاريخ التلقائي:

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)<strong>(IF-DEFAULT-DATE)</strong>&amp;popup_datepicker=true(ELSE)&amp;popup_datepicker=false(ENDIF)</URL>

في هذا المثال، إذا لم يحدّد المستخدم تاريخًا، قد تكون النتيجة مشابهة لعنوان URL التالي الذي يعرض اختيارات التاريخ التلقائية:

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=1&popup_datepicker=true

إذا اختار المستخدم تاريخًا، قد تكون النتيجة مشابهة لعنوان URL التالي، استنادًا إلى برنامج الرحلة الذي اختاره:

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=2&popup_datepicker=false

مثال على مَعلمة IF-HOTEL-CAMPAIGN (إعلانات الفنادق ونقرات روابط الحجز المجانية)

يمكنك إنشاء مجموعة مشروطة تتحقّق مما إذا كان المستخدم قد نقر على إعلان نشأ من حملة فندق.

يستخدم المثال التالي هذا التوجيه في ملف الصفحة المقصودة:

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

في هذا المثال، إذا نقر المستخدم على عنوان URL لحملة فندق، تكون النتيجة هي عنوان URL التالي:

https://www.partner.com?hotelID=123&hotel_campaign=12345678

إذا لم تكن النقرة على عنوان URL لحملة فندق (مثل "حملة عادية على شبكة البحث")، يكون النتيجة هي عنوان URL التالي:

https://www.partner.com?hotelID=123&utm_campaign=87654321

يكون ذلك مفيدًا عندما تريد التمييز بين زيارات النقرات على حملة الفنادق وأي نقرات أخرى.

أرقام تعريف حملات فارغة تتضمّن نقرات تقرير التعليقات (FBL)

إذا كانت النقرة من رابط حجز مجاني، يعرض IF-HOTEL-CAMPAIGNTRUE ويتم ضبط قيمة CAMPAIGN-ID على فارغة كما هو موضّح في عنوان URL التالي:

https://www.partner.com?hotelID=123&hotel_campaign=

يمكنك استخدام العبارة الشَرطية IF-AD-CLICK لمنع ظهور معرّف حملة فارغ كما هو موضّح في المثال التالي:

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)(IF-AD-CLICK)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)&amp;FreeBookingLink(ENDIF)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

مثال على IF-PAYMENT-ID (إعلانات الفنادق فقط)

استخدِم العبارة الشرطية IF-PAYMENT-ID لتغيير عنوان URL بناءً على ما إذا كانت النقرة ناتجة عن برنامج عمولات "الإشارات المقدَّمة من الناشر" (PPS) أم لا. يتحقّق المثال أدناه مما إذا كانت النقرة واردة من برنامج العمولات لكل نقرة ويحدّد قيمة للمَعلمة booking_source استنادًا إلى النتيجة:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)&amp;booking_source=(IF-PAYMENT-ID)(PAYMENT-ID)(ELSE)cpc(ENDIF)</URL>

إذا كان الفندق جزءًا من برنامج العمولات، تكون النتيجة أحد عناوين URL التالية:

  • في حال عدم تخصيص رقم IATA إلى Google:
    https://partner.com?hid=123&amp;booking_source=commissions
  • في حال منح رقم IATA إلى Google:
    https://partner.com?hid=123&amp;booking_source=01234567

بخلاف ذلك، تكون النتيجة هي عنوان URL التالي:

https://partner.com?hid=123&booking_source=cpc

مثال على IF-PROMOTED (إعلانات الفنادق فقط)

يمكنك إنشاء عنصر شرطي يتحقّق مما إذا كان المستخدِم قد نقر على إعلان ترويجي للموقع.

يستخدم المثال التالي هذا التوجيه في ملف صفحات مقصودة:

<URL>https://partner.com/(IF-PROMOTED)1(ELSE)0(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

في هذا المثال، إذا اختار المستخدم "إعلان الترويج لفندق"، تكون النتيجة عنوان URL التالي:

https://partner.com/1?hid=123

إذا لم يختار المستخدم إعلانًا ترويجيًا للموقع، تكون النتيجة هي عنوان URL التالي:

https://partner.com/0?hid=123

مثال على IF-RATE-Rule-ID

يمكنك إنشاء كتلة مشروطة تتحقّق مما إذا كان المستخدم قد اختار سعرًا مشروطًا، وإذا كان الأمر كذلك، سيتم استخدام قيمة العنصر <RateRuleID> في الجزء <Rate> من رسالة المعاملة.

يستخدم المثال التالي هذا التوجيه في ملف الصفحات المقصودة:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-RATE-RULE-ID)&amp;customerType=42(ELSE)(ENDIF)</URL>

في هذا المثال، إذا لم يحدّد المستخدم سعرًا مشروطًا، تكون النتيجة هو عنوان URL التالي:

https://www.partner.com?hid=123

إذا اختار المستخدم سعرًا شَرطيًا، تكون النتيجة هي عنوان URL التالي:

https://www.partner.com?hid=123&customerType=42

مثال على IF-USER-LIST-ID (محدّد في "إعلانات Google")

في حال ضبط مُضاعِفات عروض الأسعار لقوائم المستخدمين في حملة فندق في "إعلانات Google"، يمكنك استخدام IF-USER-LIST-ID مع USER-LIST-ID لضبط مَعلمة على موقعك الإلكتروني لعميل ينتمي إلى قائمة مستخدمين معيّنة في "إعلانات Google". قد تحتاج إلى إجراء ذلك لأغراض التتبّع أو لتخصيص موقعك الإلكتروني لأعضاء قوائم المستخدمين.

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-USER-LIST-ID)&amp;audience_list=(USER-LIST-ID)(ELSE)(ENDIF)</URL>

في هذا المثال، إذا لم يكن المستخدِم عضوًا في قائمة مستخدِمين، تكون النتيجة هو عنوان URL التالي:

https://www.partner.com?hid=123

إذا كان المستخدم عضوًا في قائمة المستخدمين 12345678، ستكون النتيجة هي عنوان URL التالي:

https://www.partner.com?hid=123&audience_list=12345678

مثال على IF-VERIFICATION

إذا كنت تريد معرفة ما إذا كان محرّك بحث Google قد أنشأ عنوان URL لاختباره أو التحقّق من صحته آليًا، يمكنك استخدام IF-VERIFICATION.

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-VERIFICATION)&amp;isgoogle=true(ENDIF)</URL>

في هذا المثال، إذا لم تنشئ Google عنوان URL للاختبار أو التحقّق، تكون النتيجة هي عنوان URL التالي:

https://www.partner.com?hid=123

إذا أنشأ محرّك بحث Google عنوان URL للاختبار أو التحقّق من الصحة، تكون النتيجة هي عنوان URL التالي:

https://www.partner.com?hid=123&isgoogle=true

مثال على الفئات العمرية للأطفال (FOR-EACH-CHILD-AGE)

ويمكنك إنشاء وحدة مشروطة يملأ الحد الأقصى للعمر المسموح به لكل راكب طفل على النحو المحدَّد في "خلاصة أسعار الفندق".

يستخدم المثال التالي هذا التوجيه في ملف الصفحات المقصودة:

<URL>https://partner.com?adults=(NUM-ADULTS)&amp;children=(NUM-CHILDREN)(FOR-EACH-CHILD-AGE)&amp;age=(CHILD-INDEX)_(CHILD-AGE)(END-FOR-EACH)&amp;hid=(PARTNER-HOTEL-ID)&amp;</URL>

في هذا المثال، إذا كان برنامج الرحلة يتضمّن شخصَين بالغَين وطفلَين تبلغ أعمارهما 0 و17 عامًا على التوالي، تكون النتيجة هي عنوان URL التالي:

https://www.partner.com?adults=2&children=2&age=0_0age=1_17&hid=123

إذا كان برنامج الرحلة يتضمن شخصين بالغين و0 أطفال، تكون النتيجة هي عنوان URL التالي:

https://www.partner.com?adults=2&children=0&hid=123

القواعد العامة عند إنشاء عناوين URL

وجميع المتغيرات اختيارية. لا يلزمك إدراج أي متغيرات في عنوان URL للصفحة المقصودة. ومع ذلك، فإنّ استخدام المتغيّرات لنقل معلومات الجدول الزمني للرحلة ومعلومات العميل يؤدي بشكل عام إلى توفير تجربة أفضل للمستخدم ويساعدك في الالتزام بسياسات Google.

تنطبق القواعد العامة التالية عند تحديد عناوين URL التي تم إنشاؤها في ملف الصفحات المقصودة:

  • تتم إحاطة جميع المتغيرات بأقواس مفتوحة ومغلقة.

  • يجب فصل مَعلمات سلسلة طلب البحث بعلامة العطف اللاتيني ("&") في النتيجة النهائية. لأنّ علامة "الواو" هي حرف خاص في XML وتنسيق ملفات الصفحات المقصودة هو XML. لذلك، يجب استخدام العنصر المُرمّز "&amp;" بدلاً منه. يعرض الناتج النهائي حرف "&" الفعلي. على سبيل المثال:

    <!-- Do this: -->
    <URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&amp;nights=(LENGTH)</URL>
    
    <!-- Do NOT do this: -->
    <URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&nights=(LENGTH)</URL>
    

    يجب أيضًا ترميز الأحرف الخاصة التي قد تُدرِجها في عنوان URL للصفحة المقصودة. على سبيل المثال:

    • المسافة (" "): استبدِل أحرف المسافة بـ "%20;" في عنصر <URL>.
    • الشرطة المائلة للأمام ("/"): استبدال الشرطة المائلة للأمام بـ "%2F;" في العنصر <URL>

    لا يجب ترميز عنوان URL لكل الأحرف غير الأبجدية. على سبيل المثال، ليس من الضروري ترميز علامات المدّ (-) بترميز عنوان URL. للحصول على قائمة بالرموز المشترَكة التي يجب ترميزها بترميز عناوين URL، اطّلِع على مقالة ترميز عناوين URL.

  • يمكن إنشاء قيم لمَعلمة واحدة من متغيّرات متعدّدة. يُنشئ المثال التالي معلَمة واحدة، checkinDate، من المتغيّرات CHECKINDAY وCHECKINMONTH وCHECKINYEAR:

    <URL>https://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>
    

    ينتج عن هذا المثال عنوان URL قد يبدو كما يلي:

    https://www.partnerdomain.com?checkinDate=7/23/1971
    
  • يمكنك استخدام أي معرّف لاسم مَعلمات سلسلة طلب البحث. يعالج خادمك هذه القيم. ومع ذلك، تقتصر القيم التي ترسلها على قائمة المتغيّرات المتاحة.

  • يمكنك استخدام ما يصل إلى خمسة متغيرات مخصَّصة بالإضافة إلى قائمة المتغيرات المتاحة.