تتضمّن إعلانات الفنادق والروابط المجانية للحجز روابط تؤدي إلى الصفحات المقصودة التي يمكن للمستخدمين من خلالها حجز الغرف. ويمكنك تحديد آلية 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)
&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)
&checkinYear=(CHECKINYEAR)&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 | تشير هذه السمة إلى ما إذا كان المستخدم قد نقر على بطاقة البيانات مقابل سعر عادي للفندق
أو للحصول على حزمة غرف. القيم المتاحة:
|
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 | يشير هذا الحقل إلى ما إذا كان المستخدم قد اختار التاريخ التلقائي أو تاريخًا محدّدًا تم تقديمه في البحث. القيم المتاحة:
|
GOOGLE-SITE | Optional | الموقع الإلكتروني على Google الذي شاهد أحد المستخدمين بيانات أسعار فنادقك عليه.
القيم المتاحة:
|
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، يتم تخصيص قيمة هذا المتغيّر للسمة في حال استخدام
قواعد الأسعار، يتم تحديد قيمة هذا المتغيّر للعنصر |
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
واحدة مما يلي:
يتم استنتاج قيمة المتغيّر |
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)&adType=1(ELSE)&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)&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)&checkinYear=(CHECKINYEAR)&nights=(LENGTH)<strong>(IF-DEFAULT-DATE)</strong>&popup_datepicker=true(ELSE)&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)&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)&hotel_campaign=(CAMPAIGN-ID)(ELSE)&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)&booking_source=(IF-PAYMENT-ID)(PAYMENT-ID)(ELSE)cpc(ENDIF)</URL>
إذا كان الفندق جزءًا من برنامج العمولات، تكون النتيجة أحد عناوين URL التالية:
- في حال عدم تخصيص رقم IATA إلى Google:
https://partner.com?hid=123&booking_source=commissions
- في حال منح رقم IATA إلى Google:
https://partner.com?hid=123&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)&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)&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)&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)&children=(NUM-CHILDREN)(FOR-EACH-CHILD-AGE)&age=(CHILD-INDEX)_(CHILD-AGE)(END-FOR-EACH)&hid=(PARTNER-HOTEL-ID)&</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. وبالتالي، يتعين عليك استخدام الكيان "&" المرمّز بدلاً منه. وتعرض النتيجة النهائية حرف "&" فعليًّا. مثلاً:
<!-- 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 للرموز الخاصة التي قد تدرجها في عنوان URL للصفحة المقصودة. مثلاً:
- المسافة (" "): استبدال أحرف المسافة بـ "%20;" في العنصر
<URL>
- الشرطة المائلة للأمام ("/"): استبدال الشرطة المائلة للأمام بـ "%2F;" في العنصر
<URL>
لا يجب ترميز عنوان URL لكل الأحرف غير الأبجدية. على سبيل المثال، ليس من الضروري ترميز الواصلات ("-") بعنوان URL. للحصول على قائمة بالحروف الشائعة التي يجب ترميز عنوان URL لها، يُرجى الرجوع إلى جدول ترميز عناوين URL.
- المسافة (" "): استبدال أحرف المسافة بـ "%20;" في العنصر
يمكن إنشاء قيم لمَعلمة واحدة من متغيّرات متعددة. يُنشئ المثال التالي معلَمة واحدة،
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
يمكنك استخدام أي رقم تعريف لاسم مَعلمات سلسلة طلب البحث. يعالج خادمك هذه القيم. ومع ذلك، تقتصر القيم التي تمرِّرها على قائمة المتغيّرات المتاحة.
يمكنك استخدام ما يصل إلى خمسة متغيرات مخصَّصة بالإضافة إلى قائمة المتغيرات المتاحة.