SearchCampaignChangeHistoryReportColumn 值集 - 報告
定義您可以包含在 SearchCampaignChangeHistoryReportRequest中的屬性資料行。
如需您必須包含的資料行清單，請參閱下方的 一 節。
語法
<xs:simpleType name="SearchCampaignChangeHistoryReportColumn" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:restriction base="xs:string">
<xs:enumeration value="DateTime" />
<xs:enumeration value="AccountId" />
<xs:enumeration value="AccountName" />
<xs:enumeration value="AccountNumber" />
<xs:enumeration value="ChangedBy" />
<xs:enumeration value="CampaignName" />
<xs:enumeration value="CampaignId" />
<xs:enumeration value="AdGroupName" />
<xs:enumeration value="AdGroupId" />
<xs:enumeration value="AdTitle" />
<xs:enumeration value="AdDescription" />
<xs:enumeration value="DisplayUrl" />
<xs:enumeration value="Keyword" />
<xs:enumeration value="ItemChanged" />
<xs:enumeration value="AttributeChanged" />
<xs:enumeration value="HowChanged" />
<xs:enumeration value="OldValue" />
<xs:enumeration value="NewValue" />
<xs:enumeration value="EntityName" />
<xs:enumeration value="EntityId" />
<xs:enumeration value="Tool" />
</xs:restriction>
</xs:simpleType>
值
SearchCampaignChangeHistoryReportColumn值集具有下列值：AccountId、AccountName、AccountNumber、AdDescription、AdGroupId、AdGroupName、AdTitle、AttributeChanged、CampaignId、CampaignName、ChangedBy、DateTime、DisplayUrl、EntityId、EntityName、HowChanged、ItemChanged、 關鍵字、NewValue、OldValue、Tool。
| 值 | 描述 |
|---|---|
| AccountId | Microsoft Advertising 指派的帳戶識別碼。 |
| AccountName | 帳戶名稱。 |
| AccountNumber | Microsoft Advertising 指派的帳戶號碼。 |
| AdDescription | 出現在您廣告路徑下方的第一個廣告描述。 如果 ItemChanged 不是 Ad，此資料行將會是空的。 |
| AdGroupId | 廣告群組的 Microsoft Advertising 指派識別碼。 如果 ItemChanged 不是 Ad、Ad 群組或關鍵字，則此資料行會是空的。 |
| AdGroupName | 廣告組名。 如果 ItemChanged 不是 Ad、Ad 群組或關鍵字，則此資料行會是空的。 |
| AdTitle | 廣告標題部分。 如果 ItemChanged 不是 Ad，此資料行將會是空的。 |
| AttributeChanged | 從已變更的 ItemChanged 資料行識別實體的屬性。 For a list of elements whose change history is reported, see the Attribute Changed column within Remarks. 如果已新增或刪除行銷活動、廣告群組或廣告實體，則此資料行是空的。 |
| CampaignId | 行銷活動的 Microsoft Advertising 指派識別碼。 |
| CampaignName | 行銷活動名稱。 |
| ChangedBy | 對帳戶內設定進行變更之使用者的使用者名稱。 如果系統進行變更，此值將會是 Administrator。 |
| Datetime | 變更的日期和時間。 日期和時間將位於行銷活動的時區。 |
| DisplayUrl | 廣告顯示 URL。 如果 ItemChanged 不是 Ad，此資料行將會是空的。 |
| EntityId | 已更新實體的 Microsoft Advertising 系統識別碼。 |
| EntityName | 已更新之實體的名稱。 |
| HowChanged | 值，指出是否已加入、更新或刪除專案。 如需可能的值，請參閱 ChangeTypeReportFilter 值集。 針對 adds，NewValue 資料行包含新增的實體。 對於刪除， OldValue 資料行包含已刪除的實體。 針對更新， NewValue 資料行包含新的值， 而 OldValue 資料 行包含舊值。 如果已新增具有傳遞狀態屬性的實體，例如行銷活動， 則 HowChanged 的值為 Added。 若要報告已刪除的實體， ItemChanged 欄位為 Status、 HowChanged 欄位已變更， 而 NewValue 字 段為 Deleted。 將目標與行銷活動或廣告群組建立關聯，將會回報為新增變更。 AttributeChanged資料行會識別目標物件中包含的目標型別。 目標物件的匯報會回報為刪除變更和新增變更。 移除行銷活動或廣告群組與目標物件的關聯，將會回報為刪除變更。 |
| ItemChanged | 識別已變更之實體的值。 如果變更是實體元素的更新，或是與行銷活動或廣告群組相關聯的目標相關， 則 AttributeChanged 資料行會包含已變更之實體的專案或已變更的目標型別。 |
| 關鍵字 | 關鍵字文字。 如果 ItemChanged 不是關鍵字，此資料行會是空的。 |
| NewValue | 變更後的值。 如需詳細資訊，請參閱 HowChanged 資料 行。 |
| OldValue | 變更前的值。 如需詳細資訊，請參閱 HowChanged 資料 行。 |
| 工具 | 用來進行變更的 Microsoft Advertising 工具。 可能的值包括 「API」、「自動化規則」、「大量上傳]、[匯入]、[編輯器]、[Mobile Apps]、[其他]、[腳本] 和 [Web 用戶端 (手動) ]。 未來可以新增新的值，因此您不應該對一組固定的值採取任何相依性。 |
註解
必要資料行
報表至少必須包含下列資料行。 一般而言，每個報表必須包含至少一個屬性資料行，以及至少一個非曝光共用效能統計資料資料行。 如需詳細資訊，請 參閱報表屬性和效能統計資料。
| 欄 |
|---|
| 日期時間 |
變更歷程記錄詳細資料
以下是報告變更歷程記錄的實體類型。
注意事項
如果 AttributeChanged 欄位是空白或空白，而且 HowChanged 欄位是新增或刪除，則 NewValue 或 OldValue 字 段的內容分別代表已新增或刪除之實體的專案。 例如，如果新增關鍵字， NewValue 欄位會 包含關鍵字文字。
帳戶
當 ItemChanged 字 段的值為 Account 時，可以使用下列屬性的變更歷程記錄。
| 屬性已變更 | 說明 |
|---|---|
| 無 (空白) | 參考已新增的帳戶名稱。 對應的 HowChanged 欄位值為 Added。 |
| 帳戶 | 參考已變更的帳戶名稱。 |
| 機構連絡人 | 是指機構連絡人的名稱。 |
| 銷售公司客戶 | 是指銷售公司客戶。 |
| 帳單給客戶 | 是指計費給客戶 |
| 財務狀態 | 參考財務狀態 |
| 鎖定狀態 | 參考鎖定狀態 |
| 付款選項 | 參考付款選項 |
| 慣用的帳單對付款條件 | 是指慣用的帳單對付款條件 |
| 慣用語言 | 是指慣用的語言 |
| 銷售到付款條件 | 銷售到付款條件 |
| 狀態 | 是指帳戶狀態。 |
| 慣用的使用者 | 是指慣用的使用者 |
| 消費限制 | 參照消費限制 |
| 追蹤範本 | 是指帳戶的追蹤範本。 |
廣告
當 ItemChanged 欄位的值為 Ad 時，可以使用下列屬性的變更歷程記錄。
| 屬性已變更 | 說明 |
|---|---|
| 無 (空白) | 參照已新增的廣告標題。 對應的 HowChanged 欄位值為 Added。 |
| 廣告文字 | 參照廣告複本的描述。 |
| 廣告標題 | 參照已變更的廣告標題。 |
| 自訂參數 | 參照廣告的自訂參數。 |
| 目的地 URL | 參考廣告的目的地 URL。 |
| 顯示 URL | 參照廣告的顯示 URL。 |
| 編輯狀態 | 指的是廣告的編輯狀態。 如果廣告擱置離線編輯檢閱，則在下載的變更歷程記錄報告中，編輯狀態會表示為 擱置中 - 作用 中或 擱置 - 非作用中。 如需詳細資訊，請參閱 實體和傳遞狀態。 |
| 最終 URL | 參照廣告的最終 URL。 |
| 行動裝置 URL | 參照廣告的最終行動 URL。 |
| 狀態 | 是指廣告的傳遞狀態。 如果報告已刪除的廣告， ItemChanged 欄位為 Status、 HowChanged 欄位已變更，且 NewValue 字 段為 Deleted。 |
| 追蹤範本 | 指的是廣告的追蹤範本。 |
廣告群組
當 ItemChanged 字 段的值為 Ad 群組時，可以使用下列屬性的變更歷程記錄。
| 屬性已變更 | 說明 |
|---|---|
| 無 (空白) | 參考已新增的廣告組名。 對應的 HowChanged 欄位值為 Added。 |
| 廣告群組 | 是指已變更的廣告組名。 |
| 進階位置目標 | 是指與廣告群組相關聯之位置目標的意圖選項。 |
| 年齡 | 是指年齡目標。 |
| 自訂參數 | 是指廣告群組的自訂參數。 |
| 日 | 指的是 Bing 廣告 API 第 9 版之後已被取代的日目標。 |
| 預設廣泛比對比對 | 是指預設廣泛比對的報價 |
| 預設內容比對標價 | 參考預設內容比對標價 |
| 預設完全相符的比對 | 參考預設完全相符的比對 |
| 預設片語比對標價 | 參考預設片語比對比標 |
| 裝置 | 是指裝置目標的定義程式。 |
| Distance (距離) | 是指半徑目標的距離。 |
| 結束日期 | 是指廣告群組的排程結束日期。 |
| 結束時間 | 是指 DayTime 目標的合併 To Hour 和 To Minute。 此欄位中也會包含標價調整，以單一垂直橫條字元分隔時間。 |
| 性別 | 是指性別目標。 |
| 小時 | 指的是 Bing 廣告 API 第 9 版之後已被取代的小時目標。 |
| 位置 | 參考位置目標。 |
| 位置排除 | 是指從位置目標排除位置。 |
| 中 | 參照搜尋或內容廣告發布。 |
| Negative 關鍵字 | 是指與廣告群組相關聯的負關鍵字。 匯報負關鍵字會報告為兩個數據列中的 [已移除] 和 [已新增] 變更。 已移除的記錄會對應至舊值，而新增的記錄會反映新的值。 |
| 暫停狀態 | 是指廣告群組的任何暫停狀態。 |
| 產品群組 | 產品群組的產品條件會以反斜線 (') 分隔，並以單一空白字元從中分隔。 |
| 網站排除 | 指的是廣告群組的負面網站 URL。 廣告群組可以有多個網站排除專案，而每個網站排除專案會分別在自己的報表資料列中表示。 |
| 開始時間 | 是指 DayTime 目標的 From Hour 和 From Minute 合併。 此欄位中也會包含標價調整，以單一垂直橫條字元分隔時間。 |
| 狀態 | 是指廣告群組的傳遞狀態。 如果回報已刪除的廣告群組， [ItemChanged] 欄位會是 [狀態]、[ HowChanged ] 欄位是 [已變更]，而 [NewValue] 字 段會是 [刪除]。 |
| 目標天數 | 參考 DayTime 目標的日期。 此欄位中也會包含標價調整，以單一垂直橫條字元分隔日期。 |
| 追蹤範本 | 指的是廣告群組的追蹤範本。 |
通話擴充功能
當 ItemChanged 欄位的值為呼叫延伸模組時，可以使用下列屬性的變更歷程記錄。
| 屬性已變更 | 說明 |
|---|---|
| 關聯 | 是指呼叫延伸模組與實體的關聯。 例如，如果延伸模組與行銷活動相關聯， 則 CampaignName 欄位的值是相關聯行銷活動的名稱、 ItemChanged 欄位的值為 Call extension、 AttributeChanged 欄位的值為 Association， 而 HowChanged 欄位的值為 Added。 另一個範例是，如果延伸模組與行銷活動相關聯或解除關聯，則個別的 NewValue 或 OldValue 是行銷活動的名稱，而 EntityName 資料行則包含廣告延伸模組的名稱。 |
| 國家/地區 | 是指呼叫延伸模組的國家/地區。 |
| 電話號碼 | 是指通話擴充功能的電話號碼。 |
| 顯示網站或電話 | 參考是否應以通話擴充功能的電話號碼顯示網站。 OldValue和NewValue資料行中可能的值為Phone和Website 和 phone。 |
| 使用正向號碼 | 是指是否已針對呼叫擴充功能設定轉送。 OldValue和NewValue資料行中的可能值為 [否] 和 [是]。 |
行銷活動
當 ItemChanged 字 段的值為 Campaign 時，可以使用下列屬性的變更歷程記錄。
| 屬性已變更 | 說明 |
|---|---|
| 無 (空白) | 參考已新增的行銷活動名稱。 對應的 HowChanged 欄位值為 Added。 |
| 進階位置目標 | 是指與行銷活動相關聯之位置目標的意圖選項。 |
| 年齡 | 是指年齡目標。 |
| 預算類型 | 是指行銷活動預算類型。 OldValue和NewValue資料行中可能的值如下： - 每日目標 (加速) 值會對應至 Microsoft Advertising Web 應用程式每日加速設定。 - 標準) 的每日目標 (值會對應至 Microsoft Advertising Web 應用程式的 Daily Standard 設定。 |
| 行銷活動優先順序 | 是指 Microsoft 購物活動的優先順序。 |
| 自訂參數 | 是指行銷活動的自訂參數。 |
| 每日預算 | 是指行銷活動每日預算金額。 |
| 日 | 指的是 Bing 廣告 API 第 9 版之後已被取代的日目標。 |
| 裝置 | 參考裝置目標。 |
| Distance (距離) | 是指半徑目標的距離。 |
| 結束日期 | 是指廣告群組的排程結束日期。 |
| 結束時間 | 是指 DayTime 目標的合併 To Hour 和 To Minute。 此欄位中也會包含標價調整，以單一垂直橫條字元分隔時間。 |
| 性別 | 是指性別目標。 |
| 小時 | 指的是 Bing 廣告 API 第 9 版之後已被取代的小時目標。 |
| IP 排除 | 是指透過 Microsoft Advertising Web 應用程式建立的 IP 排除專案。 |
| 位置 | 參考位置目標。 |
| 位置排除 | 是指從位置目標排除位置。 |
| 名稱 | 參考已變更的行銷活動名稱。 |
| Negative 關鍵字 | 是指與行銷活動相關聯的負關鍵字。 匯報負關鍵字會報告為兩個數據列中的 [已移除] 和 [已新增] 變更。 已移除的記錄會對應至舊值，而新增的記錄會反映新的值。 |
| 暫停狀態 | 是指行銷活動的任何暫停狀態。 OldValue和NewValue資料行中可能的值為 「Budget Paused」、「Budget and user Paused」、「Not paused」 和 「Paused」。 |
| 產品篩選 | 是指 Microsoft 購物活動的產品範圍或條件。 Microsoft 購物活動可以有多個產品條件，而且每個條件會分別在自己的報表資料列中表示。 |
| 共用預算 | 是指多個行銷活動共用的預算。 |
| 網站排除 | 指的是行銷活動的負數網站 URL。 一個行銷活動可以有多個網站排除專案，而且每個網站排除專案會分別在自己的報表資料列中表示。 |
| 開始日期 | 供內部使用。 |
| 開始時間 | 是指 DayTime 目標的 From Hour 和 From Minute 合併。 此欄位中也會包含標價調整，以單一垂直橫條字元分隔時間。 |
| 狀態 | 是指行銷活動的傳遞狀態。 如果報告已刪除的行銷活動， [ItemChanged] 欄位會是 [狀態]、[ HowChanged ] 欄位是 [已變更]，而 [NewValue] 字 段會是 [刪除]。 |
| 目標天數 | 參考 DayTime 目標的日期。 此欄位中也會包含標價調整，以單一垂直橫條字元分隔日期。 |
| 追蹤範本 | 指的是活動的追蹤範本。 |
關鍵字
當 ItemChanged 欄位的值為 Keyword 時，可以使用下列屬性的變更歷程記錄。
| 屬性已變更 | 說明 |
|---|---|
| 無 (空白) | 參考已加入之關鍵字的文字。 對應的 HowChanged 欄位值為 Added。 |
| 廣泛比對標價 | 是指 關鍵字的廣泛比對比價金額。 |
| 內容比對標價 | 是指 關鍵字的內容比對比價金額。 |
| 自訂參數 | 是指 關鍵字的自訂參數。 |
| 編輯狀態 | 是指 關鍵字的編輯狀態。 如果關鍵字擱置離線編輯檢閱，則在下載的變更歷程記錄報表中，編輯狀態會表示為擱置中 - 作用中或擱置 - 非作用中。 如需詳細資訊，請參閱 實體和傳遞狀態。 |
| 完全相符的報價 | 是指 關鍵字的完全相符的比對數量。 |
| 最終 URL | 參照關鍵字的最終 URL。 |
| 行動裝置 URL | 是指 關鍵字的 Final Mobile URL。 |
| 符合類型 | 是指 關鍵字的比對類型。 無法使用 Bing 廣告 API 更新比對類型;不過，您可以使用 Microsoft Advertising Web 應用程式來變更報價比對類型。 |
| 片語比對標價 | 是指關鍵字的片語比對比價金額。 |
| 狀態 | 是指 關鍵字的傳遞狀態。 如果報告已刪除的關鍵字， 則 ItemChanged 欄位為 Status、 HowChanged 欄位已變更，而 NewValue 字 段為 Deleted。 |
| 追蹤範本 | 是指 關鍵字的追蹤範本。 |
位置延伸模組
當 ItemChanged 欄位的值為位置延伸時，可以使用下列屬性的變更歷程記錄。
| 屬性已變更 | 說明 |
|---|---|
| 關聯 | 是指位置延伸模組與實體的關聯。 例如，如果延伸模組與行銷活動相關聯， CampaignName 欄位的值就是相關聯行銷活動的名稱、 ItemChanged 欄位的值是位置延伸模組、 AttributeChanged 欄位的值是 Association， 而 HowChanged 欄位的值為 Added。 |
負關鍵字清單
當 ItemChanged 欄位的值為負關鍵字清單時，可以使用下列屬性的變更歷程記錄。
| 屬性已變更 | 說明 |
|---|---|
| 關聯 | 是指負關鍵字清單與行銷活動的關聯。 例如，如果負關鍵字清單與行銷活動相關聯， CampaignName 欄位的值就是關聯行銷活動的名稱、 ItemChanged 欄位的值是負關鍵字清單、 AttributeChanged 欄位的值是 Association， 而 HowChanged 欄位的值是 Added。 |
| Negative 關鍵字 | 是指從負關鍵字清單新增或移除的負關鍵字。 |
| 負關鍵字清單名稱 | 參考負關鍵字清單的名稱。 |
Sitelink 擴充功能
當 ItemChanged 字 段的值是 Sitelink 延伸模組時，可以使用下列屬性的變更歷程記錄。
| 屬性已變更 | 說明 |
|---|---|
| 關聯 | 是指網站連結延伸模組與實體的關聯。 例如，如果延伸模組與行銷活動相關聯， CampaignName 欄位的值就是關聯行銷活動的名稱、 ItemChanged 欄位的值是 Sitelink 延伸模組、 AttributeChanged 欄位的值是 Association， 而 HowChanged 欄位的值是 Added。 |
| 自訂參數 | 是指月臺連結的自訂參數。 |
| 目的地 URL | 是指網站連結延伸模組的目的地 URL。 |
| 顯示文字 | 參照網站連結延伸模組的顯示文字。 |
| 最終 URL | 參照網站連結的最終 URL。 |
| 行動裝置 URL | 參照網站連結的最終行動 URL。 |
| 追蹤範本 | 是指網站連結的追蹤範本。 |
使用者
當 ItemChanged 欄位的值為 User 時，可以使用下列屬性的變更歷程記錄。
| 屬性已變更 | 說明 |
|---|---|
| 無 (空白) | 參考已新增之使用者的使用者名稱。 對應的 HowChanged 欄位值為 Added。 |
| 代碼 | 供內部使用。 |
| 電子郵件 | 是指使用者的連絡人電子郵件地址。 |
| 名字 | 是指使用者的名字。 |
| 姓氏 | 是指使用者的姓氏。 |
| 狀態 | 是指使用者的狀態。 |
需求
服務： ReportingService.svc v13
命名 空間： https://bingads.microsoft.com/Reporting/v13