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

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

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

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

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

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

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

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

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

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

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

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

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

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

• אפשר להשתמש בכל מזהה לשם של פרמטרים של מחרוזת שאילתה. השרת שלכם מעבד את הערכים האלה. עם זאת, הערכים שאתם מעבירים מוגבלים לרשימת המשתנים הזמינים.

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