משתנים ותנאים

מודעות להזמנת חדרים וקישורים ללא עלות לביצוע הזמנה כוללים קישורים לדפי נחיתה שבהם המשתמשים יכולים להזמין חדרים. אתם יכולים להגדיר איך Google יוצרת את הקישור כך שיכלול את כל המידע הנוסף על המשתמש ועל מסלול הנסיעה שלו. לדוגמה, אפשר לכלול בכתובת ה-URL מידע כמו מזהה המלון, השפה, קודי המטבע ותאריכי הצ'ק-אין.

סקירה כללית

אתם מגדירים את כתובת דף הנחיתה בקובץ דפי הנחיתה. כשהמודעה או הקישור לביצוע הזמנה ללא תשלום מוצגים, המידע הדינמי בכתובת ה-URL מוחלף בערכים בפועל. כדי להוסיף ערכים דינמיים לכתובות דפי הנחיתה, משתמשים בתחביר הבא:

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

בדוגמה הבאה מוצגת כתובת 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 כוללת את המידע הדינמי. לדוגמה, אם המשתמש מזמין חדר ל-6 לילות החל מ-23/5/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 Ads שרוצים לשייך לכתובת ה-URL. העמודה הזו ריקה אם הקליק לא משויך לקמפיין Google Ads.
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 השנה (מספר בן 4 ספרות) שמחושבת מהרכיבים <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) רשימה של מזהי כללי תמחור, מופרדים בפסיקים, של תעריפים שלא היו זמינים, אבל יכלו להיות זמינים אם המשתמש היה מבצע פעולה קלה. שימו לב: מזהי כללי התמחור של מחירים פרטיים תמיד יופיעו כאן כשמוצג למשתמש ממשק משתמש מתאים.
Optional הוצא משימוש: הערכים של שדות מותאמים אישית שמוגדרים ברכיב <Result> עם מגבלה של 200 תווים לכל שדה מותאם אישית. מידע נוסף זמין במאמר סקירה כללית של הודעות על עסקאות. אי אפשר להשתמש בשדות מותאמים אישית כשמשתמשים ב-ARI. משתני CUSTOM מופיעים רק כששולחים את המחירים בהודעת העסקה.

חשוב: אם אתם רוצים להשתמש במשתני CUSTOM, עליכם לפנות אל מנהל החשבון הטכני (TAM).

DATE-TYPE Optional מציין אם המשתמש בחר את תאריך ברירת המחדל או תאריך ספציפי שסופק בחיפוש. הערכים האפשריים הם:
  • default: המשתמש לחץ על מודעה להזמנת חדרים או על קישור ללא עלות לביצוע הזמנה שבהם נעשה שימוש בתאריכי ברירת המחדל.
  • selected: המשתמש לחץ על מודעה לקידום מלון או על קישור חינמי להזמנת חדר במלון עם תאריכים מוגדרים.
GOOGLE-ADS-CLICK-SOURCE Optional מציין ש-Google Ads היה המקור של הקליק. הערכים האפשריים הם:
  • bl: קישורים בתשלום לביצוע הזמנה
  • tpa: מודעות לקידום עסקים בענף התיירות והאירוח
  • tfsa: פידים של נתוני נסיעות במודעות לרשת החיפוש
  • pm: קמפיינים למיקסום הביצועים או קמפיינים למיקסום הביצועים לענף התיירות והאירוח
  • dg: קמפיין ליצירת ביקוש
  • הערה: אם הקליק הגיע מחיפוש Google ולא מ-Google Ads, הפרמטר הזה יהיה ריק

GOOGLE-SITE Optional הנכס של Google שבו משתמש צפה בנתוני התמחור של המלון שלכם. הערכים האפשריים הם:
  • localuniversal: המשתמש מצא את הקישור להזמנת חדר במלון דרך חיפוש google.com.
  • mapresults: המשתמש מצא את הקישור להזמנה במלון דרך maps.google.com.
  • verification: Google משתמשת בערך הזה כשהיא מבצעת בדיקות אוטומטיות של איכות הנתונים באתר שלכם. אנחנו לא מחייבים אתכם על השאילתות האלה. מערכת Google Analytics יכולה להשתמש בפרמטר הזה ובערך שלו כדי לזהות תנועה של אימות אוטומטי של מודעות להזמנת חדרים במלון.
  • 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 מספר הילדים (בגיל 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> בהודעה על העסקה.
Optional (only applies to Ads) הוצא משימוש: הפרמטר הזה מקבל ערך של מחרוזת מוגדרת מראש commission, או מספר IATA שהוקצה ל-Google (למשל '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> מייצג את המזהה הייחודי של שילוב נתוני חדר וחבילה, והאורך שלו צריך להיות עד 50 תווים כדי להשיג ביצועים אופטימליים. מידע נוסף זמין במאמר בנושא חבילות לחדרים.
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 לצורך בדיקה או אימות אוטומטי. הערך הוא 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-DATE Optional הערך הוא true אם המשתמש לחץ על כרטיס מלון שבו נעשה שימוש בתאריכי ברירת מחדל, אחרת הערך הוא false.
IF-HOTEL-CAMPAIGN Optional הערך הוא true אם הקליק של המשתמש הגיע מקמפיין לקידום מלון, אחרת הערך הוא false. ההבחנה הזו שימושית לשותפים שמפעילים ב-Google Ads כמה סוגים של קמפיינים, כדי להקצות שיוך.
IF-MODIFICATION-IDS Optional הערך שמתקבל הוא true אם המשתמש לחץ על מחיר ששונה על ידי שינוי מחיר של ARI, אחרת הערך שמתקבל הוא false.
(מודעות להזמנת חדרים בלבד) 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 Ads) Optional הערך הוא true אם המשתמש הוא חבר ברשימת לקוחות עם מזהה ב-Google Ads שציינתם כשקבעתם מכפילים של הצעות מחיר לרשימות קהלים, אחרת הערך הוא 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)&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>

בדוגמה הזו, אם המשתמש לא בחר חבילת חדרים, התוצאה היא כתובת ה-URL הבאה:

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

אם המשתמש בחר חבילת חדרים, התוצאה היא כתובת ה-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>

בדוגמה הזו, אם המשתמש לא בחר חבילת חדרים, התוצאה היא כתובת ה-URL הבאה:

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

אם המשתמש בחר חבילת חדרים, התוצאה היא כתובת ה-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>

בדוגמה הזו, אם הקליק לא מתבצע על כתובת URL של קמפיין לקידום מלונות (למשל, קמפיין רגיל לרשת החיפוש), התוצאה היא כתובת ה-URL הבאה:

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

אם המשתמש לוחץ על כתובת URL של קמפיין מלונות, התוצאה היא כתובת ה-URL הבאה:

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

האפשרות הזו שימושית כשרוצים להבחין בין התנועה של קליקים בקמפיינים לקידום מלונות לבין קליקים אחרים.

מזהי קמפיינים ריקים עם קליקים על קישורים חינמיים לביצוע הזמנה

אם הקליק הוא מקישור ללא עלות לביצוע הזמנה, אז 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-MODIFICATIONS-IDS

אפשר ליצור בלוק של תנאים שבודק אם המשתמש עדכן את ההודעה ARI Rate modifications.

בדוגמה הבאה נעשה שימוש בהנחיה הזו בקובץ של דף נחיתה:

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

בדוגמה הזו, אם קוד ההטבה לא היה תקין, כתובת ה-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)

אם מגדירים מכפילים של הצעות מחיר לרשימות קהלים בקמפיין לקידום מלונות ב-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>

בדוגמה הזו, אם המשתמש לא היה חבר ברשימת קהלים, התוצאה היא כתובת ה-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

אם Google יצרה את כתובת ה-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

כל המשתנים הם אופציונליים. לא צריך להוסיף משתנים לכתובת דף הנחיתה. עם זאת, שימוש במשתנים כדי להעביר מידע על מסלול הנסיעה ועל המשתמש בדרך כלל יוצר חוויה טובה יותר למשתמש ועוזר לכם לעמוד בדרישות המדיניות של 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 את התווים המיוחדים שאולי כללתם בה. לדוגמה:

    • רווח (" "): מחליפים את תווי הרווח ב-‎%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
    
  • אפשר להשתמש בכל מזהה לשם של פרמטרים של מחרוזת שאילתה. השרת שלכם מעבד את הערכים האלה. עם זאת, הערכים שאתם מעבירים מוגבלים לרשימת המשתנים הזמינים.

  • אפשר להשתמש בעד חמישה משתנים מותאמים אישית בנוסף לרשימת המשתנים הזמינים.