SearchQueryPerformanceReportRequest データ オブジェクト - レポート

検索クエリのパフォーマンス レポート要求を定義します。 このレポートを使用して、広告が表示されたときに対象ユーザーが検索している内容を確認します。 この情報を使用して、キーワード リストと除外キーワード リストの両方に対して情報に基づいた追加、削除、または編集を行うことができます。

広告をトリガーした検索語句のインプレッション数、クリック数、クリック率、平均位置をリクエストできます。 たとえば、住宅ローン、住宅ローン、住宅ローンなどのキーワードでキャンペーンを実行している住宅ローンの貸し手の場合。このレポートでは、検索クエリの 「住宅ローン金利」によって広告のインプレッションが多く表示され、キーワード リストに "rates" が追加される可能性が高いことがレポートに示されています。 ただし、逆引き住宅ローンを指定せず、検索クエリの "逆引き住宅ローン" によって多くのインプレッションが発生することがレポートに示されている場合は、負のキーワード リストに "逆引き住宅ローン" を追加する可能性があります。

レポートには、過去 30 日間に大量のクリックが発生した検索語句のみが含まれます。

このデータは時間の経過と同時に変化する可能性があるため、キーワードのパフォーマンス メトリックを取得するには 、KeywordPerformanceReportRequest を使用してください。

この種類のレポートを要求するには、このオブジェクトを SubmitGenerateReport 操作に渡します。

構文

<xs:complexType name="SearchQueryPerformanceReportRequest" 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:ArrayOfSearchQueryPerformanceReportColumn" />
        <xs:element minOccurs="0" name="Filter" nillable="true" type="tns:SearchQueryPerformanceReportFilter" />
        <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>

要素

SearchQueryPerformanceReportRequest オブジェクトには、集計、列、フィルター、スコープ、時刻の各要素があります。

要素	説明	データ型
集計	レポート データの集計に使用する集計の種類。 たとえば、日または週別にレポート データを集計したり、サマリー レポートを要求したりできます。 既定の集計は [概要] です。 列の一覧に TimePeriod を含めなかった場合、選択した集計は無視され、サマリー集計は関係なく使用されることに注意してください。	ReportAggregation
段組み	レポートに含める属性とパフォーマンス統計の一覧。 レポートには、指定した順序で列が含まれます。	SearchQueryPerformanceReportColumn 配列
Filter	レポート データのフィルター処理に使用するフィルター情報。	SearchQueryPerformanceReportFilter
範囲	レポートのエンティティ スコープ。 レポート データを特定のアカウント、広告グループ、またはキャンペーンに限定するには、この要素を使用します。	AccountThroughAdGroupReportScope
時刻	レポートに使用する期間。 カスタム日付範囲を指定するか、定義済みの日付範囲 (Today や ThisWeek など) を選択できます。 集計の種類ごとに指定できる期間の一覧については、「集計 と時刻」を参照してください。 ReportTime オブジェクト内のタイム ゾーンを設定できます。これにより、要求された期間のデータを正確にスコープできます。 タイム ゾーンを選択しない場合、レポート サービスでは既定で PacificTimeUSCanadaTijuana が使用されます。	ReportTime

SearchQueryPerformanceReportRequest オブジェクトには継承された要素があります。

継承された要素

ReportRequest から継承された要素

SearchQueryPerformanceReportRequest オブジェクトは ReportRequest オブジェクトから派生し、ExcludeColumnHeaders、ExcludeReportFooter、ExcludeReportHeader、Format、FormatVersion、ReportName、ReturnOnlyCompleteData の各要素を継承します。 以下の説明は SearchQueryPerformanceReportRequest に固有であり、 ReportRequest オブジェクトから同じ要素を継承する他のオブジェクトには適用されない場合があります。

要素	説明	データ型
ExcludeColumnHeaders	ダウンロードしたレポートに各列のヘッダーの説明を含めるかどうかを指定します。 レポート列ヘッダーは、要求された列名 ( インプレッション 数やクリック数など) と一致 します。 ダウンロードしたレポートからレポート列ヘッダーを除外する場合は、このプロパティを true に 設定します。 既定値は false です。	boolean
ExcludeReportFooter	ダウンロードしたレポートに Microsoft 著作権 (@2020 Microsoft Corporation) などのフッター メタデータを含めるかどうかを決定します。すべての権限が予約されています。)。 ダウンロードしたレポートからレポート フッターのメタデータを除外する場合は、このプロパティを true に 設定します。 既定値は false です。	boolean
ExcludeReportHeader	ダウンロードしたレポートに、レポート名、日付範囲、集計などのヘッダー メタデータを含めるかどうかを指定します。 ダウンロードしたレポートからレポート ヘッダーのメタデータを除外する場合は、このプロパティを true に 設定します。 既定値は false です。	boolean
フォーマット	レポート データの形式。 たとえば、コンマ区切り (Csv) 形式またはタブ区切り値 (Tsv) 形式でデータを要求できます。 既定値は Csv です。 ダウンロードされたすべてのファイルは ZIP 圧縮されます。	ReportFormat
FormatVersion	ダウンロードしたレポート ファイル内の特定のフィールドの形式を決定します。 特定のフィールドのデータ形式は、既存のクライアント アプリケーションを中断することなく、現在の API バージョン内で更新できます。 このオプションの要求フィールドを 2.0 に設定することで、最新のデータ形式を取得できます。 このフィールドを設定しない場合、サービスは既定でバージョン 1.0 になります。 書式バージョン間の変更の詳細については、「 レポート形式のバージョン」を参照してください。	string
ReportName	レポートの名前。 名前はレポート ヘッダーに含まれます。 レポート名を指定しない場合、ReportType-ReportDateTime というフォームに名前が生成されます。 レポート名の最大長は 200 です。	string
ReturnOnlyCompleteData	サービスで、すべてのデータが処理され、使用可能であることを確認する必要があるかどうかを判断します。 true に設定され、要求された集計、スコープ、時刻に基づいてすべてのデータの処理が完了していない場合、サービスはエラー コード NoCompleteDataAvaliable (2004) を返します。 それ以外の場合、既定では要求が成功する可能性があるため、データが完了しているかどうかは示されません。レポートには、要求時にシステムが処理を完了したデータのみが含まれます。 今日はまだ進行中であり、データが完了していないため、期間 (カスタムまたは定義済みの日付) に今日の日付が含まれている場合、この要素を true に設定することはできません。 詳細については、「 レポートのタイム ゾーン」を参照してください。	boolean

要件

サービス: ReportingService.svc v13
名前 空間： https://bingads.microsoft.com/Reporting/v13