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

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

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

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

<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

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

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

<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-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 التالية:

  • في حال عدم تخصيص رقم اتحاد النقل الجوي الدولي إلى Google:
    https://partner.com?hid=123&amp;booking_source=commissions
  • في حال تخصيص رقم اتحاد النقل الجوي الدولي إلى 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- ويُراس-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

إذا كان برنامج الرحلة يضمّ شخصين بالغين ولم يكن طفلاً، تكون النتيجة هي عنوان 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)&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

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

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