מודעות להזמנת חדרים וקישורים ללא עלות לביצוע הזמנה כוללים קישורים לדפי נחיתה שבהם המשתמשים יכולים להזמין חדרים. אפשר להגדיר את האופן שבו 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 | השנה בת ארבע הספרות שמוגדרת ברכיב <Checkin>
בפיד מחירי המלון. לדוגמה: 2023. |
| CHECKOUTDAY | Recommended | היום בן שתי הספרות שמחושב לפי הרכיבים <Nights>
ו-<Checkin> בפיד מחירי המלון. לדוגמה, 26. |
| CHECKOUTMONTH | Recommended | החודש הדו-ספרתי שמחושב על סמך הרכיבים <Nights>
ו-<Checkin> של פיד מחירי המלון. לדוגמה, 05. |
| CHECKOUTYEAR | Recommended | השנה בת ארבע הספרות שמחושבת מהאלמנטים <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
לצורך בדיקה או אימות אוטומטי. true הוא הערך אם הקישור נוצר על ידי Google לצורך בדיקה או אימות אוטומטי. אחרת, הערך הוא false.
|
לוגיקה מותנית בכתובות URL
אפשר להשתמש בהוראות מיוחדות ברכיב <URL> של קובץ דפי נחיתה כדי ליצור נקודות קצה (endpoints) באופן מותנה.
הלוגיקה המותנית תומכת בהצהרות הבאות:
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-Click
אפשר ליצור בלוק מותנה שבודק אם המשתמש לחץ על מודעה או על קישור ללא עלות לביצוע הזמנה כדי להפנות לדף הנחיתה.
בדוגמה הבאה נשתמש בהנחיה הזו בקובץ דפי נחיתה:
<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-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)&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-Hotel-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
האפשרות הזו שימושית כשרוצים להבדיל בין התנועה של קליקים בקמפיינים לקידום מלונות לבין כל קליק אחר.
מזהי CAMPAIGN ריקים עם קליקים של 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
דוגמה לאימות
כדי לבדוק אם 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.
- רווח (" "): החלפת תווי רווח ב-"%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אפשר להשתמש בכל מזהה בתור הפרמטרים של מחרוזת השאילתה. השרת שלכם מעבד את הערכים האלה. עם זאת, הערכים שאתם מעבירים מוגבלים לרשימת המשתנים הזמינים.
אפשר להשתמש בעד חמישה משתנים מותאמים אישית, בנוסף לרשימת המשתנים הזמינים.