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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

עם שאילתות הקשר

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

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

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

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

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

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

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

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

שאילתה עם הקשר, כולל תפוסה

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2025-07-10</Checkin>
  <Nights>2</Nights>
  <PropertyContextList>
    <PropertyContext>
      <Property>8675309</Property>
      <Context>
        <UserCountry>US</UserCountry>
      </Context>
      <Occupancy>3</Occupancy>
      <OccupancyDetails>
        <NumAdults>2</NumAdults>
        <Children>
          <Child age="7"/>
        </Children>
      </OccupancyDetails>
    </PropertyContext>
    <PropertyContext>
      <Property>8675310</Property>
      <Context>
        <UserCountry>GB</UserCountry>
      </Context>
      <Occupancy>1</Occupancy>
      <OccupancyDetails>
        <NumAdults>1</NumAdults>
      </OccupancyDetails>
    </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>