共用方式為

SearchCampaignChangeHistoryReportRequest 數據物件 - 報告

  • 發行項

定義變更歷程記錄報表要求。 使用此報告來探索帳戶的變更時間，以及哪些使用者進行了變更。

您可以要求使用者和日期所做的變更記錄。 例如，您可以要求行銷活動名稱、位置目標關聯和關鍵詞標示的變更記錄。 您可以要求報表中的舊值和新值。

注意事項

從新增、更新或刪除實體開始，大約需要一小時的時間，變更歷程記錄才會可供報告。

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

語法

<xs:complexType name="SearchCampaignChangeHistoryReportRequest" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ReportRequest">
      <xs:sequence>
        <xs:element name="Columns" nillable="true" type="tns:ArrayOfSearchCampaignChangeHistoryReportColumn" />
        <xs:element minOccurs="0" name="Filter" nillable="true" type="tns:SearchCampaignChangeHistoryReportFilter" />
        <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>

元素

SearchCampaignChangeHistoryReportRequest 物件具有下列元素：Columns、Filter、Scope、Time。

元素 描述 資料類型
Columns 要包含在報表中的屬性和效能統計數據清單。 報表會以您指定資料行的順序來包含這些數據行。 SearchCampaignChangeHistoryReportColumn 陣 列
篩選器 用來篩選報表數據的篩選資訊。 SearchCampaignChangeHistoryReportFilter
範圍 報表的實體範圍。

使用此元素可將報表數據限制為特定帳戶、廣告群組或營銷活動。

針對此報表，您只能在 AccountThroughAdGroupReportScope 物件的 AccountIds 元素中指定一個帳戶標識碼。		 AccountThroughAdGroupReportScope
時間 要用於報表的時間週期。 您可以指定自訂日期範圍，或選取下列其中一個預先定義的日期範圍：

LastSevenDays

LastMonth

LastThreeMonths

您可以在 ReportTime 物件內設定時區，以協助您精確地設定所要求時段的數據範圍。

如果您未選擇時區，報表服務預設會使用 PacificTimeUSCanadaTi要a。		 ReportTime

SearchCampaignChangeHistoryReportRequest 物件具有 Inherited Elements。

繼承的專案

從 ReportRequest 繼承的專案

SearchCampaignChangeHistoryReportRequest 物件衍生自 ReportRequest 物件，並繼承下列元素：ExcludeColumnHeaders、ExcludeReportFooter、ExcludeReportHeader、Format、FormatVersion、ReportName、ReturnOnlyCompleteData。 下列描述專屬於 SearchCampaignChangeHistoryReportRequest，而且可能不適用於從 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
Namespace： https://bingads.microsoft.com/Reporting/v13