تتضمّن إعلانات الفنادق والروابط المجانية للحجز روابط تؤدي إلى صفحات مقصودة يتصفّح فيها المستخدمون حجز الغرف. يمكنك تحديد كيفية إنشاء 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)
&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)
&checkinYear=(CHECKINYEAR)&nights=(LENGTH)
</URL>
مثال 2
<URL>https://www.partnerdomain.com/hotel/(PARTNER-HOTEL-ID)
&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)
&checkinYear=(CHECKINYEAR)&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 لصفحتك المقصودة:
| متغير | يُنصح بها/اختيارية | الوصف |
|---|---|---|
| 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 | يشير إلى ما إذا كان المستخدم قد نقر على بيانات الفندق لعرض سعره العادي
أو لعرض حزمة غرف. القيم المحتمَلة هي:
|
| 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-ADS-CLICK-SOURCE | Optional | تشير إلى أنّ "إعلانات Google" كانت مصدر النقرة. القيم المحتمَلة هي:
ملاحظة: إذا نشأت النقرة من هذه المَعلمة فارغة في "بحث Google" بدلاً من "إعلانات Google" |
| 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
رقم 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
العروض الترويجية، يتم تخصيص قيمة هذا المتغيّر للسمة في حال استخدام
لقواعد الأسعار، يتم تعيين قيمة هذا المتغير للعنصر |
| 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-AD-CLICK
يمكنك إنشاء كتلة مشروطة تتحقق مما إذا كان المستخدم قد نقر على إعلان أم رابط مجاني للحجز لإعادة التوجيه إلى صفحتك المقصودة.
يستخدم المثال التالي هذا التوجيه في ملف الصفحة المقصودة:
<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-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)&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
ويكون ذلك مفيدًا عندما تريد تمييز عدد الزيارات الناتجة عن النقرات على حملة الفنادق. من أي نقرات أخرى.
أرقام تعريف CAMPAIGN-ID فارغة تحتوي على نقرات 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) أم لا. المثال أدناه
تتحقّق مما إذا كانت النقرة واردة من برنامج عمولات "الإشارات المقدَّمة من الناشر" (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 للاختبار أو للتحقّق التلقائي منvalidity، يمكنك استخدام 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
إذا كان برنامج الرحلة يتضمّن شخصَين بالغَين وبدون أطفال، تكون النتيجة هو عنوان 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)&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يمكنك استخدام أي معرّف لاسم مَعلمات سلسلة طلب البحث. يعالج الخادم هذه القيم. ومع ذلك، تقتصر القيم التي تمررها على قائمة المتغيّرات المتاحة.
يمكنك استخدام ما يصل إلى خمسة متغيّرات مخصّصة بالإضافة إلى قائمة المتغيّرات المتاحة.