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

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

אפשר להשתמש בהוראות מיוחדות ברכיב <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_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 (ב-Hotel Ads בלבד)

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

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

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

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