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

تتضمّن "إعلانات الفنادق" والروابط المجانية للحجز روابط تؤدي إلى صفحات مقصودة يمكن للمستخدمين من خلالها حجز الغرف. يمكنك تحديد كيفية إنشاء 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 لصفحتك المقصودة:

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

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

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

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

• ‫for_statement: تنشئ شرط حلقة FOR يتكرر على عدد القيم المقدَّمة.

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

مثال على 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?hid=123

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

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

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

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

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

<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-CLOSE-RATE-RULE-IDS

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

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

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

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

https://partner.com?hid=123

إذا كان المستخدم عضوًا في برنامج ولاء ومؤهلاً للحصول على سعر خاص، تكون النتيجة عنوان URL التالي:

https://partner.com?hid=123&rate_rule=sample_qr

المثال التالي هو منطق سعر مشروط يتضمّن تفاصيل تاريخ تسجيل الوصول وتاريخ تسجيل المغادرة والإشغال مع شروط IF متداخلة للتحقّق مما إذا كان المستخدم مؤهلاً للحصول على سعر خاص أو سعر خاص مشروط أو سعر علني:

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYear)&amp;checkoutDay=(CHECKOUTDAY)&amp;checkoutMonth=(CHECKOUTMONTH)&amp;checkoutYear(CHECKOUTYear)&amp;num_adults=(NUM-ADULTS)(IF-CLOSE-RATE-RULE-IDS)&amp;promo_type=member_signup&amp;rate_rule=(CLOSE-RATE-RULE-ID)(ELSE)(IF-RATE-RULE-ID)&amp;promo_type=conditional&amp;rate_rule=(RATE-RULE-ID)(ELSE)promo_type=public(ENDIF)(ENDIF)</URL>

إذا كان المستخدم مؤهَّلاً للحصول على سعر خاص، تكون النتيجة عنوان URL التالي:

https://partner.com/?hid=123&checkinDay=05&checkinMonth=03&checkinYear=2026&checkoutDay=07&checkoutMonth=03&checkoutYear=2026&num_adults=2&promo_type=member_signup&rate_rule=sample_qr

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

https://partner.com/?hid=123&checkinDay=05&checkinMonth=03&checkinYear=2026&checkoutDay=07&checkoutMonth=03&checkoutYear=2026&num_adults=2&promo_type=conditional&rate_rule=US_users

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

https://partner.com/?hid=123&checkinDay=05&checkinMonth=03&checkinYear=2026&checkoutDay=07&checkoutMonth=03&checkoutYear=2026&num_adults=2&promo_type=public

مثال على 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)(IF-DEFAULT-DATE)&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&utm_campaign=87654321

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

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

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

أرقام تعريف حملات فارغة مع نقرات على روابط الحجز المجانية

إذا كانت النقرة من رابط مجاني للحجز، فستعرض 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-MODIFICATIONS-IDS

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

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

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

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

https://partner.com?hid=123

إذا عدّل المستخدم رسالة تعديلات الأسعار في ARI، ستكون النتيجة عنوان URL التالي:

https://partner.com?hid=123&promo_applied=true&mod_ids=7

IF-PROMO-CODE

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

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

<URL>https://partner.com/booking?hid=(PARTNER-HOTEL-ID)(IF-PROMO-CODE)&amp;promotion_code=(PROMO-CODE)&amp;discount_applied=true(ENDIF)</URL>

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

https://partner.com?hid=123

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

https://partner.com?hid=123&promotion_code=123_abc&discount_applied=true

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

https://www.partner.com?hid=123&rate_rule=(RATE-RULE-ID)

مثال على 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. لذلك، يجب استخدام الكيان المرمّز "&" بدلاً منه. وتعرض النتيجة النهائية حرف "&" فعليًا. على سبيل المثال:

  <!-- 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
  

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

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