Reporting Service 模型
Reporting 服務包含您用來提交報告要求並輪詢其狀態的作業。 這些報告提供 Microsoft Advertising 帳戶、行銷活動和廣告群組的詳細統計資料。 這些資訊可協助您追蹤財務、測量廣告績效，以及調整設定，以優化您的預算或行銷活動。 例如，您可以使用關鍵字效能報告來查看哪些關鍵字的效能良好，以及哪些關鍵字的效能不佳。
Reporting Service 概觀
提交報表要求時，您可以選擇 [ 報表屬性] 和 [效能統計資料 ] 來判斷報表的內容。 例如，您可能想要包含曝光、點選和點選速率。 報表會使用資料行名稱做為資料行標頭。 報表包含資料行的順序，與您在報表要求的 Columns 元素中包含這些資料行的順序相同。 如需資料行如何影響資料輸出的詳細資訊，請參閱下方將 資料分組的資料 行。 如需相同報表要求中資料行組合限制的相關資訊，請參閱下 方的資料行限制 。
您也會指定報表參數，以限制或限制傳回的資料集。 例如，您可以設定匯總層級，依日或月分組資料;使用特定日期或預先定義的日期範圍，例如今天或過去七天，指定要包含在報表中的資料時段;藉由識別要包含在報表中的帳戶、活動和廣告群組來指定資料的範圍;並設定篩選準則以篩選報表資料。 如需您可以為每個匯總值指定的時間週期相關資訊，請參閱下方 的匯總和時間 。
如需您可以要求的報表清單，請參閱 報表類型。 如需您可以設定的報表參數完整清單，請參閱每個報表要求物件和 ReportRequest 基底物件。
如需如何要求和下載報表的相關資訊，請參閱 要求和下載報表當報表順利完成時，您可以從服務傳回的 URL 下載報表。 報表檔案已壓縮，因此您必須將檔案解壓縮以讀取報表。 系統可以儲存的報表數目沒有限制;不過，報表的儲存時間長度是未定義的。 服務不會檢查是否有重複的報表要求。
如需時區如何影響報表可用性的相關資訊，請參閱下 列報告中的時區 。
報表檔案架構
您可以要求 Csv、Tsv 或 Xml 報表資料。 根據預設，如果您沒有選擇其他 格式 ，下載的資料會以逗號分隔 (Csv) 。
"Report Name: My Keyword Performance Report"
"Report Time: 2/7/2020"
"Time Zone: (GMT-08:00) Pacific Time (US & Canada); Tijuana"
"Last Completed Available Day: 2/8/2020 10:15:00 PM (GMT)"
"Last Completed Available Hour: 2/8/2020 10:15:00 PM (GMT)"
"Report Aggregation: Summary"
"Report Filter: "
"Potential Incomplete Data: true"
"Rows: 5"
"AccountId","CampaignId","Keyword","KeywordId","DeviceType","Clicks"
"YourAccountId","YourCampaignId","red shoes","123","Computer","35"
"YourAccountId","YourCampaignId","red shoes","123","Smartphone","50"
"YourAccountId","YourCampaignId","shoes delivered","234","Computer","1"
"YourAccountId","YourCampaignId","shoe sale","345","Computer","80"
"YourAccountId","YourCampaignId","shoe sale","345","Smartphone","5"
"@2020 Microsoft Corporation. All rights reserved. "
預設會包含下列報表標頭中繼資料。 如果您不希望標頭中繼資料設定 ExcludeReportHeader 為 true。
| 標頭中繼資料 | 說明 |
|---|---|
| 報表名稱 | 您在提交報表時選擇的 ReportName 。 |
| 報表時間 | 您在提交報表時所選擇的報表時間。 如果要求多天，開始和結束日期將會以逗號分隔，例如「報表時間：2/1/2020、2/7/2020」。 |
| 時區 | 指出用來判斷所要求報表時間最後一天結束的時區。 如需時區如何影響報表可用性的相關資訊，請參閱下 列報告中的時區 。 |
| 上次完成可用日期 | Microsoft Advertising 完成處理此報表類型資料的最新日期和時間。 時間一律會相對於 UTC 回報，因此請忽略 (GMT) 報表中所寫入的尾碼。 |
| 上次完成可用時數 | Microsoft Advertising 完成處理此報表類型資料的最新日期和時間。 時間一律會相對於 UTC 回報，因此請忽略 (GMT) 報表中所寫入的尾碼。 |
| 報表匯總 | 反映在報表要求中設定的匯總類型。 如需詳細資訊 ，請參閱下方的匯總和時間 。 |
| 報表篩選 | 保留供日後使用。 |
| 可能不完整的資料 | 如果設為 true ，則報表資料可能不會在要求報表時間的最後一天完全處理。 ReturnOnlyCompleteData要求元素會判斷服務是否必須確定所有資料都已處理且可供使用。 如需時區如何影響報表可用性的相關資訊，請參閱下 列報告中的時區 。 |
| Rows | 報表記錄資料的計數，不包括空白行標頭、資料行名稱和頁尾中繼資料。 此中繼資料不適用於 Xml 報表。 |
預設會包含報表資料行名稱，例如「AccountId」，「CampaignId」，「Keyword」，「KeywordId」，「DeviceType」，「Clicks」。 如果您不想讓報表資料行將 ExcludeColumnHeaders 設定為 true。
報表頁尾中繼資料，例如 @2020 Microsoft Corporation。保留的擁有權限。 預設會包含 。 如果您不想讓頁尾中繼資料設定 ExcludeReportFooter 為 true。
報表格式版本
某些欄位的資料格式可以在目前的 API 版本內更新，而不會中斷現有的用戶端應用程式。 您可以藉由設定選擇性的 FormatVersion 要求欄位來取得最新的資料格式。 下表摘要說明 1.0 版和 2.0 版格式之間的差異。
| 說明 | 報表資料行 | FormatVersion 1.0 範例 | FormatVersion 2.0 範例 |
|---|---|---|---|
| 已移除逗號) (千個群組分隔符號。 | AllRevenue 協助 ExtendedCost 收入 |
1,000.00 | 1000.00 |
| 有效位數會從 4 位數更新為 2 位數。 | LowQualityClicksPercent LowQualityImpressionsPercent Ptr |
12.3400 | 12.34 |
| 有效位數會從 0 位數更新為 2 位數。 | AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent ExactMatchImpressionSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankAggPercent ImpressionSharePercent TopImpressionShareLostToBudgetPercent TopImpressionShareLostToRankPercent |
12 | 12.34 |
| 每小時報表格式已從 「mm/dd/yyyy 12：00：00 AM|hour」 更新為 「yyyy-mm-dd|hour」。 只有在報表匯總設定為 [每小時] 時，此格式才適用于 TimePeriod 資料 行。 | TimePeriod | 「3/15/2020 12：00：00 AM|7」 | 「2020-03-15|7」 |
將資料分組的資料行
您包含在報表中的屬性資料行會影響統計資料資料行內的值，以及數目或資料列。 例如，如果您要求的摘要報表只包含 AccountId、 CampaignId、 Keyword、 KeywordId和 Clicks，則不論裝置、比對類型和網路等排除的屬性為何，Clicks 資料行都會包含關鍵字的點按次數。
"Report Name: My Keyword Performance Report"
"Report Time: 2/7/2020"
"Time Zone: (GMT-08:00) Pacific Time (US & Canada); Tijuana"
"Last Completed Available Day: 2/8/2020 2:55:00 PM (GMT)"
"Last Completed Available Hour: 2/8/2020 2:55:00 PM (GMT)"
"Report Aggregation: Summary"
"Report Filter: "
"Potential Incomplete Data: true"
"Rows: 3"
"AccountId","CampaignId","Keyword","KeywordId","Clicks"
"YourAccountId","YourCampaignId","red shoes","123","95"
"YourAccountId","YourCampaignId","shoes delivered","234","1"
"YourAccountId","YourCampaignId","shoe sale","345","98"
"@2020 Microsoft Corporation. All rights reserved. "
如果您接著包含 DeviceType 資料行，則報表會針對關鍵字和裝置類型值的每個唯一組合包含一個資料列，而且每個資料列的 clicks 資料行中的值會據以細分。
"Report Name: My Keyword Performance Report"
"Report Time: 2/7/2020"
"Time Zone: (GMT-08:00) Pacific Time (US & Canada); Tijuana"
"Last Completed Available Day: 2/8/2020 2:55:00 PM (GMT)"
"Last Completed Available Hour: 2/8/2020 2:55:00 PM (GMT)"
"Report Aggregation: Summary"
"Report Filter: "
"Potential Incomplete Data: true"
"Rows: 7"
"AccountId","CampaignId","Keyword","KeywordId","DeviceType","Clicks"
"YourAccountId","YourCampaignId","red shoes","123","Computer","35"
"YourAccountId","YourCampaignId","red shoes","123","Smartphone","50"
"YourAccountId","YourCampaignId","red shoes","123","Tablet","10"
"YourAccountId","YourCampaignId","shoes delivered","234","Computer","1"
"YourAccountId","YourCampaignId","shoe sale","345","Computer","80"
"YourAccountId","YourCampaignId","shoe sale","345","Smartphone","5"
"YourAccountId","YourCampaignId","shoe sale","345","Tablet","13"
"@2020 Microsoft Corporation. All rights reserved. "
如需每種可用資料行類型的詳細資訊，請 參閱報表屬性和效能統計資料。
大部分報表都需要 TimePeriod 屬性，因此您也應該考慮指定更細微的匯總期間，例如報表要求的 Aggregation 元素中的每月，會進一步依月份細分點選資料。 例如，報表接著會針對關鍵字、裝置和月份的每一個唯一組合包含一個資料列。 資料列只包含在包含點選的月份。
資料行限制
對於包含 impression 共用效能統計資料資料行的報表，您不能在相同的報表要求中包含限制屬性。 如果您包含任何「曝光數」共用效能統計資料資料行，則必須排除下列所有屬性資料行。 同樣地，如果您包含下列任何屬性資料行，則必須排除所有曝光共用效能統計資料資料行。
提交 AccountPerformanceReportRequest 和 AdGroupPerformanceReportRequest時，下列屬性和 impression 共用效能統計資料行互斥。
注意事項
此外，如果您包含任何 AudienceImpressionLostToBudgetPercent、AudienceImpressionLostToRankPercent、AudienceImpressionSharePercent 或 RelativeCtr 資料行，則必須排除 CustomerId、CustomerName 和 DeliveredMatchType 屬性欄，反之亦然。
| 屬性 | 曝光共用效能統計資料 |
|---|---|
| BidMatchType DeviceOS 目標 GoalType TopVsOther |
AbsoluteTopImpressionRatePercent AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent AbsoluteTopImpressionSharePercent AudienceImpressionLostToBudgetPercent AudienceImpressionLostToRankPercent AudienceImpressionSharePercent ClickSharePercent ExactMatchImpressionSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankAggPercent ImpressionSharePercent RelativeCtr |
提交 CampaignPerformanceReportRequest時，下列屬性和曝光數共用效能統計資料行互斥。
注意事項
此外，如果您包含任何 AudienceImpressionLostToBudgetPercent、AudienceImpressionLostToRankPercent、AudienceImpressionSharePercent 或 RelativeCtr 資料行，則必須排除 CustomerId、CustomerName 和 DeliveredMatchType 屬性欄，反之亦然。
| 屬性 | 曝光共用效能統計資料 |
|---|---|
| BidMatchType BudgetAssociationStatus BudgetName BudgetStatus DeviceOS 目標 GoalType TopVsOther |
AbsoluteTopImpressionRatePercent AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent AbsoluteTopImpressionSharePercent AudienceImpressionLostToBudgetPercent AudienceImpressionLostToRankPercent AudienceImpressionSharePercent ClickSharePercent ExactMatchImpressionSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankAggPercent ImpressionSharePercent RelativeCtr TopImpressionRatePercent TopImpressionShareLostToBudgetPercent TopImpressionShareLostToRankPercent TopImpressionSharePercent |
提交 HotelDimensionPerformanceReportRequest時，會限制下列屬性。
| 屬性 |
|---|
| AdId |
提交 HotelGroupPerformanceReportRequest時，會限制下列屬性。
| 屬性 |
|---|
| AdId |
提交 ProductDimensionPerformanceReportRequest時，下列屬性和 impression 共用效能統計資料行互斥。
| 屬性 | 曝光共用效能統計資料 |
|---|---|
| AdDistribution AdId AdStatus ClickType ClickTypeId 目標 GoalType 語言 LocalStoreCode 網路 TopVsOther |
AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent AbsoluteTopImpressionSharePercent BenchmarkBid BenchmarkCtr ClickSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankPercent ImpressionSharePercent TopImpressionShareLostToBudgetPercent TopImpressionShareLostToRankPercent TopImpressionSharePercent |
提交 ProductPartitionPerformanceReportRequest時，下列屬性和曝光數共用效能統計資料行互斥。
| 屬性 | 曝光共用效能統計資料 |
|---|---|
| AdDistribution AdId AdStatus BidMatchType ClickType ClickTypeId DeliveredMatchType 目標 GoalType 語言 LocalStoreCode 網路 TopVsOther |
AbsoluteTopImpressionSharePercent BenchmarkBid BenchmarkCtr ClickSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankPercent ImpressionSharePercent |
時間週期資料行
如果您包含 TimePeriod 資料 行，則下載報表中的值格式會根據您在報表要求中指定的 報表匯總 層級而有所不同。 例如，如果匯總層級為 Daily，則 TimePeriod 資料行中的每個欄位都會包含格式為 yyyy-mm-dd 的日期。
注意事項
我們不支援每週、每月和每年時間週期資料行的部分資料匯總。 如果選取的日期不是完整周/月/年，而且要求對應的每週/每月/每年時間週期資料行，則選取的日期將會轉換成完整周/月/年。
| 聚集 | 說明 |
|---|---|
| 每日 | 報表的每個資料列都會識別交易發生時的月份、日期和年份。 每一天都會匯總報表資料。 時間週期會格式化為 yyyy-mm-dd。 |
| DayOfWeek | 報表的每個資料列都會識別一周中發生交易的日期。 報表資料會在一周內每七天匯總一次。 可能的資料值為1 - 7，其中1代表星期日，7代表星期六。 如果報表時間跨越數周，則每週某一天所有星期的效能資料會匯總成一個資料列。 例如，如果 活動 A 每週一 (第 2 天有 5 個曝光) 報表時間範圍內所含的 3 周，則報表會包含一個資料列，其中 TimePeriod 資料行中有 2 個，而該資料列的曝光數總計為 15。 |
| 每小時 | 報表的每個資料列都會識別交易發生時的小時。 報表資料會依一天中的每一小時進行匯總。 根據預設，時間週期會格式化為日期和小時 (int 值) 以單一管道分隔，也就是「mm/dd/yyyy 12：00：00 AM|hour」，其中可忽略上午 12：00：00。 例如，如果在 2020 年 3 月 15 日 07：00 到 08：00 之間按一下，則下載報表中的欄位會是 「3/15/2020 12：00：00 AM|7」。 如果您將報表 FormatVersion 設定為 「2.0」，則時間週期會格式化為 「yyyy-mm-dd|hour」。 例如，如果在 2020 年 3 月 15 日 07：00 到 08：00 之間按一下，則下載報表中的欄位會是 「2020-03-15|7」。 小時元件的可能值為0 - 23。 如果報表時間跨越多天，則指定時段的效能資料會分別在多個資料列之間提供，也就是報表會針對每個唯一的日期和小時包含一個資料列。 例如，如果 行銷活動 A 在報表時間範圍內所含的 3 天內，于 小時 7 期間有 5 個曝光數，則報表會包含三個數據列，每一個資料列的 5 個曝光數為 小時 7。 |
| HourOfDay | 報表的每個資料列都會識別交易發生當天的小時。 報表資料會在所有天數內每隔 24 小時匯總一次。 可能的值為0 - 23。 如果報表時間跨越多天，則指定小時的所有天數效能資料會匯總成一個資料列。 例如，如果 行銷活動 A 在報表時間範圍內所包含的 3 天內，于小時 7 期間有 5 個曝光數，則報表會包含一個資料列，其中 HourOfDay 的曝光數總計為 15。 |
| 每月 | 報表的每個資料列都會識別交易發生的月份。 每個月都會匯總報表資料。 包含當月第一天的時間週期會格式化為 yyyy-mm-dd。 |
| 每週 | 報表的每個資料列都會識別交易發生的周。 報表資料會每週匯總一次。 包含每週星期日日期的時間週期會格式化為 yyyy-mm-dd。 |
| 每年 | 報表的每個資料列都會識別發生交易的年份。 報表資料會依每年匯總。 包含年份的時間週期會格式化為 yyyy。 |
匯總和時間
對於大部分的報表要求，您必須設定 匯總 和 Time 元素。 以下是您可以為每個匯總值指定的時間週期。
| 匯總值 | 時間週期 |
|---|---|
| 每日 | 今天 昨天 LastSevenDays ThisMonth LastMonth 自訂日期範圍 |
| DayOfWeek | 今天 昨天 LastSevenDays ThisMonth LastMonth LastThreeMonths LastSixMonths |
| 每小時 | 今天 昨天 自訂日期範圍 |
| HourOfDay | 今天 昨天 LastSevenDays ThisMonth LastMonth LastThreeMonths LastSixMonths |
| 每月 | ThisMonth LastMonth LastThreeMonths LastSixMonths ThisYear LastYear 自訂日期範圍 |
| 摘要 | 今天 昨天 LastSevenDays ThisMonth LastMonth 自訂日期範圍 |
| 每週 | ThisWeek LastWeek LastFourWeeks ThisMonth LastMonth ThisYear LastYear 自訂日期範圍 |
| 每年 | ThisYear LastYear 自訂日期範圍 |
零曝光數
如果在要求的時間週期之前發生曝光，則報表資料可以包含零曝光的資料列，然後在要求的時段內發生後續動作，例如按一下、轉換或撥打電話。 同樣地，即使在要求的期間內，如果您下載了上周的每日效能報告，所有曝光都可能發生在星期日，然後按一下或其他效能，例如星期一或星期二。 星期一或星期二的報表資料可能會有無印象的點選。 您可以使用 大量服務 或 行銷活動管理服務 來取得您帳戶中的所有實體，而不論它們是否有任何相關聯的效能資料。
報表中的時區
下載的報表資料一律相對於 UTC 時間。 例如，每小時報表可能會將 5 次點選屬性為小時 7。 在此情況下，會在 07：00 到 08：00 UTC 之間進行 5 次點選。
ReportTimeZone要求元素會決定用來建立今天日期的時區。 當您提交報表要求時，今天的日期可能會因時區而異。 您選擇的報表時間週期，例如「昨天」，接著會相對於今天的日期。 如果您未選擇時區，報表服務預設會使用 PacificTimeUSCanadaTi要a。 例如，在 2020 年 2 月 2 日上午 2 點針對 「昨天」要求但未指定時區的報表，將會解譯為 2020/1/31 的要求。 同時針對 「昨天」要求的報表，並將時區設定為「東部時間USCanada」，將會解譯為 2020 年 2 月 1 日的要求。
ReturnOnlyCompleteData要求元素會判斷服務是否必須確定所有資料都已處理且可供使用。 如果設為 true ，而且系統尚未根據要求的匯總、範圍和時間完成處理所有資料，服務會傳回錯誤碼 NoCompleteDataAvaliable (2004) 。 否則，根據預設，要求可能會成功，並不會指出資料是否已完成，而且報表只會包含系統在要求時已完成處理的資料。 雖然目前仍在進行中，但您可以透過不要求已完成的資料來取得最新的資料。 然後在當天關閉書籍之後，您可能會想要將此旗標設為 true，並回顧現在的「昨天」，並取得最終的報表資料。
注意事項
如果您針對具有不同時區的行銷活動要求報表，資料只會在一天結束之後才會被視為完成，而且所有行銷活動時區中已處理點擊資料。 例如，假設您要求的報表包含指定 PST 時區) 的行銷活動 A (，以及指定 EST 時區) 的行銷活動 B (，在指定的時間週期內處理行銷活動 A 的所有點擊資料之後，資料才會完成。
當使用者按一下廣告時，系統最多可能需要兩小時的時間來處理按一下 (3 小時，以進行轉換) 並使其可供報告。 資料通常會被視為完成，而書籍會在 3 小時後關閉。 在某些因流量無效而導致的例外狀況案例中，可能會有非預期的調整，可能需要一周或更多時間才能解決。 例如，如果廣告商抱怨識別出逸出自動化篩選系統的無效點擊活動，流量品質和支援小組會處理廣告商帳戶的信用額度，並將與內部小組合作，判斷他們是否可以更新自動化系統，以改善未來的偵測。 如需詳細資訊，請參閱 流量品質中心。
MRC 認證計量
媒體評等委員會 (MRC) 認可搜尋廣告點選計量;此認證不適用於任何其他計量。 如需詳細資訊，請參閱 方法的按一下度量描述 。