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

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

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

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

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

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

דוגמה עבור קליק על מודעה מסוג IF-AD

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

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

<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

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

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

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)&amp;booking_source=(IF-PAYMENT-ID)(PAYMENT-ID)(ELSE)cpc(ENDIF)</URL>

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

• אם לא הוקצה ל-Google מספר IATA:

  https://partner.com?hid=123&booking_source=commissions

• אם מספר IATA הוקצה ל-Google:

  https://partner.com?hid=123&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-כלל-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

כל המשתנים הם אופציונליים. אין צורך להוסיף משתנים לכתובת ה-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>
  

  צריך גם לקודד תווים מיוחדים שעשויים להיכלל בכתובת דף הנחיתה. לדוגמה:

  • רווח (" "): מחליפים את תווים הרווחים ב-"%20;" ברכיב <URL>
  • קו נטוי (‎"/"‎): מחליפים את הקווים הנטויים ב-‎"%2F;"‎ ברכיב <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
  

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

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