Method: accounts.participationReportViews.query

Ermöglicht die Abfrage (Abrufen, Filtern und Segmentieren) eines Teilnahmeberichts für ein bestimmtes Konto.

HTTP-Request

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Der Ressourcenname des abgefragten Kontos. Das Format dafür ist accounts/{account_id}.

Abfrageparameter

Parameter
filter

string

Die Bedingungen (Felder und Ausdrücke), mit denen die Teilnahmemesswerte für das abgefragte Konto gefiltert werden. Die Syntax erfordert Leerzeichen um den Operator in. Andernfalls können Leerzeichen weggelassen werden. Bedingungen können mit dem Operator and zusammengeführt werden.

date ist ein Pflichtfeld. Alle anderen sind optional.

Beispiele für gültige Bedingungen:

  • 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

Gibt an, wie die von der Abfrage zurückgegebenen Messwerte segmentiert werden. Wenn userRegionCode beispielsweise als Wert für aggregateBy angegeben ist, liefert participationResult Messwerte, die nach Nutzerregion zusammengefasst sind.

Der Stringwert ist eine durch Kommas getrennte Liste von Feldern. Gültige Felder sind: date, userRegionCode, deviceType, partnerHotelId, hotelRegionCode, advanceBookingWindow, lengthOfStayDays, checkinDate und occupancy. Nicht angegebene Felder sind nicht im ParticipationResult enthalten.

Die Verwendung einer aggregateBy-Spezifikation, die eine große Anzahl von Zeilen erzeugt, führt zu einem Fehler. Dies gilt insbesondere, wenn es sich um partnerHotelId oder mehr als zwei Felder handelt. Um die Möglichkeit eines Fehlers zu reduzieren, filtern Sie nach partnerHotelId und date, um nur eine bestimmte Anzahl von Hotels und Datumsangaben einzubeziehen. Bei Konten mit einer großen Anzahl von Hotels müssen die Daten weiter gefiltert werden.
pageSize

integer

Die maximale Anzahl der Ergebnisse, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 10.000 Ergebnisse zurückgegeben. Der Höchstwert ist 10.000. Werte über 10.000 werden zu 10.000 gezwungen.
pageToken

string

Ein Seiten-Token, das von einer früheren Teilnahmeberichtsanforderung empfangen wurde. Geben Sie diese an, um die nachfolgende Seite zu erhalten.

Bei der Paginierung müssen alle anderen für „biladeReportViews.query“ angegebenen Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

Antwortnachricht für ParticipationReportService.QueryParticipationReport.

JSON-Darstellung 
{
  "results": [
    {
      object (ParticipationResult)
    }
  ],
  "nextPageToken": string
}
Felder
results[]

object (ParticipationResult)

Die Liste der Ergebnisse, die der Abfrage entsprechen.
nextPageToken

string

Das Paginierungstoken, das zum Abrufen der nächsten Ergebnisseite verwendet wird.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0.

Ergebnis der Teilnahme

Stellt ein Ergebnis aus der Abfrage von Teilnahmestatistiken für ein Konto dar.

JSON-Darstellung 
{
  "key": {
    object (Key)
  },
  "opportunityCount": string,
  "participationCount": string,
  "participationPercent": number,
  "missedParticipationCount": string,
  "missedParticipationCountDetails": {
    object (MissedParticipationCountDetails)
  },
  "partnerHotelDisplayName": string
}
Felder
key

object (Key)

Schlüssel des Ergebnisses.
opportunityCount

string (int64 format)

Die Gesamtzahl der verfügbaren Empfehlungen für ein bestimmtes Hotel. Als Empfehlungen wird die Gesamtzahl der Fälle bezeichnet, in denen eine Hotelanzeige für einen Nutzer hätte ausgeliefert werden können.
participationCount

string (int64 format)

Die Gesamtzahl der Empfehlungen, für die Sie am Google Ads-Auktionsprozess teilnehmen konnten.
participationPercent

number

Der Prozentsatz der Teilnahme, bei dem die Anzahl der erfolgreich verwendeten Empfehlungen durch die Gesamtzahl der Empfehlungen geteilt wird. Wenn eine Property beispielsweise 90 Mal von 100 Mal für eine Teilnahme an der Google Ads-Auktion berücksichtigt wurde, beträgt die Teilnahmerate 90%.
missedParticipationCount

string (int64 format)

Die Gesamtzahl der Empfehlungen, die nicht für den Google Ads-Auktionsprozess infrage kommen. Umfasst folgende Elemente:

  • Landingpage fehlt
  • Preis fehlt
  • Problem mit dem Preis
  • Preis nicht verfügbar
  • Andere
missedParticipationCountDetails

object (MissedParticipationCountDetails)

Die Gründe, aus denen die Teilnahme verpasst wurde (z. B. keine Verfügbarkeit) und die Gesamtzahl für jeden Grund.
partnerHotelDisplayName

string

Angezeigter Name des Partners Dieses Feld wird nur ausgefüllt, wenn das Ergebnis nach partnerHotelId aggregiert wird.

Schlüssel

Schlüssel eines Ergebnisses.

JSON-Darstellung 
{
  "date": {
    object (Date)
  },
  "userRegionCode": string,
  "deviceType": enum (Device),
  "partnerHotelId": string,
  "hotelRegionCode": string,
  "advanceBookingWindow": integer,
  "lengthOfStayDays": integer,
  "checkinDate": {
    object (Date)
  },
  "occupancy": integer
}
Felder
date

object (Date)

Das Datum, für das Sie Messwerte anfordern.

Wenn date kein Wert des Parameters aggregateBy im Anfrageaufruf ist, wird das Feld date nicht in Key zurückgegeben.
userRegionCode

string

Der ISO 3116-Regionscode des Landes bzw. der Region des Nutzers.

Wenn userRegionCode kein Wert des Parameters aggregateBy im Anfrageaufruf ist, wird das Feld userRegionCode nicht in Key zurückgegeben.
deviceType

enum (Device)

Der Gerätetyp des Nutzers.

Wenn deviceType kein Wert des Parameters aggregateBy im Anfrageaufruf ist, wird das Feld deviceType nicht in Key zurückgegeben.
partnerHotelId

string

Hotel-ID des Partners

Wenn partnerHotelId kein Wert des Parameters aggregateBy im Anfrageaufruf ist, wird das Feld partnerHotelId nicht in Key zurückgegeben.
hotelRegionCode

string

CLDR-Regionscode des Landes bzw. der Region des Hotels.

Wenn hotelRegionCode kein Wert des Parameters aggregateBy im Anfrageaufruf ist, wird das Feld hotelRegionCode nicht in Key zurückgegeben.
advanceBookingWindow

integer

Die Anzahl der Tage, die der Nutzer im Voraus buchen möchte.

Wenn advanceBookingWindow kein Wert des Parameters aggregateBy im Anfrageaufruf ist, wird das Feld advanceBookingWindow nicht in Key zurückgegeben.
lengthOfStayDays

integer

Die Anzahl der Übernachtungen des Reiseplans.

Wenn lengthOfStayDays kein Wert des Parameters aggregateBy im Anfrageaufruf ist, wird das Feld lengthOfStayDays nicht in Key zurückgegeben.
checkinDate

object (Date)

Das Check-in-Datum des Reiseplans.

Wenn checkinDate kein Wert des Parameters aggregateBy im Anfrageaufruf ist, wird das Feld checkinDate nicht in Key zurückgegeben.
occupancy

integer

Die gesamte Belegung des Reiseplans.

Wenn occupancy kein Wert des Parameters aggregateBy im Anfrageaufruf ist, wird das Feld occupancy nicht in Key zurückgegeben.

Details zur verpassten Teilnahme

Die Anzahl der verpassten Teilnahmen wird nach Grund aufgeschlüsselt.

JSON-Darstellung 
{
  "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)
  }
}
Felder
noAvailabilityCount
(deprecated)

string (int64 format)

Die Gesamtzahl der verpassten Teilnahmen, weil die Kombination aus Hotel und Reiseplan nicht verfügbar war oder der Nutzer nicht für die Preise infrage kam. Damit Sie an diesen Auktionen teilnehmen können, müssen Sie möglicherweise zusätzliche Preisinformationen angeben.
hotelSuspendedCount
(deprecated)

string (int64 format)

Die Gesamtzahl der verpassten Teilnahmen aufgrund der Sperrung von mindestens einem Ihrer Hotels aufgrund von Verstößen gegen die Preisgenauigkeit.
noTaxBreakdownCount
(deprecated)

string (int64 format)

Die Gesamtzahl der verpassten Teilnahmen aufgrund der fehlenden separaten Angabe von Steuern und Gebühren für eines oder mehrere Ihrer Hotels.
noLandingPageCount

string (int64 format)

Keine Landingpage stimmte mit dem Nutzer überein.
noPriceCount
(deprecated)

string (int64 format)

Die Gesamtzahl der verpassten Teilnahmen aufgrund eines Preises, der nicht für den angefragten Reiseplan angeboten wird.
noPriceCountDetails
(deprecated)

object (NoPriceCountDetails)

Die Gründe, die dazu beigetragen haben, dass kein Preis gezählt wurde (z. B. Livepreise nicht verfügbar) und die Gesamtzahl für jeden Grund.
otherReasonCount

string (int64 format)

Das Hotel hat aus einem unbekannten Grund nicht teilgenommen.
priceMissingCount

string (int64 format)

Die Gesamtzahl der verpassten Teilnahmen, wenn ein Preis nicht im Google-Cache vorhanden ist oder nicht auf Livepreise reagiert hat. Umfasst folgende Elemente:

  • Bandbreite aufgebraucht
  • Cache-Rate fehlt
  • Reiseplan blockiert
  • Livepreise nicht eingerichtet
  • Zeitüberschreitung bei Livepreisen
  • Fehler bei Livepreisen
priceMissingCountDetails

object (PriceMissingCountDetails)

Die Gründe, die dazu beigetragen haben, dass der Preis fehlt.
priceProblemCount

string (int64 format)

Die Gesamtzahl der verpassten Teilnahmen aufgrund eines Problems mit der Genauigkeit des für den Reiseplan angegebenen Preises. Umfasst folgende Elemente:

  • Hotel gesperrt
  • Preis ungewöhnlich hoch
  • Preis ungewöhnlich niedrig
  • Steuern und Feeds fehlen
priceProblemCountDetails

object (PriceProblemCountDetails)

Die Gründe für das Problem mit dem Preisproblem.
priceUnavailableCount

string (int64 format)

Die Gesamtzahl der verpassten Teilnahmen aufgrund des Preises, der für den angefragten Reiseplan als nicht verfügbar (-1) aufgeführt ist. Umfasst folgende Elemente:

  • Preis nicht verfügbar
  • Teilnahme nicht wahrscheinlich
  • Andere
priceUnavailableCountDetails

object (PriceUnavailableCountDetails)

Die Gründe, die dazu beigetragen haben, dass der Preis nicht verfügbar war.

Details

Die Gründe, aus denen kein Preis gezählt wurde, und die Gesamtsumme für jeden Grund.

JSON-Darstellung 
{
  "livePricingTechnicalIssueCount": string,
  "livePricingNotTriggeredCount": string,
  "livePricingConfigIssueCount": string,
  "livePricingNotAvailableCount": string,
  "livePricingOtherReasonCount": string
}
Felder
livePricingTechnicalIssueCount

string (int64 format)

Die Gesamtzahl der verpassten Teilnahmen aufgrund von technischen Problemen mit Livepreisen aus einem der folgenden Gründe:

  • Sie haben nicht schnell genug geantwortet und die Antwortfrist (ca. 4.000 Millisekunden) überschritten.
  • Sie haben einen Fehler zurückgegeben.
  • Deine Antwort war fehlerhaft.
livePricingNotTriggeredCount

string (int64 format)

Die Gesamtzahl der verpassten Teilnahmen aufgrund von Livepreisen, die aus einem der folgenden Gründe nicht ausgelöst wurden:

  • Sie haben kein Gebot festgelegt.
  • Sie hatten keine gültige Landingpage.
  • Der Cache enthielt nicht genügend Preise.
livePricingConfigIssueCount

string (int64 format)

Die Gesamtzahl der verpassten Teilnahmen aufgrund von Livepreisen, die aus einem der folgenden Gründe nicht ausgelöst wurden:

  • Sie haben für diese Suchanfragen keine Livepreise konfiguriert.
  • Sie haben Google den Zugriff auf den betreffenden Hotelreiseplan verweigert.
livePricingNotAvailableCount

string (int64 format)

Die Gesamtzahl der verpassten Teilnahmen aufgrund nicht verfügbarer Livepreise. Für bestimmte Standardreisepläne oder Benutzeroberflächen werden Livepreise nicht ausgelöst. In diesem Fall benötigen Partner für die Teilnahme einen im Cache gespeicherten Preis.
livePricingOtherReasonCount

string (int64 format)

Die Anzahl der verpassten Teilnahmen aufgrund anderer Probleme mit Livepreisen.

PriceMissingCountDetails

Die Gründe, aus denen der Preis fehlt, und die Gesamtzahl für jeden Grund.

JSON-Darstellung 
{
  "cacheRateMissingCount": string,
  "itineraryBlockedCount": string,
  "livePricingNotSetupCount": string,
  "bandwidthDepletedCount": string,
  "livePricingTimeoutCount": string,
  "livePricingErrorCount": string
}
Felder
cacheRateMissingCount

string (int64 format)

Für diesen Reiseplan ist kein Preis im Cache vorhanden. Eine Liveabfrage wurde aufgrund von Seiteneinschränkungen nicht ausgeführt.
itineraryBlockedCount

string (int64 format)

Der Reiseplan lag außerhalb Ihrer grundlegenden Parameter. Daher wurde kein Preis aus der Liveabfrage oder der Cache-Füllung für den Reiseplan abgerufen.
livePricingNotSetupCount

string (int64 format)

Für diesen Reiseplan wurde kein Preis im Cache gespeichert und für dieses Konto wurde keine Liveabfrage konfiguriert.
bandwidthDepletedCount

string (int64 format)

Für diesen Reiseplan wurde kein Preis im Cache gespeichert und es gab kein verbleibendes Kontingent für Liveabfragen.
livePricingTimeoutCount

string (int64 format)

Für diesen Reiseplan wurde kein Preis im Cache gespeichert und bei einer an Ihr System gesendeten Liveabfrage ist eine Zeitüberschreitung aufgetreten.
livePricingErrorCount

string (int64 format)

Für diesen Reiseplan wurde kein Preis im Cache gespeichert. Es gab keine Zeitüberschreitung bei der Liveabfrage, aber Ihr System hat einen Fehler zurückgegeben.

PreisproblemAnzahlDetails

Die Gründe, aus denen sich die Anzahl der Preisprobleme zusammensetzt, und die Gesamtsumme der Gründe

JSON-Darstellung 
{
  "hotelSuspendedCount": string,
  "priceUnusuallyHighCount": string,
  "priceUnusuallyLowCount": string,
  "taxesAndFeesMissingCount": string
}
Felder
hotelSuspendedCount

string (int64 format)

Das Hotel wurde gesperrt. Dies kann auf dauerhafte Probleme in Bereichen wie falschen Steuern und Gebühren zurückzuführen sein.
priceUnusuallyHighCount

string (int64 format)

Der Preis für diesen Reiseplan schien im Vergleich zu regionalen Trends ungewöhnlich hoch zu sein.
priceUnusuallyLowCount

string (int64 format)

Der Preis für diesen Reiseplan schien im Vergleich zu regionalen Trends ungewöhnlich niedrig zu sein.
taxesAndFeesMissingCount

string (int64 format)

Steuern und Gebühren waren nicht in den Preisen enthalten.

PriceUnavailableCountDetails

Die Gründe, aus denen der Preis nicht verfügbar war, und die Gesamtzahl für jeden Grund.

JSON-Darstellung 
{
  "priceUnavailableCount": string,
  "participationNotLikelyCount": string
}
Felder
priceUnavailableCount

string (int64 format)

Das Hotel hat nicht teilgenommen, weil es für den Reiseplan nicht verfügbar war.
participationNotLikelyCount

string (int64 format)

Für diesen Reiseplan wurde kein Preis im Cache gespeichert und es wurde keine Liveabfrage ausgeführt, weil Ihr Server normalerweise meldet, dass das Hotel nicht verfügbar oder ausverkauft ist.