הודעות בנושא שאילתות

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

הרכיב הבסיסי (root) של הודעות השאילתה הוא <Query>.

המבנה של הודעת השאילתה תלוי בסוג ההודעה:

  • תמחור: Google שולחת הודעת שאילתה עם בקשה לעדכן את המחירים של המלונות שצוינו.

  • מטא-נתונים: Google שולחת הודעת שאילתה עם בקשה לנתונים על החדר והחבילה במלונות שצוינו.

במהלך ההגדרה הראשונית, צריך להגדיר את נקודת הקצה ש-Google משתמשת בה להודעות שאילתה ולשאילתות תמחור בזמן אמת. למידע נוסף, תוכלו לפנות למנהל החשבונות הטכני (TAM).

Google שולחת הודעת שאילתה כבקשת POST של HTTP. הכותרת Content-Type מוגדרת ל-"application/xml" והכותרת User-Agent מוגדרת ל-Google-HotelAdsPrices. היוצא מן הכלל לכלל הזה מתרחש במהלך בדיקה ידנית של השילוב של נקודת הקצה של המחיר דרך Google-TravelAds-Live. שאילתות הדוגמה האלה יכולות להכיל את הכותרת User-Agent, אבל לא בהכרח.

עיצוב מפורט להודעות של שאילתה מופיע בחומר העזר בנושא XML של שאילתה.

הודעות של שאילתות תמחור

הודעות של שאילתות תמחור מציינות את השילובים של הנכס או מסלול הנסיעה שעבורם אתם מציינים את המחירים.

כשהשרת מקבל הודעת שאילתת pricing, עליו להגיב עם הודעת <Transaction> שמכילה את פרטי התמחור המבוקשים.

מידע נוסף זמין במאמר סקירה כללית של התמחור.

יש שלושה סוגים מיוחדים של הודעות שאילתה:

  1. Live price (תמחור בזמן אמת): אם האפשרות הזו מופעלת, השאילתות נשלחות כשמשתמש מחפש באופן פעיל מחירים של השילוב של הנכס או מסלול הנסיעה, ועומדים לרשותכם מסגרת זמן מסוימת להשיב.

  2. עם הקשר: אם האפשרות הזו מופעלת, ההמלצות להקשר של המשתמש נכללות בכל שאילתה ש-Google שולחת לכם, וההמלצות משקפות את הסוגים הנפוצים ביותר של משתמשים שמחפשים את השילובים שצוינו של הנכס או מסלול הנסיעה. כדאי ליישם את ההמלצות האלה כדי לשפר את היעילות של התשובות שלכם.

  3. מטא-נתונים: בקשה לקבלת פרטים על חדרים וחבילות בנכסים שצוינו.

שאילתות לגבי תמחור בזמן אמת

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

לכל הבקשות לשאילתות תמחור בזמן אמת יש מגבלת זמן תגובה של עד 4,000 אלפיות השנייה. המגבלה הזו מוגדרת בבקשת השאילתה לתמחור בזמן אמת. אם אי אפשר לענות במסגרת מגבלת הזמן, אי אפשר יהיה להשתתף בהזדמנות הספציפית. עם זאת, מומלץ לציין מחיר בכל זאת כדי שיהיה אפשר לשמור אותו במטמון ולהשתמש בו להזדמנויות עתידיות. החיבור לתשובה נשאר פתוח למשך עשר דקות או בהתאם להגדרות של השותף.

גם שאילתות התמחור בזמן אמת מבוססות על הקשר, והן יכולות לאחזר מחירים לפי הפרמטרים הבאים: המדינה של המשתמש, סוג המכשיר, מספר האורחים (מספר האורחים) ואם האורחים הם מבוגרים או ילדים. בעזרת שאילתות לגבי תמחור בזמן אמת תוכלו להציג מחירים עדכניים יותר שתואמים למה שהלקוח חיפש.

שאילתות של תמחור בזמן אמת נועדו להיות מנגנון משני לעדכוני תמחור. המנגנון העיקרי לתמחור מחדש הוא עדיין באמצעות שיטת Pull או בוצע שינוי במחיר. שאילתות לתמחור בזמן אמת עוזרות למלא את הפערים במקרים שבהם אין ל-Google מחירים של שילובים של מלונות או של מסלולי נסיעה.

כללים לשימוש בשאילתות של תמחור בזמן אמת

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

  • התאריך המבוקש לא מוגדר כברירת המחדל.

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

Google בדרך כלל שומרת במטמון את התוצאות של מחיר בזמן אמת כדי שלא יישלחו שוב שאילתות לגבי אותו מלון או אותה תוכנית. ניתן לבקש שילובים של מלון אחד או מסלול נסיעה אחד וגם שילובים של כמה מלונות או מסלול נסיעה יחיד.

התכונה Livepricing with Context מאפשרת ל-Google לשלוח בקשות ספציפיות לתמחור בזמן אמת לפי סוג המכשיר של המשתמש, המדינה שבה הוא מבצע את החיפוש ומספר האורחים, כולל ילדים. גם הודעת השאילתה וגם הודעת העסקה מורחבות כך שיכללו את הרכיב <Context> שמגדיר את הפרמטרים של השאילתה. אפשר לשמור במטמון מחירים שהתקבלו משאילתות של תמחור בזמן אמת עם הקשר כחבילת חדר, אם מדובר במחיר למספר אורחים ספציפי וכתעריף מותנה, אם מדובר במדינה של משתמש או במכשיר של משתמש.

באמצעות שאילתות לפי הקשר

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

הודעות של שאילתת מטא-נתונים

הודעות של שאילתות מטא-נתונים מכילות פרטים על פרטי חדרים וחבילות בנכסים שצוינו.

כשמקבלים הודעה לגבי שאילתת מטא-נתונים, צריך לשלוח הודעה <Transaction> שמציינת תמחור לנכסים המבוקשים ברכיבי <Result>.

מידע נוסף מופיע במאמר בנושא הגדרת מטא-נתונים של חדרים וחבילות.

שאילתות בקרה

בקטע הזה מוסבר איך קובעים אילו מאפיינים ומסלולי נסיעה יכולים להיות הנושא של הודעות שאילתה מ-Google.

גבולות מסלולי נסיעה

כדי לקבוע את הגבולות האפשריים של שאילתות התמחור, משתמשים ב-<ItineraryCapabilities>. אפשר להגדיר כללים שקובעים את טווח התאריכים ואת משך השהייה המקסימלי שנתמך.

אפשר להגדיר ערכי ברירת מחדל ל-<MaxAdvancePurchase> ול-<MaxLengthOfStay> שרלוונטיים לכל השילובים של מלונות או של מסלולי נסיעה. אפשר לקבוע את ההגדרות האלה גם לקבוצות של מלונות.

דוגמאות להודעות לשאילתות

בקטע הזה מוצגות כמה דוגמאות לתמחור של הודעות שאילתה והודעת שאילתה במטא-נתונים. דוגמאות נוספות מופיעות בהפניה ל-XML של שאילתה.

מסלול נסיעה לדוגמה

בדוגמה הבאה מוצג מחיר <Query> שבו מבקשים עדכוני מחירים ל-4 מלונות, הזמין ל-3 לילות והחל מ-23 במאי 2023:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </PropertyList>
</Query>

בדוגמה הבאה מבקשים עדכוני מחירים לכל מלון:

5/23/18 - 6/26/18

דוגמה לשאילתה על תמחור בזמן אמת

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

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
<!-- Note that the latencySensitive attribute is not present by default but can
     be configured to be displayed, on request, by Google. This attribute is only
     displayed for a Live Pricing Query request -->
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <DeadlineMs>500</DeadlineMs>
<!-- The deadline represents the timeframe by which a response will need to be
     received by. This element is only displayed for a Live Pricing Query request -->
  <PropertyList>
    <Property>6781291</Property>
  </PropertyList>
<!-- Note that Context tags are potentially repeatable -->
  <Context>
<!-- The total number of guests occupying the room (adults+children) -->
    <Occupancy>3</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
<!-- In this example one of the 3 guests is a 5yr old child -->
      <Children>
        <Child age="5"/>
      </Children>
    </OccupancyDetails>
<!-- The user was located in the US when this search was made -->
    <UserCountry>US</UserCountry>
<!-- The user was searching from a mobile device at the time of search -->
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

בדוגמה הבאה מבקשים מחיר למלון אחד:

6/23/23 - 6/25/23

דוגמה לתשובה של הודעה לעסקה לשאילתה הזו זמינה בחומר העזר בנושא XML של תמחור ומלאי חדרים (עסקאות).

עם דוגמה לשאילתה לפי הקשר

הדוגמה הבאה מציגה דוגמה לשאילתה עם הקשר:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <PropertyContextList>
    <PropertyContext>
      <Property>8675309</Property>
      <!-- In the future, occupancy and device might be specified -->
      <Context><UserCountry>US</UserCountry></Context>
      <Context><UserCountry>GB</UserCountry></Context>
    </PropertyContext>
    <PropertyContext>
      <Property>8675310</Property>
      <Property>8675311</Property>
      <Context><UserCountry>CA</UserCountry></Context>
    </PropertyContext>
  </PropertyContextList>
</Query>

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

טווחי תאריכי צ'ק-אין

אם משתמשים ב-Change Pricing, המבנה של הודעת השאילתה תלוי בסוג הרמז שבו משתמשים לטווחי תאריכים של צ'ק-אין, למסלולי נסיעה מדויקים או למסלולי נסיעה בטווחי תאריכים. למידע נוסף על כל אחד מסוגי הרמזים האלו, ראו הודעות עם רמזורים.

בדוגמה הבאה מוצגת הודעת תמחור <Query> לטווחי תאריכי צ'ק-אין:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <FirstDate>2023-05-23</FirstDate>
  <LastDate>2023-05-26</LastDate>
  <Nights>3</Nights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </PropertyList>
</Query>

בדוגמה הזו מבקשים עדכוני מחירים לשהיות הבאות (לכל מלון):

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/24/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23

מקומות שהייה בטווח

בדוגמה הבאה מוצגת הודעת תמחור <Query> לשהייה בטווח מסוים:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <FirstDate>2023-05-23</FirstDate>
  <LastDate>2023-05-26</LastDate>
  <AffectedNights>3</AffectedNights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </PropertyList>
</Query>

בדוגמה הבאה מבקשים עדכוני מחירים לכל מלון:

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/25/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23

בנוסף, השהיות שהתחילו לפני (אבל כוללים) את הלילה הנתון:

5/20/23 - 5/23/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23
5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23

הודעה לגבי שאילתת מטא-נתונים

בדוגמה הבאה מוצגת הודעת <Query> עם בקשה לעדכונים במטא-נתונים של החדר והחבילה במספר נכסים:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <HotelInfoProperties>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </HotelInfoProperties>
</Query>

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