متغیرها و شرایط

«آگهی‌های هتل» و پیوندهای رایگان رزرو شامل پیوندهایی به صفحه‌های مقصد است که کاربران می‌توانند در آن‌ها اتاق رزرو کنند. می‌توانید نحوه ساخت پیوند توسط Google را تعریف کنید تا همه اطلاعات اضافی درباره کاربر و برنامه سفر او را دربرگیرد. برای مثال، می‌توانید اطلاعاتی مانند شناسه هتل، زبان، کدهای ارز، و تاریخ ورود را در نشانی وب اضافه کنید.

نمای کلی

نشانی وب صفحه مقصد را در فایل صفحه‌های مقصد تعریف می‌کنید. وقتی آگهی یا پیوند رایگان رزرو نمایش داده می‌شود، اطلاعات پویا در نشانی وب با مقادیر واقعی جایگزین می‌شود. برای افزودن مقادیر پویا به نشانی‌های وب صفحه مقصد، از نحو زیر استفاده کنید:

<URL>https://partner_url?param_id=(variable_name)</URL>

نمونه‌های زیر نشانی وبی را نشان می‌دهد که به‌جای شناسه واقعی هتل و برنامه سفر، از نام‌های متغیر Google استفاده می‌کند:

مثال ۱

<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)</URL>

مثال ۲

<URL>https://www.partnerdomain.com/hotel/(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)</URL>

وقتی پیوند صفحه مقصد برای صفحه نتایج جستجو ساخته می‌شود، Google متغیرها را با مقادیر واقعی جایگزین می‌کند تا مطمئن شود نشانی وب حاوی اطلاعات پویا است. برای مثال، اگر کاربر اتاقی را برای ۶ شب از تاریخ ۲۰۲۳/۵/۲۳ در هتل شماره ۴۲ رزرو کند، 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> فایل صفحه‌های مقصد استفاده کنید تا به‌طور مشروط نقاط پایانی بسازید.

منطق شرطی از عبارت‌های زیر پشتیبانی می‌کند:

• ‫if_statement: اگر true، مقادیری که پس‌از این شرط می‌آیند در نشانی وب درج می‌شوند، درغیراین‌صورت مقادیری که پس‌از دستورالعمل ELSE می‌آیند درج می‌شوند.

• for_statement: شرط حلقه FOR ایجاد می‌کند که روی تعداد مقادیر ارائه‌شده تکرار می‌شود.

عبارت‌های IF و FOR شامل موارد زیر است:

مثال IF-AD-CLICK

می‌توانید بلوک شرطی بسازید که بررسی کند آیا کاربر روی آگهی یا پیوند رایگان رزرو کلیک کرده است تا به صفحه مقصد شما هدایت شود.

مثال زیر از این دستورالعمل در فایل صفحه مقصد استفاده می‌کند:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-AD-CLICK)&amp;adType=1(ELSE)&amp;adType=0(ENDIF)</URL>

در این مثال، اگر کاربر روی آگهی کلیک نکرده باشد، نتیجه نشانی وب زیر است:

https://www.partner.com?hid=123&adType=0

اگر کاربر روی آگهی کلیک کند، نتیجه نشانی وب زیر است:

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>

در این مثال، اگر کاربر «بسته ترکیبی اتاق» را انتخاب نکرده باشد، نتیجه نشانی وب زیر است:

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

اگر کاربر «بسته ترکیبی اتاق» را انتخاب کرده باشد، نتیجه نشانی وب زیر است:

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

نمونه IF-CLICK-TYPE-ROOM

می‌توانید بلوک شرطی بسازید که بررسی کند آیا کاربر RoomBundle را انتخاب کرده است یا نه.

مثال زیر از این دستورالعمل در فایل صفحه‌های مقصد استفاده می‌کند:

<URL>https://partner.com/(IF-CLICK-TYPE-ROOM)landing_room(ELSE)landing(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

در این مثال، اگر کاربر «بسته ترکیبی اتاق» را انتخاب نکرده باشد، نتیجه نشانی وب زیر است:

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

اگر کاربر «بسته ترکیبی اتاق» را انتخاب کرده باشد، نتیجه نشانی وب زیر است:

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

نمونه IF-CLOSE-RATE-RULE-IDS

می‌توانید بلوک شرطی بسازید که بررسی کند آیا کاربر قیمت کاهش‌یافته ویژه یا نرخ خصوصی برای اعضای برنامه وفاداری دارد یا نه.

مثال زیر از این دستورالعمل در فایل صفحه‌های مقصد استفاده می‌کند:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-CLOSE-RATE-RULE-IDS)&amp;rate_rule=(CLOSE-RATE-RULE-ID)(ELSE)(ENDIF)</URL>

در این مثال، اگر کاربر واجدشرایط نرخ خصوصی نباشد، نتیجه نشانی وب زیر است:

https://partner.com?hid=123

اگر کاربر عضو برنامه وفاداری باشد و واجدشرایط نرخ خصوصی باشد، نتیجه نشانی وب زیر است:

https://partner.com?hid=123&rate_rule=sample_qr

مثال زیر منطق نرخ شرطی با تاریخ ورود، تاریخ خروج، و جزئیات اشغال با شرایط IF تودرتو است تا بررسی شود که آیا کاربر واجدشرایط نرخ خصوصی یا نرخ خصوصی شرطی یا نرخ عمومی است یا نه:

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYear)&amp;checkoutDay=(CHECKOUTDAY)&amp;checkoutMonth=(CHECKOUTMONTH)&amp;checkoutYear(CHECKOUTYear)&amp;num_adults=(NUM-ADULTS)(IF-CLOSE-RATE-RULE-IDS)&amp;promo_type=member_signup&amp;rate_rule=(CLOSE-RATE-RULE-ID)(ELSE)(IF-RATE-RULE-ID)&amp;promo_type=conditional&amp;rate_rule=(RATE-RULE-ID)(ELSE)promo_type=public(ENDIF)(ENDIF)</URL>

اگر کاربر واجدشرایط نرخ خصوصی باشد، نتیجه نشانی وب زیر است:

https://partner.com/?hid=123&checkinDay=05&checkinMonth=03&checkinYear=2026&checkoutDay=07&checkoutMonth=03&checkoutYear=2026&num_adults=2&promo_type=member_signup&rate_rule=sample_qr

اگر کاربر واجدشرایط نرخ خصوصی مشروط باشد، نتیجه نشانی وب زیر است:

https://partner.com/?hid=123&checkinDay=05&checkinMonth=03&checkinYear=2026&checkoutDay=07&checkoutMonth=03&checkoutYear=2026&num_adults=2&promo_type=conditional&rate_rule=US_users

اگر کاربر واجدشرایط نرخ عمومی باشد، نتیجه نشانی وب زیر است:

https://partner.com/?hid=123&checkinDay=05&checkinMonth=03&checkinYear=2026&checkoutDay=07&checkoutMonth=03&checkoutYear=2026&num_adults=2&promo_type=public

نمونه 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)(IF-DEFAULT-DATE)&amp;popup_datepicker=true(ELSE)&amp;popup_datepicker=false(ENDIF)</URL>

در این مثال، اگر کاربر تاریخی را انتخاب نکرده باشد، نتیجه ممکن است مشابه نشانی وب زیر باشد که انتخاب‌های تاریخ پیش‌فرض را نشان می‌دهد:

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=1&popup_datepicker=true

اگر کاربر تاریخی را انتخاب کرده باشد، نتیجه ممکن است مشابه نشانی وب زیر باشد، بسته به برنامه سفری که انتخاب کرده است:

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>

در این مثال، اگر کلیک روی نشانی وب پویش هتل نباشد (مثلاً پویش جستجوی معمولی)، نتیجه نشانی وب زیر است:

https://www.partner.com?hotelID=123&utm_campaign=87654321

اگر کاربر روی نشانی وب کمپین هتل کلیک کند، نتیجه نشانی وب زیر است:

https://www.partner.com?hotelID=123&hotel_campaign=12345678

این کار زمانی مفید است که می‌خواهید ترافیک کلیک‌های پویش هتل را از کلیک‌های دیگر متمایز کنید.

شناسه‌های پویش خالی با کلیک‌های FBL

اگر کلیک از «پیوند رایگان رزرو» باشد، IF-HOTEL-CAMPAIGN مقدار TRUE را برمی‌گرداند و مقدار CAMPAIGN-ID خالی می‌ماند، همان‌طور که در نشانی وب زیر نشان داده شده است:

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-MODIFICATIONS-IDS

می‌توانید بلوک شرطی بسازید که بررسی کند آیا کاربر پیام اصلاحات نرخ ARI را به‌روز کرده است یا نه.

مثال زیر از این دستورالعمل در فایل صفحه مقصد استفاده می‌کند:

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-MODIFICATION-IDS)&amp;promo_applied=true&amp;mod_ids=(MODIFICATION-IDS)(ENDIF)</URL>

در این مثال، اگر کاربر پیام اصلاحات نرخ ARI را تغییر نداده باشد، نتیجه نشانی وب زیر است:

https://partner.com?hid=123

اگر کاربر پیام اصلاحات نرخ ARI را به‌روزرسانی کرده باشد، نتیجه نشانی وب زیر است:

https://partner.com?hid=123&promo_applied=true&mod_ids=7

IF-PROMO-CODE

می‌توانید بلوک شرطی بسازید که بررسی می‌کند آیا کد ترویجی برای تخفیف به نرخ کاربر مشخص‌شده پیوند داده شده است یا نه. این نرخ ازطریق پیام‌های تبلیغات ARI یا قوانین نرخ پیکربندی می‌شود.

مثال زیر از این دستورالعمل در فایل صفحه‌های مقصد استفاده می‌کند:

<URL>https://partner.com/booking?hid=(PARTNER-HOTEL-ID)(IF-PROMO-CODE)&amp;promotion_code=(PROMO-CODE)&amp;discount_applied=true(ENDIF)</URL>

در این مثال، اگر کد ترویجی نامعتبر باشد، نتیجه نشانی وب زیر است:

https://partner.com?hid=123

اگر کاربر کد ترویجی معتبری داشته باشد و واجدشرایط تخفیف باشد، نتیجه نشانی وب زیر است:

https://partner.com?hid=123&promotion_code=123_abc&discount_applied=true

مثال IF-PROMOTED (فقط آگهی‌های هتل)

می‌توانید بلوک شرطی بسازید که بررسی کند آیا کاربر روی «آگهی تبلیغاتی دارایی» کلیک کرده است یا نه.

مثال زیر از این دستورالعمل در فایل صفحه‌های مقصد استفاده می‌کند:

<URL>https://partner.com/(IF-PROMOTED)1(ELSE)0(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

در این مثال، اگر کاربر «آگهی تبلیغاتی ملک» را انتخاب نکرده باشد، نتیجه نشانی وب زیر است:

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

اگر کاربر «آگهی تبلیغاتی دارایی» را انتخاب کرده باشد، نتیجه نشانی وب زیر است:

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

نمونه IF-RATE-RULE-ID

می‌توانید بلوک شرطی بسازید که بررسی کند آیا کاربر نرخ شرطی را انتخاب کرده است یا نه و اگر انتخاب کرده باشد، از مقدار عنصر <RateRuleID> در بلوک <Rate> پیام تراکنش استفاده می‌شود. بیشتر بدانید.

مثال زیر از این دستورالعمل در فایل صفحه‌های مقصد استفاده می‌کند:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-RATE-RULE-ID)&amp;rate_rule=(RATE-RULE-ID)(ELSE)(ENDIF)</URL>

در این مثال، اگر کاربر نرخ شرطی را انتخاب نکرده باشد، نتیجه نشانی وب زیر است:

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

اگر کاربر نرخ شرطی را انتخاب کرده باشد، نتیجه نشانی وب زیر است:

https://www.partner.com?hid=123&rate_rule=(RATE-RULE-ID)

نمونه IF-USER-LIST-ID (تعریف‌شده در Google Ads)

اگر برای فهرست‌های مخاطبان در پویش هتل در Google Ads ضریب‌های قیمت پیشنهادی تنظیم کنید، می‌توانید از IF-USER-LIST-ID همراه با USER-LIST-ID برای تنظیم پارامتری در وب‌سایتتان برای مشتری‌ای که به فهرست مخاطبان Google Ads خاصی تعلق دارد استفاده کنید. ممکن است بخواهید این کار را برای اهداف ردیابی یا سفارشی‌سازی وب‌سایت خود برای اعضای فهرست‌های مخاطبان انجام دهید.

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-USER-LIST-ID)&amp;audience_list=(USER-LIST-ID)(ELSE)(ENDIF)</URL>

در این مثال، اگر کاربر عضو فهرست مخاطبان نباشد، نتیجه نشانی وب زیر است:

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

اگر کاربر عضو فهرست مخاطبان 12345678 بود، نتیجه نشانی وب زیر است:

https://www.partner.com?hid=123&audience_list=12345678

مثال IF-VERIFICATION

اگر لازم است بررسی کنید که آیا Google نشانی وب را برای آزمایش یا اعتبارسنجی تولید کرده است یا نه، می‌توانید از IF-VERIFICATION استفاده کنید.

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-VERIFICATION)&amp;isgoogle=true(ENDIF)</URL>

در این مثال، اگر Google نشانی وب را برای آزمایش یا اعتبارسنجی تولید نکرده باشد، نتیجه نشانی وب زیر است:

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

اگر Google نشانی وب را برای آزمایش یا اعتبارسنجی تولید کرده باشد، نتیجه نشانی وب زیر است:

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>

در این مثال، اگر برنامه سفر ۲ بزرگسال و ۲ کودک به‌ترتیب با سنین ۰ و ۱۷ سال داشته باشد، نتیجه نشانی وب زیر است:

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

قوانین کلی هنگام ساختن نشانی‌های وب

همه متغیرها اختیاری هستند. لازم نیست هیچ متغیری در نشانی وب صفحه مقصدتان وارد کنید. بااین‌حال، استفاده از متغیرها برای انتقال اطلاعات سفر و کاربر معمولاً تجربه بهتری برای کاربر ایجاد می‌کند و به شما کمک می‌کند تا از خط‌مشی‌های Google پیروی کنید.

هنگام تعریف نشانی‌های وب ساخته‌شده در فایل صفحه‌های مقصد، قوانین کلی زیر اعمال می‌شود:

• همه متغیرها با پرانتز باز و بسته احاطه شده‌اند.

• پارامترهای رشته پُرسمان باید با علامت «و» (&) در خروجی نهایی از هم جدا شوند. زیرا علامت «و» نویسه‌ای خاص در XML است و قالب فایل صفحه‌های مقصد XML است. بنابراین، باید از واحد کدگذاری‌شده «&» به‌جای آن استفاده کنید. برونداد نهایی نویسه واقعی «&» را ارائه می‌دهد. برای مثال:

  <!-- Do this: -->
  <URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&amp;nights=(LENGTH)</URL>
  
  <!-- Do NOT do this: -->
  <URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&nights=(LENGTH)</URL>
  

  همچنین باید نویسه‌های خاصی را که ممکن است در نشانی وب صفحه مقصد اضافه کنید، کدگذاری URL کنید. برای مثال:

  • فاصله (" "): نویسه‌های فاصله را با «%20;» در عنصر <URL> جایگزین کنید
  • کج‌خط روبه‌جلو («/»): کج‌خط‌های روبه‌جلو را با «%2F;» در عنصر <URL> جایگزین کنید

  همه نویسه‌های غیرالفبایی نباید کدگذاری URL شوند. برای مثال، خط تیره («-») نیازی به کدبندی نشانی وب ندارد. برای مشاهده فهرست نویسه‌های رایجی که باید کدبندی نشانی وب شوند، به کدبندی نشانی وب مراجعه کنید.

• مقادیر یک پارامتر واحد را می‌توان از چند متغیر ساخت. مثال زیر یک پارامتر واحد، checkinDate، را از متغیرهای CHECKINDAY، CHECKINMONTH، و CHECKINYEAR می‌سازد:

  <URL>https://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>
  

  این مثال منجر به نشانی وبی می‌شود که ممکن است شبیه به موارد زیر باشد:

  https://www.partnerdomain.com?checkinDate=7/23/1971
  

• می‌توانید از هر شناسه‌ای برای نام پارامترهای رشته پُرسمان استفاده کنید. سرور شما این مقادیر را پردازش می‌کند. بااین‌حال، مقادیری که ارسال می‌کنید به فهرست متغیرهای دردسترس محدود است.

• می‌توانید علاوه‌بر فهرست متغیرهای دردسترس، از حداکثر پنج متغیر سفارشی استفاده کنید.