מודעות להזמנת חדרים וקישורים ללא עלות לביצוע הזמנות כוללים קישורים לדפי נחיתה שבהם המשתמשים יכולים להזמין חדרים. אתם יכולים להגדיר איך Google יוצרת את הקישור כך שיכלול את כל המידע הנוסף על המשתמש ועל מסלול הנסיעה שלו. לדוגמה, תוכלו לכלול בכתובת ה-URL פרטים כמו מזהה המלון, השפה, קודי המטבע ותאריכי הצ'ק-אין.
סקירה
את כתובת דף הנחיתה מגדירים בקובץ דפי הנחיתה. כשהמודעה או הקישור להזמנה בחינם מוצגים, המידע הדינמי בכתובת ה-URL מוחלף בערכים בפועל. כדי להוסיף ערכים דינמיים לכתובות דפי הנחיתה, משתמשים בתחביר הבא:
<URL>https://partner_url?param_id=(variable_name)</URL>
בדוגמה הבאה מוצגת כתובת URL שמשתמשת בשמות המשתנים של Google במקום במזהה המלון ובמסלול הנסיעה בפועל:
<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)
&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)
&checkinYear=(CHECKINYEAR)&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
בטבלה הבאה מתוארים המשתנים הזמינים שבהם אפשר להשתמש כדי ליצור את כתובת דף הנחיתה:
| משתנה | מומלץ/אופציונלי | תיאור |
|---|---|---|
| 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 | השנה (4 הספרות) שהוגדרה ברכיב <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 | מציין אם המשתמש לחץ על כרטיס המוצר כדי לציין תעריף רגיל
של מלון או עבור חבילת חדרים. הערכים האפשריים הם:
|
| CLOSE-RATE-RULE-IDS | Optional (only applies if you are using conditional or private rates) | רשימה מופרדת בפסיקים של מזהים של כללי תמחור בשביל תעריפים שלא היו זמינים, אבל יכול להיות שהמזהים היו זמינים אם המשתמש ביצע פעולה משנית. לתשומת ליבך, מזהים של כללי תמחור בשביל תעריפים פרטיים תמיד מאוכלסים כאן כשמוצג ממשק משתמש תואם שמוצג למשתמש. |
| CUSTOM[1-5] | Optional | הערכים של שדות בהתאמה אישית שמוגדרים ברכיב <Result> עם מגבלה של 200 תווים לכל שדה מותאם אישית. למידע נוסף, קראו את המאמר סקירה כללית של הודעות בנושא עסקאות. שדות בהתאמה אישית לא זמינים כשמשתמשים ב-ARI. |
| DATE-TYPE | Optional | מציין אם המשתמש בחר את תאריך ברירת המחדל או תאריך ספציפי
שסופק בחיפוש. הערכים האפשריים הם:
|
| GOOGLE-SITE | Optional | הנכס של Google שבו משתמש צפה בנתוני התמחור של המלון.
הערכים האפשריים הם:
|
| LENGTH | Recommended | משך השהייה במונחים של מספר הלילות, המוגדר על ידי
הרכיב <Nights> בפיד מחירי המלון. לדוגמה, 3. |
| 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>
בהודעת העסקה. |
| PAYMENT-ID | 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, הערך של המשתנה מוקצה למאפיין אם משתמשים ב
כללי תמחור, הערך של המשתנה מוקצה לרכיב |
| 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 יכול להיות אחד מהערכים הבאים:
המערכת מסיקה את הערך של המשתנה |
| 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
לצורך בדיקה או אימות אוטומטי. אם הקישור נוצר על ידי Google לצורך בדיקה או אימות אוטומטי, הסטטוס שלו יהיה true. אחרת, הקישור הוא 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-PAYMENT-ID (מודעות להזמנת חדרים בלבד) | 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
אפשר ליצור בלוק מותנה כדי לבדוק אם המשתמש לחץ על מודעה או על קישור ללא עלות לביצוע הזמנה כדי להפנות לדף הנחיתה שלכם.
הדוגמה הבאה משתמשת בהוראה הזו בקובץ דף נחיתה:
<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-AD-CLICK)&adType=1(ELSE)&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-מלון
אפשר ליצור בלוק מותנה כדי לבדוק אם המשתמש בחר מלון
בלי חבילת חדרים מפורשת. הערך של הרכיב <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)&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)&checkinYear=(CHECKINYEAR)&nights=(LENGTH)<strong>(IF-DEFAULT-DATE)</strong>&popup_datepicker=true(ELSE)&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-GUEST-CAMPAIGN (מודעות להזמנת חדרים וקליקים על קישורים ללא עלות לביצוע הזמנה)
אפשר ליצור חסימה מותנית כדי לבדוק אם המשתמש לחץ על מודעה שהגיעה מקמפיין לקידום מלון.
הדוגמה הבאה משתמשת בהוראה הזו בקובץ דף נחיתה:
<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)&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)&hotel_campaign=(CAMPAIGN-ID)(ELSE)&FreeBookingLink(ENDIF)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>
דוגמה ל-IF-PAYMENT-ID (מודעות להזמנת חדרים בלבד)
אפשר להשתמש בהצהרה המותנית IF-PAYMENT-ID כדי לשנות את כתובת ה-URL בהתאם למקרים שבהם הקליק הוא תוצאה של תוכנית עמלות PPS או לא. בדוגמה הבאה אנחנו בודקים אם הקליק הגיע מתוכנית העמלות של PPS, ומקצה ערך לפרמטר booking_source על סמך התוצאה:
<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)&booking_source=(IF-PAYMENT-ID)(PAYMENT-ID)(ELSE)cpc(ENDIF)</URL>
אם המלון משתתף בתוכנית 'עמלות', התוצאה תהיה אחת מכתובות ה-URL הבאות:
- אם לא הוקצה ל-Google מספר IATA:
https://partner.com?hid=123&booking_source=commissions
- אם הוקצה ל-Google מספר IATA:
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)&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)&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
כדי לבדוק אם Google יצרה את כתובת ה-URL לצורך בדיקה או אימות אוטומטי, אפשר להשתמש ב-IF-VERIFICATION.
<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-VERIFICATION)&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)&children=(NUM-CHILDREN)(FOR-EACH-CHILD-AGE)&age=(CHILD-INDEX)_(CHILD-AGE)(END-FOR-EACH)&hid=(PARTNER-HOTEL-ID)&</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 מובנות בקובץ של דפי נחיתה:
כל המשתנים מוקפים בסוגריים פתוחים ובסוגריים סוגרים.
אפשר להעביר פרמטרים של מחרוזת שאילתה רק אחרי סימן השאלה ("?") בכתובת ה-URL.
הפרמטרים של מחרוזת השאילתה צריכים להיות מופרדים באמצעות אמפרסנד ('&') בפלט הסופי. האמפרסנד הוא תו מיוחד ב-XML, והפורמט של דפי הנחיתה הוא XML. לכן צריך להשתמש בישות המקודדת '&" במקומה. הפלט הסופי מעבד את התו '&' אמיתי. למשל:
<!-- Do this: --> <URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&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.
- רווח (" "): מחליפים את תווי הרווח ב-"%20;" ברכיב
אפשר ליצור ערכים של פרמטר יחיד מכמה משתנים. בדוגמה הבאה נוצר פרמטר יחיד,
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אפשר להשתמש בכל מזהה בתור שם הפרמטרים של מחרוזת השאילתה. השרת מעבד את הערכים האלו. עם זאת, הערכים שאתם מעבירים מוגבלים לרשימת המשתנים הזמינים.
בנוסף לרשימת המשתנים הזמינים, אפשר להשתמש בעד חמישה משתנים מותאמים אישית.