Method: accounts.participationReportViews.query

Belirli bir hesaba ait katılım raporunu sorgulama (alma, filtreleme ve segmentlere ayırma) olanağı sağlar.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
name

string

Sorgulanan hesabın kaynak adı. Biçim accounts/{account_id} şeklindedir.

Sorgu parametreleri

Parametreler
filter

string

Sorgulanan hesabın katılım metriklerini filtrelemek için kullanılan koşullar (alanlar ve ifadeler). Söz diziminde in operatörünün etrafında boşluk olması gerekir. Aksi takdirde boşluklar atlanabilir. Koşullar AND operatörü kullanılarak birleştirilebilir.

Önemli: Birden fazla koşul eklemek için doğru söz dizimi: "?filter=<condition>=<value>%20AND%20<condition>=<value>..."

date alanı zorunludur. Diğer tüm alanlar isteğe bağlıdır.

Geçerli koşullara örnek olarak aşağıdakiler verilebilir:

  • advanceBookingWindow = 2
  • advanceBookingWindow >= 0
  • advanceBookingWindow <= 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
  • 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

Sorgu tarafından döndürülen metriklerin nasıl bölümlendirileceğini belirtir. Örneğin, userRegionCode değeri aggregateBy değeri olarak belirtilirse participationResult, kullanıcı bölgesine göre toplanan metrikleri sağlar.

Dize değeri, virgülle ayrılmış bir alan listesidir. Geçerli alanlar şunlardır: date, userRegionCode, deviceType, partnerHotelId, hotelRegionCode, advanceBookingWindow, lengthOfStayDays, checkinDate ve occupancy. Belirtilmeyen alanlar ParticipationResult'a dahil edilmez.

Önemli: aggregateBy parametresini partnerHotelId veya ikiden fazla değerle kullanmak hataya neden olabilir. Satır sayısını azaltmak için partnerHotelId ve date ile filtreleme yapmak hataların oluşmasını önleyebilir.
pageSize

integer

Döndürülecek maksimum katılım sonucu sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmezse en fazla 10.000 sonuç döndürülür. Maksimum değer 10.000'dir. 10.000'in üzerindeki değerler 10.000'e zorlanır.
pageToken

string

Önceki bir participationReportViews.query isteğinden alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalara ayırma işlemi yapılırken participationReportViews.query'ye sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

ParticipationReportService.QueryParticipationReport için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "results": [
    {
      object (ParticipationResult)
    }
  ],
  "nextPageToken": string
}
Alanlar
results[]

object (ParticipationResult)

Sorguyla eşleşen sonuçların listesi.
nextPageToken

string

Sonuçların sonraki sayfasını almak için kullanılan sayfalama jetonu.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.

ParticipationResult

Bir hesabın katılım istatistikleri sorgulanarak elde edilen sonucu temsil eder.

JSON gösterimi 
{
  "key": {
    object (Key)
  },
  "opportunityCount": string,
  "participationCount": string,
  "participationPercent": number,
  "missedParticipationCount": string,
  "missedParticipationCountDetails": {
    object (MissedParticipationCountDetails)
  },
  "partnerHotelDisplayName": string
}
Alanlar
key

object (Key)

Sonucun anahtarı.
opportunityCount

string (int64 format)

Belirli bir otel için mevcut fırsatların toplam sayısı. Fırsatlar, bir otel reklamının kullanıcılara toplam kaç kez gösterilebileceğini belirtir.
participationCount

string (int64 format)

Google Ads açık artırma sürecine girmeye uygun olduğunuz toplam fırsat sayısı.
participationPercent

number

Başarılı şekilde katılınan fırsatların sayısının toplam fırsat sayısına bölünmesiyle elde edilen katılım yüzdesi. Örneğin, bir tesis 100 fırsattan 90'ında Google Ads açık artırmasına katılmaya hak kazanmışsa katılım oranı %90'dır.
missedParticipationCount

string (int64 format)

Google Ads açık artırma süreci için uygun olmayan toplam fırsat sayısı. Şunlardan oluşur:

  • Açılış sayfası eksik
  • Fiyat bilgisi eksik
  • Fiyat sorunu
  • Fiyat yok
  • Diğer
missedParticipationCountDetails

object (MissedParticipationCountDetails)

Kaçırılan katılım sayısına katkıda bulunan nedenler (ör. stokta yok) ve her nedenin toplam sayısı.
partnerHotelDisplayName

string

İş ortağının otelinin görünen adı. Bu alan yalnızca sonuç partnerHotelId tarafından toplandığında doldurulur.

Anahtar

Sonucun anahtarı.

JSON gösterimi 
{
  "date": {
    object (Date)
  },
  "userRegionCode": string,
  "deviceType": enum (Device),
  "partnerHotelId": string,
  "hotelRegionCode": string,
  "advanceBookingWindow": integer,
  "lengthOfStayDays": integer,
  "checkinDate": {
    object (Date)
  },
  "occupancy": integer
}
Alanlar
date

object (Date)

Metrikleri istediğiniz tarih.

date, istek çağrısındaki aggregateBy parametresinin değeri değilse date alanı Key içinde döndürülmez.
userRegionCode

string

Kullanıcının bulunduğu ülkenin/bölgenin ISO 3116 bölge kodu.

userRegionCode, istek çağrısındaki aggregateBy parametresinin değeri değilse userRegionCode alanı Key içinde döndürülmez.
deviceType

enum (Device)

Kullanıcının cihaz türü.

deviceType, istek çağrısındaki aggregateBy parametresinin değeri değilse deviceType alanı Key içinde döndürülmez.
partnerHotelId

string

İş ortağının otel kimliği.

partnerHotelId, istek çağrısındaki aggregateBy parametresinin değeri değilse partnerHotelId alanı Key içinde döndürülmez.
hotelRegionCode

string

Otelin bulunduğu ülkenin/bölgenin CLDR bölge kodu.

hotelRegionCode, istek çağrısındaki aggregateBy parametresinin değeri değilse hotelRegionCode alanı Key içinde döndürülmez.
advanceBookingWindow

integer

Kullanıcının seyahat planı rezervasyonunu kaç gün önceden yapmak istediği.

advanceBookingWindow, istek çağrısındaki aggregateBy parametresinin değeri değilse advanceBookingWindow alanı Key içinde döndürülmez.
lengthOfStayDays

integer

Seyahat planı için gece sayısıdır.

lengthOfStayDays, istek çağrısındaki aggregateBy parametresinin değeri değilse lengthOfStayDays alanı Key içinde döndürülmez.
checkinDate

object (Date)

Seyahat planının check-in tarihi.

checkinDate, istek çağrısındaki aggregateBy parametresinin değeri değilse checkinDate alanı Key içinde döndürülmez.
occupancy

integer

Seyahat planının toplam doluluk oranı.

occupancy, istek çağrısındaki aggregateBy parametresinin değeri değilse occupancy alanı Key içinde döndürülmez.

MissedParticipationCountDetails

Katılımın kaçırılma sayısı, nedene göre ayrılmıştır.

JSON gösterimi 
{
  "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)
  }
}
Alanlar
noAvailabilityCount
(deprecated)

string (int64 format)

Otel/seyahat planı kombinasyonunda boş yer olmaması veya kullanıcının fiyatlar için uygun olmaması nedeniyle kaçırılan toplam katılım sayısı. Bu açık artırmalara katılmak için daha fazla fiyatlandırma bilgisi sağlamanız gerekebilir.
hotelSuspendedCount
(deprecated)

string (int64 format)

Fiyat doğruluğu ihlalleri nedeniyle bir veya daha fazla oteliniz askıya alındığı için kaçırılan toplam katılım sayısı.
noTaxBreakdownCount
(deprecated)

string (int64 format)

Otellerinizden bir veya daha fazlası vergileri ve ücretleri ayrı ayrı belirtmediği için kaçırılan toplam katılım sayısı.
noLandingPageCount

string (int64 format)

Kullanıcı ile eşleşen açılış sayfası yok.
noPriceCount
(deprecated)

string (int64 format)

İstenen seyahat planı için fiyat sunulmaması nedeniyle kaçırılan toplam katılım sayısı.
noPriceCountDetails
(deprecated)

object (NoPriceCountDetails)

Fiyat yok sayısına katkıda bulunan nedenler (ör. canlı fiyatlandırma kullanılamıyor) ve her nedenin toplam sayısı.
otherReasonCount

string (int64 format)

Otel, bilinmeyen bir nedenle katılmadı.
priceMissingCount

string (int64 format)

Google'ın önbelleğinde bulunmayan bir fiyatlandırmanın mevcut olması veya gerçek zamanlı fiyatlandırmaya yanıt verilememesi nedeniyle kaçırılan katılımların toplam sayısıdır. Şunlardan oluşur:

  • Bant genişliği tükenmiş
  • Önbellek hızı eksik
  • Seyahat planı engellendi
  • Gerçek zamanlı fiyatlandırma ayarlanmamış
  • Gerçek zamanlı fiyatlandırmada zaman aşımı
  • Gerçek zamanlı fiyatlandırma hatası
priceMissingCountDetails

object (PriceMissingCountDetails)

Eksik fiyat sayısına katkıda bulunan nedenler.
priceProblemCount

string (int64 format)

Seyahat planı için sağlanan fiyatın doğruluğuyla ilgili bir sorun nedeniyle kaçırılan toplam katılım sayısı. Şunlardan oluşur:

  • Otel askıya alındı
  • Fiyat normalden çok yüksek
  • Fiyat normalden çok düşük
  • Vergiler ve feed'ler eksik
priceProblemCountDetails

object (PriceProblemCountDetails)

Fiyat sorunu sayısına katkıda bulunan nedenler.
priceUnavailableCount

string (int64 format)

İstenen seyahat planı için fiyat "yok" (-1) olarak listelendiği için kaçırılan toplam katılım sayısı. Şunlardan oluşur:

  • Fiyat yok
  • Katılım olasılığı yok
  • Diğer
priceUnavailableCountDetails

object (PriceUnavailableCountDetails)

Fiyatın kullanılamadığı sayısına katkıda bulunan nedenler.

NoPriceCountDetails

Fiyat yok sayısına katkıda bulunan nedenler ve her bir nedenin toplam sayısı.

JSON gösterimi 
{
  "livePricingTechnicalIssueCount": string,
  "livePricingNotTriggeredCount": string,
  "livePricingConfigIssueCount": string,
  "livePricingNotAvailableCount": string,
  "livePricingOtherReasonCount": string
}
Alanlar
livePricingTechnicalIssueCount

string (int64 format)

Aşağıdaki nedenlerden herhangi birinden dolayı canlı fiyatlandırmayla ilgili teknik sorunlar yaşandığı için kaçırılan toplam katılım sayısı:

  • Yeteri kadar hızlı yanıt vermediniz ve yanıt verme süresini aştınız (yaklaşık 4.000 milisaniye).
  • Bir hata döndürdünüz.
  • Yanıtınızın yapısı bozuktu.
livePricingNotTriggeredCount

string (int64 format)

Aşağıdaki nedenlerden herhangi birinden dolayı canlı fiyatlandırma tetiklenmediği için kaçırılan toplam katılım sayısı:

  • Teklif belirlemediniz.
  • Geçerli bir açılış sayfanız yoktu.
  • Önbellekte yeterince fiyat yoktu.
livePricingConfigIssueCount

string (int64 format)

Aşağıdaki nedenlerden herhangi birinden dolayı canlı fiyatlandırma tetiklenmediği için kaçırılan toplam katılım sayısı:

  • Bu aramalar için yapılandırılmış canlı fiyatlandırmanız yoktu.
  • Google'ın söz konusu otel seyahat planına erişmesini kısıtladınız.
livePricingNotAvailableCount

string (int64 format)

Gerçek zamanlı fiyatlandırma mevcut olmadığı için kaçırılan toplam katılım sayısı. Gerçek zamanlı fiyatlandırma belirli varsayılan seyahat planları veya kullanıcı arayüzleri için tetiklenmez. Bu senaryoda iş ortaklarının, katılım için önbelleğe alınmış bir fiyata ihtiyacı vardır.
livePricingOtherReasonCount

string (int64 format)

Gerçek zamanlı fiyatlandırmayla ilgili diğer sorunlar nedeniyle kaçırılan katılım sayısı.

PriceMissingCountDetails

Fiyat eksik sayısına katkıda bulunan nedenler ve her bir nedenin toplam sayısı.

JSON gösterimi 
{
  "cacheRateMissingCount": string,
  "itineraryBlockedCount": string,
  "livePricingNotSetupCount": string,
  "bandwidthDepletedCount": string,
  "livePricingTimeoutCount": string,
  "livePricingErrorCount": string
}
Alanlar
cacheRateMissingCount

string (int64 format)

Bu seyahat planı için önbellekte fiyat yok. Sayfa kısıtlamaları nedeniyle canlı sorgu yapılmadı.
itineraryBlockedCount

string (int64 format)

Seyahat planı, temel parametrelerinizin dışındaydı. Bu nedenle, seyahat planı için canlı sorgu veya önbellek doldurma işleminden fiyat alınmadı.
livePricingNotSetupCount

string (int64 format)

Bu seyahat planı için önbelleğe fiyat alınmadı ve bu hesapla ilgili olarak canlı sorgu yapılandırılmadı.
bandwidthDepletedCount

string (int64 format)

Bu seyahat planı için önbelleğe fiyat alınmadı ve canlı sorgu kotası doldu.
livePricingTimeoutCount

string (int64 format)

Bu seyahat planı için önbelleğe fiyat alınmadı ve sisteminize gönderilen canlı sorgu zaman aşımına uğradı.
livePricingErrorCount

string (int64 format)

Bu seyahat planı için önbelleğe fiyat alınmadı. Canlı sorgu zaman aşımına uğramadı ancak sisteminiz hata döndürdü.

PriceProblemCountDetails

Fiyat sorunu sayısına katkıda bulunan nedenler ve her nedenin toplam sayısı.

JSON gösterimi 
{
  "hotelSuspendedCount": string,
  "priceUnusuallyHighCount": string,
  "priceUnusuallyLowCount": string,
  "taxesAndFeesMissingCount": string,
  "basePriceViolationsCount": string,
  "priceAccuracyIssueCount": string
}
Alanlar
hotelSuspendedCount

string (int64 format)

Otel askıya alındı. Bunun nedeni, vergi ve ücret hatası gibi kalıcı sorunlar olabilir.
priceUnusuallyHighCount

string (int64 format)

Bu seyahat planı için verilen fiyat, bölgesel trendlerle karşılaştırıldığında ilginç biçimde yüksek görünüyordu.
priceUnusuallyLowCount

string (int64 format)

Bu seyahat planı için verilen fiyat, bölgesel trendlerle karşılaştırıldığında beklenmedik şekilde düşük görünüyor.
taxesAndFeesMissingCount

string (int64 format)

Fiyatlarda vergiler ve ücretler eksik.
basePriceViolationsCount

string (int64 format)

Taban fiyat, toplam fiyata göre çok düşük.
priceAccuracyIssueCount

string (int64 format)

Fiyat doğruluğu sorunu.

PriceUnavailableCountDetails

Fiyatın kullanılamadığı sayıya katkıda bulunan nedenler ve her nedenin toplam sayısı.

JSON gösterimi 
{
  "priceUnavailableCount": string,
  "participationNotLikelyCount": string
}
Alanlar
priceUnavailableCount

string (int64 format)

Otel, seyahat planıyla ilişkili tarihlerde müsait olmadığı için katılmadı.
participationNotLikelyCount

string (int64 format)

Bu seyahat planı için önbelleğe fiyat alınmadı ve sunucunuz genellikle otelin hizmet vermediğini ya da tüm odaların dolu olduğunu belirttiğinden canlı sorgu yapılmadı.