Method: accounts.participationReportViews.query

string

Tên tài nguyên của tài khoản đang được truy vấn. Định dạng là accounts/{account_id}.

string

Các điều kiện (trường và biểu thức) dùng để lọc chỉ số tham gia cho tài khoản đang được truy vấn. Cú pháp này yêu cầu khoảng trắng xung quanh toán tử in. Nếu không, có thể bỏ qua dấu cách. Bạn có thể kết hợp các điều kiện bằng toán tử and.

Trường date là bắt buộc. Tất cả các trường khác là không bắt buộc.

Ví dụ về các điều kiện hợp lệ như sau:

• 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')

string

Chỉ định cách phân đoạn các chỉ số mà truy vấn trả về. Ví dụ: nếu userRegionCode được chỉ định làm giá trị aggregateBy, thì participationResult sẽ cung cấp các chỉ số được tổng hợp theo khu vực của người dùng.

Giá trị chuỗi là một danh sách các trường được phân tách bằng dấu phẩy. Các trường hợp lệ là: date, userRegionCode, deviceType, partnerHotelId, hotelRegionCode, advanceBookingWindow, lengthOfStayDays, checkinDate và occupancy. Các trường không được chỉ định sẽ không có trong đíchResult.

Việc sử dụng thông số kỹ thuật aggregateBy tạo ra một số lượng lớn hàng sẽ gây ra lỗi. Điều này đặc biệt đúng khi tổng hợp bằng partnerHotelId hoặc nhiều trường. Để giảm khả năng xảy ra lỗi, hãy lọc theo partnerHotelId và date để chỉ bao gồm một số khách sạn và ngày nhất định. Các tài khoản có nhiều khách sạn sẽ cần phải giảm bớt dữ liệu khi có nhiều bộ lọc hơn.

integer

Số lượng kết quả tham gia tối đa được trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu không chỉ định, tối đa 10.000 kết quả sẽ được trả về. Giá trị tối đa là 10.000; các giá trị trên 10.000 sẽ bị ép buộc thành 10.000.

string

Mã thông báo trang, nhận được từ yêu cầu engagementReportView.query trước đó. Cung cấp mã này để nhận trang tiếp theo.

Khi phân trang, tất cả các thông số khác được cung cấp cho engagementReportViews.query phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

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

object (Key)

Khóa của kết quả.

string (int64 format)

Đối với khách sạn thì đây là tổng số cơ hội đã có. Cơ hội là tổng số lần quảng cáo khách sạn đã có thể tiếp cận người dùng.

string (int64 format)

Tổng số cơ hội khi bạn đủ điều kiện tham gia quá trình đấu giá trên Google Ads.

number

Tỷ lệ phần trăm nắm được cơ hội đấu giá, tức là lấy số cơ hội mà bạn đã tham gia thành công chia cho tổng số cơ hội. Ví dụ: nếu một cơ sở lưu trú đã 90 lần đủ điều kiện tham gia phiên đấu giá trên Google Ads trong số 100 cơ hội, thì tỷ lệ được tham gia đấu giá là 90%.

string (int64 format)

Tổng số cơ hội không đủ điều kiện để tham gia vào quá trình đấu giá trên Google Ads. Bao gồm những điều sau:

• Thiếu trang đích
• Thiếu giá
• Có vấn đề về giá
• Chưa có giá
• Khác

object (MissedParticipationCountDetails)

Những lý do khiến số lượng người tham gia bị bỏ lỡ (ví dụ: không có tình trạng rảnh/bận) và tổng số lượng lý do cho mỗi lý do.

string

Tên hiển thị của khách sạn của đối tác. Hệ thống chỉ điền trường này khi kết quả được tổng hợp bằng partnerHotelId.

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

object (Date)

Ngày mà bạn yêu cầu chỉ số.

Nếu date không phải là một giá trị của thông số aggregateBy trong lệnh gọi yêu cầu, thì trường date sẽ không được trả về trong Key.

string

Mã vùng ISO 3116 của quốc gia/khu vực của người dùng.

Nếu userRegionCode không phải là một giá trị của thông số aggregateBy trong lệnh gọi yêu cầu, thì trường userRegionCode sẽ không được trả về trong Key.

enum (Device)

Loại thiết bị của người dùng.

Nếu deviceType không phải là một giá trị của thông số aggregateBy trong lệnh gọi yêu cầu, thì trường deviceType sẽ không được trả về trong Key.

string

Mã khách sạn của đối tác.

Nếu partnerHotelId không phải là một giá trị của thông số aggregateBy trong lệnh gọi yêu cầu, thì trường partnerHotelId sẽ không được trả về trong Key.

string

Mã vùng CLDR của quốc gia/khu vực của khách sạn.

Nếu hotelRegionCode không phải là một giá trị của thông số aggregateBy trong lệnh gọi yêu cầu, thì trường hotelRegionCode sẽ không được trả về trong Key.

integer

Số ngày mà người dùng muốn đặt trước hành trình.

Nếu advanceBookingWindow không phải là một giá trị của thông số aggregateBy trong lệnh gọi yêu cầu, thì trường advanceBookingWindow sẽ không được trả về trong Key.

integer

Số đêm trong hành trình.

Nếu lengthOfStayDays không phải là một giá trị của thông số aggregateBy trong lệnh gọi yêu cầu, thì trường lengthOfStayDays sẽ không được trả về trong Key.

object (Date)

Ngày nhận phòng trong hành trình.

Nếu checkinDate không phải là một giá trị của thông số aggregateBy trong lệnh gọi yêu cầu, thì trường checkinDate sẽ không được trả về trong Key.

integer

Tổng sức chứa của hành trình.

Nếu occupancy không phải là một giá trị của thông số aggregateBy trong lệnh gọi yêu cầu, thì trường occupancy sẽ không được trả về trong Key.

{
  "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)
  }
}

string (int64 format)

Tổng số cơ hội đấu giá bị bỏ lỡ do không có tổ hợp khách sạn/hành trình hoặc khách du lịch không đủ điều kiện hưởng mức giá được đưa ra. Để tham gia các phiên đấu giá này, có thể bạn cần phải cung cấp thêm thông tin về giá.

string (int64 format)

Tổng số cơ hội đấu giá bị bỏ lỡ do một hoặc nhiều khách sạn của bạn bị tạm ngưng do vi phạm mức độ chính xác về giá.

string (int64 format)

Tổng số cơ hội đấu giá bị bỏ lỡ do một hoặc nhiều khách sạn của bạn không xác định cụ thể các khoản thuế và phí.

string (int64 format)

Không có trang đích nào phù hợp với người dùng.

string (int64 format)

Tổng số cơ hội đấu giá bị bỏ lỡ do không cung cấp giá cho hành trình được yêu cầu.

object (NoPriceCountDetails)

Các lý do dẫn đến việc không tính giá (ví dụ: không có chế độ cung cấp mức giá hiện tại) và tổng số tiền cho từng lý do.

string (int64 format)

Khách sạn không tham gia đấu giá vì lý do không xác định.

string (int64 format)

Tổng số cơ hội đấu giá bị bỏ lỡ do giá không xuất hiện trong bộ nhớ đệm của Google hoặc không thể cung cấp mức giá hiện tại. Bao gồm những điều sau:

• Hết băng thông
• Thiếu tỷ lệ bộ nhớ đệm
• Hành trình bị chặn
• Chưa thiết lập chế độ cung cấp mức giá hiện tại
• Live pricing timeout (Hết thời gian chờ của chế độ cung cấp mức giá hiện tại)
• Live pricing error (Lỗi về chế độ cung cấp mức giá hiện tại)

object (PriceMissingCountDetails)

Các lý do dẫn đến việc thiếu giá.

string (int64 format)

Tổng số cơ hội đấu giá bị bỏ lỡ do có vấn đề với độ chính xác của giá được cung cấp cho hành trình. Bao gồm những điều sau:

• Khách sạn bị tạm ngưng
• Price unusually high (Giá cao bất thường)
• Giá thấp bất thường
• Thiếu thuế và nguồn cấp dữ liệu

object (PriceProblemCountDetails)

Lý do khiến số lượng vấn đề về giá.

string (int64 format)

Tổng số cơ hội đấu giá bị bỏ lỡ do không có giá niêm yết (-1) cho hành trình được yêu cầu. Bao gồm những điều sau:

• Chưa có giá
• Không có cơ hội đấu giá
• Khác

object (PriceUnavailableCountDetails)

Những lý do khiến giá có thể bị tính.

{
  "livePricingTechnicalIssueCount": string,
  "livePricingNotTriggeredCount": string,
  "livePricingConfigIssueCount": string,
  "livePricingNotAvailableCount": string,
  "livePricingOtherReasonCount": string
}

string (int64 format)

Tổng số cơ hội đấu giá bị bỏ lỡ do các vấn đề kỹ thuật về chế độ cung cấp mức giá hiện tại vì bất cứ lý do nào sau đây:

• Bạn đã không phản hồi đủ nhanh và vượt quá thời hạn phản hồi (khoảng 4000 mili giây).
• Bạn trả về lỗi.
• Phản hồi của bạn không đúng định dạng.

string (int64 format)

Tổng số cơ hội đấu giá bị bỏ lỡ do chế độ cung cấp mức giá hiện tại không được kích hoạt vì bất cứ lý do nào sau đây:

• Bạn chưa đặt giá thầu.
• Bạn chưa có trang đích hợp lệ.
• Không có đủ giá trong bộ nhớ đệm.

string (int64 format)

Tổng số cơ hội đấu giá bị bỏ lỡ do chế độ cung cấp mức giá hiện tại không được kích hoạt vì bất cứ lý do nào sau đây:

• Bạn chưa định cấu hình chế độ cung cấp mức giá hiện tại cho những lượt tìm kiếm này.
• Bạn đã hạn chế quyền truy cập của Google vào hành trình lưu trú của khách sạn đang được nói đến.

string (int64 format)

Tổng số cơ hội đấu giá bị bỏ lỡ do không có chế độ cung cấp mức giá hiện tại. Chúng tôi sẽ không kích hoạt chế độ cung cấp mức giá hiện tại đối với một số hành trình hoặc giao diện người dùng mặc định. Trong trường hợp này, các đối tác sẽ cần giá đã lưu vào bộ nhớ đệm để tham gia.

string (int64 format)

Số người tham gia bị bỏ lỡ do các vấn đề khác trong chế độ cung cấp mức giá hiện tại.

{
  "cacheRateMissingCount": string,
  "itineraryBlockedCount": string,
  "livePricingNotSetupCount": string,
  "bandwidthDepletedCount": string,
  "livePricingTimeoutCount": string,
  "livePricingErrorCount": string
}

string (int64 format)

Không có giá trong bộ nhớ đệm cho hành trình này. Một truy vấn trực tiếp đã không được thực hiện do các hạn chế của trang.

string (int64 format)

Hành trình nằm ngoài các thông số cơ bản, vì vậy không có giá nào từ truy vấn trực tiếp hoặc bộ nhớ đệm được lấy cho hành trình này.

string (int64 format)

Giá không được lưu vào bộ nhớ đệm cho hành trình này và tài khoản này chưa thiết lập chế độ truy vấn trực tiếp.

string (int64 format)

Không có giá nào được lưu vào bộ nhớ đệm cho hành trình này và không còn hạn mức truy vấn trực tiếp.

string (int64 format)

Giá không được lưu vào bộ nhớ đệm cho hành trình này và lượt truy vấn trực tiếp gửi đến hệ thống của bạn đã hết thời gian chờ.

string (int64 format)

Giá không được lưu vào bộ nhớ đệm cho hành trình này. Lượt truy vấn trực tiếp không hết thời gian chờ nhưng hệ thống trả về lỗi.

{
  "hotelSuspendedCount": string,
  "priceUnusuallyHighCount": string,
  "priceUnusuallyLowCount": string,
  "taxesAndFeesMissingCount": string
}

string (int64 format)

Khách sạn bị tạm ngưng hoạt động. Điều này có thể xảy ra do những vấn đề liên tục xảy ra liên quan đến thuế và phí không chính xác.

string (int64 format)

Giá cho hành trình này có vẻ cao hơn rất nhiều so với các xu hướng theo khu vực.

string (int64 format)

Giá cho hành trình này có vẻ thấp hơn rất nhiều so với các xu hướng theo khu vực.

string (int64 format)

Thiếu thuế và phí trong giá.

{
  "priceUnavailableCount": string,
  "participationNotLikelyCount": string
}

string (int64 format)

Khách sạn không tham gia đấu giá vì không có giá cho ngày trong hành trình.

string (int64 format)

Không có giá trong bộ nhớ đệm cho hành trình này và không thể truy vấn trực tiếp vì máy chủ của bạn thường thông báo với chúng tôi rằng khách sạn không có phòng hoặc đã hết phòng.