Reporting 服務包含您用來提交報告要求及輪詢其狀態的作業。 這些報告會提供有關 Microsoft Advertising 帳戶、行銷活動和廣告群組的詳細統計資料。 這些資訊可協助您追蹤財務狀況、測量廣告成效，以及調整設定以最佳化您的預算或廣告活動。 例如，您可以使用關鍵字廣告成效報表來查看哪些關鍵字成效良好，哪些關鍵字成效不佳。
Reporting Service 概觀
提交報告請求時，您可以選擇 報告屬性和效能統計來 決定報告的內容。 例如，您可能會想要加入曝光數、點選數和點選率。 報表會使用欄名稱作為欄標題。 報表包含欄的順序與您在報表要求的 [欄 ] 元素中的順序相同。 如需欄如何影響資料輸出的相關資訊，請參閱下方的 將資料分組的欄 。 如需相同報表要求中資料行組合限制的相關資訊，請參閱下方的資料 行限制 。
您也會指定限制或限制傳回資料集的報告參數。 例如，您可以設定彙總層級以依日或月對資料進行分組;使用特定日期或預先定義的日期範圍，例如今天或過去七天，指定要包含在報告中的資料時段;識別要包含在報告中的帳戶、廣告活動和廣告群組，以指定資料的範圍;並設定篩選準則以篩選報表資料。 如需您可以為每個彙總值指定的時段的相關資訊，請參閱下方的 彙總和時間 。
如需您可以要求的報告清單，請參閱 報告類型。 如需您可以設定的報表參數完整清單，請參閱每個報表要求物件和 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 。 |
| 報告時間 | 您在提交報表時選擇的報表時間。 如果要求有多個天，開始日期和結束日期將會以逗號分隔，例如「報告時間：2020 年 2 月 1 日、2020 年 2 月 7 日」。 |
| 時區 | 指出用來判斷所要求報告時間最後一天結束的時區。 如需時區如何影響報告可用性的相關資訊，請參閱下方報告 中的時區 。 |
| 上次完成的可用日 | 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 | “2020/3/15 上午 12：00：00|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. "
如果您接著包含 [裝置類型 ] 資料欄位，報表會針對關鍵字和裝置類型值的每個唯一組合包含一列，而每一列的 [點選數] 資料欄位中的值會依此細分。
"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 屬性，因此您也應該考慮指定更精細的彙總期間，例如在報表要求的 彙總 元素中指定每月，會進一步按月細分點選資料。 例如，報表接著會包含關鍵字、裝置和月份的每一個唯一組合的資料列。 只有包含點選的月份才會包含此列。
欄位限制
對於包含曝光數佔有率成效統計資料欄位的報表，您無法在同一個報表要求中納入受限制的屬性。 如果您納入任何曝光數佔有率成效統計資料欄位，則必須排除下列所有屬性資料欄位。 同樣地，如果您納入下列任一屬性資料欄位，則必須排除所有 [曝光數佔有率成效] 統計資料欄位。
提交 AccountPerformanceReportRequest 和 AdGroupPerformanceReportRequest 時，下列屬性與曝光數佔有率成效統計資料欄位是互斥的。
注意事項
此外，如果您包含任何 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 時，下列屬性和曝光數佔有率成效統計資料欄位是互斥的。
| 屬性 | 曝光數佔有率成效統計 |
|---|---|
| AdDistribution AdId 廣告狀態 ClickType ClickTypeId 目標 GoalType 語言 LocalStoreCode 網路 TopVsOther |
AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent AbsoluteTopImpressionSharePercent BenchmarkBid BenchmarkCtr ClickSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankPercent ImpressionSharePercent TopImpressionShareLostToBudgetPercent TopImpressionShareLostToRankPercent TopImpressionSharePercent |
提交 ProductPartitionPerformanceReportRequest 時，下列屬性和曝光數佔有率成效統計資料欄位是互斥的。
| 屬性 | 曝光數佔有率成效統計 |
|---|---|
| AdDistribution AdId 廣告狀態 BidMatchType ClickType ClickTypeId DeliveredMatchType 目標 GoalType 語言 LocalStoreCode 網路 TopVsOther |
AbsoluteTopImpressionSharePercent BenchmarkBid BenchmarkCtr ClickSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankPercent ImpressionSharePercent |
時間週期資料行
如果您包含 TimePeriod 欄，則下載報告中的值格式將根據您在報告請求中指定的 報告彙總 層級而有所不同。 例如，如果彙總層級為 [每日]，則 [期間] 資料行中的每個欄位都會包含日期，格式為 yyyy-mm-dd。
注意事項
我們不支援每週、每月和每年時段欄的部分資料彙總。 如果選取的日期不是完整的週/月/年，且要求對應的每週/每月/每年時段欄，則選取的日期將會轉換為完整的週/月/年。
| 彙總 | 描述 |
|---|---|
| 每日 | 報告的每一列都會標識交易發生的月、日和年。 報表資料會依每天彙總。 時間週期的格式會是 yyyy-mm-dd。 |
| 星期幾 | 報告的每一列都會標識交易發生的星期幾。 報告資料將依一週中的七天中的每一天彙總。 可能的資料值為 1 - 、7，其中 1 代表星期日，7 代表星期六。 如果報表時間跨越數週，則一週中某一天的所有週的成效資料會彙總成一列。 例如，如果 廣告活動 A 在報表時間範圍中包含的 3 週內，每週一 (第 2 天) 均有 5 次曝光數，則報表中的 [時段] 資料欄位中會有 2 的一列曝光數，而該列中的曝光數總計為 15 次。 |
| 每小時 | 報告的每一列都會識別交易發生的小時。 報表資料會依一天中的每個小時彙總。 根據預設，時間週期的格式設定為日期和小時 (int 值) 以單一管道分隔，例如「mm/dd/yyyy 12：00：00 AM|hour」，其中可以忽略 12：00：00 AM。 例如，如果點選發生在 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 次曝光數，則報表將包含三列，每列第 7 小時 有 5 次曝光數。 |
| HourOfDay | 報告的每一列都會識別交易發生時的小時。 報表資料會依所有天的 24 小時彙總。 可能的值為 0 - 、23。 如果報表時間跨越數天，則指定一小時內所有天數的成效資料會彙總成一列。 例如，如果 廣告活動 A 在報表時間範圍中包含的 3 天中的每一天的第 7 小時均有 5 次曝光數，則報表會包含一列，其中 HourOfDay 的曝光數總計為 15 次。 |
| 每月 | 報告的每一列都會標識交易發生的月份。 報表資料會依每月彙總。 包含當月第一天的時段會格式化為 yyyy-mm-dd。 |
| 每週 | 報告的每一列都會標識交易發生的週。 報告資料將每週彙總。 包含每一週星期日日期的時段格式會是 yyyy-mm-dd。 |
| 每年 | 報告的每一列都會標識交易發生的年份。 報告資料將每年彙總。 包含年份的時段會格式化為 yyyy。 |
彙總和時間
對於大部分的報表要求，您必須設定 [彙總 ] 和 [時間] 元素。 以下是您可以為每個彙總值指定的時段。
| 彙總值 | 時間段 |
|---|---|
| 每日 | 今天 昨天 過去七天 本月 LastMonth 自訂日期範圍 |
| 星期幾 | 今天 昨天 過去七天 本月 LastMonth 過去三個月 過去六個月 |
| 每小時 | 今天 昨天 自訂日期範圍 |
| HourOfDay | 今天 昨天 過去七天 本月 LastMonth 過去三個月 過去六個月 |
| 每月 | 本月 LastMonth 過去三個月 過去六個月 今年 LastYear 自訂日期範圍 |
| 摘要 | 今天 昨天 過去七天 本月 LastMonth 自訂日期範圍 |
| 每週 | 本週 上週 過去四週 本月 LastMonth 今年 LastYear 自訂日期範圍 |
| 每年 | 今年 LastYear 自訂日期範圍 |
零曝光數
如果曝光數發生在要求的時段之前，然後在要求的時段內發生後續動作 （例如點選、成交或撥打電話） ，則報表資料可能包含零曝光數的資料列。 同樣地，即使在要求的時間範圍內，如果您下載上週的廣告成效日報，也可能所有曝光數都發生在星期日，然後又有點選數或其他成效發生在星期一或星期二。 星期一或星期二的報表資料可能含有零曝光數的點選數。 您可以使用 大量服務 或 廣告活動管理服務 來取得您帳戶中的所有實體，無論它們是否有任何相關聯的廣告成效資料。
報告中的時區
下載的報告資料一律是相對於 UTC 時間。 例如，每小時報表可能會將 5 次點選歸因於第 7 小時。 在此情況下，5 次點選發生在 07：00 到 08：00 UTC 之間。
ReportTimeZone 要求元素會決定用來確定今天日期的時區。 當您提交舉報要求時，今天的日期可能會因時區而有所不同。 您選擇的報告時段（例如 '昨天'）是相對於今天的日期。 如果您未選擇時區，則 Reporting 服務預設會使用 PacificTimeUSCanadaTijuana。 例如，在 2020 年 2 月 2 日凌晨 2 點美國東部時間凌晨 2 點要求的「昨天」報告，會解譯為 2020/1/31 的要求。 同時要求的 '昨天' 報告，且時區設定為 EasternTimeUSCanada，會解譯為 2020/2/1 的要求。
ReturnOnlyCompleteData 要求元素會判定服務是否必須確保所有資料都已處理且可供使用。 如果設為 true ，且系統尚未根據要求的彙總、範圍和時間完成處理所有資料，服務會傳回錯誤碼 NoCompleteDataAvaliable (2004) 。 否則，預設情況下請求可以成功，沒有資料是否完整的指示，並且報告將僅包含系統在請求時已完成處理的資料。 雖然今天仍在進行中，但您可以透過不要求已完成的資料來取得最新的資料。 然後在當天的帳簿結束後，您可能需要將此旗標設定為 true，並回顧現在的 [昨天] 並取得最終報告資料。
注意事項
如果您針對具有不同時區的廣告活動要求報表，則只有在該日結束且所有廣告活動時區的點選資料都已處理完畢之後，才會將資料視為完整。 例如，假設您要求的報表包含指定 PST 時區) 的行銷活動 A (，以及指定 EST 時區) 的行銷活動 B (，則在廣告活動 A 的所有點選資料都處理完指定時段內，資料才算完整。
當使用者點選廣告時，系統最多可能需要 2 小時來處理該點選 (3 小時的成交) ，並將該點選提供給報表。 數據通常被認為是完整的，賬簿在 3 小時後關閉。 在某些例外情況下，由於流量無效，可能會發生非預期的調整，可能需要一週或更長時間才能解決。 例如，如果廣告客戶抱怨指出逸出自動篩選系統的點擊活動無效，流量品質和支援團隊將會處理廣告客戶帳戶的點數，並且會與內部團隊合作，判斷他們是否可以更新自動化系統，以在未來改善偵測功能。 如需詳細資訊，請參閱 流量品質中心。
MRC 認可指標
搜尋廣告點選數計量由媒體評級委員會 (MRC) 認證;此認證不適用於任何其他指標。 如需詳細資訊，請參閱 方法論的點選計算標準說明 。