הודעות Hint Response

כש-Google שולחת הודעת Hint Request, השרתים שלכם צריכים להשיב עם הודעת Hint Response שמציינת את המלונות שהמחירים שלהם השתנו מאז הפעם האחרונה ש-Google קיבלה הודעת Hint Response מוצלחת מאותם שרתים. אם יש שינויים במחירים, Google שולחת <Query> כדי לאחזר את נתוני התמחור המעודכנים של המלונות ומסלולי הנסיעה שצוינו.

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

הערה: כדי לתמחר מחדש את המלונות שנבחרו ואת תוכניות הנסיעה שלהם, הודעות התשובה משתמשות בשיטות הבאות:

רכיב הבסיס של הודעת Hint Response הוא <Hint>. כדי לבקש עדכון של מלון או מסלול נסיעה, משתמשים באלמנט <Item> אחד או יותר. הודעת Hint Response אחת יכולה להגדיר כל מספר של רכיבי <Item>.

בכל הודעת Hint Response צריך לציין לפחות רכיב <Property> אחד לכל <Item>. התג <Property> מזהה מלון באמצעות אותם מזהים שמופיעים ברשימת המלונות. כברירת מחדל, מציינים מזהה מלון יחיד לכל בלוק <Item> עם זאת, אם אתם משתמשים בטווח תאריכי הצ'ק אין או בשהיות עם טווח תאריכים לצורך תמחור מחדש, אתם יכולים להנחות את Google לאפשר כמה בתי מלון בבלוק של פריט.

תהליך הבקשה והתגובה המדויק של מסלול הנסיעה

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

תגובת השותף

ההודעה הבאה של הודעת Hint Response מגדירה מאפיין יחיד ומסלול נסיעה יחיד:

<Hint>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2023-05-20</CheckInDate>
      <LengthOfStay>3</LengthOfStay>
    </Stay>
  </Item>
</Hint>

התגובה של Google

‫Google משיבה להודעת Hint Response שלכם עם <Query> שדומה לזו:

<Query>
  <Checkin>2023-05-20</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

יצירה של <Transaction>

לאחר מכן, עליך ליצור <Transaction> עם עדכוני מחירים למלון לשהייה הבאה:

5/20/23 - 5/23/23

תהליך הבקשה והתגובה של טווחי תאריכי צ'ק-אין

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

תאריכים בטווח שהוגדר על ידי השותף

בדוגמה הבאה להודעת Hint Response מוגדר נכס יחיד עם טווח תאריכים לצ'ק-אין:

<Hint>
  <Item>
    <Property>12345</Property>
    <FirstDate>2023-05-20</FirstDate>
    <LastDate>2023-05-23</LastDate>
  </Item>
</Hint>

התגובה של Google

‫Google משיבה להודעת Hint Response עם <Query> שדומה למה שמופיע בהמשך:

<Query>
  <FirstDate>2023-05-20</FirstDate>
  <LastDate>2023-05-23</LastDate>
  <Nights>5</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

יצירה של <Transaction>

לאחר מכן, עליכם ליצור <Transaction> עם עדכוני מחירים לשהיות הבאות במלון:

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

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

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

בדוגמה הזו נשתמש במשך השהייה של 5 לילות. משך השהייה שמוגדר כברירת מחדל הוא 30 ימים.

תהליך הבקשה והתגובה לגבי הזמנות עם תאריכים גמישים

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

שהיות בטווח של השותף

הדוגמה הבאה להודעת Hint Response משתמשת בשהיות בטווח:

<Hint>
  <Item>
    <Property>12345</Property>
    <StaysIncludingRange>
      <FirstDate>2023-05-20</FirstDate>
      <LastDate>2023-05-23</LastDate>
    </StaysIncludingRange>
  </Item>
</Hint>

התגובה של Google

‫Google משיבה להודעת Hint Response שלכם עם <Query> שדומה לזו:

<Query>
  <FirstDate>2023-05-20</FirstDate>
  <LastDate>2023-05-23</LastDate>
  <AffectedNights>3</AffectedNights>
  <PropertyList>
    <Property>12345</Property>
    <Property>67891</Property>
  </PropertyList>
</Query>

יצירה של <Transaction>

לאחר מכן, עליכם ליצור <Transaction> עם עדכוני מחירים למלון לגבי השהיות הבאות:

5/17/23 - 5/20/23

5/18/23 - 5/20/23
5/18/23 - 5/21/23

5/19/23 - 5/20/23
5/19/23 - 5/21/23
5/19/23 - 5/22/23

5/20/23 - 5/21/23
5/20/23 - 5/22/23
5/20/23 - 5/23/23

5/21/23 - 5/22/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

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23

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

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

$$ \text{Total Items} = \left( \text{Date Span} \times \text{LOS} + \frac{\text{LOS} \times (\text{LOS} + 1)}{2} \right) \times N_{\text{hotel_batch_size}} $$

כאשר:

  • ‫Date Span: מספר הימים כולל בין <FirstDate> ל-<LastDate> (טווח התאריכים = LastDate – FirstDate + 1).
  • ‫LOS: משך השהייה המקסימלי שצוין ברמז (לדוגמה, <AffectedNights>14</AffectedNights>).
  • ‫\(N_{\text{hotel_batch_size}}\): מספר המאפיינים שנכללים באצווה של השאילתות (מוגדר באמצעות hotel_batch_size).

מה קורה כשטיפ חורג מ-10,000 פריטים?

אם מספר הפריטים המחושבים גדול מ-10,000, Google מפצלת אוטומטית את עומס העבודה של השאילתה:

  1. ניסיון ראשוני (שהייה בטווח): חלון תאריכים קטן יותר שכולל את תחילת הטווח נשלח באמצעות <AffectedNights>.
  2. חזרה לשיטה הקודמת (אם נתמכת – טווח תאריכים של צ'ק-אין): ננסה לשלוח שאילתות קטנות יותר של טווח תאריכים של צ'ק-אין באמצעות <Nights> (השאילתה מופיעה בהמשך).
  3. חזרה סופית (מסלולי נסיעה מדויקים): נחזור להרחבת קבוצת השאילתות למסלולי נסיעה מדויקים ספציפיים.
<!-- Example: Remainder batch dispatched after a split -->
<Query>
  <FirstDate>2026-10-01</FirstDate>
  <LastDate>2026-10-31</LastDate>
  <Nights>14</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>
  • שמירה על איזון בין גדלי קבוצות של נכסים: אם אתם מעדכנים חלונות תאריכים גדולים (למשל 180 עד 365 ימים) עם משך שהייה של 14 לילות ומעלה, כדאי לבקש ממנהל החשבון הטכני שלכם ב-Google להגדיר את hotel_batch_size לערך נמוך יותר כדי למנוע פיצולים של רמזים.
  • הגדרת טווחים בצורה מדויקת: כשמודיעים ל-Google על שינויים במחירים, צריך להגביל את טווחי התאריכים <FirstDate> ו-<LastDate> למרווחי התאריכים הספציפיים שבהם המחירים השתנו בפועל, במקום לשלוח שנה קלנדרית מלאה.
  • אם הרמזים שלכם מכסים טווחי תאריכים גדולים: צריך לוודא שהכלי לניתוח מקבל את או את בתוך בלוקים של שמכילים את <FirstDate> ואת <LastDate>, כדי שאפשר יהיה להשתמש בכמה סוגים של שאילתות עם טווחים כדי למלא את בקשות השליפה.