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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

בדוגמה הבאה מוצגת הודעת תמחור <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>

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