Method: accounts.participationReportViews.query

Belirli bir hesap için 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, gTB Kod Geçişi söz dizimini kullanır.

Yol parametreleri

Parametreler
name

string

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

Sorgu parametreleri

Parametreler
filter

string

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

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

Geçerli koşul örnekleri şunlardır:

  • 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

Sorgu tarafından döndürülen metriklerin nasıl segmentlere ayrılacağını belirtir. Örneğin userRegionCode, aggregateBy değeri olarak belirtilirse participationResult, kullanıcı bölgesine göre birleştirilmiş metrikleri sağlar.

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

Çok sayıda satır oluşturan bir aggregateBy spesifikasyonunun kullanılması hataya neden olur. Bu, özellikle partnerHotelId veya ikiden fazla alan toplandığında geçerlidir. Hata olasılığını azaltmak için, partnerHotelId ve date ile filtreleme yaparak yalnızca belirli sayıda otel ve tarih ekleyin. Çok sayıda otel bulunan hesapların daha fazla filtrelemeyle verileri daha da azaltması gerekir.
pageSize

integer

Döndürülecek maksimum katılım sonucu sayısı. Hizmet bu değerden daha az değer döndürebilir. Belirtilmemesi halinde 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 birKatılımReportViews.query isteğinden alınan sayfa jetonu. Sonraki sayfayı almak için bunu girin.

Sayfalara ayırma sırasında, reportReports.query'ya 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 gövdesi

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

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

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

object (ParticipationResult)

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

string

Sonraki sonuç sayfasını almak için kullanılan sayfalara ayırma jetonu.

Yetkilendirme Kapsamları

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

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış konusuna bakın.

KatılımSonuçu

Bir hesabın katılım istatistiklerini sorgulayarak elde edilen bir 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ıdır. Fırsatlar, bir otel reklamının kullanıcılara gösterilebileceği durumların toplam sayısını belirtir.
participationCount

string (int64 format)

Google Ads açık artırma sürecinde girmeye uygun olduğunuz toplam fırsat sayısıdır.
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üzdesidir. Ö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 (örneğin, müsaitlik durumu yok) ve her neden için toplam sayıya katkıda bulunan nedenler.
partnerHotelDisplayName

string

İş ortağının otel 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 ülkesinin/bölgesinin 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 ülke/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ı için önceden rezervasyon yapmak istediği gün sayısı.

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ı.

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 giriş 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 durumudur.

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

KaçırılanKatılım SayısıAyrıntıları

Kaçırılan katılım sayısı nedene göre ayrılı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ıdır. 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ıdır.
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ıdır.
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 sağlanmadığı için kaçırılan toplam katılım sayısıdır.
noPriceCountDetails
(deprecated)

object (NoPriceCountDetails)

Fiyat sayısının olmamasına neden olan nedenler (örneğin, gerçek zamanlı fiyatlandırma mevcut değildir) ve her bir 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ı engellenmiş
  • Gerçek zamanlı fiyatlandırma ayarlanmamış
  • Gerçek zamanlı fiyatlandırmada zaman aşımı
  • Gerçek zamanlı fiyatlandırma hatası
priceMissingCountDetails

object (PriceMissingCountDetails)

Fiyatın eksik olmasına yol açan 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ıdır. Ş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 problemine 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ıdır. Şunlardan oluşur:

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

object (PriceUnavailableCountDetails)

Fiyatın gösterilmemesine neden olan nedenler.

Fiyat Sayısı Ayrıntıları

Fiyat sayısının gösterilmemesine neden olan faktörler 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 dolayı gerçek zamanlı fiyatlandırmayla ilgili teknik sorunlar yaşandığı için kaçırılan toplam katılım sayısıdır:

  • 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ürüldü.
  • Yanıtınızın yapısı bozuktu.
livePricingNotTriggeredCount

string (int64 format)

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

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

string (int64 format)

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

  • 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ıdır. 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 başka sorunlar nedeniyle kaçırılan katılım sayısı.

PriceMissingCountDetails

Fiyat eksikliği ve her nedenin toplam sayısı gibi etmenlerin etkisi.

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ı sorgudan 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 verdi.

FiyatSorunu Ayrıntıları

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

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

string (int64 format)

Otel askıya alındı. Bunun nedeni, yanlış vergi ve ücret 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 beklenmedik şekilde 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üyordu.
taxesAndFeesMissingCount

string (int64 format)

Fiyatlarda vergiler ve ücretler eksikti.

PriceAvailableCountDetails

Fiyatın gösterilmemesine 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ı.