次の方法で共有

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

  • [アーティクル]

資産パフォーマンス レポート要求を定義します。

注:

AssetPerformanceReportRequest は現在パイロット段階です。

注:

このレポートは現在フェーズ 1 にあります。つまり、広告レベルとアセット グループ レベルのパフォーマンス データは使用できません。 アセット グループ レベルはまだサポートされていないため、AdGroupId または AdGroupName が選択されている場合、アセット グループ資産のパフォーマンス データ (パフォーマンスの最大値またはアプリ キャンペーン) は除外されます。 資産グループのデータは、アカウントレベルとキャンペーンレベルの集計に含まれます。

構文

<xs:complexType name="AssetPerformanceReportRequest" 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:ArrayOfAssetPerformanceReportColumn" />
        <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>

要素

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

要素 説明 データ型
集合体 レポート データの集計に使用する集計の種類。 たとえば、日または週別にレポート データを集計したり、サマリー レポートを要求したりできます。

既定の集計は [概要] です。 列の一覧に TimePeriod を含めなかった場合、選択した集計は無視され、サマリー集計は関係なく使用されることに注意してください。		 ReportAggregation
段組み レポートに含める属性とパフォーマンス統計の一覧。 レポートには、指定した順序で列が含まれます。 AssetPerformanceReportColumn 配列
範囲 レポートのエンティティ スコープ。

レポート データを特定のアカウント、資産グループ、またはキャンペーンに限定するには、この要素を使用します。		 AccountThroughAdGroupReportScope
時刻 レポートに使用する期間。 カスタム日付範囲を指定するか、定義済みの日付範囲 (Today や ThisWeek など) を選択できます。

集計の種類ごとに指定できる期間の一覧については、「集計 と時刻」を参照してください。		 ReportTime

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

継承された要素

ReportRequest から継承された要素

AssetPerformanceReportRequest オブジェクトは ReportRequest オブジェクトから派生し、ExcludeColumnHeaders、ExcludeReportFooter、ExcludeReportHeader、Format、FormatVersion、ReportName、ReturnOnlyCompleteData の各要素を継承します。 以下の説明は AssetPerformanceReportRequest に固有であり、 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
Namespace: https://bingads.microsoft.com/Reporting/v13