HotelDimensionPerformanceReportRequest 資料物件 - 報告

定義旅館維度效能報告要求，以依產品類別、自訂標籤、標題和類型匯總指定時段的效能資料。 您可以在報表中包含詳細資料，例如曝光、點選和花費，以用來識別旅館維度是否執行良好。

若要要求此類型的報表，請將此物件傳遞至 SubmitGenerateReport 作業。

語法

<xs:complexType name="HotelDimensionPerformanceReportRequest" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ReportRequest">
      <xs:sequence>
        <xs:element name="Aggregation" type="tns:ReportAggregation" />
        <xs:element name="Columns" nillable="true" type="tns:ArrayOfHotelDimensionPerformanceReportColumn" />
        <xs:element minOccurs="0" name="Filter" nillable="true" type="tns:HotelDimensionPerformanceReportFilter" />
        <xs:element name="Scope" nillable="true" type="tns:AccountThroughAdGroupReportScope" />
        <xs:element name="Time" nillable="true" type="tns:ReportTime" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

元素

HotelDimensionPerformanceReportRequest物件具有下列元素：匯總、資料行、篩選、範圍、時間。

元素	說明	資料類型
聚集	用來匯總報表資料的匯總類型。 例如，您可以依日或周匯總報表資料，或要求摘要報表。 預設匯總為 Summary。 請務必注意，如果您未在資料行清單中包含 TimePeriod ，則會忽略您選擇的匯總，不論為何都會使用摘要匯總。	ReportAggregation
列	要包含在報表中的屬性和效能統計資料清單。 報表會以您指定資料行的順序來包含這些資料行。	HotelDimensionPerformanceReportColumn 數 組
篩選器	用來篩選報表資料的篩選資訊。	HotelDimensionPerformanceReportFilter
範圍	報表的實體範圍。 使用此元素可將報表資料限制為特定帳戶。	AccountThroughAdGroupReportScope
時間	要用於報表的時間週期。 您可以指定自訂日期範圍，或選取預先定義的日期範圍，例如 Today 或 ThisWeek。 如需您可以為每個匯總類型指定的時間週期清單，請參閱 匯總和時間。 您可以在 ReportTime 物件內設定時區，以協助您精確地設定所要求時段的資料範圍。 如果您未選擇時區，報表服務預設會使用 PacificTimeUSCanadaTi要a。	ReportTime

HotelDimensionPerformanceReportRequest物件具有Inherited Elements。

繼承的專案

從 ReportRequest 繼承的專案

HotelDimensionPerformanceReportRequest物件衍生自ReportRequest物件，並繼承下列元素：ExcludeColumnHeaders、ExcludeReportFooter、ExcludeReportHeader、Format、FormatVersion、ReportName、ReturnOnlyCompleteData。 下列描述專屬於 HotelDimensionPerformanceReportRequest，而且可能不適用於從 ReportRequest 物件繼承相同元素的其他物件。

元素	說明	資料類型
ExcludeColumnHeaders	判斷下載的報表是否應該包含每個資料行的標頭描述。 報表資料行標頭符合要求的資料行名稱，例如 [曝光數 ] 和 [ 按一下]。 如果您想要將報表資料行標頭從下載的報表中排除，請將此屬性設定 為 true 。 預設值為 false。	布林
ExcludeReportFooter	判斷下載的報表是否應該包含頁尾中繼資料，例如 Microsoft 著作權 (@2020 Microsoft Corporation。保留的擁有權限。) 。 如果您想要將報表頁尾中繼資料從下載的報表中排除，請將此屬性設定 為 true 。 預設值為 false。	布林
ExcludeReportHeader	判斷下載的報表是否應該包含標頭中繼資料，例如報表名稱、日期範圍和匯總。 如果您想要從下載的報表中排除報表標頭中繼資料，請將此屬性設為 true 。 預設值為 false。	布林
格式	報表資料的格式。 例如，您可以要求以逗號分隔值 (Csv) 格式或索引標籤分隔值 (Tsv) 格式的資料。 預設值為 Csv。 所有下載的檔案都會壓縮。	ReportFormat
FormatVersion	決定所下載報表檔案中特定欄位的格式。 某些欄位的資料格式可以在目前的 API 版本內更新，而不會中斷現有的用戶端應用程式。 您可以將此選擇性要求欄位設定為 2.0，以取得最新的資料格式。 如果您未設定此欄位，服務預設為 1.0 版。 如需格式版本之間變更的詳細資訊，請 參閱報表格式版本。	string
ReportName	報表的名稱。 名稱包含在報表標頭中。 如果您未指定報表名稱，系統會以 ReportType-ReportDateTime 格式產生名稱。 報表名稱的最大長度為 200。	string
ReturnOnlyCompleteData	判斷服務是否必須確定所有資料都已處理且可供使用。 如果設為 true ，而且系統尚未根據要求的 匯總、 範圍和 時間完成處理所有資料，服務會傳回錯誤碼 NoCompleteDataAvaliable (2004) 。 否則，根據預設，要求可能會成功，並不會指出資料是否已完成，而且報表只會包含系統在要求時已完成處理的資料。 請注意，因為今天仍在進行中，而且資料尚未完成，所以如果[時間] 期間 (自訂或預先定義的日期) 包含今天的日期，您就無法將此元素設定為true。 如需詳細資訊，請參閱 報表中的時區。	布林

需求

服務： ReportingService.svc v13
命名 空間： https://bingads.microsoft.com/Reporting/v13