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

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

المنطق الشرطي في عناوين 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_room?hid=123

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

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

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

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

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

<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

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

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

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

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

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

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