Method: accounts.participationReportViews.query

מאפשר לשלוח שאילתות (לקבל, לסנן ולפלח) דוח השתתפות בחשבון מסוים.

בקשת HTTP

GET https://travelpartner.googleapis.com/v3/{name=accounts/*}/participationReportViews:query

כתובת ה-URL כוללת תחביר gRPC קידוד מחדש.

פרמטרים של נתיב

פרמטרים
name

string

שם המשאב של החשבון שלגביו נשלחת שאילתה. הפורמט הוא accounts/{account_id}.

פרמטרי שאילתה

פרמטרים
filter

string

התנאים (שדות וביטויים) המשמשים לסינון מדדי ההשתתפות של החשבון בשאילתות השאילתות. התחביר דורש רווחים מסביב לאופרטור in. אחרת, לא תהיה אפשרות למחוק רווחים. אפשר לצרף את התנאים באמצעות האופרטור and.

השדה date הוא שדה חובה. כל שאר השדות הם אופציונליים.

דוגמאות לתנאים חוקיים:

  • advanceBookingWindow = 2
  • advanceBookingWindow >= 0
  • advanceBookingWindow <= 5
  • advanceBookingWindow between 1 and 5
  • checkinDate = '2020-10-01'
  • checkinDate >= '2020-10-01'
  • checkinDate <= '2020-10-01'
  • checkinDate between '2020-10-01' and '2020-10-05'
  • date = '2020-02-04'
  • date between '2020-02-04' and '2020-02-09'
  • deviceType = 'TABLET'
  • deviceType in ('MOBILE', 'TABLET')
  • hotelRegionCode = 'US'
  • hotelRegionCode in ('US', 'CA')
  • lengthOfStayDays = 2
  • lengthOfStayDays >= 0
  • lengthOfStayDays <= 5
  • lengthOfStayDays between 1 and 5
  • occupancy = 2
  • occupancy >= 0
  • occupancy <= 5
  • occupancy between 1 and 5
  • partnerHotelId = 'AAA'
  • partnerHotelId in ('AAA', 'BBB')
  • userRegionCode = 'US'
  • userRegionCode in ('US', 'CA')
aggregateBy

string

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

ערך המחרוזת הוא רשימה של שדות המופרדים בפסיקים. השדות החוקיים הם: date, userRegionCode, deviceType, partnerHotelId, hotelRegionCode, advanceBookingWindow, lengthOfStayDays, checkinDate ו-occupancy. שדות שלא צוינו לא ייכללו בתוצאה המשתתפת.

שימוש במפרט aggregateBy שיוצר מספר גדול של שורות יגרום לשגיאה. זה נכון במיוחד בצבירה של partnerHotelId או יותר משני שדות. כדי לצמצם את האפשרות של שגיאה, יש לסנן לפי partnerHotelId ו-date כך שיכלול רק מספר נבחר של מלונות ותאריכים. חשבונות עם מספר גדול של מלונות יצטרכו לצמצם עוד יותר נתונים בעזרת סינון נוסף.
pageSize

integer

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

string

אסימון דף, שהתקבל מבקשת השתתפות קודמת של ReportViews.query. יש לספק אותו כדי לקבל את הדף הבא.

בעת העימוד, כל הפרמטרים האחרים המסופקים ל-השתתפותReportViews.query חייבים להתאים לשיחה שסיפקה את אסימון הדף.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התגובה

אם התגובה מוצלחת, גוף התגובה מכיל נתונים במבנה הבא:

הודעת תגובה להודעה של ParticipationReportService.QueryParticipationReport.

ייצוג JSON 
{
  "results": [
    {
      object (ParticipationResult)
    }
  ],
  "nextPageToken": string
}
שדות
results[]

object (ParticipationResult)

רשימת התוצאות שתואמות לשאילתה.
nextPageToken

string

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

היקפי הרשאה

יש צורך בהיקף OAuth הבא:

  • https://www.googleapis.com/auth/travelpartner

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

תוצאת ההשתתפות

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

ייצוג JSON 
{
  "key": {
    object (Key)
  },
  "opportunityCount": string,
  "participationCount": string,
  "participationPercent": number,
  "missedParticipationCount": string,
  "missedParticipationCountDetails": {
    object (MissedParticipationCountDetails)
  },
  "partnerHotelDisplayName": string
}
שדות
key

object (Key)

מפתח התוצאה.
opportunityCount

string (int64 format)

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

string (int64 format)

המספר הכולל של הזדמנויות שהיית כשיר להשתתף בהן במכירה הפומבית של Google Ads.
participationPercent

number

שיעור ההשתתפות, שבו מספר ההזדמנויות שתועדו בהצלחה מחולק במספר הכולל של הזדמנויות. לדוגמה, אם נכס היה כשיר להשתתף במכירה הפומבית של Google Ads 90 פעמים מתוך 100 הזדמנויות, שיעור ההשתתפות הוא 90%.
missedParticipationCount

string (int64 format)

המספר הכולל של הזדמנויות שלא כשירות להשתתף במכרז של Google Ads. הרכיבים הבאים מורכבים:

  • חסר דף נחיתה
  • חסר מחיר
  • בעיה במחיר
  • המחיר לא זמין
  • אחר
missedParticipationCountDetails

object (MissedParticipationCountDetails)

הסיבות שתרמו למספר המשתתפים שלא נכללו (לדוגמה, אין זמינות) ולמספר הכולל של כל סיבה.
partnerHotelDisplayName

string

שם התצוגה של השותף. השדה הזה מאוכלס רק כשהתוצאה מצטברת באמצעות partnerHotelId.

מפתח

מפתח של תוצאה.

ייצוג JSON 
{
  "date": {
    object (Date)
  },
  "userRegionCode": string,
  "deviceType": enum (Device),
  "partnerHotelId": string,
  "hotelRegionCode": string,
  "advanceBookingWindow": integer,
  "lengthOfStayDays": integer,
  "checkinDate": {
    object (Date)
  },
  "occupancy": integer
}
שדות
date

object (Date)

התאריך שעבורו אתם מבקשים מדדים.

אם date אינו ערך של הפרמטר aggregateBy בקריאה לבקשה, השדה date לא מוחזר ב-Key.
userRegionCode

string

קוד האזור ISO 3116 של המדינה/האזור של המשתמש.

אם userRegionCode אינו ערך של הפרמטר aggregateBy בקריאה לבקשה, השדה userRegionCode לא מוחזר ב-Key.
deviceType

enum (Device)

סוג המכשיר של המשתמש.

אם deviceType אינו ערך של הפרמטר aggregateBy בקריאה לבקשה, השדה deviceType לא מוחזר ב-Key.
partnerHotelId

string

מזהה המלון של השותף.

אם partnerHotelId אינו ערך של הפרמטר aggregateBy בקריאה לבקשה, השדה partnerHotelId לא מוחזר ב-Key.
hotelRegionCode

string

קוד האזור במאגר CLDR של המדינה/האזור של המלון.

אם hotelRegionCode אינו ערך של הפרמטר aggregateBy בקריאה לבקשה, השדה hotelRegionCode לא מוחזר ב-Key.
advanceBookingWindow

integer

כמה ימים מראש המשתמש רוצה להזמין את מסלול הנסיעה.

אם advanceBookingWindow אינו ערך של הפרמטר aggregateBy בקריאה לבקשה, השדה advanceBookingWindow לא מוחזר ב-Key.
lengthOfStayDays

integer

מספר הלילות במסלול הנסיעה.

אם lengthOfStayDays אינו ערך של הפרמטר aggregateBy בקריאה לבקשה, השדה lengthOfStayDays לא מוחזר ב-Key.
checkinDate

object (Date)

תאריך הצ'ק אין.

אם checkinDate אינו ערך של הפרמטר aggregateBy בקריאה לבקשה, השדה checkinDate לא מוחזר ב-Key.
occupancy

integer

התפוסה הכוללת של מסלול הנסיעה.

אם occupancy אינו ערך של הפרמטר aggregateBy בקריאה לבקשה, השדה occupancy לא מוחזר ב-Key.

פרטי השתתפות שהוחמצו

מספר המשתתפים שלא נענו מפורט לפי סיבה.

ייצוג JSON 
{
  "noAvailabilityCount": string,
  "hotelSuspendedCount": string,
  "noTaxBreakdownCount": string,
  "noLandingPageCount": string,
  "noPriceCount": string,
  "noPriceCountDetails": {
    object (NoPriceCountDetails)
  },
  "otherReasonCount": string,
  "priceMissingCount": string,
  "priceMissingCountDetails": {
    object (PriceMissingCountDetails)
  },
  "priceProblemCount": string,
  "priceProblemCountDetails": {
    object (PriceProblemCountDetails)
  },
  "priceUnavailableCount": string,
  "priceUnavailableCountDetails": {
    object (PriceUnavailableCountDetails)
  }
}
שדות
noAvailabilityCount
(deprecated)

string (int64 format)

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

string (int64 format)

המספר הכולל של משתתפים שלא נענו עקב השעיה של אחד או יותר מהמלונות בגלל הפרות הקשורות לדיוק המחירים.
noTaxBreakdownCount
(deprecated)

string (int64 format)

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

string (int64 format)

לא נמצאו דפי נחיתה שתואמים למשתמש.
noPriceCount
(deprecated)

string (int64 format)

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

object (NoPriceCountDetails)

הסיבות שתרמו לספירה של המחיר (למשל, תמחור בזמן אמת לא זמין) והמספר הכולל של כל סיבה.
otherReasonCount

string (int64 format)

בית המלון לא השתתף מסיבה לא ידועה.
priceMissingCount

string (int64 format)

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

  • רוחב הפס אזל
  • חסר שיעור מטמון
  • מסלול הנסיעה נחסם
  • לא הוגדר תמחור בזמן אמת
  • שידור חי של תמחור בזמן אמת
  • שגיאה בתמחור בזמן אמת
priceMissingCountDetails

object (PriceMissingCountDetails)

הסיבות שתרמו למחיר החסר.
priceProblemCount

string (int64 format)

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

  • המלון מושעה
  • המחיר גבוה באופן חריג
  • המחיר נמוך באופן חריג
  • חסרים מיסים ופידים
priceProblemCountDetails

object (PriceProblemCountDetails)

הסיבות שתרמו למספר הבעיה במחיר.
priceUnavailableCount

string (int64 format)

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

  • המחיר לא זמין
  • ההשתתפות לא סבירה
  • אחר
priceUnavailableCountDetails

object (PriceUnavailableCountDetails)

הסיבות שתרמו למחיר לא זמינות.

NoPriceCountDetails

הסיבות שתרמו לחוסר המחיר ולמספר הכולל של כל סיבה.

ייצוג JSON 
{
  "livePricingTechnicalIssueCount": string,
  "livePricingNotTriggeredCount": string,
  "livePricingConfigIssueCount": string,
  "livePricingNotAvailableCount": string,
  "livePricingOtherReasonCount": string
}
שדות
livePricingTechnicalIssueCount

string (int64 format)

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

  • לא הגבת מספיק מהר וחרגת מהמועד האחרון לתגובה (בסביבות 4,000 אלפיות השנייה).
  • החזרת שגיאה.
  • פורמט התגובה שלך היה שגוי.
livePricingNotTriggeredCount

string (int64 format)

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

  • לא הגדרת הצעת מחיר.
  • לא היה לך דף נחיתה חוקי.
  • לא היו מספיק מחירים במטמון.
livePricingConfigIssueCount

string (int64 format)

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

  • לא הגדרת תמחור בזמן אמת לחיפושים האלה.
  • הגבלת את הגישה של Google למסלול הנסיעה הרלוונטי של המלון.
livePricingNotAvailableCount

string (int64 format)

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

string (int64 format)

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

חסר מחיר לפרטים

הסיבות שתרמו למספר החסר והמספר הכולל של הסיבות.

ייצוג JSON 
{
  "cacheRateMissingCount": string,
  "itineraryBlockedCount": string,
  "livePricingNotSetupCount": string,
  "bandwidthDepletedCount": string,
  "livePricingTimeoutCount": string,
  "livePricingErrorCount": string
}
שדות
cacheRateMissingCount

string (int64 format)

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

string (int64 format)

תוכנית הנסיעה הייתה מחוץ לפרמטרים הבסיסיים, כך שלא נשלף מחיר עבור מסלול הנסיעה משאילתה פעילה או ממילוי שמור במטמון.
livePricingNotSetupCount

string (int64 format)

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

string (int64 format)

אין מחיר שנשמר במטמון עבור מסלול הנסיעה הזה, ולא נותרה מכסה לשאילתה פעילה.
livePricingTimeoutCount

string (int64 format)

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

string (int64 format)

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

מחיר CountCountDetails

הסיבות שתרמו לספירה של הבעיות במחיר ולמספר הכולל של כל סיבה.

ייצוג JSON 
{
  "hotelSuspendedCount": string,
  "priceUnusuallyHighCount": string,
  "priceUnusuallyLowCount": string,
  "taxesAndFeesMissingCount": string
}
שדות
hotelSuspendedCount

string (int64 format)

המלון הושעה. הסיבה לכך עשויה להיות בעיות מתמשכות בתחומים כמו מיסים ועמלות לא נכונים.
priceUnusuallyHighCount

string (int64 format)

המחיר שניתן למסלול הנסיעה הזה נראה גבוה באופן חריג בהשוואה למגמות אזוריות.
priceUnusuallyLowCount

string (int64 format)

המחיר שניתן למסלול הנסיעה הזה נראה נמוך באופן חריג בהשוואה למגמות אזוריות.
taxesAndFeesMissingCount

string (int64 format)

לא צוין מיסים ועמלות.

מחיר לא זמיןCountDetails

הסיבות שתרמו למחיר לא זמינות והמספר הכולל של כל סיבה.

ייצוג JSON 
{
  "priceUnavailableCount": string,
  "participationNotLikelyCount": string
}
שדות
priceUnavailableCount

string (int64 format)

המלון לא השתתף כי הוא לא היה זמין לתאריכי הנסיעה.
participationNotLikelyCount

string (int64 format)

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