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、 Keyword、NewValue、OldValue、Tool。
| 値 | 説明 |
|---|---|
| AccountId | アカウントの Microsoft Advertising 割り当て識別子。 |
| AccountName | アカウント名。 |
| AccountNumber | アカウントの Microsoft Advertising 割り当て番号。 |
| AdDescription | 広告のパスの下に表示される最初の広告の説明。 ItemChanged が Ad でない場合、この列は空になります。 |
| AdGroupId | 広告グループの Microsoft Advertising 割り当て識別子。 ItemChanged が [広告]、[広告グループ]、または [キーワード] でない場合、この列は空になります。 |
| AdGroupName | 広告グループ名。 ItemChanged が [広告]、[広告グループ]、または [キーワード] でない場合、この列は空になります。 |
| AdTitle | 広告タイトルパーツ。 ItemChanged が Ad でない場合、この列は空になります。 |
| AttributeChanged | 変更された ItemChanged 列からエンティティの属性またはプロパティを識別します。 変更履歴が報告される要素の一覧については、「解説」の「属性の変更」列 を参照してください。 キャンペーン、広告グループ、または広告エンティティが追加または削除された場合、この列は空です。 |
| CampaignId | キャンペーンの Microsoft Advertising 割り当て識別子。 |
| CampaignName | キャンペーン名。 |
| ChangedBy | アカウント内の設定を変更したユーザーのユーザー名。 システムが変更を行った場合、値は Administrator になります。 |
| DateTime | 変更の日付と時刻。 日付と時刻は、キャンペーンのタイム ゾーンに含まれます。 |
| DisplayUrl | 広告表示 URL。 ItemChanged が Ad でない場合、この列は空になります。 |
| EntityId | 更新されたエンティティの Microsoft Advertising システム識別子。 |
| EntityName | 更新されたエンティティの名前。 |
| HowChanged | 要素が追加、更新、または削除されたかどうかを示す値。 使用可能な値については、「 ChangeTypeReportFilter 値セット」を参照してください。 add の場合、 NewValue 列には追加されたエンティティが含まれます。 削除の場合、 OldValue 列には削除されたエンティティが含まれます。 更新の場合、 NewValue 列には新しい値が含まれており、 OldValue 列には古い値が含まれます。 配信状態プロパティを持つエンティティ (キャンペーンなど) が追加された場合、 HowChanged の値は [追加] になります。 削除されたエンティティを報告するには、[ ItemChanged ] フィールドが [状態]、[ HowChanged ] フィールドが [変更済み]、 NewValue フィールドが [削除済み] になります。 ターゲットをキャンペーンまたは広告グループに関連付けると、追加の変更として報告されます。 AttributeChanged 列は、ターゲット オブジェクトに含まれるターゲット型を識別します。 ターゲット オブジェクトへのUpdatesは、削除の変更と追加の変更として報告されます。 キャンペーンまたは広告グループのターゲット オブジェクトとの関連付けを削除すると、削除の変更として報告されます。 |
| ItemChanged | 変更されたエンティティを識別する値。 変更がエンティティの要素に対する更新であるか、キャンペーンまたは広告グループに関連付けられているターゲットに関連する場合、 AttributeChanged 列には、変更されたエンティティの要素または変更されたターゲットの種類が含まれます。 |
| キーワード | キーワード テキスト。 ItemChanged がキーワードでない場合、この列は空になります。 |
| NewValue | 変更後の値。 詳細については、 HowChanged 列を参照してください。 |
| OldValue | 変更前の値。 詳細については、 HowChanged 列を参照してください。 |
| ツール | 変更を行うために使用される Microsoft Advertising ツール。 使用可能な値には、"API"、"自動ルール"、"一括アップロード"、"Imports"、"Editor"、"Mobile Apps"、"Other"、"Scripts"、"Web クライアント (手動)" などがあります。 新しい値は将来追加できるため、固定の値セットに依存しないようにしてください。 |
注釈
必須列
レポートには、少なくとも次の列が含まれている必要があります。 一般的なルールとして、各レポートには少なくとも 1 つの属性列と少なくとも 1 つの非インプレッション共有パフォーマンス統計列が含まれている必要があります。 詳細については、「 レポート属性とパフォーマンス統計」を参照してください。
| Column |
|---|
| DateTime |
変更履歴の詳細
変更履歴が報告されるエンティティ型を次に示します。
注:
AttributeChanged フィールドが空白または空で、[HowChanged] フィールドが [追加] または [削除済み] の場合、NewValue フィールドまたは OldValue フィールドの内容は、それぞれ追加または削除されたエンティティの要素を表します。 たとえば、キーワードが追加された場合、 NewValue フィールドにはキーワード テキストが含まれます。
アカウント
ItemChanged フィールドの値が Account の場合、次の属性の変更履歴を使用できます。
| 属性の変更 | 説明 |
|---|---|
| なし (空白) | 追加されたアカウントの名前を参照します。 対応する HowChanged フィールドの値が追加されます。 |
| アカウント | 変更されたアカウントの名前を参照します。 |
| 代理店の連絡先 | 代理店の連絡先の名前を参照します。 |
| セールスハウスのお客様 | 販売ハウスのお客様を指します。 |
| 請求先顧客 | 請求先顧客を参照します |
| 財務状態 | 財務状態を参照します |
| ロックの状態 | ロック状態を参照します |
| 支払いオプション | 支払いオプションを参照します |
| 優先請求先の支払い方法 | 優先される請求先支払い方法を参照します |
| 優先する言語 | 優先する言語を参照します |
| 販売先のお支払い方法 | 販売先のお支払い方法 |
| 状態 | アカウントの状態を参照します。 |
| 優先ユーザー | 優先ユーザーを参照します |
| 支出制限 | 支出制限を参照します |
| 追跡テンプレート | アカウントの追跡テンプレートを参照します。 |
広告
ItemChanged フィールドの値が Ad の場合は、次の属性の変更履歴を使用できます。
| 属性の変更 | 説明 |
|---|---|
| なし (空白) | 追加された広告のタイトルを参照します。 対応する HowChanged フィールドの値が追加されます。 |
| 広告テキスト | 広告コピーの説明を参照します。 |
| 広告タイトル | 変更された広告のタイトルを参照します。 |
| カスタム パラメーター | 広告のカスタム パラメーターを参照します。 |
| 宛先 URL | 広告の宛先 URL を参照します。 |
| 表示 URL | 広告の表示 URL を参照します。 |
| 編集状態 | 広告の編集状態を指します。 広告がオフライン編集レビューを保留中の場合、ダウンロードした変更履歴レポート内で編集状態は [保留中] - [アクティブ] または [ 保留中 ] - [非アクティブ] として表されます。 詳細については、「 エンティティと配信状態」を参照してください。 |
| 最終 URL | 広告の最終 URL を参照します。 |
| モバイル URL | 広告の最終モバイル URL を参照します。 |
| 状態 | 広告の配信状態を示します。 削除された広告を報告する場合、[ ItemChanged ] フィールドは [状態]、[ HowChanged ] フィールドは [変更済み]、 NewValue フィールドは [削除済み] です。 |
| 追跡テンプレート | 広告の追跡テンプレートを参照します。 |
広告グループ
ItemChanged フィールドの値が [広告グループ] の場合は、次の属性の変更履歴を使用できます。
| 属性の変更 | 説明 |
|---|---|
| なし (空白) | 追加された広告グループの名前を参照します。 対応する HowChanged フィールドの値が追加されます。 |
| 広告グループ | 変更された広告グループの名前を参照します。 |
| 高度な場所のターゲット設定 | 広告グループに関連付けられている場所ターゲットの意図オプションを参照します。 |
| 年齢 | 年齢目標を参照します。 |
| カスタム パラメーター | 広告グループのカスタム パラメーターを参照します。 |
| 日 | Bing Ads API バージョン 9 以降に非推奨となった日ターゲットを参照します。 |
| 既定の一致範囲の入札 | 既定の広い一致入札を参照します |
| 既定のコンテンツ一致入札 | 既定のコンテンツの一致入札を参照します |
| 既定の完全一致入札 | 既定の完全一致入札を参照します |
| 既定の語句の一致入札 | 既定の語句の一致入札を参照します |
| デバイス | デバイス ターゲットに対する遅延を参照します。 |
| Distance | 半径ターゲットの距離を参照します。 |
| [終了日] | 広告グループのスケジュールされた終了日を参照します。 |
| 終了時刻 | DayTime ターゲットの To Hour と To Minute の組み合わせを参照します。 このフィールドには、1 つの縦棒文字で区切られた時間から区切られた入札単価調整も含まれます。 |
| Gender | 性別ターゲットを参照します。 |
| 時 | Bing Ads API バージョン 9 以降に非推奨となった時間ターゲットを参照します。 |
| 場所 | 場所ターゲットを参照します。 |
| 場所の除外 | 場所ターゲットから場所を除外することを指します。 |
| 中 | 検索広告またはコンテンツ広告配信を参照します。 |
| 負のキーワード | 広告グループに関連付けられている除外キーワードを参照します。 除外キーワードへのUpdatesは、2 行の削除および追加された変更として報告されます。 Removed レコードは古い値に対応し、Add レコードには新しい値が反映されます。 |
| 一時停止状態 | 広告グループの一時停止状態を参照します。 |
| 製品グループ | 製品グループの製品条件は、互いに下位スラッシュ ('') で区切られ、入札から 1 つのスペース文字で区切られます。 |
| サイトの除外 | 広告グループの除外サイト URL を参照します。 広告グループには複数のサイト除外を設定でき、各サイトの除外は個別にレポート行に表示されます。 |
| 開始時刻 | DayTime ターゲットの From Hour と From Minute の組み合わせを参照します。 このフィールドには、1 つの縦棒文字で区切られた時間から区切られた入札単価調整も含まれます。 |
| 状態 | 広告グループの配信状態を参照します。 削除された広告グループを報告する場合、[ ItemChanged ] フィールドは [状態]、[ HowChanged ] フィールドは [変更済み]、 NewValue フィールドは [削除済み] です。 |
| 対象日数 | DayTime ターゲットの日を参照します。 このフィールドには、1 つの縦棒文字で区切られた日から区切られた入札単価調整も含まれます。 |
| 追跡テンプレート | 広告グループの追跡テンプレートを参照します。 |
通話拡張機能
ItemChanged フィールドの値が [拡張機能の呼び出し] の場合は、次の属性の変更履歴を使用できます。
| 属性の変更 | 説明 |
|---|---|
| 関連付け | 呼び出し拡張機能とエンティティの関連付けを参照します。 たとえば、拡張機能がキャンペーンに関連付けられている場合、 CampaignName フィールドの値は関連付けられたキャンペーンの名前、 ItemChanged フィールドの値は通話拡張機能、 AttributeChanged フィールドの値は関連付け、 HowChanged フィールドの値は追加されます。 別の例として、拡張機能がキャンペーンに関連付けられているか、キャンペーンとの関連付けが解除されている場合、それぞれの NewValue または OldValue がキャンペーンの名前であり、[EntityName] 列には広告拡張機能の名前が含まれます。 |
| 国/地域 | 通話拡張機能の国/地域を参照します。 |
| 電話番号 | 通話拡張機能の電話番号を参照します。 |
| Web サイトまたは電話を表示する | 通話拡張機能の電話番号で Web サイトを表示するかどうかを示します。 OldValue 列と NewValue 列で使用できる値は、電話と Web サイトと電話です。 |
| 前方番号を使用する | 呼び出し拡張機能の転送が設定されているかどうかを示します。 OldValue 列と NewValue 列で使用できる値は、No と Yes です。 |
キャンペーン
ItemChanged フィールドの値が [キャンペーン] の場合は、次の属性の変更履歴を使用できます。
| 属性の変更 | 説明 |
|---|---|
| なし (空白) | 追加されたキャンペーンの名前を参照します。 対応する HowChanged フィールドの値が追加されます。 |
| 高度な場所のターゲット設定 | キャンペーンに関連付けられている場所ターゲットの意図オプションを参照します。 |
| 年齢 | 年齢目標を参照します。 |
| 予算の種類 | キャンペーンの予算の種類を参照します。 OldValue 列と NewValue 列で使用できる値は次のとおりです。 - 日単位のターゲット (高速化) の値は、Microsoft Advertising Web アプリケーションの [毎日の高速化] 設定に対応します。 - 日次ターゲット (標準) の値は、Microsoft Advertising Web アプリケーションの Daily Standard 設定に対応します。 |
| キャンペーンの優先度 | Microsoft ショッピング キャンペーンの優先順位を指します。 |
| カスタム パラメーター | キャンペーンのカスタム パラメーターを参照します。 |
| 1 日の予算 | キャンペーンの 1 日の予算金額を参照します。 |
| 日 | Bing Ads API バージョン 9 以降に非推奨となった日ターゲットを参照します。 |
| デバイス | デバイス ターゲットを参照します。 |
| Distance | 半径ターゲットの距離を参照します。 |
| [終了日] | 広告グループのスケジュールされた終了日を参照します。 |
| 終了時刻 | DayTime ターゲットの To Hour と To Minute の組み合わせを参照します。 このフィールドには、1 つの縦棒文字で区切られた時間から区切られた入札単価調整も含まれます。 |
| Gender | 性別ターゲットを参照します。 |
| 時 | Bing Ads API バージョン 9 以降に非推奨となった時間ターゲットを参照します。 |
| IP 除外 | Microsoft Advertising Web アプリケーションを介して作成された IP 除外を参照します。 |
| 場所 | 場所ターゲットを参照します。 |
| 場所の除外 | 場所ターゲットから場所を除外することを指します。 |
| 名前 | 変更されたキャンペーンの名前を参照します。 |
| 負のキーワード | キャンペーンに関連付けられている除外キーワードを参照します。 除外キーワードへのUpdatesは、2 行の削除および追加された変更として報告されます。 Removed レコードは古い値に対応し、Add レコードには新しい値が反映されます。 |
| 一時停止状態 | キャンペーンの一時停止状態のいずれかを参照します。 OldValue 列と NewValue 列で使用できる値は、"予算の一時停止"、"予算とユーザーの一時停止"、"一時停止していない"、"一時停止" です。 |
| 製品フィルター | Microsoft ショッピング キャンペーンの製品範囲または条件を参照します。 Microsoft ショッピング キャンペーンには複数の製品条件を設定でき、各条件は個別のレポート行に表示されます。 |
| 共有予算 | 複数のキャンペーンで共有される予算を指します。 |
| サイトの除外 | キャンペーンの除外サイト URL を参照します。 キャンペーンには複数のサイト除外を設定でき、各サイトの除外は独自のレポート行で個別に表されます。 |
| 開始日 | 内部使用の場合。 |
| 開始時刻 | DayTime ターゲットの From Hour と From Minute の組み合わせを参照します。 このフィールドには、1 つの縦棒文字で区切られた時間から区切られた入札単価調整も含まれます。 |
| 状態 | キャンペーンの配信状態を参照します。 削除されたキャンペーンを報告する場合、[ ItemChanged ] フィールドは [状態]、[ HowChanged ] フィールドは [変更済み]、 NewValue フィールドは [削除済み] です。 |
| 対象日数 | DayTime ターゲットの日を参照します。 このフィールドには、1 つの縦棒文字で区切られた日から区切られた入札単価調整も含まれます。 |
| 追跡テンプレート | キャンペーンの追跡テンプレートを参照します。 |
キーワード
ItemChanged フィールドの値が Keyword の場合、次の属性の変更履歴を使用できます。
| 属性の変更 | 説明 |
|---|---|
| なし (空白) | 追加されたキーワードのテキストを参照します。 対応する HowChanged フィールドの値が追加されます。 |
| 広義一致の入札 | キーワードの広範な一致入札金額を参照します。 |
| コンテンツの一致の入札 | キーワードのコンテンツ一致入札金額を参照します。 |
| カスタム パラメーター | キーワードのカスタム パラメーターを参照します。 |
| 編集状態 | キーワードの編集状態を参照します。 キーワードがオフライン編集レビューを保留中の場合、ダウンロードした変更履歴レポート内で編集状態は [保留中] - [アクティブ] または [ 保留中 ] - [非アクティブ] のいずれかとして表されます。 詳細については、「 エンティティと配信状態」を参照してください。 |
| 完全一致の入札 | キーワードの完全一致入札金額を参照します。 |
| 最終 URL | キーワードの最終 URL を参照します。 |
| モバイル URL | キーワードの最終モバイル URL を参照します。 |
| 照合する種類 | キーワードの入札一致の種類を参照します。 Bing広告 API を使用して、入札マッチの種類を更新することはできません。ただし、Microsoft Advertising Web アプリケーションを使用して、入札の一致の種類を変更できます。 |
| フレーズ一致の入札 | キーワードの語句一致入札金額を参照します。 |
| 状態 | キーワードの配信状態を参照します。 削除されたキーワードを報告する場合、[ ItemChanged ] フィールドは [状態]、[ HowChanged ] フィールドは [変更済み]、 NewValue フィールドは [削除済み] です。 |
| 追跡テンプレート | キーワードの追跡テンプレートを参照します。 |
場所の拡張子
ItemChanged フィールドの値が Location extension の場合は、次の属性の変更履歴を使用できます。
| 属性の変更 | 説明 |
|---|---|
| 関連付け | 場所拡張機能とエンティティの関連付けを参照します。 たとえば、拡張機能がキャンペーンに関連付けられている場合、 CampaignName フィールドの値は関連付けられたキャンペーンの名前、 ItemChanged フィールドの値は Location extension、 AttributeChanged フィールドの値は Association、 HowChanged フィールドの値は追加されます。 |
負のキーワード リスト
ItemChanged フィールドの値が負のキーワード リストの場合は、次の属性の変更履歴を使用できます。
| 属性の変更 | 説明 |
|---|---|
| 関連付け | 除外キーワード リストとキャンペーンの関連付けを指します。 たとえば、負のキーワード リストがキャンペーンに関連付けられている場合、 CampaignName フィールドの値は関連付けられているキャンペーンの名前、 ItemChanged フィールドの値は負のキーワード リスト、 AttributeChanged フィールドの値は関連付け、 HowChanged フィールドの値は追加されます。 |
| 負のキーワード | 除外キーワード リストに追加または削除された負のキーワードを参照します。 |
| 負のキーワード リスト名 | 負のキーワード リストの名前を参照します。 |
Sitelink 拡張機能
ItemChanged フィールドの値が Sitelink 拡張機能である場合は、次の属性の変更履歴を使用できます。
| 属性の変更 | 説明 |
|---|---|
| 関連付け | サイトリンク拡張機能とエンティティの関連付けを参照します。 たとえば、拡張機能がキャンペーンに関連付けられている場合、 CampaignName フィールドの値は関連付けられたキャンペーンの名前、 ItemChanged フィールドの値は Sitelink 拡張機能、 AttributeChanged フィールドの値は Association、 HowChanged フィールドの値は [追加] です。 |
| カスタム パラメーター | サイトリンクのカスタム パラメーターを参照します。 |
| 宛先 URL | サイトリンク拡張機能の宛先 URL を参照します。 |
| テキストの表示 | サイトリンク拡張機能の表示テキストを参照します。 |
| 最終 URL | サイトリンクの最終 URL を参照します。 |
| モバイル URL | サイトリンクの最終モバイル URL を参照します。 |
| 追跡テンプレート | サイトリンクの追跡テンプレートを参照します。 |
User
ItemChanged フィールドの値が User の場合、次の属性の変更履歴を使用できます。
| 属性の変更 | 説明 |
|---|---|
| なし (空白) | 追加されたユーザーのユーザー名を参照します。 対応する HowChanged フィールドの値が追加されます。 |
| コード | 内部使用の場合。 |
| 電子メール | ユーザーの連絡先メール アドレスを参照します。 |
| 名 | ユーザーの名を参照します。 |
| 姓 | ユーザーの姓を参照します。 |
| 状態 | ユーザーの状態を参照します。 |
要件
サービス: ReportingService.svc v13
名前 空間： https://bingads.microsoft.com/Reporting/v13