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

تبلیغات هتل و لینک‌های رزرو رایگان شامل لینک‌هایی به صفحات فرود هستند که کاربران می‌توانند در آنجا اتاق رزرو کنند. می‌توانید تعریف کنید که گوگل چگونه لینک را طوری بسازد که شامل تمام اطلاعات اضافی در مورد کاربر و برنامه سفر او باشد. به عنوان مثال، می‌توانید اطلاعاتی مانند شناسه هتل، زبان، کدهای ارزی و تاریخ ورود را در URL قرار دهید.

نمای کلی

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

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

مثال‌های زیر نشانی اینترنتی (URL) را نشان می‌دهند که به جای شناسه هتل و برنامه سفر واقعی، از نام‌های متغیرهای گوگل استفاده می‌کند:

مثال ۱ 

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

وقتی لینک صفحه فرود برای صفحه نتایج جستجو ساخته می‌شود، گوگل متغیرها را با مقادیر واقعی جایگزین می‌کند تا مطمئن شود که URL شامل اطلاعات پویا است. برای مثال، اگر کاربر از تاریخ 23/5/2023 برای هتل شماره 42، اتاقی را به مدت 6 شب رزرو کند، گوگل لینک قبلی را به صورت زیر نمایش می‌دهد:

https://www.partnerdomain.com?hotelID=42&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=6

مقادیری که گوگل به متغیرهای موجود در رشته جستجو اختصاص می‌دهد، به داده‌های مربوطه در فید قیمت هتل، فید لیست هتل و تنظیمات کاربر بستگی دارد.

برای مثال، مقدار متغیر LENGTH به عنصر <Nights> از فید قیمت برنامه سفر مربوطه اختصاص داده می‌شود. به طور مشابه، مقدار متغیر PARTNER-HOTEL-ID در عنصر <id> از فید لیست هتل که با معیار جستجوی کاربر مطابقت دارد، تعریف می‌شود.

برخی از متغیرها زیرمجموعه عناصر فید قیمت هستند. برای مثال، متغیرهای CHECKINDAY ، CHECKINMONTH و CHECKINYEAR از عنصر <Checkin> در فید قیمت استخراج می‌شوند. سایر متغیرها بر اساس موقعیت مکانی کاربر و سایر تنظیمات کلاینت محاسبه می‌شوند.

برای اطلاعات بیشتر در مورد منابع مقادیر متغیر، به نمای کلی قیمت‌گذاری و فهرست هتل‌ها مراجعه کنید.

متغیرهای آدرس اینترنتی

جدول زیر متغیرهای موجود را که می‌توانید برای ساخت URL صفحه فرود خود استفاده کنید، شرح می‌دهد:

متغیر توصیه شده/اختیاری توضیحات
ADVANCE-BOOKING-WINDOW Optional تعداد روزهای رزرو قبلی قبل از تاریخ ورود در منطقه زمانی هتل در زمان رزرو. به عنوان مثال، 36 .
ALTERNATE-HOTEL-ID Recommended (if you have separate IDs to identify properties versus booking engines) یک شناسه جایگزین برای ملک شما. نام این ویژگی در فید لیست هتل شما مشخص شده است. داشتن شناسه‌های جداگانه در صورتی مفید است که به یک شناسه ملک برای اطلاعات فید و یک شناسه ملک دیگر برای موتور رزرو خود نیاز داشته باشید.
CAMPAIGN-ID Recommended شناسه کمپین تبلیغات گوگل که می‌خواهید به URL مرتبط کنید. اگر کلیک به یک کمپین تبلیغات گوگل مرتبط نباشد، این فیلد خالی است.
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 نشان می‌دهد که آیا کاربر برای نرخ استاندارد هتل یا برای بسته اتاق روی لیست کلیک کرده است. مقادیر ممکن عبارتند از:
  • hotel : کاربر برای مشاهده نرخ استاندارد اتاق روی لیست کلیک کرد.
  • room : کاربر روی فهرست یک بسته اتاق کلیک کرد.
CLOSE-RATE-RULE-IDS Optional (only applies if you are using conditional or private rates) فهرستی از شناسه‌های قانون نرخ که با کاما از هم جدا شده‌اند، برای نرخ‌هایی که در دسترس نبودند، اما اگر کاربر اقدام کوچکی انجام می‌داد، می‌توانست در دسترس باشد. توجه داشته باشید که شناسه‌های قانون نرخ برای نرخ‌های خصوصی همیشه در اینجا پر می‌شوند، زمانی که یک رابط کاربری مربوطه به کاربر نشان داده می‌شود.
Optional منسوخ‌شده: مقادیر فیلدهای سفارشی که در عنصر <Result> با محدودیت ۲۰۰ کاراکتر برای هر فیلد سفارشی تعریف شده‌اند. برای اطلاعات بیشتر، به «مروری بر پیام‌های تراکنش» مراجعه کنید. فیلدهای سفارشی هنگام استفاده از ARI در دسترس نیستند. متغیرهای CUSTOM فقط زمانی فهرست می‌شوند که قیمت‌ها را در پیام تراکنش ارسال کنید.

مهم: اگر می‌خواهید از متغیرهای CUSTOM استفاده کنید، با مدیر حساب فنی (TAM) خود تماس بگیرید.

DATE-TYPE Optional نشان می‌دهد که آیا کاربر تاریخ پیش‌فرض یا تاریخ خاصی را که در جستجو ارائه شده است، انتخاب کرده است. مقادیر ممکن عبارتند از:
  • default : کاربر روی تبلیغ هتل یا لینک رزرو رایگان کلیک کرده است که در آن از تاریخ‌های پیش‌فرض استفاده شده است.
  • selected : کاربر روی تبلیغ هتل یا لینک رزرو رایگان با تاریخ‌های تعیین‌شده کلیک کرده است.
GOOGLE-ADS-CLICK-SOURCE Optional نشان می‌دهد که تبلیغات گوگل منبع کلیک بوده است. مقادیر ممکن عبارتند از:
  • bl : لینک‌های رزرو پولی
  • tpa : تبلیغات و آگهی‌های مسافرتی
  • tfsa : فیدهای مسافرتی در تبلیغات جستجو
  • pm : Performance Max یا Performance Max برای کمپین‌های Travel Goals
  • dg : کمپین تولید تقاضا

    • توجه: اگر کلیک از جستجوی گوگل به جای تبلیغات گوگل سرچشمه گرفته باشد، این پارامتر خالی است.

GOOGLE-SITE Optional ویژگی گوگل که کاربر در آن داده‌های قیمت‌گذاری هتل شما را مشاهده کرده است. مقادیر ممکن عبارتند از:
  • localuniversal : کاربر لینک رزرو هتل را از طریق جستجوی google.com پیدا کرد.
  • mapresults : کاربر لینک رزرو هتل را از طریق maps.google.com پیدا کرد.
  • verification : گوگل از این مقدار هنگام انجام آزمایش‌های خودکار کیفیت داده‌ها در سایت شما استفاده می‌کند. برای این جستجوها هزینه‌ای از شما دریافت نمی‌شود. گوگل آنالیتیکس می‌تواند از این پارامتر و مقدار آن برای شناسایی ترافیک تأیید خودکار Hotel Ads استفاده کند.
  • unknown : کاربر تبلیغ یا لینک رزرو رایگان را از طریق یک منبع نامشخص پیدا کرده است.
LENGTH Recommended مدت اقامت بر اساس تعداد شب‌هایی که توسط عنصر <Nights> در فید قیمت هتل تعریف می‌شود. برای مثال، 3 .
MODIFICATION-IDS Optional

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

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 تعداد سرنشینان کودک (۰ تا ۱۷ سال) که توسط کاربر در برنامه سفر مشخص شده است. برای شرکت موفقیت‌آمیز در برنامه‌های سفر با سرنشینان کودک 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> در پیام تراکنش اختصاص داده شده است.
Optional (only applies to Ads) منسوخ‌شده: در صورت استفاده از یک آژانس وصول کمیسیون، به یک رشته از پیش تعریف‌شده commission یا شماره IATA اختصاص داده‌شده توسط گوگل (برای مثال، "01234567") تبدیل می‌شود. برای تغییر قالب‌بندی شماره IATA یا رشته از پیش تعریف‌شده خود، با مدیر حساب فنی (TAM) خود تماس بگیرید.
PRICE-DISPLAYED-FEES (Optional) مبلغ کارمزد شامل شده در کل مالیات‌ها و عوارض، که به ارز محلی کاربر نمایش داده می‌شود. مقدار PRICE-DISPLAYED-FEES برابر با مقدار عنصر <Fee> در پیام تراکنش است. برای ARI، این مبلغ کارمزد محاسبه شده بر اساس پیام TaxFeeInfo است. به عنوان مثال، "60.14".
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 (تعریف شده در گوگل ادز) Optional (only applies if you use Audience Lists in Google Ads) شناسه فهرست کاربران گوگل ادز که شامل فهرست مخاطبان یا اطلاعات کاربر است. فهرست مخاطبان به عنوان مبنایی برای تنظیم تنظیمات پیشنهاد قیمت استفاده می‌شود. اگر کاربر عضوی از چندین فهرست مخاطب باشد، فهرست مخاطبانی که بیشترین تنظیم پیشنهاد قیمت را دارد انتخاب می‌شود. تساوی بین مخاطبانی که بیشترین تنظیم پیشنهاد قیمت را دارند به صورت تصادفی تعیین می‌شود.
VERIFICATION Optional یک مقدار بولی که بررسی می‌کند آیا لینک توسط گوگل برای آزمایش یا اعتبارسنجی خودکار ایجاد شده است یا خیر. اگر لینک توسط گوگل برای آزمایش یا اعتبارسنجی خودکار ایجاد شده باشد، مقدار آن true (true) و در غیر این صورت مقدار آن false (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 اگر کاربر روی لیست اتاق‌های یک Room Bundle کلیک کرده باشد، مقدار true و در غیر این صورت مقدار false را برمی‌گرداند.
IF-CLOSE-RATE-RULE-IDS Optional اگر یک یا چند نرخ شرطی به دلیل عدم واجد شرایط بودن کاربر در دسترس نباشند، مقدار true و در غیر این صورت مقدار false را برمی‌گرداند. به طور پیش‌فرض، اگر یک رابط کاربری با نرخ خصوصی به کاربر نشان داده شده باشد، مقدار true را برمی‌گرداند.
IF-DEFAULT-DATE Optional اگر کاربر روی لیست هتلی که تاریخ‌های پیش‌فرض در آن استفاده شده است کلیک کند، مقدار true و در غیر این صورت مقدار false را برمی‌گرداند.
IF-HOTEL-CAMPAIGN Optional اگر کلیک کاربر از یک کمپین هتل سرچشمه گرفته باشد، به true برمی‌گردد، در غیر این صورت به false برمی‌گردد. این تمایز برای شرکایی که انواع کمپین‌های متعددی در Google Ads دارند، برای تخصیص انتساب مفید است.
IF-MODIFICATION-IDS Optional اگر کاربر روی نرخی که توسط اصلاح نرخ ARI تغییر یافته است کلیک کرده باشد، مقدار true را برمی‌گرداند؛ در غیر این صورت مقدار false را برمی‌گرداند.
Recommended (if you use pay-per-stay Google Ads campaigns) منسوخ شده: برای هتل‌های برنامه پورسانت پرداخت به ازای اقامت (PPS) به true (true) برمی‌گردد، در غیر این صورت به false (false) برمی‌گردد.
IF-PROMO-CODE Optional اگر کاربر روی نرخی کلیک کرده باشد که بر اساس یک تبلیغ ARI یا یک قانون نرخ با یک PromoCode مشخص است، مقدار true را برمی‌گرداند؛ در غیر این صورت مقدار false را برمی‌گرداند.
IF-PROMOTED (فقط تبلیغات هتل) Recommended (if you use Promoted hotels) اگر کاربر روی آگهی تبلیغاتی ملک کلیک کرده باشد، مقدار true و در غیر این صورت مقدار false را برمی‌گرداند.
IF-RATE-RULE-ID Optional اگر کاربر یک نرخ شرطی را انتخاب کرده باشد، مقدار true و در غیر این صورت مقدار false را برمی‌گرداند.
IF-USER-LIST-ID (تعریف شده در گوگل ادز) Optional اگر کاربر عضوی از شناسه لیست مشتریان گوگل ادز باشد که شما هنگام تنظیم ضرایب پیشنهاد برای لیست مخاطبان مشخص کرده‌اید، مقدار true و در غیر این صورت مقدار false را برمی‌گرداند.
IF-VERIFICATION Optional اگر لینک توسط گوگل برای آزمایش یا اعتبارسنجی خودکار ایجاد شده باشد، مقدار true و در غیر این صورت مقدار 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)&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>

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

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

اگر کاربر یک Room Bundle انتخاب کرده باشد، نتیجه URL زیر خواهد بود: 

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>

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

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

اگر کاربر یک Room Bundle انتخاب کرده باشد، نتیجه URL زیر خواهد بود: 

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>

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

https://partner.com?hid=123

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

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>

اگر کاربر واجد شرایط دریافت نرخ خصوصی باشد، نتیجه 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

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

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

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

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>

در این مثال، اگر کاربر تاریخی را انتخاب نکرده باشد، نتیجه ممکن است مشابه 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>

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

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

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

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

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

شناسه‌های کمپین خالی با کلیک‌های 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)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)&amp;FreeBookingLink(ENDIF)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

شناسه‌های اصلاح‌شده‌ی IF

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

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

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

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

https://partner.com?hid=123

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

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

کد تخفیف IF

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

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

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

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

https://partner.com?hid=123

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

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>

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

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

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

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>

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

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

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

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

مثال IF-USER-LIST-ID (تعریف شده در Google Ads)

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

<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

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

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

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

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

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

https://www.partner.com?hid=123&isgoogle=true

مثال برای هر سن کودک

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

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

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

در این مثال، اگر برنامه سفر شامل ۲ بزرگسال و ۲ کودک به ترتیب با سن ۰ و ۱۷ سال باشد، نتیجه 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 صفحه فرود خود نیستید. با این حال، استفاده از متغیرها برای ارسال برنامه سفر و اطلاعات کاربر عموماً تجربه بهتری را برای کاربر ایجاد می‌کند و به شما در مطابقت با سیاست‌های گوگل کمک می‌کند.

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

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

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

    <!-- 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 صفحه فرود قرار دهید، رمزگذاری 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

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

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