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

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

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

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

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

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

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

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

ניתן למצוא עיצוב מפורט להודעות שאילתה בקובץ שאילתה בפורמט XML.

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

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

כשהשרת מקבל הודעת שאילתת תמחור, הוא אמור להגיב באמצעות <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>

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