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

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

نمای کلی

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

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

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

مثال 1 

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

مثال 2 

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

هنگامی که پیوند صفحه فرود برای صفحه نتایج جستجو ساخته می شود، Google متغیرها را با مقادیر واقعی جایگزین می کند تا اطمینان حاصل شود که URL شامل اطلاعات پویا است. برای مثال، اگر کاربر از تاریخ 23/5/2023 اتاقی را به مدت 6 شب برای هتل شماره 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 مرتبط شود. اگر کلیک به یک کمپین تبلیغاتی گوگل مرتبط نباشد، این خالی است.
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 نشان می دهد که آیا کاربر برای نرخ استاندارد هتل روی لیست کلیک کرده است یا برای یک بسته اتاق. مقادیر ممکن عبارتند از:
  • hotel : کاربر برای نرخ استاندارد اتاق روی لیست کلیک کرد.
  • room : کاربر روی لیست یک اتاق بسته کلیک کرد.
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 نشان می دهد که آیا کاربر تاریخ پیش فرض را انتخاب کرده است یا تاریخ خاصی را که در جستجو ارائه شده است. مقادیر ممکن عبارتند از:
  • default : کاربر روی آگهی هتل یا پیوند رزرو رایگان کلیک کرده است که در آن از تاریخ‌های پیش‌فرض استفاده شده است.
  • selected : کاربر روی آگهی هتل یا لینک رزرو رایگان با تاریخ های تعیین شده کلیک کرده است.
GOOGLE-ADS-CLICK-SOURCE Optional نشان می دهد که Google Ads منبع کلیک بوده است. مقادیر ممکن عبارتند از:
  • bl : پیوندهای رزرو پولی
  • tpa : تبلیغات تبلیغاتی سفر
  • tfsa : فیدهای سفر در تبلیغات جستجو
  • pm : کمپین‌های حداکثر عملکرد یا حداکثر عملکرد برای اهداف سفر.

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

GOOGLE-SITE Optional دارایی Google که کاربر داده‌های قیمت هتل شما را در آن مشاهده کرده است. مقادیر ممکن عبارتند از:
  • localuniversal : کاربر لینک رزرو هتل را از طریق جستجوی google.com پیدا کرد.
  • mapresults : کاربر لینک رزرو هتل را از طریق maps.google.com پیدا کرد.
  • verification : Google از این مقدار هنگام انجام آزمایش‌های خودکار کیفیت داده در سایت شما استفاده می‌کند. شما برای این سوالات صورتحساب دریافت نمی کنید. Google Analytics می‌تواند از این پارامتر و مقدار آن برای شناسایی ترافیک تأیید خودکار تبلیغات هتل استفاده کند.
  • unknown : کاربر آگهی یا پیوند رزرو رایگان را از طریق منبع نامشخصی پیدا کرده است.
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> است. برای یک Room Bundle، شناسه بسته مقدار عنصر <PackageID> در بلوک‌های <RoomBundle> یا <PackageData> پیام Transaction است.
PARTNER-CURRENCY Optional کد ارز سه حرفی که توسط ویژگی currency عنصر <Baserate> در فید قیمت هتل تعریف شده است. به عنوان مثال، USD یا CAD .
PARTNER-HOTEL-ID Recommended شناسه منحصر به فرد هتل که توسط عنصر <id> در فید لیست هتل تعریف شده است.
PARTNER-ROOM-ID Recommended (applies if you use Room Bundles) شناسه منحصر به فرد اتاق در فید قیمت هتل. برای یک اتاق استاندارد، شناسه اتاق مقدار عنصر <RoomID> در بلوک <Result> است. برای یک Room Bundle، شناسه اتاق مقداری است که به عنصر <RoomID> در بلوک‌های <RoomBundle> یا <RoomData> در پیام Transaction اختصاص داده شده است.
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 استفاده می کنید، مقدار این متغیر به ویژگی 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 (تعریف شده در Google Ads) Optional (only applies if you use Audience Lists in Google Ads) شناسه فهرست کاربری Google Ads که حاوی لیست مخاطبان یا اطلاعات کاربر است. فهرست های مخاطبان به عنوان مبنایی برای تنظیم تعدیل قیمت ها استفاده می شود. اگر کاربر بخشی از چند فهرست مخاطب باشد، فهرست مخاطبان با بیشترین تعدیل قیمت انتخاب می شود. روابط بین مخاطبان با بیشترین تعدیل قیمت به صورت تصادفی تعیین می شود.
VERIFICATION Optional یک بولی که تأیید می‌کند آیا پیوند توسط Google برای آزمایش یا اعتبارسنجی خودکار ایجاد شده است یا خیر. اگر پیوند توسط Google برای آزمایش یا اعتبارسنجی خودکار ایجاد شده باشد، true است، در غیر این صورت 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 تعیین می‌شود. به‌طور پیش‌فرض، اگر یک UI نرخ خصوصی به کاربر نشان داده شود، true است.
IF-DEFAULT-RATE Optional اگر کاربر روی فهرست هتلی که در آن از تاریخ‌های پیش‌فرض استفاده شده است کلیک کند، به true تبدیل می‌شود، در غیر این صورت به false تشخیص داده می‌شود.
IF-HOTEL-CAMPAIGN Optional در صورتی که کلیک کاربر از یک کمپین هتلی منشا گرفته باشد، به true حل می‌شود، در غیر این صورت به false تبدیل می‌شود. این تمایز برای شرکای دارای چندین نوع کمپین در Google Ads برای تخصیص انتساب مفید است.
IF-PAYMENT-ID (فقط تبلیغات هتل) Recommended (if you use pay-per-stay Google Ads campaigns) برای هتل‌ها در برنامه کمیسیون پرداخت به ازای اقامت (PPS) به true حل می‌شود، در غیر این صورت به 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 (تعریف شده در Google Ads) Optional اگر کاربر عضو شناسه فهرست مشتریان Google Ads باشد که هنگام تنظیم ضرایب قیمت پیشنهادی برای فهرست‌های مخاطبان مشخص کرده‌اید، به true حل می‌شود، در غیر این صورت به false تعیین می‌شود.
IF-VERIFICATION Optional اگر پیوند توسط Google برای آزمایش یا اعتبارسنجی خودکار ایجاد شده باشد، 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_room?hid=123

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

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

مثال IF-CLICK-TYPE-ROOM

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

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

<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-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)<strong>(IF-DEFAULT-DATE)</strong>&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>

در این مثال، اگر کاربر روی 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)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)&amp;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)&amp;booking_source=(IF-PAYMENT-ID)(PAYMENT-ID)(ELSE)cpc(ENDIF)</URL>

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

  • اگر شماره IATA به Google اختصاص داده نشده است:
    https://partner.com?hid=123&amp;booking_source=commissions
  • اگر شماره IATA به Google اختصاص داده شده باشد:
    https://partner.com?hid=123&amp;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)&amp;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 Ads)

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

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

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

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

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

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

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

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>

در این مثال، اگر برنامه سفر دارای 2 بزرگسال و 2 کودک با سن 0 و 17 سال بود، نتیجه URL زیر است: 

https://www.partner.com?adults=2&children=2&age=0_0age=1_17&hid=123

اگر برنامه سفر دارای 2 بزرگسال و 0 کودک بود، نتیجه URL زیر است: 

https://www.partner.com?adults=2&children=0&hid=123

قوانین کلی هنگام ساخت URL

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

قوانین کلی زیر هنگام تعریف 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 صفحه فرود قرار دهید، رمزگذاری کنید. به عنوان مثال:

    • space (" "): کاراکترهای فاصله را با "%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

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

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