ShareOfVoiceReportRequest 數據物件 - 報告
定義語音 (SOV) 報表要求的共用。 使用此報表來檢視每個關鍵詞成功中標 (%) ，並找出增加曝光數分享的機會。
您可以要求曝光數、曝光率共用 (%) 、對預算遺失的曝光率 (%) ，以及在中標時遺失曝光率共用。 下載之後，即可依關鍵詞、關鍵詞標識碼、登陸頁面用戶體驗和品質分數來排序此數據。
若要要求此類型的報表，請將此對象傳遞至 SubmitGenerateReport 作業。
<xs:complexType name="ShareOfVoiceReportRequest" 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:ArrayOfShareOfVoiceReportColumn" />
<xs:element minOccurs="0" name="Filter" nillable="true" type="tns:ShareOfVoiceReportFilter" />
<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>
元素
ShareOfVoiceReportRequest 物件具有下列元素：匯總、數據行、篩選、範圍、時間。
| 元素 | 描述 | 資料類型 |
|---|---|---|
| 集合體 | 用來匯總報表數據的匯總類型。 例如，您可以依日或周匯總報表數據，或要求摘要報表。 默認匯總為 Summary。 請務必注意，如果您未在數據行清單中包含 TimePeriod ，則會忽略您選擇的匯總，不論為何都會使用摘要匯總。 |
ReportAggregation |
| Columns | 要包含在報表中的屬性和效能統計數據清單。 報表會以您指定資料行的順序來包含這些數據行。 | ShareOfVoiceReportColumn 陣 列 |
| 篩選器 | 用來篩選報表數據的篩選資訊。 | ShareOfVoiceReportFilter |
| 範圍 | 報表的實體範圍。 使用此元素可將報表數據限制為特定帳戶、廣告群組或營銷活動。 |
AccountThroughAdGroupReportScope |
| 時間 | 要用於報表的時間週期。 您可以指定自定義日期範圍，或選取預先定義的日期範圍，例如 Today 或 ThisWeek。 如需您可以為每個匯總類型指定的時間週期清單，請參閱 匯總和時間。 您可以在 ReportTime 物件內設定時區，以協助您精確地設定所要求時段的數據範圍。 如果您未選擇時區，報表服務預設會使用 PacificTimeUSCanadaTi要a。 |
ReportTime |
ShareOfVoiceReportRequest 物件具有 Inherited Elements。
繼承的專案
從 ReportRequest 繼承的專案
ShareOfVoiceReportRequest 物件衍生自 ReportRequest 物件，並繼承下列元素：ExcludeColumnHeaders、ExcludeReportFooter、ExcludeReportHeader、Format、FormatVersion、ReportName、ReturnOnlyCompleteData。 下列描述專屬於 ShareOfVoiceReportRequest，而且可能不適用於從 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