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

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

نظرة عامة

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

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

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

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

فعندما يتم إنشاء رابط الصفحة المقصودة لصفحة نتائج البحث، يستخدم محرك بحث Google تستبدل المتغيرات بالقيم الفعلية للتأكد من أن عنوان URL يتضمن معلومات ديناميكية. على سبيل المثال، إذا حجز المستخدم غرفة لـ 6 ليالٍ اعتبارًا من 23/5/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. يكون هذا الحقل فارغًا إذا لم تكن النقرة مرتبطة بحساب على "إعلانات Google". .
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 متغير حلقة مفهرسة مفهرسة يمثل عدّادًا لكل وحدة فرعية الراكب وعمر الطفل المحدّد في برنامج الرحلة على الرغم من أنه ليس إلزاميًا، لا يمكن استخدام هذا المتغير إلا مع جزء 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-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 رقم IATA الذي تم تحديده (على سبيل المثال، "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-النقر على الإعلان"

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

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

<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-نقرة-TYPE-

يمكنك إنشاء مربّع مشروط للتحقّق مما إذا كان المستخدم قد اختار فندقًا. بدون حزمة غرف صريحة. قيمة العنصر <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-CAMPAIGN. تم ضبط قيمة TRUE و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) أم لا. المثال أدناه تتحقّق مما إذا كانت النقرة واردة من برنامج عمولات "الإشارات المقدَّمة من الناشر" (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 المنشأة في صفحة مقصودة ملف الصفحات:

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

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

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