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

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

לוגיקה מותנית בכתובות URL

אפשר להשתמש בהוראות מיוחדות ברכיב <URL> של קובץ דפי נחיתה כדי ליצור נקודות קצה באופן מותנה.

הלוגיקה המותנית תומכת בהצהרות הבאות:

  • if_statement: אם true, המערכת מוסיפה לכתובת ה-URL את הערכים שמופיעים אחרי התנאי הזה. אחרת, המערכת מוסיפה את הערכים שמופיעים אחרי ההוראה ELSE.

  • for_statement: יוצרת תנאי של לולאת FOR שחוזרת על עצמה לפי מספר הערכים שסופקו.

ההצהרות IF ו-FOR כוללות את הפרטים הבאים:

תנאי מומלץ/אופציונלי תיאור
IF-AD-CLICK (מודעות להזמנת חדרים בלבד) Optional הערך שמתקבל הוא true אם הקליק של המשתמש הגיע ממודעה. הערך הוא false אם הקליק של המשתמש הגיע מקישור ללא עלות לביצוע הזמנה.
IF-CLICK-TYPE-HOTEL Optional הערך שמוחזר הוא true אם המשתמש לחץ על כרטיס מוצר של מלון, אחרת הערך שמוחזר הוא false.
IF-CLICK-TYPE-ROOM Optional הערך שמתקבל הוא true אם המשתמש לחץ על כרטיס מוצר של חבילת חדרים, אחרת הערך שמתקבל הוא false.
IF-CLOSE-RATE-RULE-IDS Optional הערך שמתקבל הוא true אם תעריף מותנה אחד או יותר לא היו זמינים כי המשתמש לא עמד בדרישות, אחרת הערך שמתקבל הוא false. ברירת המחדל היא trueאם הטיפול בממשק של שיעור פרטי הוצג למשתמש.
IF-DEFAULT-RATE Optional הערך הוא true אם המשתמש לחץ על כרטיס מלון שבו נעשה שימוש בתאריכי ברירת מחדל, אחרת הערך הוא false.
IF-HOTEL-CAMPAIGN Optional הערך הוא true אם הקליק של המשתמש הגיע מקמפיין לקידום מלון, אחרת הערך הוא false. ההבחנה הזו מועילה לשותפים שמפעילים ב-Google 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_room?hid=123

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

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

דוגמה לתנאי IF-CLICK-TYPE-ROOM

אפשר ליצור חסימה מותנית שבודקת אם המשתמש בחר חבילת חדרים.

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

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

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

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

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

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

דוגמה לשימוש בתנאי IF-DEFAULT-DATE

משתמשים במשפט התנאי IF-DEFAULT-DATE כדי להגדיר פרמטר שאינו תאריך, שאפשר להשתמש בו באתר כדי להפעיל התנהגות מותאמת אישית אם המשתמש לא בחר תאריך.

בדוגמה הבאה נבדק אם נעשה שימוש בתאריך ברירת המחדל:

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)&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

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

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

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

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

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