تتضمّن إعلانات الفنادق والروابط المجانية للحجز روابط تؤدي إلى صفحات مقصودة يمكن للمستخدمين حجز الغرف من خلالها. يمكنك تحديد كيفية إنشاء 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 | متغيّر حلقة بفهرس 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-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 (مثلاً، "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 للفنادق المشارِكة في برنامج عمولات الدفع لكل إقامة
، وبخلاف ذلك يتمّ ضبطه على 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 فارغة تتضمّن نقرات على الروابط المجانية للحجز
إذا كانت النقرة من رابط حجز مجاني، سيعرض IF-HOTEL-CAMPAIGNTRUE وسيتم ضبط قيمة 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 استنادًا إلى ما إذا كانت
النقرة نتيجةً لبرنامج العمولات في "الإعلانات الصورية" أم لا. يتحقّق المثال أدناه مما إذا كانت النقرة واردة من برنامج العمولات لكل نقرة ويحدّد قيمة للمَعلمة 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
إذا كان برنامج الرحلة يتضمّن شخصَين بالغَين وبدون أطفال، تكون النتيجة ملف تعريف الارتباط التالي التالي:
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 للصفحة المقصودة. على سبيل المثال:
- المسافة (" "): استبدِل أحرف المسافة بـ "%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يمكنك استخدام أي معرّف لاسم مَعلمات سلسلة طلب البحث. يعالج الخادم هذه القيم. ومع ذلك، تقتصر القيم التي ترسلها على قائمة المتغيّرات المتاحة.
يمكنك استخدام ما يصل إلى خمسة متغيّرات مخصّصة بالإضافة إلى قائمة المتغيّرات المتاحة.